Włączanie pomiaru konwersji

Przypisanie konwersji może obejmować wiele stron, m.in. wydawcę, reklamodawcę, firmę technologiczną wyświetlającą reklamy (podmiot wyświetlający reklamę) i dostawcę usług pomiarowych. W tym dokumencie przedstawiamy typowe scenariusze pomiaru konwersji, ale ogólnie rzecz biorąc każda strona, która chce otrzymywać raporty o przypisaniu z interfejsu Attribution Reporting API (ARA), musi wykonać czynności integracyjne opisane w tym dokumencie.

Na przykład wydawca może mieć co najmniej 1 technologię reklamową odpowiedzialną za wyświetlanie reklamy. Mogą to być firmy dostarczające znaczniki dla kreacji, firmy dostarczające piksele wyświetleń lub piksele śledzące w kreacji oraz firmy dostarczające pakiet SDK lub tag dla boksu reklamowego na stronie wydawcy. Dostawcy technologii reklamowych mogą, ale nie muszą otrzymywać raportów atrybucji z ARA. Są jednak w stanie zapewnić, aby raporty te otrzymywali dostawcy technologii reklamowych, którzy korzystają z ich usług.

Reklamodawca może też korzystać z usług zewnętrznego dostawcy pomiaru konwersji w celu atrybucji w różnych sieciach oraz innych funkcji raportowania. Reklamodawcy wykorzystują te dane do określania zwrotu z inwestycji w reklamę w różnych przypadkach użycia w przypadku wielu wydawców i kanałów. Dlatego ważne jest, aby platformy DSP lub serwery reklam wiedziały, jak włączyć interfejs Attribution Reporting API, aby obsługiwać te przypadki użycia. Reklamodawcy, którzy chcą korzystać z usług zewnętrznych, mogą nadal to robić, korzystając z usług zewnętrznego dostawcy pomiarów lub konfigurując własny serwer do rejestrowania i odbierania raportów z interfejsu API.

Interfejs Attribution Reporting API umożliwia wielu technologiom reklamowym rejestrowanie źródeł atrybucji i wyzwalaczy w przypadku tego samego wyświetlenia lub konwersji oraz otrzymywanie oddzielnych raportów z interfejsu API. Na przykład platforma DSP może otrzymywać własne raporty o atrybucji z interfejsu Attribution Reporting API, a także umożliwiać tworzenie oddzielnych raportów przez zewnętrznego dostawcę usług pomiarowych reklamodawcy. Aby otrzymywać raporty z interfejsu API, dostawca technologii reklamowej musi zarejestrować zarówno źródła atrybucji, jak i jej wyzwalacze. Atrybucja jest przeprowadzana w ramach źródeł atrybucji i wyzwalaczy zarejestrowanych przez dostawcę technologii reklamowej w interfejsie API.

Typowe scenariusze pomiaru konwersji

W tej sekcji omówimy 2 typowe scenariusze pomiaru konwersji.

Scenariusz 1. Zarówno technologia reklamowa do wyświetlania reklam, jak i zewnętrzny dostawca usług pomiarowych muszą otrzymywać raporty z interfejsu Attribution Reporting API

Reklamodawca chce przypisywać konwersje do zasobów reklamowych za pomocą zewnętrznego dostawcy usług pomiarowych, a firma technologiczna obsługująca kreację chce przypisywać konwersje do zasobów reklamowych. Jest to typowe dla systemów DSP lub serwerów reklamowych reklamodawców (zewnętrznych serwerów reklamowych – 3PAS), które udostępniają znaczniki dla kreacji reklamowych, wykonują własne raporty atrybucji i współpracują z reklamodawcami, którzy integrują się z zewnętrznymi dostawcami usług analitycznych lub pomiarowych.

W takim przypadku technologia służąca do wyświetlania reklam jest też odpowiedzialna za wywoływanie zdarzeń kliknięcia i wyświetlenia w ramach bieżącej konfiguracji. Technologia reklamy do wyświetlania powinna ustawić nową wartość attributionsrc w odpowiednich miejscach i upewnić się, że przekierowania są prawidłowo skonfigurowane. Zarówno dostawca technologii reklamowej, jak i zewnętrzny dostawca usług pomiarowych powinien też zarejestrować się w tym systemie i zadbać o to, aby jego serwery były gotowe do odbierania żądań interfejsu Attribution Reporting API i na nie odpowiadania.

