Filtrowanie źródeł przed atrybucją za pomocą zakresów atrybucji

Zakresy atrybucji umożliwiają wywołującym interfejs API określenie listy ciągów podczas rejestracji źródła i wyzwalacza, które można wykorzystać do filtrowania przed przypisaniem atrybucji. Umożliwia to dokładniejsze filtrowanie, co zwiększa wydajność interfejsu API i daje większą elastyczność. Umożliwia np. oddzielne śledzenie różnych reklamodawców w tej samej witrynie. Ułatwia też śledzenie wielu kampanii lub produktów w ramach pojedynczego banera reklamowego.

Zakresy atrybucji to opcjonalne pola, które można ustawić podczas rejestracji źródła i wyzwalacza. Podczas przypisywania źródeł do atrybucji uwzględniane są tylko te źródła, których wartości zakresu atrybucji zawierają co najmniej jedną wartość zakresu atrybucji reguły. Jeśli w wyzwalaczu nie określisz zakresu, zostaną uwzględnione wszystkie źródła. Zanim przejdziesz dalej, zapoznaj się z interfejsem Attribution reporting API i filtrami wysokiego poziomu.

Podczas rejestracji źródła

Do nagłówka Attribution-Reporting-Register-Source dodawany jest opcjonalny parametr attribution_scopes, który zawiera 2 wymagane parametry: values i limit oraz 1 opcjonalny parametr: max_event_states.

  • limit: oznacza łączną liczbę różnych zakresów dozwolonych na miejsce docelowe dla źródła raportującego dane. Wszystkie istniejące zarejestrowane źródła o tym samym pochodzeniu i miejscu docelowym, ale z mniejszym limitem, zostaną usunięte.
  • values: zawiera listę zakresów atrybucji dla konkretnego źródła. Te wartości muszą być ciągami znaków o maksymalnej długości 50.
  • max_event_states (opcjonalnie): reprezentuje maksymalną liczbę stanów zdarzenia, których wywołujący interfejs API zamierza używać we wszystkich kolejnych rejestracjach źródeł zdarzeń. Pamiętaj, że wszystkie istniejące zarejestrowane źródła z tym samym miejscem wyjazdu i miejscem docelowym, ale z innym max_event_states value, zostaną usunięte. Wartością domyślną tego opcjonalnego pola jest 3.

Przykład rejestracji źródła

  Attribution-Reporting-Register-source: {
  //optional
  "attribution_scopes":{
  "limit": <int>,
  "values": <list of strings>,
  // optional
  "max_event_states": <int>
    },
  ...
  }

Podczas rejestracji reguły

Opcjonalny parametr attribution_scopes jest dodawany do nagłówka Attribution-Reporting-Register-Trigger podczas rejestracji reguły. Upewnij się, że wartość parametru to lista ciągów znaków reprezentujących zakresy działania reguły. Jeśli jest podany, reguła będzie pasować tylko do źródeł, których parametr wartości attribution_scopes zawiera co najmniej jeden z parametrów attribution_scopes reguły.

Przykład rejestracji za pomocą aktywatora

Attribution-Reporting-Register-Trigger: {
//optional
"attribution_scopes": <list of strings>,
...
}

Przykład zakresów atrybucji

Poniższy przykład pokazuje przypadek, w którym podczas korzystania z zakresów atrybucji wywołanie jest przypisywane do źródła.

Źródło rejestracji 1

  Attribution-Reporting-Register-source: {
  "destination": "https://trigger.example",
  "attribution_scopes": {
  "limit": 2,
  "values": ["advertiser1"],
  "max_event_states": 3
  },
  ...
  }

Rejestracja źródła 2

  Attribution-Reporting-Register-source: {
  "destination": "https://trigger.example",
  "attribution_scopes": {
  "limit": 2,
  "values": ["advertiser2"],
  "max_event_states": 3
  },
  ...
  }

Rejestracja wyzwalacza

  Attribution-Reporting-Register-Trigger: {
  "attribution_scopes": ["advertiser1"],
  ...
  }

