Włącz pomiar konwersji

Na pomiar atrybucji konwersji może brać udział wiele osób: wydawca, reklamodawca, dostawca technologii reklamowych (podmiot, który wyświetla reklamę), dostawca usług pomiaru itp. W tym dokumencie opisujemy typowe scenariusze dotyczące pomiaru konwersji. Zazwyczaj każda firma, która chce otrzymywać raport atrybucji za pomocą interfejsu Attribution Reporting API (ARA), musi wykonać kroki integracji opisane w tym dokumencie.

Na przykład często za wyświetlanie reklamy odpowiada jeden lub kilka technik reklamowych. Mogą to być strony odpowiedzialne za dodanie znaczników do kreacji, podmioty dostarczające piksel śledzący do wyświetlenia lub wyświetlenia kreacji oraz podmioty, które dostarczają pakiet SDK lub tag do boksu reklamowego na stronie wydawcy. Ci specjaliści ds. technologii reklamowych mogą, ale nie muszą, otrzymywać raporty atrybucji z ARA, ale są odpowiednio przygotowani, aby umożliwić otrzymywanie raportów atrybucji na dalszych etapach.

Poza tym reklamodawca może korzystać z usług zewnętrznego dostawcy usługi pomiaru konwersji na potrzeby atrybucji międzysieciowej oraz innych funkcji raportowania. Reklamodawcy wykorzystują te dane, aby poznać zwrot z inwestycji w reklamę u wielu unikalnych wydawców i kanałów. Dlatego platformy DSP i serwery reklam muszą wiedzieć, jak włączyć Attribution Reporting API w takich przypadkach. Reklamodawcy, którzy chcą korzystać z usług firm zewnętrznych, mogą to robić, korzystając z usług zewnętrznego dostawcy usług pomiarowych lub konfigurując własny serwer, który będzie rejestrować i odbierać raporty przez interfejs API.

Attribution Reporting API umożliwia wielu technikom reklamowym rejestrowanie źródeł i reguł atrybucji dla tego samego wyświetlenia lub konwersji oraz otrzymywanie osobnych raportów od interfejsu API. Na przykład platforma DSP może otrzymywać z interfejsu Attribution Reporting API własne raporty atrybucji, a także umożliwiać oddzielne raportowanie zewnętrzne dostawcy usług pomiarowych reklamodawcy. Aby otrzymywać raporty z interfejsu API, technika reklamowa musi zarejestrować zarówno źródła atrybucji, jak i reguły, a atrybucja jest przeprowadzana wśród źródeł i reguł atrybucji zarejestrowanych przez daną technologię reklamową w interfejsie API.

Typowe scenariusze pomiaru konwersji

W tej sekcji przyjrzymy się 2 typowym scenariuszom pomiaru konwersji.

Scenariusz 1. Zarówno firma oferująca technologie reklamowe, jak i zewnętrzny dostawca usług pomiaru muszą otrzymywać raporty z interfejsu Attribution Reporting API

Reklamodawca chce przypisywać konwersje w zasobach reklamowych, korzystając z usług zewnętrznego dostawcy usług pomiarowych, a technologia reklamowa hostująca kreację chce przypisywać konwersje do zasobów reklamowych. Jest to typowa sytuacja w przypadku platform DSP i serwerów reklamowych reklamodawców (zewnętrznych serwerów reklamowych – 3PAS), które udostępniają znaczniki na potrzeby kreacji, generują własne raporty atrybucji i współpracują z reklamodawcami, którzy integrują się z zewnętrznymi dostawcami usług pomiarowych lub analitycznych.

W tym przypadku technika wyświetlania reklam jest również stroną, która odpowiada za wywoływanie zdarzeń kliknięć i wyświetleń w bieżącej konfiguracji. Technologia wyświetlania reklam powinna ustawić nowy attributionsrc w odpowiednich lokalizacjach i upewnić się, że przekierowania są prawidłowo skonfigurowane. Dodatkowo dostawca technologii reklamowych, który wyświetla reklamy, i zewnętrzny dostawca usług pomiarowych powinni się upewnić, że są zarejestrowani, a ich serwery są gotowe do odbierania żądań Attribution Reporting API i odpowiadania na nie.

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

  1. Serwer reklam reklamodawcy (3PAS) dostarcza do platformy DSP znaczniki kreacji, które obejmują piksele śledzenia wyświetleń i kliknięć pochodzące od zewnętrznego dostawcy usług pomiarowych. Serwer reklam powinien się upewnić, że w znacznikach kreacji reklamy dodano attributionsrc.

  2. Platforma DSP umożliwia dodawanie kolejnych pikseli śledzących wyświetlenia i śledzenia kliknięć. Należy się też upewnić, że parametr attributionsrc jest uwzględniony w końcowych znacznikach kreacji reklam, za pomocą których ustalają stawki.

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