Typowa konfiguracja kampanii może wyglądać tak:

  1. Serwer reklamowy reklamodawcy (3PAS) dostarcza platformie DSP znaczniki kreacji reklamy, w tym piksele śledzące wyświetlenia i kliknięcia od zewnętrznego dostawcy pomiarów. Serwer reklam powinien zadbać o to, aby element attributionsrc był uwzględniony w tagach reklamy.

  2. Platforma DSP umożliwia dodawanie dodatkowych pikseli pomiarowych wyświetleń i pikseli śledzenia kliknięć. Należy się upewnić, że attributionsrc jest uwzględniona w ostatecznym znaczniku kreacji reklamy, za którą ustalana jest stawka.

Scenariusz 2. Tylko zewnętrzny dostawca usług pomiarowych musi otrzymywać raporty z interfejsu Attribution Reporting API

Reklamodawca chce przypisywać konwersje do zasobów reklamowych za pomocą zewnętrznego dostawcy usług pomiarowych, ale technologia reklamowa hostująca kreację nie ma wymagań dotyczących pomiaru atrybucji. Jest to typowe dla wydawców, SSP-ów i serwerów reklamowych wydawców, którzy hostują kreacje i nie planują korzystania z raportowania atrybucji, ale chcą włączyć interfejs Attribution Reporting API dla swoich partnerów DSP lub firm zajmujących się tagowaniem danych, takich jak zewnętrzne serwery reklamowe, dostawcy usług pomiarowych lub analitycznych.

W takim przypadku strona odpowiedzialna za wywoływanie zdarzeń kliknięcia i wyświetlenia w bieżącej konfiguracji musi dodać do kreacji nowy atrybut attributionsrc i zadbać o prawidłowe działanie przekierowań. Jest to bardzo zależne od integracji każdego wydawcy, ale w przypadku zdarzeń kliknięcia może to być SSP, usługa adtech do obsługi reklam lub sam wydawca. W przypadku zdarzeń wyświetlenia jest to zwykle zewnętrzny dostawca usług pomiarowych.

W przypadku typowej konfiguracji kampanii ze scenariusza 1 serwer reklam wydawcy, SSP lub sam wydawca może po prostu zadbać o to, aby atrybut attributionsrc podany przez DSP znalazł się na stronie wydawcy.

Szczegóły implementacji

W tabeli poniżej opisano ogólnie kroki implementacji interfejsu Attribution Reporting API:

Kroki Odpowiedzialność za pracę Przykłady
Krok 1. Włącz źródło atrybucji dla dotychczasowych kreacji i kodu pomiarowego Podmiot odpowiedzialny za wywoływanie zdarzeń wyświetlenia lub obsługę zdarzeń kliknięcia dodaje atrybut attributionsrc. W przypadku zdarzeń kliknięcia atrybut dodaje zwykle kupujący (DSP lub serwer reklamowy reklamodawcy), który renderuje kreację.

W przypadku zdarzeń wyświetlenia atrybut dodaje platforma DSP, platforma SSP, wydawca, serwer reklam lub dostawca usług pomiarowych. Zależy to od konfiguracji wydawcy.

W przypadku reklam wideo korzystających z formatu VAST atrybut dodają wydawca i pakiet SDK wideo.
Krok 2. Włącz raportowanie atrybucji w przypadku źródeł zewnętrznych Ta funkcja działa „od razu po wyjęciu z pudła”, jeśli używasz istniejącej ścieżki przekierowania z przekierowaniami 302.

Jeśli nie można użyć przekierowań 302, atrybut attributionsrc może służyć do podawania listy wielu serwerów reklamowych.

 Ogólnie, jeśli atrybut attributionsrc został dodany do kreacji, przekierowania zewnętrzne powinny otrzymywać wywołania interfejsu Attribution Reporting API.
Krok 3. Skonfiguruj odpowiedzi na żądania interfejsu Attribution Reporting API Każdy podmiot, który chce otrzymywać raporty z interfejsu Attribution Reporting API DSP i zewnętrzny dostawca usług pomiarowych używany przez reklamodawcę

Pamiętaj, że szczegóły poszczególnych kroków zależą od tego, jak kreacje są renderowane i wyświetlane na stronie wydawcy oraz które podmioty związane z technologią reklamową otrzymują raporty wysyłane przez Attribution Reporting API.

Krok 1. Włącz źródło atrybucji dla dotychczasowych kreacji i kodu pomiarowego

W pierwszym kroku włączamy źródła atrybucji.

Jak działa atrybut attributionsrc

Nowy atrybut attributionsrc określa, dokąd mają być wysyłane żądania interfejsu Attribution Reporting API. Element, który odpowiada za wywoływanie zdarzeń wyświetlenia i kliknięcia, musi zaktualizować kreacje za pomocą atrybutu attributionsrc. Wartość attributionsrc powinna zostać dodana do dotychczasowych zdarzeń kliknięcia i wyświetlenia. Może być pusta lub niepusta.

