Zarejestruj reguły atrybucji

Dowiedz się, jak zarejestrować reguły atrybucji, aby zliczać konwersje.

Reguła atrybucji to zdarzenie, które informuje przeglądarkę, że ma zarejestrować konwersje.

Wykonując czynności opisane w tym dokumencie, możesz zarejestrować reguły rejestrujące konwersje, które przeglądarka następnie przypisuje do odpowiednich zdarzeń źródłowych, czyli wyświetleń lub kliknięć reklam.

Metody rejestracji

Aby zarejestrować aktywatory, użyj elementów HTML lub wywołań JavaScript:

• Tag <img>
• Tag <script>
• fetch komponent do wykonywania połączeń
• XMLHttpRequest

Spowoduje to wygenerowanie żądań sieciowych, na które odpowiesz nagłówkiem odpowiedzi HTTP rejestracji aktywatora.

Zarejestruj regułę, aby przypisać konwersję

Rejestrowanie aktywatora przypomina rejestrowanie zdarzenia źródła atrybucji. Szczegółowe instrukcje znajdziesz później. Oto podsumowanie:

1. Rozpocznij rejestrację reguły. Użyj piksela lub wywołania fetch(), aby o żądanie.

2. Dokończ rejestrację reguły, odpowiadając za pomocą reguły. rejestracyjnym.

   Po otrzymaniu żądania piksela – wysłanego do punkt końcowy zdefiniowany w standardowym atrybucie src lub do punktu końcowego zdefiniowanego w attributionsrc, jeśli wybrano korzystanie z usługi attributionsrc wartość – odpowiedz nagłówkiem Attribution-Reporting-Register-Trigger.

   W tym nagłówku określ dane reguły, które mają być widoczne ogłoszone w ostateczności. Możesz ustawić ten nagłówek w dowolnej odpowiedzi. Jeśli jest to odpowiedź na żądanie wysłane z witryny, która zawiera destination, źródła będą dopasowane. Po odebraniu nagłówka przeglądarka szuka pasujących źródeł i planuje raport.

   Przykład raportów na poziomie zdarzenia:

   {
     "event_trigger_data": [{
       "trigger_data": "[unsigned 64-bit integer]",
       "priority": "[signed 64-bit integer]",
       "deduplication_key": "[unsigned 64-bit integer]"
     }]
   }
   

   Przykład raportów podsumowujących:

   {
     ... // existing fields, such as "event_trigger_data"
   
     "aggregatable_trigger_data": [
      {
        "key_piece": "0x400",
        "source_keys": ["campaignCounts"]
      },
      {
        "key_piece": "0xA80",
        "source_keys": ["geoValue", "nonMatchingKeyIdsAreIgnored"]
      }
     ],
     "aggregatable_values": {
       "campaignCounts": 32768,
       "geoValue": 1664
     }
   }
   

.

Uwaga: gdy przeglądarka otrzyma odpowiedź wywołującą atrybucję z adresu URL attributionsrc na danej stronie, następuje wyszukiwanie w pamięci lokalnej w celu znalezienia źródła pasującego zarówno do witryny źródłowej, jak i docelowej witryny, do której należy ta strona.attributionsrc W przypadku znalezienia wielu źródeł przeglądarka wybiera to, które zostało zapisane jako ostatnie – chyba że źródła mają różne priorytety, a przeglądarka wybiera to o najwyższym priorytecie.

Postępowanie z subdomenami

Jeśli destination to https://advertiser.example, konwersje z obu tych źródeł Przypisanie identyfikatora https://advertiser.example i jego subdomen, na przykład https://shop.advertiser.example, może być przypisane.

Jeśli destination to https://shop.advertiser.example, konwersje zarówno na https://advertiser.example, jak i Można przypisać udział w konwersji https://shop.advertiser.example.

Atrybuty wymagane i opcjonalne

Podczas rejestrowania reguł za pomocą elementów HTML lub wywołań JavaScript może być wymagane użycie funkcji attributionsrc lub attributionReporting. W tabeli poniżej znajdziesz szczegółowe informacje na temat tego, kiedy występują

Gdy parametr attributionsrc jest opcjonalny, użycie go wskazuje, że żądanie kwalifikuje się do raportowania atrybucji. Jeśli używasz attributionsrc, przeglądarka wysyła parametr Attribution-Reporting-Eligible. Przydaje się to też w przypadku połączeń z aplikacji do witryny, pomiar: jeśli jest podany attributionsrc, przeglądarka wysyła parametr Attribution-Reporting-Support.

