Włącz pomiar konwersji

Pomiar atrybucji konwersji może obejmować wiele podmiotów, takich jak wydawca, reklamodawca, dostawca technologii reklamowych (podmiot, który wyświetla reklamę), dostawca usług pomiarowych itd. W tym dokumencie omawiamy typowe scenariusze pomiaru konwersji, jednak ogólnie wszystkie firmy, które chcą otrzymywać raporty atrybucji z interfejsu Attribution Reporting API (ARA), muszą przestrzegać kroków integracji opisanych w tym dokumencie.

Często na przykład wydawca ma co najmniej jedną osobę odpowiedzialną za wyświetlanie reklamy. Może to być podmiot odpowiedzialny za dostarczenie znacznika do kreacji, podmiot dostarczający piksel śledzący lub wyświetlenia do kreacji oraz pakiet SDK lub tag do boksu reklamowego na stronie wydawcy. Specjaliści ds. technologii reklamowych mogą, ale nie muszą, otrzymywać raporty atrybucji z interfejsu ARA, ale są odpowiednio przygotowani, by umożliwić im otrzymywanie raportów atrybucji.

Reklamodawca może też korzystać z usług zewnętrznego dostawcy usług pomiaru konwersji na potrzeby atrybucji międzysieciowej i innych funkcji raportowania. Reklamodawcy korzystają z tych danych, aby określać zwrot z inwestycji w reklamy w przypadku wielu unikalnych wydawców i kanałów, dlatego ważne jest, aby platformy DSP i serwery reklam wiedziały, jak włączyć interfejs Attribution Reporting API pod kątem obsługi tych przypadków użycia. Reklamodawcy, którzy chcą korzystać z usług firmy zewnętrznej, mogą nadal 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 otrzymywać raporty za pomocą interfejsu API.

Interfejs Attribution Reporting API umożliwia wielu technikom reklamowym rejestrowanie źródeł atrybucji i reguł atrybucji dla tego samego wyświetlenia lub konwersji i otrzymywanie osobnych raportów z poziomu interfejsu API. Na przykład platforma DSP może otrzymywać własne raporty atrybucji z interfejsu Attribution Reporting API oraz umożliwiać oddzielne raportowanie dla zewnętrznego dostawcy usług pomiarowych reklamodawcy. Aby otrzymywać raporty z interfejsu API, technologia reklamowa musi zarejestrować zarówno źródła atrybucji, jak i reguły atrybucji.

Typowe scenariusze pomiaru konwersji

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

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

Reklamodawca chce przypisywać konwersje do zasobów 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. Zdarza się to często w przypadku platform DSP lub serwerów reklam reklamodawców (serwerów reklamowych firm zewnętrznych), które dostarczają znaczniki kreacji reklamowych, generują własne raporty atrybucji i współpracują z reklamodawcami współpracującymi z zewnętrznymi dostawcami usług pomiarowych lub analitycznych.

W tym przypadku technologia wyświetlania reklam jest też odpowiedzialna za uruchamianie zdarzeń kliknięcia i wyświetlenia w ramach bieżącej konfiguracji. Technologia wyświetlania reklam powinna ustawić nowy attributionsrc w odpowiednich lokalizacjach i upewnić się, że przekierowania są prawidłowo skonfigurowane. Zarówno technologia reklamowa wyświetlająca reklamy, jak i zewnętrzny dostawca usług pomiarowych powinni też zarejestrować swoje serwery, a ich serwery są gotowe do odbierania żądań do interfejsu Attribution Reporting API i odpowiadania na nie.

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

  1. Serwer reklam reklamodawcy (3PAS) dostarcza znaczniki kreacji reklamy do platformy DSP, która obejmuje piksele śledzenia wyświetleń i kliknięć zewnętrznego dostawcy usług pomiarowych. Serwer reklam powinien się upewnić, że w znacznikach kreacji występuje fragment attributionsrc.

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

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 żadnych wymagań dotyczących pomiaru atrybucji. Zdarza się to często w przypadku wydawców, platform SSP i serwerów reklam wydawców, którzy hostują kreacje i nie planują samodzielnie korzystać z raportowania atrybucji, a którzy chcą włączyć interfejs Attribution Reporting API dla swoich partnerów DSP lub firm świadczących usługi pomiarowe, takich jak zewnętrzne serwery reklamowe oraz dostawcy usług pomiarowych lub analitycznych.