W przypadku zdarzeń kliknięcia, które używają przekierowań, do nawigacji należy dodać atrybut attributionsrc. W przypadku przekierowań 302 po przejściu na inną stronę nie trzeba dodawać atrybutu attributionsrc. Będą one kwalifikować się do ARA, o ile początkowe przekierowanie będzie zawierać atrybut attributionsrc.

Gdy attributionsrc jest pusty, żądania ARA są wysyłane pod adres URL zdefiniowany w atrybucie href tagu kotwicy (adres URL przejścia). Gdy atrybut attributionsrc jest zdefiniowany, żądania ARA są wysyłane pod adres URL zdefiniowany w atrybucie attributionsrc. Adres URL przejścia do witryny może też służyć do rejestrowania źródeł.

Jeśli serwer hostujący adres URL przejścia do witryny docelowej może odbierać żądania interfejsu Attribution Reporting API i na nie odpowiadać, użyj pustego atrybutu attributionsrc. Jeśli chcesz, aby żądania interfejsu Attribution Reporting API były wysyłane do innego serwera, zdefiniuj własny adres URL attributionsrc.

Przykład pustego atrybutu attributionsrc:

Dotychczasowa konfiguracja Z integracją ARA
<a href="[CLICKTHROUGH_URL]">...</a> <a href="[CLICKTHROUGH_URL]" attributionsrc>...</a>

Gdy atrybut attributionsrc jest pusty, żądania interfejsu Attribution Reporting API są wysyłane pod adres URL zdefiniowany przez atrybut href tagu kotwicy.

Przykład niepustego atrybutu attributionsrc:

Dotychczasowa konfiguracja Z integracją ARA
<a href="[CLICKTHROUGH_URL]">...</a> <a href="[CLICKTHROUGH_URL]" attributionsrc="[ATTRIBUTION_SRC_URL]">...</a>

Jeśli parametr attributionsrc nie jest pusty, żądania interfejsu Attribution Reporting API będą wysyłane pod adres URL zdefiniowany przez tag attributionsrc. Adres URL przejścia do witryny może też służyć do rejestrowania źródeł.

Dodaj attributionsrc do zdarzeń kliknięcia i wyświetlenia

  • Zdarzenia kliknięcia:
    • Podmiotem odpowiedzialnym za dodanie attributionsrc jest zwykle technologia reklamowa służąca do wyświetlania reklam.
    • Tagi kotwicy z zdarzeniami kliknięcia powinny mieć dodany atrybut attributionsrc.
    • Aby określić źródło atrybucji, kliknięcia korzystające z funkcji window.open powinny używać argumentu windowFeatures wywołania window.open.
  • Zdarzenia dotyczące wyświetleń:
    • Podmiotem odpowiedzialnym za dodanie attributionsrc jest zwykle technologia reklamowa służąca do wyświetlania reklam i dostawcy usług pomiarowych.
    • Zdarzenia wyświetlenia wywoływane przez tag <img> lub tag <script> powinny zawierać atrybut attributionsrc.
    • Zdarzenia dotyczące wyświetlenia, które korzystają z interfejsu Fetch API, powinny zawierać obiekt attributionReporting w argumencie options przekazywanym do wywołania interfejsu Fetch API.

W tabeli poniżej znajdziesz podsumowanie zmian wymaganych w przypadku zdarzeń kliknięcia i wyświetlenia:

Zdarzenie Tag Dotychczasowa konfiguracja Po integracji z ARA
Kliknięcie HTML <a href="[CLICKTHROUGH_URL]">...</a> <a href="[CLICKTHROUGH_URL]" attributionsrc>...</a>
JavaScript window.open("[CLICKTHROUGH_URL]", "_blank"); window.open("[CLICKTHROUGH_URL]", "_blank", "attributionsrc");
Wyświetlenie Tag HTML <img> <img src="[IMPRESSION_URL]"> <img src="[IMPRESSION_URL]" attributionsrc>
Tag HTML <script> <script src="[IMPRESSION_URL]"></script> <script src="[IMPRESSION_URL]" attributionsrc></script>
JavaScript const options = {...}
window.fetch("[IMPRESSION_URL]", options); 		const options = {
  attributionReporting: {
    eventSourceEligible: true,
    triggerEligible: false,
  },
  ...
};
window.fetch("[IMPRESSION_URL]", options);

Włączanie rejestracji źródła atrybucji w aukcji z Protected Audience API

