Przewodnik po integracji Protected Audience (wcześniej FLEDGE) dla dostawców usług pomiarowych

W ramach Piaskownicy prywatności Chrome zaproponował Protected Audience API API – interfejs API w przeglądarce, który umożliwia reklamodawcom i firmom z branży technologii reklamowych wyświetlanie reklam kierowanych na grupy zainteresowań bez użycia plików cookie innych firm, przy jednoczesnej ochronie użytkowników przed śledzenie konwersji.

W interfejsie Protected Audience API, gdy reklama remarketingowa wygra aukcję, URL reklamy zostanie wysłany do Ramka: jak renderowanie. Ramka chroniona to proponowany element HTML dla umieszczonej treści, są podobne do elementów iframe. W przeciwieństwie do elementów iframe chroniona ramka ogranicza komunikację z kontekstem wektora dystrybucyjnego, aby umożliwić ramce dostęp do danych z innych witryn bez udostępniając je wraz z kontekstem umieszczania. Aby dowiedzieć się więcej, zapoznaj się z Przypadki użycia ramek chronionych .

Reklamy displayowe i Wideo 360 obsługuje listę: makr do pomiarów. do śledzenia wyświetleń i kliknięć. Tylko niewielka ich część które można zastępować podczas renderowania kreacji ze względu na brak i sygnały z aukcji. Na przykład ${PUBLISHER_ID} przestanie działać bez zmian do tagów dostawców usług pomiaru.

Ten przewodnik jest przeznaczony dla partnerów świadczących usługi pomiaru skuteczności reklam, którzy śledzą zdarzeń dla reklamodawców, którzy korzystanie z reklam displayowych Film 360.

Rejestracja

Od sierpnia 2023 r. dostawcy usług pomiarowych będą musieli wykonać te czynności poniżej, aby zarejestrować się w celu korzystania z interfejsów Fenced Frame Reporting API w ramach Protected Audience API.

Kto i w jaki sposób będzie musiał zarejestruj się

Integracja

Tagi wyświetleń dostawcy usług pomiaru

Instrukcje konfiguracji:

Tagi skryptu Przykład
<script src='https://tracking.com/a.js'>xxx</script>
Odpowiedzialność: dostawcy usług pomiaru będą aktualizować tagi skryptu, które będą używane Interfejs API reportEvent do śledzenia wyświetleń (zobacz wskazówki) poniżej).
Tagi obrazów Przykład
<img src='https://tracking.com/'>
Odpowiedzialność: reklamy displayowe i Film 360 aktualizuje tagi img src do użycia Interfejs API reportEvent do śledzenia wyświetleń.

Interfejs reportEvent API

Zaproponowano użycie interfejsu API śledzenie po renderowaniu. Interfejs API składa się z 2 części: registerAdMacro oraz reportEvent

  • Reklamy displayowe i Film 360 jest właścicielem funkcji registerAdMacro w elemencie reportWin. funkcja zarejestruje pary klucz-wartość makr w przeglądarce przed z renderowaniem.
  • W zależności od typu tagu tag Display & Posiadacz usługi Video 360 lub dostawcy rozwiązań pomiarowych zmiany w tagach 3PAT, tak aby korzystały z interfejsu API reportEvent.

Parametr reportEvent przyjmuje tylko jedną wartość wejściową „destinationURL”, która wskazuje z serwerami dostawców usług pomiaru. Może zawierać dowolne makra wymienione w Wyświetlacz & Google Video 360 – pomoc pomocy. Na przykład:

window.fence.reportEvent({
  'destinationURL': 'https://adtech.example/impression?cid=555&pub_id=${PUBLISHER_ID}&site=${SOURCE_URL_ENC}&t=123'
});

Gdy Chrome uruchomi w funkcji ping adresu URL, wyszuka słowo zarejestrowane i zastąp je wartościami przed wysłaniem żądania HTTP GET do https://adtech.example

Instrukcje aktualizowania tagów skryptu

Istniejące tagi kreacji nie ulegną zmianie. Reklamy displayowe i Kadr z filmu 360 renderuje w kreacji tagi dostawcy usług pomiaru bez modyfikacji ładunek. Gdy dostawcy usług pomiaru otrzymują pingi wyświetleń z Protected Audience API, musi wykonać poniższe czynności, aby wyświetlić śledzenie:

  1. Przygotuj adres URL wyświetleń dla dostawcy usług pomiaru, aby akceptować pingi wyświetleń. Na przykład:

    https://adtech.example/impression?cid=555&pub_id=${PUBLISHER_ID}&site=${SOURCE_URL_ENC}&t=123
    
  2. Dodaj reportEvent JS podczas odpowiadania na skrypt z Protected Audience API. Na przykład:

    window.fence.reportEvent({
      'destinationURL': 'https://adtech.example/impression?cid=555&pub_id=${PUBLISHER_ID}&site=${SOURCE_URL_ENC}&t=123'
    });
    
  3. Rejestruj wyświetlenia po otrzymaniu pingów z adresu URL wyświetlenia skonfigurowanego w kroku 1.

Tagi kliknięcia dostawcy usług pomiaru

Dotychczasowy tag kliknięcia dostawcy usług pomiaru nadal będzie działać w przypadku wyświetleń z użyciem Protected Audience API. Reklamy displayowe i Video 360 będzie korzystać z interfejsu Fenced Frames Ads Reporting API reserved.top_navigation beacon do rejestrowania kliknięć i będzie łączyć wszystkie tagów śledzenia kliknięć dostawcy usług pomiaru jako przekierowań. Więcej informacji: Dokumentacja Chrome dotycząca raportowania reklam z zabezpieczonymi ramkami API.