Reklamodawca chce przypisywać konwersje w zasobach reklamowych, korzystając z usług zewnętrznego dostawcy usług pomiaru, ale technologia reklamowa hostująca kreację nie ma wymagań dotyczących pomiaru atrybucji. Jest to typowe w przypadku wydawców, platform SSP lub serwerów reklam wydawców, którzy hostują kreacje i nie planują sami korzystać z raportowania atrybucji, ale chcą włączyć interfejs Attribution Reporting API w przypadku partnerów DSP lub firm zajmujących się tagowaniem pomiarowym (np. zewnętrznych serwerów reklamowych, usług pomiarowych lub dostawców rozwiązań analitycznych).

W tym przypadku podmiot odpowiedzialny za wywoływanie zdarzeń kliknięć i wyświetleń w bieżącej konfiguracji musi dodać do kreacji nowy atrybut attributionsrc i zadbać o prawidłowe działanie przekierowań. To zależy w dużym stopniu od integracji poszczególnych wydawców, ale w przypadku zdarzeń kliknięcia może to być platforma SSP, technologia reklamowa lub sam wydawca. W przypadku zdarzeń związanych z wyświetleniami jest to zwykle zewnętrzny dostawca usług pomiaru.

W typowym przykładzie konfiguracji kampanii ze scenariuszy 1 serwer reklam wydawcy, platforma SSP lub wydawca może po prostu dopilnować, aby atrybut attributionsrc przesłany przez platformę DSP znalazł się na stronie wydawcy.

Szczegóły implementacji

W tej tabeli opisano ogólne etapy implementacji interfejsu Attribution Reporting API:

Instrukcje Odpowiedzialność za pracę Przykłady
Krok 1. Włącz źródło atrybucji w przypadku istniejących kreacji i kodu pomiarowego Element 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 (DSP/serwer reklam reklamodawcy), który renderuje kreację.

W przypadku zdarzeń wyświetlenia atrybut jest dodawany do platformy DSP, platformy dostawców (SSP), wydawcy, serwera reklam lub dostawcy usług pomiaru. Zależy on od konfiguracji wydawcy.

W przypadku reklam wideo w formacie VAST wydawca i pakiet SDK wideo dodają atrybut.
Krok 2. Włącz raporty atrybucji w przypadku źródeł zewnętrznych To rozwiązanie od razu dział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 posłużyć do wyświetlenia listy wielu serwerów technologii reklamowych.

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

Pamiętaj, że szczegóły każdego etapu zależą od sposobu renderowania i wyświetlania kreacji na stronie wydawcy oraz od tego, które podmioty z branży technologii reklamowych otrzymują raporty wysyłane przez Attribution Reporting API.

Krok 1. Włącz źródło atrybucji w przypadku istniejących 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 będą wysyłane żądania interfejsu Attribution Reporting API. Element odpowiedzialny za uruchamianie zdarzeń wyświetleń i kliknięć musi aktualizować kreacje za pomocą atrybutu attributionsrc. Pole attributionsrc należy dodać do dotychczasowych zdarzeń kliknięć i wyświetleń – może być puste lub nie może być puste.

W przypadku zdarzeń kliknięcia korzystających z przekierowań należy dodać do elementów nawigacyjnych atrybut attributionsrc. Przekierowania 302 po nawigacji nie muszą dodawać atrybutu attributionsrc. Będą one działać w interfejsie ARA, o ile w początkowej nawigacji dodano element attributionsrc.

Jeśli attributionsrc jest pusty, żądania ARA będą wysyłane na adres URL zdefiniowany w atrybucie href tagu kotwicy (docelowy URL). Gdy atrybut attributionsrc jest zdefiniowany, żądania ARA będą wysyłane na adres URL zdefiniowany w atrybucie attributionsrc. Docelowy URL może również służyć do rejestrowania źródeł.