Metoda rejestracji	Aktywator
Tag <a>	Nie dotyczy: kotwice nie mogą rejestrować reguł.
Tag <img>	Pole attributionsrc jest opcjonalne. W nagłówku wystarcza do zarejestrowania reguły.
Tag <script>	Pole attributionsrc jest opcjonalne. W nagłówku wystarcza do zarejestrowania reguły.
fetch komponent do wykonywania połączeń	Opcja attributionReporting to wymagane.
XMLHttpRequest	Opcja attributionReporting to wymagane.
window.open()	Nie dotyczy: window.open nie może zarejestrować aktywatora.

Krok 1. Rozpocznij rejestrację aktywatora

Możesz zarejestrować regułę za pomocą piksela (tagu <img>) lub tagu skryptu.

Używanie nowego lub istniejącego piksela konwersji

Ten przykład wyzwala atrybucję w przypadku istniejącego obrazu przez dodanie atrybutu attributionsrc.

Źródło dla attributionsrc musi być zgodne z punktem początkowym, które przeprowadzono rejestrację źródła.

<img src="https://advertiser.example/conversionpixel"
     attributionsrc="https://adtech.example/attribution_trigger?purchase=13">

Następny przykład wyzwala atrybucję poprzez dodanie nowego atrybutu piksela konwersji attributionsrc.

Źródło dla src musi być zgodne z punktem początkowym, które przeprowadzono rejestrację źródła.

<img src="https://adtech.example/conversionpixel"
     attributionsrc>

Ważne: W obu przypadkach atrybucję można uruchomić tylko na stronie, której witryna odpowiada witrynie podanej w miejscu docelowym w momencie rejestracji źródła.

Używanie tagu skryptu

Możesz przeprowadzić rejestrację reguły za pomocą tagu skryptu. działa tak samo jak <img>. W poniższych przykładach kodu ilustrujemy zastosowania fetch() i XMLHttpRequest() (XHR).

Ten kod skutecznie symuluje działanie żądania HTML z użyciem funkcji attributionsrc:

const attributionReporting = {
  eventSourceEligible: false,
  triggerEligible: true,
};

// Optionally set keepalive to ensure the request outlives the page.
window.fetch("https://adtech.example/attribution_source?my_ad_id=123",
  { keepalive: true, attributionReporting });

,

const attributionReporting = {
  eventSourceEligible: false,
  triggerEligible: true,
};

const req = new XMLHttpRequest();
req.open("GET", url);
req.setAttributionReporting(attributionReporting);
req.send();

Ważne:

• Źródło lub url ustawione w metodach fetch() lub open() musi być zgodne z punktem początkowym, które przeprowadzono rejestrację źródła.
• Pochodzenie atrybucji może zostać aktywowane tylko na stronie, której witryna odpowiada witrynie podanej w miejscu docelowym w momencie rejestracji źródła.

attributionsrc z wartością lub bez niej

attributionsrc możesz dodać z wartością lub bez niej.

<!-- Without a value -->
<img src="..." width="1" height="1" attributionsrc>

<!-- With a value (URL) -->
<img src="..." width="1" height="1" attributionsrc="https://...">

Jeśli ustawisz wartość attributionsrc, może to być co najmniej 1 adres URL oddzielony spacjami.

Użycie adresu URL powoduje, że przeglądarka zainicjuje osobne żądanie utrzymywania aktywności – jedno dla każdego adresu URL, który zawiera żądanie Attribution-Reporting-Eligible nagłówek.

Jest to przydatne, jeśli chcesz, aby rejestracja aktywatora odbywała się przez udzielenie odpowiedzi na które jest niezależne od głównego żądania elementu.

Jeśli np. musisz zarejestrować reguły dla elementu graficznego, możesz nie mieć kontroli nad odpowiedzią w postaci obrazu; W tym przypadku warto konfigurację, w której w odpowiedzi na żądanie wysyłasz nagłówek rejestracji aktywatora oddzielony od obrazu i nad którym masz pełną kontrolę. Według określona wartość dla attributionsrc, instruujesz i skonfigurować miejsce docelowe.

Krok 2. Odpowiedz nagłówkiem

Po otrzymaniu żądania przeglądarki odpowiedz i umieść w odpowiedzi nagłówek Attribution-Reporting-Register-Trigger:

JSON.stringify({
  event_trigger_data: [{
    trigger_data: "412444888111012",
    // Optional
    priority: "1000000000000",
    deduplication_key: "2345698765"
  }],
  debug_key: "1115698977"
});

Uwaga: wartość pola event_trigger_data musi być zagnieżdżona w nawiasach kwadratowych, ponieważ przeglądarka oczekuje tablicy JSON. Przydaje się to w przypadku filtrów.

Dalsze kroki

Dowiedz się, jak zarejestrować źródła atrybucji.