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 śledzenia brane są pod uwagę tylko źródła, których zakresy atrybucji zawierają co najmniej jedną wartość zakresu atrybucji reguły. Jeśli w wyzwalaczu nie określisz zakresu, wszystkie źródła będą brane pod uwagę. 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. 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 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ą wyzwalacza
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 pasujących źródeł 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 je miejsce ich zastosowania w procedurze 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 obrazie widać grupę źródeł i wyzwalacz, które mają to samo miejsce docelowe, źródło raportowania i nie wygasły. 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 wyzwalaniaczy.
<img "activewear"="" "attribution="" "casualwear"="" "casualwear",="" "outerwear"="" "outerwear".="" "outerwear"."="" #1".the="" 1.="" 2.="" alt="An image showing 4 boxes labelled sources numbered 1 through 4 and a single box labelled " and="" attributes="" filter:="" first="" following="" fourth="" has="" priority:="" scope":="" second="" source="" src="/static/assets/images/attribution-scopes-example-1.png" the="" third="" title="Example on how attribution works with attribution scopes and filters" trigger="" />
Przed atrybucją
- Źródło 1 zostało odfiltrowane, ponieważ jego zakres atrybucji nie pasuje do zakresu reguły
casualwear. Najwyższy priorytet wśród wszystkich dostępnych źródeł nie zapobiega odfiltrowywaniu, 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 postu
- 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:
Podczas atrybucji
- Źródło 3 jest wybrane, ponieważ jego zakres atrybucji częściowo pokrywa się z zakresem atrybucji reguły.
Atrybucja postu
- Źródło 3 nie jest odrzucane, ponieważ jego filtr nakłada 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, który występuje przed atrybucją i pozostałymi sprawdzaniami atrybucji.
<img "attribution="" "attribution",="" "deactivation="" "filters="" "report="" "source="" "trigger="" alt="Przedstawia obraz uproszczonej wersji procesu atrybucji, w którym każdy krok jest przedstawiony jako kwadrat połączony z kolejnym krokiem za pomocą strzałki. Kolejność czynności to „and="" check",="" checks"="" generation"."="" matching",="" of="" other="" registration",="" scopes="" source="" sources",="" src="/static/assets/images/attribution-scopes-attribution-flow.png" title="Simplified attribution flow diagram" />
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 kolejne żądanie do źródła raportowania, 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, pochodzenie raportu i termin ważności.
- 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
- Więcej informacji o zakresie atrybucji znajdziesz w artykule na GitHubie wyjaśniającym filtrowanie przed atrybucją.
- Więcej informacji o filtrach znajdziesz w artykule Definiowanie reguł dotyczących klientów za pomocą filtrów.