Ogólnie używaj pustego atrybutu attributionsrc, jeśli serwer hostujący docelowy URL może odbierać żądania do interfejsu Attribution Reporting API i na nie odpowiadać. Jeśli chcesz, by żądania interfejsu Attribution Reporting API były kierowane na inny serwer, określ własny adres URL attributionsrc.

Przykład pustego atrybutu attributionsrc:

Twoja obecna konfiguracja Z integracją z interfejsem ARA
<a href="[CLICKTHROUGH_URL]">...</a> <a href="[CLICKTHROUGH_URL]" attributionsrc>...</a>

Gdy atrybut attributionsrc jest pusty, żądania do interfejsu Attribution Reporting API będą wysyłane na adres URL zdefiniowany w atrybucie href tagu kotwicy.

Przykład niepustego atrybutu Attributionsrc:

Twoja obecna konfiguracja Z integracją z interfejsem ARA
<a href="[CLICKTHROUGH_URL]">...</a> <a href="[CLICKTHROUGH_URL]" attributionsrc="[ATTRIBUTION_SRC_URL]">...</a>

Gdy attributionsrc nie jest pusty, żądania Attribution Reporting API będą wysyłane na adres URL zdefiniowany w tagu attributionsrc. Docelowy URL może również służyć do rejestrowania źródeł.

Dodaj pole attributionsrc w przypadku zdarzeń kliknięć i wyświetleń

  • Zdarzenia kliknięcia:
    • Podmiot odpowiedzialny za dodanie elementu attributionsrc jest zwykle odpowiedzialny za wyświetlanie technologii reklamowej.
    • Do tagów kotwicy ze zdarzeniami kliknięcia należy dodać atrybut attributionsrc.
    • Aby określić źródło atrybucji, kliknięcia z parametrem window.open powinny używać argumentu windowFeatures wywołania window.open.
  • Zdarzenia wyświetlenia:
    • Podmiotem odpowiedzialnym za dodanie elementu attributionsrc jest zwykle dostawca technologii reklamowej i dostawca usług pomiarowych.
    • Zdarzenia wyświetlenia wywoływane przez tag <img> lub tag <script> powinny zawierać atrybut attributionsrc.
    • Zdarzenia wyświetlenia realizowane za pomocą interfejsu Fetch API powinny zawierać obiekt attributionReporting w argumencie options przekazywanym do wywołania interfejsu API pobierania.

W tej tabeli znajdziesz podsumowanie modyfikacji wymaganych w przypadku zdarzeń kliknięć i wyświetleń:

Zdarzenie Tag Twoja obecna konfiguracja Po integracji z interfejsem ARA
Kliknij 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

Jeśli chcesz mierzyć konwersje w aukcjach z Protected Audience API, zamiast attributionsrc możesz używać funkcji registerAdBeacon/registerAdMacro i setReportEventDataForAutomaticBeacons/reportEvent, aby włączyć rejestrowanie źródeł atrybucji.

W przypadku sygnałów z Protected Audience API funkcja registerAdBeacon jest dostępna w listach raportowania, a registerAdMacro – w zadaniu raportowania wygranego kupującego. Następnie dane zdarzenia z ramki reklamy można dodać do zarejestrowanych obrazów typu beacon 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 zdarzenia ramki kreacji w reklamie mogą być ze sobą powiązane.

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 przeglądarka aktywuje automatyczne beacony. Możesz użyć odpowiedzi beaconu, by zarejestrować źródło atrybucji. Żądania beaconu mogą być przekierowywane, aby umożliwić korzystanie z zewnętrznych usług pomiarowych.

Więcej informacji znajdziesz w sekcji dotyczącej raportowania atrybucji w artykule o interfejsie 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 zdefiniowanych w nim zdarzeń należy uznać za potencjalne zdarzenia źródłowe kwalifikujące się do rejestracji w interfejsie Attribution Reporting API. Szczegółowe informacje na ten temat omawiamy w Załączniku VAST dotyczącym obsługi raportowania atrybucji, ale w skrócie – wszystkie zdarzenia <Tracking>, <Impression>, <*ClickThrough> i <*ClickTracking> są potencjalnymi zdarzeniami źródła atrybucji. Wszystkie implementacje VAST powinny obejmować warunki rejestracji na te zdarzenia.

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

