Pliki uporządkowanych danych (SDF) to specjalnie sformatowane pliki CSV. Umożliwiają one zbiorcze pobieranie, tworzenie i edytowanie zasobów w Display & Video 360. Wprowadzaj zbiorcze zmiany w zasobach, pobierając, edytując i ponownie przesyłając pliki SDF.
Interfejs Display & Video 360 obsługuje pobieranie i przesyłanie plików SDF. Interfejs Display & Video 360 API obsługuje pobieranie plików SDF.
Formaty
Plik SDF ma jeden z 2 formatów podstawowych: Standard i QA.
- Możesz pobierać i przesyłać pliki w formacie Standard. Dane w tych plikach mogą używać identyfikatorów numerycznych, aby zapewnić dokładność podczas przesyłania. Do interpretacji danych mogą być potrzebne informacje referencyjne.
- Możesz pobierać pliki w formacie QA. Pliki te zawierają te same dane co pliki w formacie standardowym, ale używają bardziej czytelnych wartości. Na przykład niektóre kolumny mogą używać wyświetlanych nazw zamiast identyfikatorów. Kolumny specyficzne dla tego formatu mają sufiks „Qa”.
Typy plików
SDF obsługuje 7 typów zasobów. Każdy typ zasobu ma własny typ pliku z własną strukturą kolumn. Obsługiwane typy zasobów to:
- Kampania
- Zamówienie reklamowe
- Element zamówienia
- Grupa reklam
- Reklama
- Źródło zasobów reklamowych
- Produkt medialny
Format QA jest obsługiwany tylko w przypadku typów plików Element zamówienia i Grupa reklam.
Nowe wersje pliku SDF są regularnie publikowane, a starsze wersje są wycofywane. Nowe wersje aktualizują strukturę kolumny typu pliku. W razie potrzeby nowa wersja SDF będzie zawierać przewodnik po migracji.
Pobierz błędy
Pobieranie plików SDF może powodować 2 rodzaje błędów: błędy generowania plików i pominięte zasoby.
Błędy generowania plików
Generowanie plików SDF może zakończyć się błędem. Jeśli generowanie się nie powiedzie podczas korzystania z interfejsu Display & Video 360 API, ukończone zadanie ustawi pole error z obiektem Status. Obiekt Status będzie zawierać komunikat z wyjaśnieniem przyczyny błędu.
Więcej informacji o tych błędach znajdziesz w naszym przewodniku po błędach i ostrzeżeniach.
Pominięte błędy
Pliki SDF nie obsługują wszystkich podtypów zasobów. Jeśli zasobu nie można uwzględnić w pliku SDF, w pobranych plikach znajdzie się plik „Skipped” (np. SDF-LineItems-Skipped.csv). Ten plik ma strukturę dwukolumnową. Pierwsza kolumna identyfikuje pominięty zasób. W drugiej kolumnie znajdziesz wyjaśnienie wykluczenia.
Prześlij plik
Przesyłaj pliki SDF za pomocą interfejsu Display & Video 360, aby tworzyć nowe lub aktualizować istniejące zasoby.
Aby zminimalizować liczbę błędów podczas aktualizowania lub tworzenia zasobów za pomocą plików SDF, wykonaj te czynności:
- Pobieraj pliki SDF za pomocą interfejsu Display & Video 360 API lub interfejsu użytkownika.
- Modyfikuj istniejące wpisy w plikach, aby wprowadzać aktualizacje w istniejących zasobach.
- Dodaj wpisy plików, aby utworzyć nowe zasoby.
- Usuń wszystkie wpisy, które nie są nowe ani zaktualizowane. Zmniejsza to rozmiar pliku i eliminuje ryzyko niezamierzonych aktualizacji.
- Prześlij plik w interfejsie Display & Video 360.
Po przesłaniu i przetworzeniu pliku SDF można pobrać SDF-ResultFile.zip. Ten plik ZIP może zawierać 2 rodzaje plików:
SDF-{ResourceType}-Updated-ResultFile.csv, która zawiera listę zasobów, które zostały zaktualizowane lub utworzone.SDF-{ResourceType}-Failed-ResultFile.csv, który zawiera listę nieudanych operacji i odpowiednie komunikaty o błędach.
Plik ZIP może zawierać jeden lub oba te pliki.