Włączanie pomiaru konwersji

Pomiar atrybucji konwersji może obejmować wiele podmiotów, w tym wydawcę, reklamodawcę, technologię wyświetlania reklam (podmiot, który wyświetla reklamę), dostawcę pomiarów i inne. W tym dokumencie przedstawiamy typowe scenariusze pomiaru konwersji, ale ogólnie każda strona, która chce otrzymywać raport atrybucji z interfejsu Attribution Reporting API (ARA), musi mieć pewność, że wykonuje kroki integracji opisane w tym dokumencie.

Wydawca może na przykład korzystać z usług co najmniej 1 firmy technologicznej, która odpowiada za wyświetlanie reklamy. Mogą to być podmioty odpowiedzialne za dostarczanie kodu znaczników kreacji, podmioty dostarczające piksel wyświetlenia lub śledzenia w kreacji oraz podmioty dostarczające pakiet SDK lub tag do boksu reklamowego na stronie wydawcy. Ci dostawcy technologii reklamowych mogą chcieć otrzymywać raporty o atrybucji z interfejsu ARA lub nie, ale są w stanie zapewnić, że dostawcy technologii reklamowych niższego szczebla będą mogli otrzymywać takie raporty.

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

Interfejs Attribution Reporting API umożliwia wielu dostawcom technologii reklamowych rejestrowanie źródeł i wyzwalaczy atrybucji dla tego samego wyświetlenia lub konwersji oraz otrzymywanie z niego osobnych raportów. Na przykład platforma DSP może otrzymywać własne raporty o atrybucji z interfejsu Attribution Reporting API, a także umożliwiać oddzielne raportowanie dla zewnętrznego dostawcy pomiarów reklamodawcy. Aby otrzymywać raporty z interfejsu API, dostawca technologii reklamowych musi zarejestrować zarówno źródła atrybucji, jak i wyzwalacze. Atrybucja jest przeprowadzana wśród źródeł atrybucji i wyzwalaczy, które dostawca technologii reklamowych zarejestrował indywidualnie w interfejsie API.

Typowe scenariusze pomiaru konwersji

W tej sekcji omówimy 2 typowych scenariuszy pomiaru konwersji.

Scenariusz 1. Zarówno technologia wyświetlania reklam, jak i dostawca pomiarów zewnętrznych muszą otrzymywać raporty z interfejsu Attribution Reporting API

Reklamodawca chce przypisywać konwersje w zasobach reklamowych za pomocą zewnętrznego dostawcy pomiarów, a technologia reklamowa hostująca kreację chce przypisywać konwersje w zasobach reklamowych. Jest to powszechne w przypadku platform DSP lub serwerów reklamowych reklamodawców (serwer reklamowy firmy zewnętrznej – 3PAS), które udostępniają kod znaczników kreacji reklamowych, generują własne raporty o atrybucji i współpracują z reklamodawcami, którzy korzystają z usług zewnętrznych dostawców pomiarów lub analityki.

W tym przypadku technologia wyświetlania reklam jest też podmiotem odpowiedzialnym za wywoływanie zdarzeń kliknięcia i wyświetlenia w bieżącej konfiguracji. Technologia wyświetlania reklam powinna umieścić nowy parametr attributionsrc w odpowiednich miejscach i sprawdzić, czy przekierowania są prawidłowo skonfigurowane. Dostawca technologii reklamowych wyświetlających reklamy i zewnętrzny dostawca pomiarów powinni też sprawdzić, czy są zarejestrowani, a ich serwery są gotowe do odbierania żądań interfejsu Attribution Reporting API i odpowiadania na nie.

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

  1. Serwer reklamowy reklamodawcy (3PAS) dostarcza do platformy DSP kod kreacji reklamy, który zawiera piksele śledzące wyświetlenia i kliknięcia dostawcy pomiarów zewnętrznych. Serwer reklam powinien zadbać o to, aby w kodzie kreacji reklamowej znajdował się parametr attributionsrc.

  2. Platforma DSP umożliwia dodawanie dodatkowych pikseli śledzących wyświetlenia i kliknięcia, a także powinna zadbać o to, aby w końcowym znaczniku kreacji reklamy, za którą licytuje, znajdował się kod attributionsrc.

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

