Skrzynka domyślna pliku danych umożliwia przesyłanie wielu typów plików danych do jednej skrzynki referencyjnej w danym środowisku. Ten przewodnik zawiera informacje o tym, jak korzystać ze standardowej skrzynki referencyjnej, a także linki do odpowiednich przewodników dotyczących plików danych, których zamierzasz używać.
(Zapoznaj się z sekcją Eksportowanie plików danych (w ramach pełnej implementacji) lub Pliki danych (wprowadzenie) w dokumentacji).Ogólna skrzynka referencyjna jest przesyłana do dwóch osobnych plików:
- Plik deskryptora: określa typ przesyłanego pliku danych.
- Pliki kanału: zawartość rzeczywistego kanału
Tworzenie struktury pola deskryptora
Plik z deskryptorem informuje nasz system o typie przesyłanego pliku danych. Dzięki temu możemy zweryfikować i prawidłowo przetworzyć plik danych. Plik z deskryptorem należy przesłać przed zawartością pliku danych i musi on spełniać te wymagania dotyczące nazewnictwa:
- Użyj rozszerzenia pliku .filesetdesc.json
- Każda nazwa pliku z deskryptorem musi być unikalna i nie można jej ponownie użyć w przesyłanych materiałach. Zalecamy umieszczenie w nazwie pliku sygnatury czasowej wygenerowania.
- Przykład: offer_1524606581.filesetdesc.json
message FilesetDescriptor { // The timestamp at which this feed was generated, in Unix time format // (seconds since the epoch). (required) int64 generation_timestamp = 1; // Identifies the name of this feed. (required) string name = 2; // Paths (relative to the dropbox root) specifying data files included in this // feed. (required) repeated string data_file = 3; }
Możliwe wartości pola name
:
Poniżej dostępny jest przykładowy plik deskryptora JSON dla pliku danych z ofertami zawierającymi 2 fragmenty:
{ "generation_timestamp": 1524606581, "name": "promote.offer", "data_file": [ "offers_1524606581_1.json", "offers_1524606581_2.json" ] }
Tworzenie struktury treści pliku danych
Po przesłaniu pliku z deskryptorem musisz przesłać wszystkie pliki danych o typie pliku danych, który odpowiada plikowi konfiguracji pliku danych, którego nazwa jest wskazana w Twoim pliku deskryptora. Nazwy plików i lokalizacje ścieżek (względne w skrzynce referencyjnej) muszą być dokładnie takie same jak podane w polu data_file
. Jeśli brakuje jakiegoś pliku, ma on nieprawidłową nazwę lub został przesłany do innej lokalizacji, cały plik danych nie zostanie przetworzony.
Zawartość tych plików danych musi być zgodna z odpowiednią specyfikacją pliku danych określoną w pliku deskryptora.
Każda nazwa pliku danych musi być niepowtarzalna i nie można jej używać wielokrotnie w przesyłanych materiałach. Zalecamy umieszczenie w nazwie pliku sygnatury czasowej generowania i numeru fragmentu (identyfikatora przyrostowego).
- Przykład: offer_1524606581_1.json
Rozmiary plików danych i częstotliwość przesyłania
- Rozmiar pliku danych nie może przekraczać 200 MB (po skompresowaniu).
- Większość integracji wymaga tylko jednego fragmentu. Użyj jak najmniejszej liczby fragmentów. Obowiązuje limit 1000 fragmentów na kanał.
- Poszczególne rekordy wysyłane w jednym fragmencie nie muszą być wysyłane w tym samym numerze fragmentu w przyszłych 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 do skompresowania plików danych użyj narzędzia gzip. Należy to jednak zrobić w przypadku każdego pojedynczego fragmentu pliku danych.
Rozwiązywanie problemów i debugowanie
Po przesłaniu plików (deskryptora i plików kanału) otwórz panel historii kanału (dokumentacja) w portalu dla partnerów (otwórz Historia > Kanały), aby śledzić postęp przetwarzania kanałów.
Aby znaleźć plik danych, poszukaj elementu name
podanego w pliku deskryptora w kolumnie „Nazwa pliku danych”.
Po przetworzeniu pliku danych (stan to Success
lub Fail
) możesz kliknąć jego wiersz, aby wyświetlić szczegóły błędów i ostrzeżeń.