Aby zapewnić maksymalny zasięg, w implementacjach VAST podczas uruchamiania pingów zdarzeń wszystkie wymienione zdarzenia powinny kwalifikować się do rejestracji. Jeśli na przykład uruchamiasz adres URL zdarzenia <Impression>, do elementu <img> używanego do wysłania żądania (lub jego odpowiednika w wywołaniu pobierania) należy użyć (pustego) atrybutu attributionsrc, aby strona odbierająca mogła zawsze zarejestrować to zdarzenie za pomocą Attribution Reporting API.

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

Aby umożliwić firmom zewnętrznym 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 technologia reklamowa ma własny, niezależny moduł do śledzenia wyświetleń, więc przekierowania są w nich trafniejsze.

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

W typowym przypadku klikalności reklamy wiele tagów śledzenia kliknięć może przedstawiać się jako łańcuch przekierowań 302 w ramach nawigacji do ostatecznej 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 w interfejsie registerAdBeacon/registerAdMacro w interfejsie Protected Audience API. Technologia reklamowa w łańcuchu przekierowań musi też być zarejestrowana.

Treść wstępnego żądania nie jest wysyłana w przypadku przekierowań. Jeśli w aukcjach z Protected Audience API konieczne jest przekazanie parametru eventData do reportEvent, a jako część przekierowania trzeba użyć parametru setReportEventDataForAutomaticBeacons, musi on być wyraźnie przekazany jako część przekierowania.

W poniższym przykładzie wykorzystamy technologię wyświetlania reklam (serving-adtech.example) i zewnętrznego dostawcę usług pomiarowych (3p-measurement.example) jako 2 różne podmioty, które chcą generować i otrzymywać raporty 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. Zewnętrzny dostawca usług pomiaru może być podmiotem, z którego reklamodawca korzysta na potrzeby raportowania konwersji.

Schemat, który opisuje, w jaki sposób własna rejestruje źródło, a następnie

W momencie rejestracji źródła wykonywane są 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. W odpowiedzi serving-adtech.example przesyła nagłówek Attribution-Reporting-Register-Source i nagłówek Location.
    1. serving-adtech.example używa nagłówka Attribution-Reporting-Register-Source do odpowiedzi z metadanymi dotyczącymi zarejestrowanego źródła.
    2. W elemencie serving-adtech.example nagłówek Location zawiera przekierowanie do 3p-measurement.example. Uwaga: nagłówek Location prawdopodobnie jest już używany w Twoich istniejących procesach śledzenia kliknięć do obsługi przekierowań 302 na stronę firmy zewnętrznej.
  3. Przeglądarka otrzymuje odpowiedź od serving-adtech.example i analizuje nagłówek Attribution-Reporting-Register-Source. Przeglądarka zapisuje zdarzenie źródłowe, używając serving-adtech.example jako źródła raportowania.
  4. To żądanie jest przekierowaniem, więc przeglądarka wysyła nowe żądanie do strony 3p-measurement.example.
  5. 3p-measurement.example wysyła odpowiedź zawierającą nagłówek Attribution-Reporting-Register-Source.
  6. Przeglądarka otrzymuje tę odpowiedź z adresu 3p-measurement.example i odczytuje Attribution-Reporting-Register-Source. Przeglądarka zapisuje zdarzenie źródłowe, używając 3p-measurement.example jako źródła raportowania.

W przypadku źródeł zewnętrznych, których nie ma w łańcuchu przekierowań, użyj zasady attributionsrc

Jeśli kilka źródeł zgłaszających chce zarejestrować źródło w zdarzeniu nawigacji, ale z jakiegoś powodu nie może wystąpić w łańcuchu przekierowań, jako alternatywne rozwiązanie możesz podać w usłudze attributionsrc wiele witryn jako źródeł atrybucji.

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

W tym przykładzie żądania, które kwalifikują się do interfejsu Attribution Reporting API, będą wysyłane do REPORTING_URL_1 i.REPORTING_URL_2. Żądanie nawigacji wysłane na docelowy URL może też służyć do rejestrowania źródeł atrybucji.

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

W przypadku wszystkich źródeł odbierających żądanie Attribution Reporting API upewnij się, że serwer odpowiada odpowiednim nagłówkiem Attribution-Reporting-Register-Source. Informacje o tym, jak skonstruować odpowiedź, znajdziesz w przewodniku po rejestrowaniu źródeł i w objaśnieniu.

Rejestrowanie wielu aktywatorów

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

Możesz też zarejestrować wiele reguł związanych z pojedynczym elementem pikselowym, używając żądań przekierowania lub umieszczają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, które zostały wygenerowane przez te same źródła, będą dopasowywane.