W takim przypadku firma odpowiedzialna za uruchamianie zdarzeń kliknięć i wyświetleń w obecnej konfiguracji musi dodać do kreacji nowy atrybut attributionsrc i upewnić się, że przekierowania działają zgodnie z oczekiwaniami. Zależy to w dużym stopniu od integracji poszczególnych wydawców, ale w przypadku zdarzeń kliknięć może to być platforma SSP, technologia reklamowa wyświetlająca reklamy lub sam wydawca. W przypadku zdarzeń wyświetleń częściej jest to zewnętrzny dostawca usług pomiarowych.

W typowym przykładzie konfiguracji kampanii ze scenariusza 1 serwer reklam wydawcy, platforma SSP lub wydawca może po prostu zadbać o to, by atrybut attributionsrc dostarczony przez platformę DSP znalazł się na stronie wydawcy.

Szczegóły implementacji

W tabeli poniżej znajdziesz ogólne opisy czynności związanych z implementacją interfejsu Attribution Reporting API:

Kroki Odpowiedzialność za pracę Przykłady
Krok 1. Włącz źródło atrybucji dla istniejących kreacji i kodu pomiarowego Element, który odpowiada za uruchamianie zdarzeń wyświetlenia lub obsługę takich zdarzeń, dodaje atrybut attributionsrc. W przypadku zdarzeń kliknięcia atrybut dodaje zazwyczaj kupujący (DSP lub serwer reklam reklamodawcy), który renderuje kreację.

W przypadku zdarzeń wyświetlenia atrybut jest dodawany w przypadku zdarzeń wyświetlenia: platforma DSP, platforma dostawców reklam, wydawca, serwer reklam lub dostawca pomiarów, który zależy od konfiguracji wydawcy.

W przypadku reklam wideo korzystających z formatu VAST atrybut ten dodaje wydawca i pakiet SDK wideo.

Krok 2. Włącz raporty atrybucji w przypadku źródeł zewnętrznych Ta funkcja działa od razu w przypadku korzystania z istniejącej ścieżki przekierowania z przekierowaniami 302.

Jeśli nie możesz użyć przekierowań 302, możesz użyć atrybutu attributionsrc, by wyświetlić listę wielu serwerów technologii reklamowych.

Jeśli do kreacji został dodany atrybut attributionsrc, przekierowania zewnętrzne 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 Platforma DSP oraz zewnętrzny dostawca usług pomiarowych, z których korzysta reklamodawca

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

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

W pierwszym kroku włączone 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. Element, który odpowiada za uruchamianie zdarzeń wyświetlenia i kliknięcia, musi aktualizować kreacje za pomocą atrybutu attributionsrc. Pole attributionsrc należy dodać do dotychczasowych zdarzeń kliknięć i wyświetleń. Pole może być puste lub niepełne.

W przypadku zdarzeń kliknięcia korzystających z przekierowań należy dodać do menu nawigacyjnego atrybut attributionsrc. Wszelkie przekierowania 302 po nawigacji nie wymagają dodawania atrybutu attributionsrc i mogą korzystać z interfejsu ARA, o ile do początkowej nawigacji dodano atrybut attributionsrc.

Gdy pole attributionsrc jest puste, żądania ARA będą wysyłane na adres URL zdefiniowany w atrybucie href tagu kotwicy (docelowego adresu URL). Po zdefiniowaniu atrybutu attributionsrc żądania ARA będą wysyłane na adres URL zdefiniowany w atrybucie attributionsrc. Docelowy URL może też rejestrować źródła.

Jeśli serwer hostujący docelowy URL może odbierać żądania do interfejsu Attribution Reporting API i na nie odpowiadać, ogólnie używaj pustego atrybutu attributionsrc. Jeśli chcesz, aby żądania interfejsu Attribution Reporting API były kierowane do innego serwera, zdefiniuj 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 Attribution Reporting API będą wysyłane na adres URL zdefiniowany przez atrybut href tagu kotwicy.

