Skrzynka ogólna ulotek umożliwia przesyłanie wielu typów plików danych do 1 skrzynki referencyjnej na środowisko. W tym przewodniku znajdziesz informacje o tym, jak korzystać ze standardowej skrzynki pocztowej, oraz linki do odpowiedniego przewodnika po pliku danych, którego zamierzasz używać.
(Zapoznaj się z sekcją Eksportowanie plików danych (pełne dane) lub Pliki danych (początek) w dokumentacji.Skrzynka odbiorcza ogólna korzysta z 2 osobnych plików:
- Plik deskryptora: opisuje, jaki typ pliku danych będziesz przesyłać.
- Pliki: zawartość rzeczywistego pliku danych.
Struktura pola deskryptora
Plik deskryptora jest przesyłany w celu informowania naszego systemu o rodzaju przesyłanego pliku danych. Dzięki temu będziemy mogli prawidłowo zweryfikować i przetworzyć plik danych. Plik deskryptora należy przesłać przed treścią pliku danych i spełniać te wymagania dotyczące nazw:
- Użyj rozszerzenia pliku .filesetdesc.json
- Każda nazwa pliku z deskryptorem musi być unikalna i nie można jej użyć ponownie w przesyłanych materiałach. Zalecamy umieszczenie w nazwie pliku sygnatury czasowej wygenerowania.
- Przykład: offers_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 w polu name
:
Poniżej znajdziesz przykładowy plik deskryptora JSON dla pliku danych ofert z dwoma fragmentami:
{ "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 deskryptora prześlij wszystkie pliki danych typu pliku danych odpowiadającego plikowi konfiguracji kanału opisanemu przez ten plik. Nazwy plików i lokalizacje ścieżek (względnie w skrzynce domyślnej) muszą być takie same jak wartości podane w polu data_file
. Jeśli brakuje pliku lub ma on nieprawidłową nazwę albo znajduje się w innej lokalizacji, cały plik danych nie zostanie przetworzony.
Zawartość tych plików danych musi być zgodna z odpowiednią specyfikacją pliku danych, która została określona w pliku deskryptora.
Każda nazwa pliku danych musi być unikalna i nie można jej użyć ponownie w przesyłanych filmach. Zalecamy umieszczenie w nazwie pliku sygnatury czasowej wygenerowania oraz fragmentu kodu (identyfikatora przyrostowego).
- Przykład: offers_1524606581_1.json
Rozmiary plików danych i częstotliwość przesyłania
- Rozmiar pliku danych nie powinien przekraczać 200 MB (po kompresji).
- Większość integracji wymaga tylko jednego fragmentu. Użyj jak najmniejszej liczby fragmentów. Możesz przesłać maksymalnie 1000 fragmentów na kanał.
- Indywidualne rekordy wysyłane w jednym fragmencie nie muszą być wysyłane z takim samym numerem w kolejnych plikach danych.
- Aby uzyskać lepszą wydajność, podziel dane równo między fragmenty, dzięki czemu wszystkie pliki fragmentów będą miały podobny rozmiar.
- W razie potrzeby możesz użyć narzędzia gzip, aby skompresować kanały. Wykonaj te czynności dla każdego fragmentu pliku danych.
Rozwiązywanie problemów i debugowanie
Po przesłaniu plików (deskryptorów i plików danych) otwórz panel historii kanału (dokumentacja) w portalu dla partnerów (wybierz Historia > Kanały), aby sprawdzić postęp przetwarzania kanału.
Aby znaleźć swój kanał, w kolumnie „Nazwa pliku danych” odszukaj ciąg name
podany w pliku deskryptora.
Po przetworzeniu pliku danych (stan: Success
lub Fail
) możesz kliknąć jego wiersz, aby wyświetlić szczegółowe informacje o błędach i ostrzeżeniach.