Zmiany w interfejsie Display & Video 360 API i plikach uporządkowanych danych, które mają na celu spełnienie wymogów rozporządzenia Unii Europejskiej w sprawie reklam politycznych

Czwartek, 21 sierpnia 2025 r.

Co się zmienia?

Jak ogłosiliśmy w zeszłym roku, Google przestanie wyświetlać reklamy polityczne w Unii Europejskiej (UE) przed wejściem w życie nowego rozporządzenia w październiku 2025 r. Od 8 września 2025 r. zaczniemy egzekwować te zmiany w interfejsie Display & Video 360 API i plikach uporządkowanych danych (SDF). Jeśli używasz którejś z tych usług do tworzenia elementów zamówienia lub zarządzania nimi, być może musisz zaktualizować aplikację, aby obsługiwała te zmiany, przed 8 września 2025 r., aby uniknąć przerw w działaniu usługi.

Tło

Od 8 września 2025 r. Display & Video 360 będzie wymagać samodzielnego składania deklaracji dotyczących reklam politycznych w UE. Podczas tworzenia elementu zamówienia musisz zadeklarować, czy będzie on wyświetlać reklamy polityczne w UE.

Możesz też złożyć tę deklarację w imieniu całego reklamodawcy. W tym oświadczeniu należy określić, czy elementy zamówienia reklamodawcy będą wyświetlać reklamy polityczne w UE. Złóż deklarację na poziomie reklamodawcy za pomocą interfejsu Display & Video 360 API lub w ustawieniach Informacje podstawowe reklamodawcy w interfejsie Display & Video 360, gdy zostanie on uruchomiony po 8 września. Jeśli zadeklarujesz, że reklamodawca nie będzie wyświetlać reklam politycznych w UE, nowe elementy zamówienia tego reklamodawcy będą używać tej deklaracji, jeśli nie zostanie podana inna, co pozwoli uniknąć przerw w działaniu usługi.

Interfejs Display & Video 360 API i pliki uporządkowanych danych obsługują teraz deklarowanie, czy element zamówienia wyświetla reklamy polityczne w UE. Podobna funkcja samodzielnego składania deklaracji zostanie udostępniona w interfejsie Display & Video 360 8 września 2025 r.

Display & Video 360 API

W interfejsie Display & Video 360 API do tych obiektów interfejsu API w wersjach 3 i 4 dodaliśmy pole containsEuPoliticalAds, aby umożliwić samodzielne deklarowanie na różnych poziomach zasobów:

  • LineItem, aby pobierać i ustawiać deklarację na poziomie elementu zamówienia.
  • Advertiser, aby pobrać i ustawić deklarację na poziomie reklamodawcy.

Możliwe wartości, które można ustawić dla tego pola, są podane w tabeli poniżej wraz ze znaczeniem odpowiadającym zasobowi, do którego są przypisane.

Wartość
Znaczenie
CONTAINS_EU_POLITICAL_ADVERTISING Zasób będzie używany do wyświetlania reklam politycznych w UE.
DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING Zasób nie będzie używany do wyświetlania reklam politycznych w UE.

Od 8 września 2025 r. interfejs Display & Video 360 API będzie wymagać ustawienia pola containsEuPoliticalAds w przypadku nowych zasobów elementów zamówienia lub istniejących zasobów elementów zamówienia podczas aktualizowania kierowania geograficznego istniejących elementów zamówienia.

Co muszę zrobić?

Każdy nowo utworzony element zamówienia będzie wymagał prawidłowej deklaracji w polu containsEuPoliticalAds.

Ustaw pole containsEuPoliticalAds w obiekcie Advertiser za pomocą metody advertisers.patch lub ustaw deklarację w ustawieniach Informacje podstawowe reklamodawcy w interfejsie Display & Video 360, gdy będzie ona dostępna. Jeśli w przypadku reklamodawcy nadrzędnego ustawisz pole containsEuPoliticalAds na DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING, nowe elementy zamówienia będą używać tej wartości, chyba że podczas tworzenia zostanie ustawiona inna wartość. Pole zostanie wypełnione w przypadku istniejących elementów zamówienia w ciągu dnia. To pole można następnie zaktualizować za pomocą interfejsu, interfejsu API lub plików uporządkowanych danych.