Przykład niepustego atrybutu atrybucjisrc:

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

Gdy pole attributionsrc nie jest puste, żądania do Attribution Reporting API będą wysyłane na adres URL zdefiniowany w tagu attributionsrc. Docelowy URL może też rejestrować źródła.

Dodaj attributionsrc dla zdarzeń kliknięć i wyświetleń

  • Zdarzenia kliknięcia:
    • Podmiot odpowiedzialny za dodanie attributionsrc jest zwykle technologią wyświetlania reklam
    • Tagi kotwicy ze zdarzeniami kliknięcia powinny mieć dodany atrybut attributionsrc
    • Aby określić źródło atrybucji, kliknięcia korzystające z funkcji window.open powinny korzystać z argumentu windowFeatures w wywołaniu window.open.
  • Zdarzenia wyświetlenia:
    • Podmiot odpowiedzialny za dodanie attributionsrc to zwykle technologia reklamowa wyświetlająca reklamy i dostawca usług pomiarowych
    • Zdarzenia wyświetlenia wywołane z tagu <img> lub tagu <script> powinny zawierać atrybut attributionsrc.
    • Zdarzenia wyświetlenia korzystające z interfejsu Fetch API powinny zawierać obiekt attributionReporting w argumentu options przekazywanym w wywołaniu interfejsu API pobierania.

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

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 Protected Audience API

Aby mierzyć konwersje w aukcjach Protected Audience, zamiast używać metody attributionsrc możesz rejestrować źródła atrybucji za pomocą registerAdBeacon/registerAdMacro i setReportEventDataForAutomaticBeacons/reportEvent.

Na potrzeby raportowania sygnałów w ramach Protected Audience API funkcja registerAdBeacon jest dostępna w workletach raportowania, a registerAdMacro – w zasobie raportowania wygranych kupującego. Następnie dane zdarzeń wewnątrz ramki reklamy można dodać do zarejestrowanych obrazów typu beacon i makr za pomocą funkcji reportEvent i setReportEventDataForAutomaticBeacons interfejsu API do raportowania reklam Fenced Frame Ads. Dzięki temu sygnały w workletach raportowania Protected Audience API oraz ładunek zdarzenia ramki kreacji w reklamie mogą być ze sobą powiązane.

Nagłówek HTTP Attribution-Reporting-Eligible jest dodawany do żądania, gdy sygnały typu beacon i makra zostaną wywołane przez wywołanie reportEvent z ramki lub gdy przeglądarka uruchomi automatyczne sygnały typu beacon. Aby zarejestrować źródło atrybucji, możesz użyć odpowiedzi obrazu typu beacon. Żądania beaconów mogą być przekierowywane, aby umożliwić korzystanie z rozwiązań pomiarowych firm zewnętrznych.

Aby dowiedzieć się więcej, zapoznaj się z sekcją Obsługa raportów atrybucji w objaśnieniu dotyczącym interfejsu API Fenced Frame do raportowania reklam.

Włączanie raportowania atrybucji dla formatów VAST

VAST to popularny format do wyświetlania i pomiaru zasobów reklamowych wideo. Wiele zdarzeń zdefiniowanych w tym standardzie należy uznać za potencjalne zdarzenia źródłowe kwalifikujące się do zarejestrowania w Attribution Reporting API. Szczegółowe informacje na ten temat znajduje się w Załączniku VAST dotyczącym pomocy w zakresie raportów atrybucji, ale w skrócie: wszystkie zdarzenia <Tracking>, <Impression>, <*ClickThrough> i <*ClickTracking> są potencjalnymi zdarzeniami źródła atrybucji. Wszystkie implementacje VAST powinny umożliwiać rejestrację tych zdarzeń.

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

Aby zapewnić maksymalny zasięg, implementacje VAST powinny domyślnie umożliwiać rejestrację wszystkich wymienionych zdarzeń podczas uruchamiania pingów zdarzeń. Na przykład podczas uruchamiania adresu URL zdarzenia <Impression> należy użyć (pustego) atrybutu attributionsrc w elemencie <img> używanym do wysyłania żądania (lub odpowiednika w wywołaniu pobierania), aby zawsze umożliwić odbiorcy potencjalne zarejestrowanie tego zdarzenia za pomocą interfejsu Attribution Reporting API.

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