Reklamodawca chce przypisywać konwersje w zasobach reklamowych za pomocą zewnętrznego dostawcy pomiarów, ale technologia reklamowa hostująca kreację nie ma wymagań dotyczących pomiarów atrybucji. Jest to powszechne w przypadku wydawców, platform SSP lub serwerów reklam wydawców, którzy hostują kreacje i nie planują samodzielnie korzystać z raportowania atrybucji, ale chcą włączyć interfejs Attribution Reporting API dla swoich partnerów DSP lub firm zajmujących się tagowaniem pomiarowym, takich jak serwery reklam innych firm czy dostawcy usług pomiarowych lub analitycznych.

W takim przypadku podmiot odpowiedzialny za wywoływanie zdarzeń kliknięć i wyświetleń w bieżącej konfiguracji musi dodać nowy atrybut attributionsrc do kreacji i sprawdzić, czy przekierowania działają zgodnie z oczekiwaniami. Zależy to w dużej mierze od integracji każdego wydawcy, ale w przypadku zdarzeń kliknięcia może to być platforma SSP, technologia wyświetlania reklam lub sam wydawca. W przypadku zdarzeń wyświetlenia jest to zwykle zewnętrzny dostawca usług pomiarowych.

W typowym przykładzie konfiguracji kampanii z scenariusza 1 serwer reklam wydawcy, platforma SSP lub sam wydawca mogą po prostu potrzebować sprawdzenia, czy atrybut attributionsrc podany przez platformę DSP znajduje się na stronie wydawcy.

Szczegóły implementacji

W tabeli poniżej znajdziesz ogólne informacje o krokach wdrażania interfejsu Attribution Reporting API:

Kroki Odpowiedzialność za pracę Przykłady
Krok 1. Włącz źródło atrybucji w przypadku 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 jest zwykle dodawany przez kupującego (platformę DSP lub serwer reklam reklamodawcy), który renderuje kreację.

W przypadku zdarzeń wyświetlenia atrybut jest dodawany przez platformę DSP, platformę SSP, wydawcę, serwer reklam lub dostawcę usług pomiarowych i zależy od konfiguracji wydawcy.

W przypadku reklam wideo korzystających z formatu VAST wydawca i pakiet SDK do wyświetlania reklam wideo dodają atrybut.
Krok 2. Włącz raportowanie atrybucji w przypadku źródeł innych firm Działa to od razu, jeśli używasz istniejącej ścieżki przekierowania z przekierowaniami 302.

Jeśli nie można użyć przekierowań 302, można użyć atrybutu attributionsrc, aby podać listę wielu serwerów technologii reklamowych.

 Zasadniczo, o ile do kreacji zostanie dodany atrybut attributionsrc, 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 Platforma DSP i zewnętrzny dostawca pomiarów używany przez reklamodawcę

Pamiętaj, że szczegóły każdego kroku zależą od tego, jak kreacje są renderowane i wyświetlane na stronie wydawcy oraz które podmioty technologii reklamowych otrzymują raporty wysyłane przez interfejs Attribution Reporting API.

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

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

Jak działa atrybut attributionsrc

Nowy atrybut attributionsrc określa, gdzie będą wysyłane żądania do interfejsu Attribution Reporting API. Podmiot odpowiedzialny za wywoływanie zdarzeń wyświetlenia i kliknięcia musi zaktualizować kreacje za pomocą atrybutu attributionsrc. Parametr attributionsrc należy dodać do dotychczasowych zdarzeń kliknięć i wyświetleń. Może on być pusty lub niepusty.

W przypadku zdarzeń kliknięcia korzystających z przekierowań do nawigacji należy dodać atrybut attributionsrc. Wszelkie przekierowania 302 po nawigacji nie muszą dodawać atrybutu attributionsrc i będą kwalifikować się do ARA, o ile początkowa nawigacja dodała atrybut attributionsrc.

Gdy parametr attributionsrc jest pusty, żądania ARA będą wysyłane na adres URL zdefiniowany w atrybucie href tagu kotwicy (docelowy adres URL). Gdy zdefiniowany jest atrybut attributionsrc, żądania ARA będą wysyłane na adres URL zdefiniowany w atrybucie attributionsrc. Docelowy adres URL również kwalifikuje się do rejestrowania źródeł.

Zazwyczaj używaj pustego atrybutu attributionsrc, jeśli serwer hostujący docelowy URL może odbierać żądania interfejsu Attribution Reporting API i na nie odpowiadać. Zdefiniuj własny attributionsrc URL, jeśli chcesz, aby żądania do interfejsu Attribution Reporting API były wysyłane na inny serwer.

