Pliki danych przekazują dane o asortymencie do Centrum działań. Codzienne przesyłanie danych za pomocą bezpiecznego protokołu przesyłania plików (SFTP) aktualizuje wszystkie dane sprzedawców, usług i przedziałów czasowych. Pliki danych określają, których sprzedawców obsługujesz, ich dostępność i wszelkie specjalne funkcje wymagane do potwierdzenia, że Google prawidłowo wyświetla Twój asortyment. Pliki danych są przesyłane do skrzynek referencyjnych SFTP, które są konfigurowane po podaniu klucza SSH w sekcji Konfiguracja.
Zanim przejdziesz do serwera rezerwacji, musisz wykonać te czynności związane z plikami danych:
- Plik danych sprzedawcy gotowy
- Plik danych o usługach gotowy
- Plik danych o dostępności gotowy
- Jakość danych
Po przesłaniu plików danych zadania zostaną oznaczone jako ukończone i zmienią kolor na zielony. Zapoznaj się z dokumentacją, do której prowadzą linki, aby wykonać poszczególne zadania związane z etapami.
Aby zapewnić prawidłowe działanie integracji rezerwacji w restauracjach, musisz codziennie automatycznie przesyłać pliki danych o sprzedawcach, usługach i dostępności. Zautomatyzowana infrastruktura plików danych musi zawierać pełny asortyment.
Typy plików danych
Integracje kompleksowych rezerwacji w restauracjach wymagają tych plików danych i częstotliwości ich przesyłania:
| Kanał | Opis | Częstotliwość | Przykład |
|---|---|---|---|
| Sprzedawca | Opisuje sprzedawców. | Raz na 24 godziny | Przykładowy plik danych sprzedawcy |
| Usługi | Opisz usługi sprzedawców. | Raz na 24 godziny | Przykładowy plik danych o usługach |
| Dostępność | Opisuje dostępne terminy usług sprzedawców. Należy zapewnić co najmniej 30-dniowy okres ochrony. Aby przedłużyć okres ochrony do 90 dni, skontaktuj się z zespołem pomocy Google za pomocą formularza kontaktowego w Centrum działań. | Raz na 24 godziny | Przykładowy plik danych o dostępności |
Formaty plików danych są opisane za pomocą składni bufora protokołu 3, ale możesz przesyłać pliki danych w odpowiednim formacie JSON. Przykłady plików danych w formacie JSON znajdziesz w sekcji Zalecamy przesyłanie plików danych w formacie JSON.
Konwencje nazewnictwa i metadane
Nazwy plików
Jeśli używasz dzielenia na fragmenty, przesyłane przez Ciebie pliki danych muszą mieć unikalne nazwy, które określają typ i liczbę plików danych. Sygnatura czasowa generowania pliku danych spełnia wymaganie unikalności nazwy pliku danych.
Struktura: {feed_name}_{timestamp_epoch}_{shard_nunber}_{total_shard}.json
Przykład: availability_feed_1574117613_001_of_002.json.gz
Definiowanie identyfikatorów
Podczas definiowania identyfikatorów sprzedawców lub innych atrybutów, które wymagają identyfikatora, zdecydowanie zalecamy używanie identyfikatorów UID lub UUID. Możesz podać własne rozwiązanie alfanumeryczne, o ile identyfikatory pozostaną odrębne na Twojej platformie.
Metadane
Podczas tworzenia plików danych element generation_timestamp musi odzwierciedlać czas, w którym dane zostały pobrane z bazy danych. Ponowne użycie tej wartości w różnych plikach danych może prowadzić do błędów przetwarzania.
Wartości nonce, czyli liczby losowe lub niepowtarzające się, muszą być unikalne w przypadku wszystkich typów plików danych i nie mogą być używane ponownie. Wartość musi być zgodna we wszystkich plikach w konkretnym podzielonym pliku danych.
Rozmiar pliku danych
Dzielenie plików danych na części
W zależności od asortymentu może być konieczne podzielenie plików danych na kilka plików. Dzielenie plików danych na mniejsze części może być konieczne w tych sytuacjach:
- Skompresowany plik danych gzip przekracza 200 MB.
- Przykład: wygenerowany plik danych o dostępności ma rozmiar 1 GB. Musi być podzielony na co najmniej 5 osobnych fragmentów.
- Zasoby reklamowe partnera są rozproszone w różnych systemach lub regionach, co utrudnia ich uzgadnianie.
- Przykład: partner ma zasoby reklamowe w Stanach Zjednoczonych i Unii Europejskiej, które znajdują się w osobnych systemach.
Plik danych może zostać wygenerowany w 2 fragmentach. Jeden dla Stanów Zjednoczonych i jeden dla Unii Europejskiej z tym samym identyfikatorem jednorazowym i parametrem
generation_timestamp.
- Przykład: partner ma zasoby reklamowe w Stanach Zjednoczonych i Unii Europejskiej, które znajdują się w osobnych systemach.
Plik danych może zostać wygenerowany w 2 fragmentach. Jeden dla Stanów Zjednoczonych i jeden dla Unii Europejskiej z tym samym identyfikatorem jednorazowym i parametrem
Więcej informacji znajdziesz w artykule Samouczki i sprawdzone metody dotyczące dzielenia plików danych.
Plik danych może składać się z wielu plików zwanych fragmentami. Aby określić rozmiar plików danych, postępuj zgodnie z tymi wskazówkami:
- Sugerowane dzielenie pliku danych:
- Plik danych sprzedawcy: 1 fragment.
- Kanał usług: 1 fragment.
- Plik danych o dostępności: mniej niż 20 fragmentów. Jeśli masz uzasadnienie biznesowe, które wymaga większej kwoty niż podana, skontaktuj się z zespołem pomocy, aby uzyskać dalsze instrukcje.
- Rozmiar plików danych i dzielenie na fragmenty:
- Rozmiar pliku fragmentu po skompresowaniu nie może przekraczać 200 MB. W razie potrzeby użyj wielu fragmentów.
- Poszczególne rekordy wysłane w jednym fragmencie nie muszą być wysyłane w tym samym fragmencie w przyszłych plikach danych.
- Aby uzyskać lepszą wydajność, równomiernie rozdziel dane między fragmenty, tak aby wszystkie pliki fragmentów miały podobny rozmiar.
- W razie potrzeby użyj kompresji gzip, aby skompresować pliki danych JSON w formacie zwykłego tekstu dla każdego fragmentu pliku danych.
Kompresowanie plików danych
Przed przesłaniem dowolnego pliku JSON lub PB3 możesz go skompresować za pomocą gzip. Może to znacznie zmniejszyć rozmiar plików danych w bajtach.
Każdy plik fragmentu musi być skompresowany za pomocą gzip i przesłany osobno, np. gzip*.json. Skompresowane fragmenty pliku danych muszą kończyć się na .json.gz lub .pb3.gz.
Przesyłanie plików danych do skrzynki referencyjnej SFTP
Po wygenerowaniu plików danych sprzedawcy, usługi i dostępności możesz przesłać je do środowiska testowego lub produkcyjnego za pomocą skrzynki SFTP. Skrzynka referencyjna SFTP jest konfigurowana, gdy w sekcji Konfiguracja podasz klucz SSH.
Serwer SFTP Google jest dostępny pod adresem sftp://partnerupload.google.com na porcie 19321.
Google sprawdza i weryfikuje pliki danych zaraz po ich przesłaniu do skrzynki SFTP. Jeśli plik danych jest podzielony na kilka plików, są one przetwarzane po przesłaniu ostatniego z nich. Jeśli Twój plik danych zawiera błędy, wyślemy Ci e-maila z kodami błędów pliku danych. Błędy uniemożliwiają wczytywanie zdefiniowanych sprzedawców, usług lub dostępności. Po zweryfikowaniu plików danych może minąć do 24 godzin, zanim pojawią się one w interfejsie.