Podczas rejestracji reguły interfejs API wybiera źródła, które mają być brane pod uwagę w ramach atrybucji i mają wartości atrybucji_zakresów, które pokrywają się z wartościami w rejestracji reguły. Rejestracje źródeł pasujących do domeny będą kontynuowane w ramach dalszego procesu przypisywania. W tym przykładzie wywołujący interfejs API otrzyma raport atrybucji, który przypisze rejestrację wywołania do rejestracji pierwszego źródła.

Zakresy atrybucji a filtry

Chociaż zakresy i filtry atrybucji mogą wydawać się podobne, różnią się tym, gdzie są stosowane w ramach procesu rejestracji reguły. Filtrowanie zakresów atrybucji ma miejsce przed atrybucją. Oznacza to, że zmniejsza pulę niewygasłych źródeł kandydatów, które mają ten sam cel i miejsce docelowe, na podstawie źródeł, których zakresy pokrywają się z zakresem określonym w aktywacjach. Filtry najwyższego poziomu są jednak stosowane po przypisaniu reguły do pojedynczego źródła. Jeśli filtry źródła i filtry reguły się nie pokrywają, nie są generowane żadne raporty.

Na tym obrazku widać grupę źródeł i wyzwalacz, które mają ten sam cel i źródło raportowania, a których nie minął jeszcze termin ważności. Krótko omówimy, jak używać zakresów i filtrów atrybucji oraz czy raport zostanie wygenerowany na podstawie dostępnych źródeł i wyzwalaczy.

4 pole z etykietą „źródło 1–4” i 1 pole z etykietą „wyzwalacz 1”. Pierwsze źródło ma te atrybuty: „Zakres atrybucji”: „Odzież sportowa” i „Priorytet”: 2. Drugie źródło ma atrybuty „Zakres atrybucji”: „Odzież sportowa” i „Filtr”: „Odzież wierzchnia”. Trzecie źródło ma atrybuty „Zakres atrybutu”: „Odzież nieformalna” i „Filtr”: „Odzież wierzchnia”. Czwarty źródło ma atrybuty „Zakres atrybucji”: „odzież nieformalna”, „Filtr”: „odzież wierzchnia” i „Priorytet”: 1. Aktywator ma atrybuty „Zakres atrybucji”: „Odzież nieformalna” i „Filtr”: „Odzież wierzchnia”.
Przykład działania atrybucji z użyciem zakresów i filtrów atrybucji

Przed atrybucją

  • Źródło 1 zostało odfiltrowane, ponieważ jego zakres atrybucji nie pasuje do zakresu reguły casualwear. Nawet najwyższy priorytet wśród wszystkich dostępnych źródeł nie zapobiega odfiltrowaniu źródła, ponieważ filtrowanie przed przypisaniem następuje przed sprawdzeniem priorytetów.
  • Źródło 2 jest również odfiltrowane, ponieważ nie ma tego samego zakresu co reguła. To źródło ma też ten sam filtr co reguła, ale filtry wysokiego poziomu są stosowane dopiero po atrybucji.

Podczas atrybucji

  • Źródło 3 nie jest wybrane do atrybucji, ponieważ ma niższą priorytet niż źródło 4.
  • Źródło 4 jest wybrane, ponieważ ma zakres atrybucji pasujący do reguły i najwyższy priorytet. Filtry wysokiego poziomu są stosowane po przypisaniu, więc nie mają wpływu na proces przypisywania.

Atrybucja postów

  • Nie generuje się raportu, ponieważ filtry wysokiego poziomu wybranego źródła (źródło 4) i filtry reguły się nie pokrywają.

W przypadku poprzedniego przykładu raport nie zostanie wygenerowany. Jeśli jednak czwarte źródło zostanie całkowicie usunięte:

Te same 4 pole z etykietami źródeł 1–4 i pojedyncze pole z etykietą „Trigger 1”. Różnica na tym obrazie polega na tym, że pole z etykietą „Źródło 4” jest przekreślone czerwonym X.
Zmodyfikowany przykład działania atrybucji z użyciem zakresów i filtrów atrybucji