Aby mierzyć konwersje w aukcjach w ramach funkcji Protected Audience, zamiast attributionsrc możesz używać parametrów registerAdBeacon/registerAdMacro i setReportEventDataForAutomaticBeacons/reportEvent, aby rejestrować źródła atrybucji.

W przypadku raportowania sygnałów Protected Audience funkcja registerAdBeacon jest dostępna w ramach modułów raportowania, a funkcja registerAdMacro – w ramach modułu raportowania wygranych przez kupującego. Następnie dane zdarzenia w ramce reklamy można dodać do zarejestrowanych beaconów i makr za pomocą funkcji reportEvent i setReportEventDataForAutomaticBeacons interfejsu Fenced Frame Ads Reporting API. Dzięki temu sygnały z workletów raportowania Protected Audience i ładunku zdarzeń ramki kreacji reklamy mogą być ze sobą powiązane.

Nagłówek HTTP Attribution-Reporting-Eligible jest dodawany do żądania, gdy beacony i makra są wywoływane przez wywołanie reportEvent z ramki lub gdy automatyczne beacony są wywoływane przez przeglądarkę. Odpowiedź beacona możesz wykorzystać do zarejestrowania źródła atrybucji. Prośby o beacony mogą być przekierowywane, aby umożliwić pomiary zewnętrzne.

Więcej informacji znajdziesz w sekcji Obsługa raportowania atrybucji w artykule wyjaśniającym interfejs Fenced Frame Ad Reporting API.

Włączanie raportowania atrybucji w przypadku formatów VAST

VAST to standardowy format do wyświetlania i pomiaru zasobów reklamowych z reklamami wideo. Wiele zdarzeń zdefiniowanych w tym standardzie można uznać za potencjalne zdarzenia źródłowe kwalifikujące się do rejestracji w interfejsie Attribution Reporting API. Szczegółowe informacje na ten temat znajdziesz w Aneksie VAST dotyczącym obsługi raportowania atrybucji, ale w skrócie: wszystkie zdarzenia <Tracking>, <Impression>, <*ClickThrough> i <*ClickTracking> to potencjalne źródła atrybucji. Wszystkie implementacje VAST powinny zapewniać możliwość rejestracji w przypadku tych zdarzeń.

Dodatek VAST definiuje nowe atrybuty tych elementów, aby umożliwić ustawienie dodatkowego adresu URL specjalnie do rejestrowania atrybucji. Jeśli zdarzenie zawiera parametry attributiontype="DOUBLE_PING" i attributionsrc="[URL]", kod wywołujący to zdarzenie powinien używać wartości [URL] jako wartości atrybutu attributionsrc podczas włączania interfejsu Attribution Reporting API. W załączniku do specyfikacji VAST znajdziesz przykłady dla każdego scenariusza.

Aby zapewnić maksymalne pokrycie, implementacje VAST powinny domyślnie ustawiać wszystkie wymienione zdarzenia jako kwalifikujące się do rejestracji podczas wywoływania pingów zdarzeń. Na przykład podczas wywoływania adresu URL zdarzenia <Impression> należy użyć (pustego) atrybutu attributionsrc w elemencie <img> używanym do wysyłania żądania (lub jego odpowiednika w wywołaniu fetch), aby zawsze umożliwić stronie odbierającej potencjalne zarejestrowanie tego zdarzenia za pomocą interfejsu Attribution Reporting API.

Krok 2. Włącz raportowanie atrybucji w przypadku źródeł zewnętrznych

Aby umożliwić osobom trzecim korzystanie z interfejsu Attribution Reporting API, możesz użyć istniejących przekierowań lub dodać listę firm zewnętrznych do atrybutu attributionsrc. W większości przypadków każda firma technologiczna ma własny niezależny licznik wyświetleń, więc przekierowania są bardziej przydatne dla liczników kliknięć.

Obsługa źródeł zewnętrznych w dotychczasowym łańcuchu przekierowań

W przypadku typowego kliknięcia reklamy może występować wiele tagów śledzenia kliknięć w postaci łańcucha 302 przekierowań wykonanych w ramach nawigacji do ostatecznej strony docelowej. Każde żądanie w łańcuchu przekierowań może zostać zarejestrowane w interfejsie Attribution Reporting API, jeśli pierwotny cel kliknięcia został oznaczony za pomocą atrybutu attributionsrc lub zarejestrowany za pomocą atrybutu registerAdBeacon/registerAdMacro w interfejsie Protected Audience API. Technologia reklamowa w łańcuchu przekierowań musi też być zarejestrowana.