Przykład pustego atrybutu attributionsrc:

Obecna 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 będą wysyłane na adres URL zdefiniowany przez atrybut href tagu kotwicy.

Przykład niepustego atrybutu attributionsrc:

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

Gdy pole attributionsrc nie jest puste, żądania Attribution Reporting API są wysyłane na adres URL zdefiniowany przez tag attributionsrc. Docelowy adres URL również kwalifikuje się do rejestrowania źródeł.

Dodawanie parametru attributionsrc do zdarzeń kliknięcia i wyświetlenia

  • Zdarzenia kliknięcia:
    • Podmiotem odpowiedzialnym za dodanie attributionsrc jest zwykle technologia reklamowa wyświetlająca reklamy.
    • Do tagów kotwicy ze zdarzeniami kliknięcia należy dodać atrybut attributionsrc.
    • Kliknięcia z użyciem window.open powinny używać argumentu windowFeatures wywołania window.open do określania źródła atrybucji.
  • Zdarzenia wyświetleń:
    • Podmiotem odpowiedzialnym za dodanie attributionsrc jest zwykle technologia reklamowa wyświetlająca reklamy i dostawcy pomiarów.
    • Zdarzenia wyświetlenia wywoływane przez tag <img> lub <script> powinny zawierać atrybut attributionsrc.
    • Zdarzenia wyświetleń korzystające z Fetch API powinny zawierać obiekt attributionReporting w argumencie options przekazywanym do wywołania Fetch API.

W tabeli poniżej znajdziesz podsumowanie zmian, które należy wprowadzić w przypadku zdarzeń kliknięcia i wyświetlenia:

Zdarzenie Tag Obecna 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 na aukcji z Protected Audience API

Aby mierzyć konwersje w aukcjach Protected Audience, zamiast attributionsrc możesz używać registerAdBeacon/registerAdMacro i setReportEventDataForAutomaticBeacons/reportEvent, aby umożliwić rejestrowanie źródeł atrybucji.

W przypadku raportowania sygnałów Protected Audience funkcja registerAdBeacon jest dostępna w workletach raportowania, a funkcja registerAdMacro – w worklecie raportowania wygranych przez kupującego. Następnie dane zdarzenia w ramce reklamy można dodać do zarejestrowanych sygnałów i makr za pomocą funkcji reportEvent i setReportEventDataForAutomaticBeacons interfejsu Fenced Frame Ads Reporting API. Umożliwia to powiązanie sygnałów z procesów roboczych raportowania Protected Audience API z ładunkiem zdarzenia ramki kreacji reklamy.

Nagłówek HTTP Attribution-Reporting-Eligible jest dodawany do żądania, gdy sygnały i makra są wywoływane przez wywołanie reportEvent z ramki lub gdy automatyczne sygnały są wywoływane przez przeglądarkę. Odpowiedzi z beacona możesz używać do rejestrowania źródła atrybucji. Żądania sygnałów mogą być przekierowywane, aby umożliwić pomiary prowadzone przez firmy zewnętrzne.

Więcej informacji znajdziesz w sekcji dotyczącej obsługi interfejsu Attribution Reporting API w wyjaśnieniu interfejsu Fenced Frame Ad Reporting API.

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

VAST to popularny format wyświetlania i pomiaru zasobów reklamowych wideo. Wiele zdarzeń zdefiniowanych w tym standardzie należy uznać za potencjalne zdarzenia źródłowe, które można zarejestrować w interfejsie Attribution Reporting API. Szczegółowe informacje na ten temat znajdziesz w dodatku do VAST dotyczącym obsługi interfejsu Attribution Reporting API. W skrócie: wszystkie zdarzenia <Tracking>, <Impression>, <*ClickThrough> i <*ClickTracking> mogą być zdarzeniami źródłowymi atrybucji. Wszystkie implementacje VAST powinny zapewniać możliwość rejestracji tych zdarzeń.

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

Aby uzyskać maksymalny zasięg, implementacje VAST powinny domyślnie kwalifikować wszystkie wymienione zdarzenia do rejestracji, gdy są wysyłane pingi zdarzeń. Na przykład podczas uruchamiania adresu URL zdarzenia <Impression> w elemencie <img> używanym do wysyłania żądania (lub w odpowiedniku w wywołaniu fetch) należy użyć (pustego) atrybutu attributionsrc, 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ł innych firm

