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ć.
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:
- reservewithgoogle.conversion_data
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ń.