Podczas atrybucji

  • Źródło 3 jest wybrane, ponieważ jego zakres atrybucji częściowo pokrywa się z zakresem atrybucji reguły.

Atrybucja postów

  • Źródło 3 nie jest odrzucane, ponieważ jego filtr pokrywa się z filtrem w regułach. Następnie atrybucja przechodzi przez pozostałe kontrole po atrybucji, a na końcu, jeśli przejdzie wszystkie kontrole, generowany jest raport.

Zakresy atrybucji zmniejszają liczbę źródeł uwzględnianych w ramach atrybucji. Pozostałe kroki dotyczące atrybucji są następnie stosowane do tego mniejszego zbioru źródeł, co może skutkować raportem.

Miejsce zakresów atrybucji w procesie atrybucji

Zakresy atrybucji są stosowane przed wybraniem źródła do atrybucji. Filtrowanie to ma też pierwszeństwo przed filtrami najwyższego poziomu i filtrowaniem w oknie raportu niestandardowego. Ten diagram przedstawia uproszczony ogólny proces atrybucji z zakresem atrybucji przed atrybucją i pozostałymi sprawdzaniami atrybucji.

Uproszczona wersja przepływu atrybucji z każdym krokiem przedstawionym jako kwadrat połączony ze strzałką z koleją. Kolejność czynności to „Rejestrowanie źródła”, „Rejestrowanie reguły”, „Dopasowywanie źródeł”, „Sprawdzanie zakresów atrybucji”, „Atrybuty”, „Sprawdzanie filtrów”, „Deaktywowanie innych źródeł”, „Sprawdzanie atrybucji” i „Generowanie raportu”.
Uproszczony proces atrybucji

Operacje związane z procesem atrybucji

Poniżej znajdziesz podsumowanie różnych operacji wykonywanych podczas przepływu atrybucji:

  • Rejestrowanie źródła: gdy użytkownik wchodzi w interakcję z reklamą w witrynie reklamodawcy, rejestrowane jest zdarzenie źródła. Następnie urządzenie wysyła żądanie do punktu końcowego źródła raportowania, który odpowiada nagłówkiem zawierającym dane źródłowe zdarzenia.
  • Rejestracja reguły: gdy w witrynie reklamodawcy nastąpi konwersja, zostanie zarejestrowane zdarzenie uruchamiające. Urządzenie wysyła kolejną prośbę do źródła raportu, które odpowiada nagłówkiem zawierającym dane zdarzenia wyzwalającego.
  • Dopasowywanie źródła: urządzenie dopasowuje zdarzenia źródła i wyzwalacza na podstawie takich kryteriów jak strona docelowa, raportowanie źródła i wygaśnięcie.
  • Sprawdzanie zakresów atrybucji: źródła są filtrowane na podstawie przecięcia wartości źródła i wartości atrybucji_zakresu reguły.
  • Atrybucja: jeśli pasuje kilka źródeł, urządzenie wybiera źródło o najwyższym priorytecie. Jeśli priorytety są równe, wybrany zostanie najnowszy.
  • Sprawdzanie filtrów: urządzenie porównuje filtry źródła i filtry wyzwalacza, aby określić, czy są one zgodne. Jeśli filtry nie pasują, przypisanie zostanie odrzucone.
  • Dezaktywowanie innych źródeł: jeśli filtry wybranego źródła pasują, urządzenie dezaktywuje źródła dopasowane na etapie dopasowywania źródeł. Dezaktywowane źródła to źródła, których zakres atrybucji nie pasuje do zakresu reguły.
  • Sprawdzanie po atrybucji: urządzenie wykonuje dodatkowe sprawdzenia wybranej atrybucji, np. sprawdza, czy źródło nie jest zaśmiecone fałszywymi raportami, czy nie ma duplikatów atrybucji za pomocą kluczy deduplikacji, czy wywołanie mieści się w oknie raportowania źródła i czy nie ma przekroczonych limitów szybkości.
  • Generowanie raportu: jeśli wszystkie kontrole się powiodą, urządzenie wygeneruje i zaplanuje raport atrybucji, który zostanie wysłany do punktu końcowego pochodzenia raportu.

Dalsze kroki