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 <a>
• Tag <img>
• Tag <script>
• fetch komponent do wykonywania połączeń
• XMLHttpRequest
• window.open

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. Aby wysłać żądanie, użyj piksela lub wywołania fetch().

2. Dokończ rejestrację aktywatora, odpowiadając, wysyłając nagłówek rejestracji wyzwalacza.
   
   

   Po otrzymaniu żądania piksela – wysłanego do punktu końcowego zdefiniowanego w zwykłym atrybucie src lub do punktu końcowego zdefiniowanego w attributionsrc, jeśli wybrano używanie attributionsrc i podałeś mu wartość – odpowiedz, używając nagłówka Attribution-Reporting-Register-Trigger.
   
   

   W tym nagłówku określ dane aktywatorów, które mają być ostatecznie widoczne w raportach. Możesz ustawić ten nagłówek w dowolnej odpowiedzi. O ile jest to odpowiedź na żądanie wysłane z witryny, która odpowiada atrybutowi destination, źródła będą dopasowywane. Po otrzymaniu nagłówka przeglądarka szuka pasujących źródeł i zaplanuje 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]"
     }]
   }
   ```
   
   **Example for summary reports:**
   
   ```json
   {
     ... // 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ź aktywatora atrybucji z adresu URL attributionsrc na danej stronie, przeprowadza się wyszukiwanie w pamięci lokalnej, aby znaleźć źródło pasujące zarówno do witryny źródłowej, jak i docelowej witryny, do której należy dana 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 ma wartość https://advertiser.example, można przypisywać konwersje zarówno w domenie https://advertiser.example, jak i w jej subdomenach, np. https://shop.advertiser.example.

Jeśli destination to https://shop.advertiser.example, można przypisywać konwersje zarówno https://advertiser.example, jak i https://shop.advertiser.example.

Atrybuty wymagane i opcjonalne

Jeśli używasz elementów HTML lub wykonujesz wywołania JavaScriptu do rejestrowania reguł, konieczne może być użycie attributionsrc lub attributionReporting. W tabeli poniżej znajdziesz szczegółowe informacje o tym, kiedy są one wymagane.

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

Metoda rejestracji	Aktywator
Tag <a>	Nie dotyczy Kotwice nie mogą rejestrować aktywatorów.
Tag <img>	Pole attributionsrc jest opcjonalne. Nagłówek wystarcza do zarejestrowania aktywatora.
Tag <script>	Pole attributionsrc jest opcjonalne. Nagłówek wystarcza do zarejestrowania aktywatora.
fetch komponent do wykonywania połączeń	Opcja attributionReporting jest wymagana.
XMLHttpRequest	Opcja attributionReporting jest wymagana.
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że zostać aktywowana tylko na stronie, której witryna odpowiada witrynie podanej w miejscu docelowym podczas rejestracji źródła.

Używanie tagu skryptu

Rejestrację reguły możesz przeprowadzić za pomocą tagu skryptu. Działa on 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:

// With fetch
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 });

// With XMLHttpRequest:
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, powinna to być pojedynczy adres URL.

Użycie adresu URL powoduje wysłanie przez przeglądarkę osobnego żądania utrzymywania aktywności – po jednym dla każdego adresu URL – zawierającego nagłówek żądania Attribution-Reporting-Eligible.

Jest to przydatne, gdy chcesz dokonać rejestracji źródła, odpowiadając na żądanie niezależne od głównego żądania elementu.

Jeśli na przykład musisz rejestrować źródła kliknięć elementu zakotwiczonego, możesz nie mieć kontroli nad miejscem docelowym. W takim przypadku potrzebujesz konfiguracji, która wysyła nagłówek rejestracji źródła jako odpowiedź na żądanie, które jest niezależne od nawigacji i nad którą masz całkowitą kontrolę. Określając jawną wartość dla attributionsrc, informujesz przeglądarkę, że ma wysłać to dodatkowe żądanie i skonfigurować jego 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.