Tworzenie plików danych
Aby dane wyświetlały się bezpośrednio w Google, muszą być regularnie przesyłane do Google. Wymagane są te pliki danych.
| Kanał | Opis | Częstotliwość |
|---|---|---|
| Sprzedawcy | Opisuje Twoich sprzedawców. | Co 24 godziny |
| Usługi | Opisuje usługi świadczone przez Twoich sprzedawców | Co 24 godziny |
| Dostępność | Dostępne przedziały dla usług świadczonych przez sprzedawców. Musisz podać polisę ubezpieczeniową przez co najmniej 30 dni. | Co 24 godziny |
W każdym pliku danych uwzględnij metadane, które wskażą Google, jak je interpretować.
Format plików danych jest opisany zgodnie ze 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 przesłanie plików danych w formacie JSON.
Rozmiar pliku danych, fragmentacja i kompresja
Zapoznaj się z samouczkami dotyczącymi kompresji i fragmentów:Aby określić rozmiar plików danych, korzystaj z tych wskazówek (kanał może składać się z wielu plików nazywanych „fragmentami”):
- Sugerowane fragmenty pliku danych:
- 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:
- Zachowaj rozmiar pliku dla fragmentu poniżej 200 MB (po skompresowaniu). W razie potrzeby użyj wielu fragmentów.
- Indywidualne rekordy wysyłane w jednym fragmencie nie muszą być wysyłane w tym samym fragmencie w przyszłych kanałach.
- 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 do skompresowania plików danych JSON w postaci zwykłego tekstu. Zrób to jednak w przypadku każdego fragmentu kanału.
Przesyłanie plików danych do skrzynki referencyjnej SFTP
Prześlij pliki danych do środowiska piaskownicy. W tym celu zapoznaj się z nazwami użytkowników na stronie konfiguracji pliku danych Portalu dla partnerów. Serwer SFTP Google jest dostępny pod adresem sftp://partnerupload.google.com i portem 19321.
Zalecamy nadanie przesyłanych plikom unikalnych nazw. Na przykład pomocne może być dopisanie sygnatury czasowej do każdego 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 w sekcji Panele znaleźć poniższe strony.
- Pliki danych
- Pokazuje podsumowanie statystyk pliku danych i wskazuje błędy podczas przesyłania.
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 sprawdź, czy na stronie Podsumowanie zasobów reklamowych nie występują problemy z danymi. Typowe problemy obejmują przesyłanie informacji o sprzedawcach, którzy nie korzystają z żadnych usług, lub przesyłanie usług bez żadnych przedziałów dostępności w przyszłości.
Frontend piaskownicy, który emuluje interfejs aktywnego użytkownika, pokazuje, jak dane będą wyglądać z perspektywy użytkownika. Aby uzyskać do niego dostęp, ustaw przełącznik środowiska u góry na piaskownicę. Kliknij Zasoby reklamowe > Zasoby reklamowe , znajdź sprzedawcę o statusie „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 „Gotowy” lub „Aktywny (w trybie piaskownicy)”, otwórz konto sprzedawcy wyłączonego i rozwiąż wszystkie problemy wymienione po prawej stronie (np. upewnij się, że informacje o przyszłej dostępności zostały przesłane).
Jeśli nie masz dostępu do frontendu piaskownicy, sprawdź, czy korzystasz z konta, które otrzymało do niego dostęp. Upewnij się też, że jest to jedyne konto, z którego aktualnie korzystasz. Jeśli zalogujesz się na inne konto, a potem użyjesz funkcji Przełącz użytkownika, aby zalogować się na zatwierdzone konto Google, nadal utracisz dostęp do frontendu piaskownicy.
Przesyłanie plików danych do wersji produkcyjnej
Gdy będziesz w stanie regularnie przesyłać do środowiska piaskownicy pełne, wolne od błędów pliki danych, możesz zacząć je przesyłać 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 rozpoczęciem kampanii), aby móc dopasowywać sprzedawców do wizytówek firm w Google. Sprawdź, czy dopasowanie jest prawidłowe.
Gdy wszystkie informacje z produkcyjnego pliku danych będą konsekwentnie przesyłane i połączone z systemem produkcyjnym, pliki danych będą 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. Uwzględniamy te czynniki:
- 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 plikach danych jest zgodna z liczbą ustaloną z Google.
- Sprawdzamy, ile usług ma otwarte przedziały dostępności w ciągu najbliższych 1–30 dni.
- Sprawdzamy, ilu podanych sprzedawców można dopasować do obiektów w Mapach Google.