Pamiętaj, że treść początkowego żądania nie jest wysyłana w przypadku przekierowań. W przypadku aukcji Protected Audience, jeśli eventData przekazane do reportEvent i setReportEventDataForAutomaticBeacons musi być używane w ramach przekierowania, musi być wyraźnie przekazane jako część adresu URL przekierowania.

W tym przykładzie użyjemy technologii reklamowej do wyświetlania reklam (serving-adtech.example) i zewnętrznego dostawcy usług pomiarowych (3p-measurement.example) jako 2 różnych podmiotów, które chcą generować i odbierać raporty atrybucji. W tym przykładzie technologia służąca do wyświetlania reklam może być platformą DSP, która renderuje kreację w witrynie wydawcy i ma własny produkt do raportowania. Dostawcą zewnętrznym może być podmiot, którego reklamodawca używa do raportowania konwersji.

Schemat pokazujący, jak dane źródłowe są rejestrowane przez źródło własne, a potem przez źródło zewnętrzne

W momencie rejestracji źródła wykonywane są następujące czynności:

  1. serving-adtech.example ustawia atrybut attributionsrc w kreacji. Użytkownik odwiedza stronę wydawcy, a przeglądarka wysyła żądanie do serving-adtech.example..
  2. serving-adtech.example odpowiada nagłówkiem Attribution-Reporting-Register-Source i Location.
    1. serving-adtech.example używa nagłówka Attribution-Reporting-Register-Source, aby odpowiedzieć metadanymi dotyczącymi źródła, które ma zostać zarejestrowane.
    2. serving-adtech.example używa nagłówka Location, aby uwzględnić przekierowanie do 3p-measurement.example. Pamiętaj, że nagłówek Location jest prawdopodobnie już używany w dotychczasowych przepływach śledzenia kliknięć do obsługi przekierowań 302 do zewnętrznego dostawcy.
  3. Przeglądarka odbiera odpowiedź od serving-adtech.example i analizuje nagłówek Attribution-Reporting-Register-Source. Przeglądarka przechowuje zdarzenie źródłowe, używając serving-adtech.example jako źródła raportowania.
  4. Ponieważ to żądanie jest przekierowaniem, przeglądarka wysyła też nowe żądanie do 3p-measurement.example.
  5. 3p-measurement.example odpowiada, wysyłając odpowiedź zawierającą nagłówek Attribution-Reporting-Register-Source.
  6. Przeglądarka otrzymuje tę odpowiedź od 3p-measurement.example i odczytuje Attribution-Reporting-Register-Source. Przeglądarka przechowuje zdarzenie źródłowe, używając 3p-measurement.example jako źródła raportowania.

Używaj zasady attributionsrc w przypadku źródeł zewnętrznych, które nie znajdują się w łańcuchu przekierowań

Jeśli wiele źródeł raportowania chce zarejestrować źródło zdarzenia nawigacyjnego, ale z jakiegoś powodu nie może się pojawić w łańcuchu przekierowań, możesz w sekcji attributionsrc podać jako źródła atrybucji kilka witryn.

Dotychczasowa konfiguracja Z modyfikacją ARA
<a href="[CLICKTHROUGH_URL]">...</a> <a href="[CLICKTHROUGH_URL]" attributionsrc="[REPORTING_URL_1] [REPORTING_URL_2]">...</a>

W tym przykładzie żądania kwalifikujące się do użycia interfejsu Attribution Reporting API zostaną wysłane zarówno do REPORTING_URL_1, jak i do REPORTING_URL_2. Żądanie nawigacyjne wysłane do docelowego adresu URL może też służyć do rejestrowania źródeł atrybucji.

Krok 3. Skonfiguruj odpowiedzi na żądania interfejsu Attribution Reporting API

W przypadku wszystkich źródeł, które otrzymują żądanie interfejsu Attribution Reporting API, sprawdź, czy serwer odpowiada odpowiednim nagłówkiem Attribution-Reporting-Register-Source. Aby dowiedzieć się, jak sformułować odpowiedź, zapoznaj się z przewodnikiem dotyczącym rejestrowania źródeł i artykułem wyjaśniającym.

Rejestrowanie wielu reguł

Możesz zarejestrować większą liczbę reguł atrybucji, dodając po stronie konwersji wiele elementów piksela (po jednym na regułę). Element attributionsrc jest opcjonalny w przypadku rejestracji wyzwalacza.

Możesz też zarejestrować wiele reguł z pojedynczego elementu piksela, używając żądań przekierowania lub podając w elemencie attributionsrc wiele adresów URL w taki sam sposób jak w przypadku rejestracji źródła. Zdarzenia źródłowe i zdarzenia wywołujące, które zostały wygenerowane przez te same źródła, zostaną dopasowane.