Jeśli reklamodawca nie wyświetla reklam politycznych w UE, wystarczy zadeklarować to na poziomie reklamodawcy, aby uniknąć błędów. Jeśli nie możesz złożyć deklaracji na poziomie reklamodawcy lub deklarujesz, że reklamy polityczne w UE mogą być wyświetlane w przypadku Twojego reklamodawcy, musisz zaktualizować sposób korzystania z tych metod interfejsu API:

Pliki uporządkowanych danych

W plikach uporządkowanych danych wprowadziliśmy v9, która dodaje kolumnę Contains EU Political Ads do pliku elementu zamówienia. Umożliwia to pobieranie i ustawianie deklaracji dotyczącej reklam politycznych w UE na poziomie elementu zamówienia. Ta kolumna używa wartości YES i NO do reprezentowania deklaracji elementu zamówienia.

Wraz z tym wprowadzeniem wycofujemy też pliki SDF w wersjach 7.1, 8 i 8.1. Zalecamy jak najszybsze przejście na wersję 9. Będziemy obsługiwać te wersje do momentu ich wycofania w marcu 2026 r.

Od 8 września 2025 r. Display & Video 360 będzie wymagać używania wersji 9 do przesyłania plików uporządkowanych danych i ustawiania kolumny Contains EU Political Ads na wartość YES lub NO w przypadku nowych wpisów elementów zamówienia w plikach SDF. Jeśli reklamodawca zadeklarował, że nie będzie wyświetlać reklam politycznych w UE, możesz nadal używać poprzednich wersji do przesyłania plików SDF.

Co muszę zrobić?

Każdy nowo utworzony element zamówienia będzie wymagał prawidłowej deklaracji w kolumnie Contains EU Political Ads.

Ustaw pole containsEuPoliticalAds na poziomie reklamodawcy za pomocą metody advertisers.patch interfejsu Display & Video 360 API lub ustaw deklarację w ustawieniach Informacje podstawowe na poziomie reklamodawcy w interfejsie Display & Video 360, gdy będzie ona dostępna. Jeśli zadeklarujesz, że reklamodawca nie będzie wyświetlać reklam politycznych w UE, nowe elementy zamówienia będą używać wartości NO w kolumnie Contains EU Political Ads, chyba że podczas tworzenia zostanie ustawiona inna wartość. Pole zostanie wypełnione w ciągu dnia w przypadku dotychczasowych elementów zamówienia. Dzięki temu możesz używać wersji 7, 7.1, 8 lub 8.1 do przesyłania plików SDF. Po utworzeniu elementu zamówienia to pole można zaktualizować za pomocą interfejsu, interfejsu API lub plików uporządkowanych danych.

Jeśli nie możesz złożyć deklaracji na poziomie reklamodawcy lub masz zadeklarowane, że reklamy polityczne w UE mogą być wyświetlane w ramach Twojego konta reklamodawcy, przed 8 września 2025 r. wykonaj te czynności:

  • Przejdź na pliki SDF w wersji 9. Instrukcje znajdziesz w przewodniku po migracji.
  • Podczas przesyłania pliku SDF ustaw kolumnę Contains EU Political Ads na YES lub NO we wpisach elementów zamówienia, gdy:
    • Tworzenie nowych elementów zamówienia.
    • aktualizowanie dowolnej z tych kolumn istniejącego elementu zamówienia:
      • Geography Targeting - Include
      • Geography Targeting - Exclude
      • Geography Regional Location List Targeting - Include
      • Geography Regional Location List Targeting - Exclude
      • Proximity Targeting
      • Proximity Location List Targeting
    • Tworzę nowe grupy reklam z ustawionymi kolumnami (Geography Targeting) w ramach istniejącego elementu zamówienia.
    • Aktualizowanie kolumn Geography Targeting grup reklam w ramach dotychczasowego elementu zamówienia.

Jeśli używasz plików uporządkowanych danych, pamiętaj, aby przejść na wersję 9, zanim w marcu 2026 r. wszystkie poprzednie wersje zostaną wycofane.

Jak uzyskać pomoc?

Jeśli masz więcej pytań dotyczących tej zmiany, skontaktuj się z zespołem pomocy Display & Video 360 API.

portret autora, – Trevor Mulchay, zespół ds. interfejsu Display & Video 360 API

Etykiety: deprecation, display-video-360-api, structured-data-files