Korzystanie ze skrzynki referencyjnej ogólnego pliku danych

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ć.

Ogólna skrzynka referencyjna opiera się na 2 osobnych operacjach przesyłania:

1. Plik deskryptora: opisuje, jakiego typu pliku danych będziesz używać przesyłanie
2. 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ń.