Aby umożliwić osobom trzecim korzystanie z interfejsu Attribution Reporting API, możesz użyć dotychczasowych 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ą dla nich bardziej istotne.

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

W typowym klikalności reklamy wiele tagów śledzenia kliknięć może występować w postaci łańcucha przekierowań 302 podczas nawigacji do ostatecznej strony docelowej. Każde żądanie w łańcuchu przekierowań kwalifikuje się do rejestracji w Attribution Reporting API, jeśli pierwotne docelowe kliknięcie ma adnotację attributionsrc lub zostało zarejestrowane w Protected Audience API przez registerAdBeacon/registerAdMacro. Technologie reklamowe w łańcuchu przekierowań też muszą być zarejestrowane.

Treść żądania początkowego nie jest wysyłana w przypadku przekierowań. W przypadku aukcji w ramach Protected Audience API, jeśli w przekierowaniu ma być używane uwierzytelnianie eventData, należy bezpośrednio przekazać je do przekierowania reportEvent i setReportEventDataForAutomaticBeacons.

W poniższym przykładzie użyjemy technologii reklamowej do wyświetlania (serving-adtech.example) i zewnętrznego dostawcy usług pomiarowych (3p-measurement.example) jako 2 odrębnych podmiotów, które chcą generować i otrzymywać raporty atrybucji. Technologią reklam do wyświetlania w tym przykładzie może być platforma DSP, która renderuje kreację w witrynie wydawcy, i ma własną usługę do raportowania. Zewnętrznym dostawcą usług pomiarowych może być podmiot, którego reklamodawca używa do raportowania konwersji.

Diagram pokazujący, w jaki sposób firma zewnętrzna rejestruje źródło, a następnie inna firma rejestruje

W momencie rejestracji źródła wykonywane są te czynności:

  1. serving-adtech.example ustawia w kreacji atrybut attributionsrc. Użytkownik odwiedza stronę wydawcy, a przeglądarka wysyła żądanie do strony serving-adtech.example..
  2. W odpowiedzi serving-adtech.example przesyła nagłówki Attribution-Reporting-Register-Source i Location.
    1. Parametr serving-adtech.example używa nagłówka Attribution-Reporting-Register-Source, aby podawać w odpowiedzi metadane dotyczące źródła, które ma być zarejestrowane.
    2. Tag serving-adtech.example używa nagłówka Location, aby uwzględnić przekierowanie do witryny 3p-measurement.example. Pamiętaj, że nagłówek Location prawdopodobnie jest już używany w Twoich dotychczasowych procesach śledzenia kliknięć do obsługi przekierowań 302 na stronę firmy zewnętrznej.
  3. Przeglądarka otrzymuje odpowiedź z komponentu serving-adtech.example i przetwarza 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. To żądanie jest przekierowaniem, więc przeglądarka wysyła też nowe żądanie do 3p-measurement.example.
  5. 3p-measurement.example przekazuje odpowiedź 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żywaj pola 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 występować w łańcuchu przekierowań, jako alternatywne rozwiązanie w attributionsrc możesz podać wiele witryn jako źródła atrybucji.

Twoja obecna konfiguracja Z modyfikacjami interfejsu 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 interfejsów REPORTING_URL_1, jak i do REPORTING_URL_2. Żądanie nawigacji wysłane na docelowy URL także kwalifikuje się do rejestrowania źródeł atrybucji.

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

W przypadku wszystkich źródeł odbierających żądanie do interfejsu Attribution Reporting API upewnij się, że serwer wysyła w odpowiedzi odpowiedni nagłówek Attribution-Reporting-Register-Source. Informacje o tym, jak powinna być konstruowana odpowiedź, znajdziesz w przewodniku po rejestrowaniu źródeł oraz z objaśnieniem.

Zarejestruj wiele aktywatorów

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

Możesz też zarejestrować wiele reguł z jednego 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. Zostaną dopasowane zdarzenia źródłowe i zdarzenia aktywujące, które zostały wygenerowane przez te same źródła.