Tworzenie plików danych
Aby dane wyświetlały się bezpośrednio w Google, muszą być regularnie przekazywane do Google. Potrzebne są te pliki danych.
| Kanał | Opis | Częstotliwość |
|---|---|---|
| Sprzedawcy | Opisuje Twoich sprzedawców. | Co 24 godziny |
| Usługi | Opisuje usługi świadczone przez sprzedawców | Co 24 godziny |
| Dostępność | Dostępne przedziały czasu na usługi oferowane przez sprzedawców. Musisz podać polisę przez co najmniej 30 dni. | Co 24 godziny |
W każdym kanale uwzględnij metadane, które wskażą Google, jak je interpretować.
Format plików danych jest opisany za pomocą składni bufora protokołu 3, ale możesz przesyłać pliki danych w odpowiednim formacie JSON. Format JSON znajdziesz w przykładach plików danych. Zalecamy przesyłanie plików danych w formacie JSON.
Rozmiar pliku danych, fragmentacja i kompresja
Zapoznaj się z tymi samouczkami dotyczącymi kompresji i fragmentów:Aby określić rozmiar plików danych, skorzystaj z tych wskazówek (kanał może składać się z kilku plików nazywanych „fragmentami”):
- Sugerowane fragmenty kanału:
- Plik danych sprzedawców: 1 fragment
- Plik danych usług: 1 fragment
- Plik danych o dostępności : mniej niż 20 fragmentów
- Rozmiar plików danych i fragmentacja:
- Utrzymuj rozmiar pliku fragmentu poniżej 200 MB (po skompresowaniu). W razie potrzeby użyj wielu fragmentów.
- Poszczególne rekordy wysyłane w jednym fragmencie nie muszą być wysyłane w tym samym fragmencie w kolejnych plikach danych.
- Aby uzyskać lepszą wydajność, podziel dane po równo między fragmenty, aby rozmiar wszystkich plików fragmentów był podobny.
- W razie potrzeby użyj narzędzia gzip, aby skompresować pliki danych JSON w postaci zwykłego tekstu. Należy to jednak zrobić w przypadku każdego pojedynczego fragmentu pliku danych.
Przesyłanie plików danych do skrzynki referencyjnej SFTP
Prześlij pliki danych do środowiska piaskownicy. W tym celu użyj nazw użytkowników na stronie konfiguracji pliku danych Portalu dla partnerów. Serwer SFTP Google jest dostępny pod adresem sftp://partnerupload.google.com na porcie 19321.
Zalecamy nadanie przesyłanym plikom unikalnych nazw. Na przykład pomocne może być dodanie sygnatury czasowej do każdej nazwy pliku. Pomaga to rozwiązywać problemy i wysyłać zapytania o stan pliku danych.
Sprawdź, czy dane wyglądają prawidłowo
Zaloguj się w portalu dla partnerów. Przełącz się na środowisko Piaskownica, aby znaleźć poniższe strony w sekcji Panele informacyjne.
- Pliki danych
- Pokazuje podsumowanie statystyk kanału i wskazuje błędy podczas przesyłania pliku danych.
Aby się upewnić, że po pierwszym przesłaniu do środowiska piaskownicy dane wyglądają prawidłowo, sprawdź, czy na stronie Pliki danych nie ma błędów w pliku danych. Następnie otwórz stronę Podsumowanie zasobów reklamowych pod kątem problemów z danymi. Typowe problemy obejmują przesyłanie sprzedawców, którzy nie mają żadnych usług, lub przesyłanie usług bez przedziałów dostępności w przyszłości.
Frontend piaskownicy, który emuluje interfejs aktywnego interfejsu, pokazuje, jak dane będą wyglądać z punktu widzenia użytkownika. Aby uzyskać do niego dostęp, upewnij się, że przełącznik środowisk u góry jest ustawiony na tryb piaskownicy, i kliknij Zasoby reklamowe > Zasoby reklamowe , znajdź sprzedawcę, który ma stan „Gotowy” lub „Aktywny (w trybie piaskownicy)”, a potem kliknij link w kolumnie po prawej stronie (jeśli jest dostępny) lub wiersz i link „RwG – E2E”. Jeśli nie ma sprzedawcy ze stanem „Gotowe” lub „Aktywny (w trybie piaskownicy)”, otwórz wyłączonego sprzedawcę i rozwiąż wszystkie problemy wymienione po prawej stronie (np. sprawdź, czy została przesłana przyszłe informacje o dostępności).
Jeśli nie możesz uzyskać dostępu do frontendu piaskownicy, sprawdź, czy korzystasz z konta, które otrzymało dostęp do frontendu. Upewnij się też, że jest to jedyne konto, na które się logujesz. Jeśli zalogujesz się na inne konto, a potem użyjesz funkcji Przełącz użytkownika, aby zalogować się na zatwierdzone konto Google, nadal nie będziesz mieć dostępu do frontendu piaskownicy.
Przesyłanie plików danych do wersji produkcyjnej
Gdy będziesz w stanie regularnie przesyłać do środowiska piaskownicy kompletne, wolne od błędów pliki danych, możesz rozpocząć przesyłanie do środowiska produkcyjnego. Na tym etapie Twoja integracja nie będzie aktywna.
Jak najszybciej prześlij pełny plik danych sprzedawcy (co najmniej tydzień przed uruchomieniem), aby zacząć dopasowywać sprzedawców do informacji o firmie w Google. Sprawdź, czy dopasowanie jest prawidłowe.
Gdy wszystkie dane z pliku danych produkcyjnego będą konsekwentnie przesyłane i połączone z systemem produkcyjnym, pliki danych są gotowe do sprawdzenia.
Google ocenia pliki danych
Gdy prześlesz pliki danych, Google przetwarza je i ocenia pod względem jakości i kompletności. Przyglądamy się następującym czynnikom:
- Pliki danych są zgodne ze specyfikacją pliku danych.
- Pliki danych zawierają wszystkie wymagane pola.
- Łączna liczba sprzedawców w plikach danych jest zgodna z liczbą ustaloną z Google.
- Dla każdego sprzedawcy zdefiniowano co najmniej jedną usługę.
- Łączna liczba usług w kanałach jest zgodna z liczbą omawianą z Google.
- Sprawdzamy, ile usług ma wolne przedziały dostępności na najbliższe 1–30 dni.
- Sprawdzamy, ilu podanych sprzedawców można dopasować do obiektów w Mapach Google.