Eksportowanie plików danych

Tworzenie plików danych

Pliki danych muszą być regularnie udostępniane Google, aby mogły być bezpośrednio wyświetlane w Google. Potrzebujemy tych plików danych.

Kanał Opis Częstotliwość
Sprzedawcy Opisuje sprzedawców. Raz na 24 godziny
Usługi Opisuje usługi świadczone przez Twoich sprzedawców Raz na 24 godziny
Dostępność Przedziały dostępne dla usług świadczonych przez sprzedawców. Musisz podać dane z pokrycia przez co najmniej 30 dni. Raz na 24 godziny

W każdym pliku danych umieść metadane, które pomogą Google zrozumieć jego interpretację.

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. Aby zobaczyć format JSON, skorzystaj z przykładów kanału. 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 kanałów, postępuj według tych wytycznych (plik danych może składać się z wielu plików nazywanych „fragmentami”):

  • Sugerowana fragmentacja 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:
    • Rozmiar pliku zrzutu nie może przekraczać 200 MB (po kompresji). 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 równomiernie między fragmenty, aby wszystkie pliki były podobne do rozmiaru.
    • W razie potrzeby możesz skompresować kanały JSON zawierające zwykły tekst w formacie gzip. Musisz to jednak zrobić dla poszczególnych fragmentów kanału.

Przesyłanie plików danych do skrzynki domyślnej SFTP

Prześlij pliki danych do środowiska piaskownicy. Aby to zrobić, sprawdź nazwy użytkowników na stronie konfiguracji pliku danych w portalu dla partnerów. Serwer Google SFTP jest dostępny pod adresem sftp://partnerupload.google.com na porcie 19321.

Zalecamy nadawanie plikom przesyłanych unikalnych nazw. Na przykład do nazwy każdego pliku możesz użyć sygnatury czasowej. Pomaga to rozwiązywać problemy i zapytać o stan pliku danych.

Sprawdzanie poprawności danych

Zaloguj się w portalu dla partnerów. Przełącz się na środowisko Piaskownica, aby w sekcji Panele znaleźć te strony.

Kanały
Pokazuje statystyki podsumowania pliku danych 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 sprawdź, czy na stronie Podsumowanie zasobów reklamowych nie ma problemów z danymi. Typowe problemy to przesyłanie sprzedawców bez żadnych usług lub przesyłanie usług bez dostępnych przedziałów dostępności w przyszłości.

Interfejs sandbox, który emuluje działanie interfejsu użytkownika, pokazuje, jak dane będą wyglądać z perspektywy użytkownika. Aby uzyskać do niej dostęp, sprawdź, czy u góry przełącznik środowiska jest ustawiony na tryb piaskownicy, i kliknij Zasoby reklamowe > Zasoby reklamowe, znajdź sprzedawcę ze stanem „Gotowy” lub „Aktywny (w trybie piaskownicy)”, kliknij link w kolumnie po prawej stronie (jeśli jest dostępny) lub w wierszu po prawej stronie i kliknij link „RwG – E2E”. Jeśli nie ma sprzedawcy o stanie „Gotowy” lub „Aktywny (w trybie piaskownicy)”, otwórz wyłączonego sprzedawcę i rozwiąż wszystkie problemy wymienione po prawej stronie (na przykład prześlij przesłaną dostępność w przyszłości).

Jeśli nie masz dostępu do frontendu piaskownicy, sprawdź, czy korzystasz z konta z przyznanym dostępem do frontendu. Pamiętaj, by zalogować się na to jedyne konto. Jeśli zalogujesz się za pomocą innego konta, a następnie za pomocą funkcji przełączania użytkowników zalogujesz 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 już regularnie przesyłać kompletne, bezbłędne pliki danych do środowiska piaskownicy, możesz rozpocząć przesyłanie do środowiska produkcyjnego. Na tym etapie integracja nie będzie aktywna.

Jak najszybciej prześlij pełny plik danych o sprzedawcach (co najmniej 1 tydzień przed uruchomieniem), aby móc zacząć dopasowywać sprzedawców do wizytówki firmy w Google. Sprawdź, czy dopasowanie jest poprawne.

Gdy wszystkie pliki danych produkcyjnych będą regularnie 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 kątem jakości i kompletności. Przyglądamy się takim czynnikom:

  1. Pliki danych są zgodne ze specyfikacją pliku danych.
  2. Pliki danych zawierają wszystkie wymagane pola.
  3. Łączna liczba sprzedawców w plikach danych odpowiada wartościom omówionym przez Google.
  4. Dla każdego sprzedawcy określono co najmniej jedną usługę.
  5. Łączna liczba usług w plikach danych jest zgodna z liczbą omówioną przez Google.
  6. Sprawdzamy, jak wiele usług ma wolne przedziały na następne 1–30 dni.
  7. Sprawdzamy, ilu wybranych sprzedawców można dopasować do funkcji Map Google.