Aby zezwolić innym firmom na korzystanie z interfejsu Attribution Reporting API, możesz użyć istniejących przekierowań lub dodać listę innych firm do atrybutu attributionsrc. W większości przypadków każda technologia reklamowa ma własny, niezależny moduł śledzenia wyświetleń, więc przekierowania są bardziej istotne w przypadku modułów śledzenia kliknięć.

Obsługa źródeł zewnętrznych w istniejącym łańcuchu przekierowań

W typowym kliknięciu reklamy może występować wiele tagów śledzenia kliknięć w postaci łańcucha 302przekierowań wykonywanych w ramach nawigacji do strony docelowej. Każde żądanie w łańcuchu przekierowań kwalifikuje się do rejestracji w interfejsie Attribution Reporting API, jeśli pierwotny cel kliknięcia został oznaczony adnotacją attributionsrc lub zarejestrowany za pomocą registerAdBeacon/registerAdMacro w interfejsie Protected Audience API. Technologia reklamowa w łańcuchu przekierowań musi być również zarejestrowana.

Pamiętaj, że treść początkowego żądania nie jest wysyłana w przypadku przekierowań. W przypadku aukcji z Protected Audience API, jeśli wartość eventData jest przekazywana do reportEvent i wartość setReportEventDataForAutomaticBeacons ma być używana w ramach przekierowania, musi być jawnie przekazywana jako część adresu URL przekierowania.

W poniższym przykładzie użyjemy technologii wyświetlania reklam (serving-adtech.example) i zewnętrznego dostawcy pomiarów (3p-measurement.example) jako 2 osobnych podmiotów, które chcą generować i otrzymywać raporty o atrybucji. Technologia wyświetlania reklam w tym przykładzie może być platformą DSP, która renderuje kreację w witrynie wydawcy i ma własną usługę raportowania. Dostawcą pomiarów zewnętrznych może być podmiot, z którego usług reklamodawca korzysta do raportowania konwersji.

Diagram opisujący, jak podmiot własny rejestruje źródło.
Przykład działania pomiaru konwersji w przypadku firmy zewnętrznej.

Podczas rejestracji źródła wykonuje się te 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łówkami Attribution-Reporting-Register-Source i Location.
    1. serving-adtech.example używa nagłówka Attribution-Reporting-Register-Source, aby odpowiadać 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 procesach śledzenia kliknięć, aby obsługiwać 302 przekierowania do zewnętrznego dostawcy.
  3. Przeglądarka otrzymuje odpowiedź z 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 odpowiedzią zawierającą nagłówek Attribution-Reporting-Register-Source.
  6. Przeglądarka otrzymuje tę odpowiedź z 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żyj attributionsrc w przypadku źródeł zewnętrznych, które nie należą do łańcucha przekierowań.

Jeśli wiele źródeł raportujących chce zarejestrować źródło w zdarzeniu nawigacji, ale z jakiegoś powodu nie może pojawić się w łańcuchu przekierowań, możesz jako alternatywne rozwiązanie wymienić wiele witryn jako źródła atrybucji w attributionsrc.

Obecna 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 interfejsu Attribution Reporting API będą wysyłane zarówno do REPORTING_URL_1, jak i REPORTING_URL_2. Żądanie nawigacji wysłane na docelowy adres URL również kwalifikuje się 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 z odpowiednim nagłówkiem Attribution-Reporting-Register-Source. Zapoznaj się z przewodnikiem Rejestrowanie źródeł i wyjaśnieniem, aby dowiedzieć się, jak powinna być skonstruowana odpowiedź.

Rejestrowanie wielu reguł

Możesz zarejestrować wiele wywołań atrybucji, dodając po stronie konwersji wiele elementów piksela (po jednym na wywołanie). Element attributionsrc jest opcjonalny w przypadku rejestracji wyzwalacza.

Możesz też zarejestrować wiele reguł z jednego elementu piksela, używając żądań przekierowania lub podając wiele adresów URL w elemencie attributionsrc w taki sam sposób jak w przypadku rejestracji źródła. Zdarzenia źródłowe i zdarzenia aktywujące wygenerowane przez te same źródła będą dopasowywane.