Ogólna skrzynka referencyjna umożliwia przesyłanie wielu typów plików danych do jedną skrzynkę referencyjną na środowisko. Z tego przewodnika dowiesz się, jak korzystać z ogólną skrzynkę referencyjną i podać linki do odpowiednich przewodników dla poszczególnych kanału, którego zamierzasz użyć.
. (Zapoznaj się z Eksportowanie plików danych (kompleksowo) i plików danych (start) w dokumentacji. .Ogólna skrzynka referencyjna opiera się na 2 osobnych operacjach przesyłania:
- Plik deskryptora: opisuje, jakiego typu pliku danych będziesz używać przesyłanie
- Pliki kanału: zawartość faktycznego kanału.
Tworzenie struktury pola deskryptora
Przesłany plik deskryptora informuje nasz system o typie pliku danych, które przesyłasz. Pozwoli nam to zweryfikować i przetworzyć plik danych. plik deskryptora należy przesłać przed treścią pliku danych i musi spełniać następujące wymagania dotyczące nazw:
- Użyj rozszerzenia pliku .filesetdesc.json
- Każda nazwa pliku deskryptora musi być unikalna i nie można jej użyć ponownie w kolejnych przesyłanych plikach. Śr
zalecamy dodanie do nazwy 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:
Przykładowy plik deskryptora JSON dla pliku danych ofert z dwoma fragmentami to dostępne poniżej:
{
"generation_timestamp": 1524606581,
"name": "promote.offer",
"data_file": [
"offers_1524606581_1.json",
"offers_1524606581_2.json"
]
}
Tworzenie struktury zawartości kanału
Po przesłaniu pliku deskryptora prześlij też wszystkie pliki danych
dla typu danych kanału odpowiadającego plikowi konfiguracji pliku danych o nazwie
w pliku deskryptora. Nazwy plików i lokalizacje ścieżek (względna w tagu
skrzynki referencyjnej) musi dokładnie odpowiadać informacjom zawartym w
data_file. jeśli brakuje pliku, ma on nieprawidłową nazwę lub
przesłany do innej lokalizacji, cały plik danych nie zostanie
przetworzono.
Zawartość tych plików danych musi spełniać wymagania z pliku danych określonego w pliku deskryptora.
Każda nazwa pliku danych musi być unikalna i nie można jej użyć ponownie w różnych plikach. Zalecamy łącznie z sygnaturą czasową generowania i numerem fragmentu (identyfikatorem przyrostowym) w nazwie pliku.
- 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 potrzebuje tylko 1 fragmentu. Należy użyć jako jak najmniejszą liczbę fragmentów. Możesz mieć maksymalnie 1000 fragmentów na kanał.
- Nie trzeba wysyłać w tym samym fragmencie pojedynczych rekordów wysyłanych w jednym fragmencie numeru fragmentu w przyszłych kanałach.
- Aby uzyskać lepszą wydajność, podziel dane równomiernie między fragmenty, aby wszystkie pliki fragmentów o podobnym rozmiarze.
- W razie potrzeby użyj programu gzip do skompresowania kanałów. Zrób to jednak w przypadku każdej z nich, fragment pojedynczego kanału.
Rozwiązywanie problemów i debugowanie
Po przesłaniu plików (plików deskryptorów i plików danych) przejdź do Panel historii pliku danych (dokumentacja) w Portalu dla partnerów (otwórz Historia > Kanały), aby śledzić postęp przetwarzania kanału.
Odszukaj element name podany w pliku deskryptora w kolumnie „Nazwa pliku danych”. .
Po przetworzeniu pliku danych (stan to Success lub Fail) możesz kliknąć
swojego wiersza, aby zobaczyć szczegóły błędów i ostrzeżeń.