Większość reklamodawców współpracuje z kilkoma różnymi sieciami reklamowymi, aby wyświetlać reklamy w aplikacjach wydawców. Jeśli sieci reklamowe zarejestrują w interfejsie API własne źródła atrybucji i wyzwalacze, będą otrzymywać raporty o zdarzeniach i raporty zbiorcze z atrybucją własną.
Reklamodawcy, którzy chcą korzystać z usług zewnętrznych firm do atrybucji w wielu sieciach (XNA), aby określić jedną zwycięską reklamę dla danej konwersji, mogą nadal to robić, stosując te techniki:
- Skonfiguruj serwer wewnętrzny, aby rejestrować zdarzenia reguł i otrzymywać raporty o atrybucji z interfejsu API.
- dalszego używania obecnego partnera ds. pomiarów mobilnych,
Niezależnie od wybranej techniki interfejs Attribution Reporting API obsługuje wiele różnych funkcji, które umożliwiają zewnętrznemu dostawcy dostosowywanie logiki XNA w imieniu reklamodawcy:
- Atrybucję można przeprowadzić za pomocą interfejsu API z lub bez przekierowań z sieci reklamowych.
- Klucze priorytetu, filtry i usuwania duplikatów mogą zapewnić dodatkowe dostosowanie atrybucji na podstawie wymiarów źródła i wyzwalacza.
- Okna atrybucji po instalacji umożliwiają źródłom, które spowodowały instalację, dalsze uzyskiwanie udziału w przyszłych zdarzeniach konwersji w aplikacji.
Model atrybucji, którego technologie reklamowe używają do deduplikacji w różnych sieciach i wybierania zwycięskich źródeł, może mieć różny poziom złożoności w zależności od tego, jak wykorzystywane są te funkcje interfejsu API.
Poniższe przykłady ilustrują scenariusze, w których można używać tych funkcji, oraz pokazują, jak różne konfiguracje wpływają na to, które źródło atrybucji ostatecznie otrzymuje udział w przypadku danego zdarzenia wywołującego.
Proces
Poniżej znajdziesz listę kroków procesu XNA. Aby uprościć opis, w tym artykule założyliśmy, że reklamodawca używa technologii wyświetlania reklam do dostarczania reklam i platformy MMP do pomiaru konwersji. Projekt interfejsu API jest jednak elastyczny – funkcjonalność nie różni się w zależności od typu technologii reklamowej ani nie wymaga jej użycia.
- Rejestracja źródła: użytkownik wyświetla reklamę lub klika ją, a technologia wyświetlania reklam rejestruje te źródła w interfejsie API. Technologia reklamowa wyświetlająca reklamy może też przekierowywać do innych technologii reklamowych, które również mogą rejestrować źródła bezpośrednio w interfejsie API lub włączać atrybucję w wielu sieciach bez przekierowań.
- Rejestracja wyzwalacza: użytkownik wykonuje działanie związane z konwersją, np. pierwsze otwarcie aplikacji, zakup lub dodanie produktu do koszyka, po czym platforma MMP rejestruje wyzwalacz w interfejsie API. Platforma MMP może też przekierowywać do innych dostawców technologii reklamowych, którzy mogą rejestrować wyzwalacze bezpośrednio w interfejsie API. Jeśli platforma MMP musi włączyć atrybucję w różnych sieciach bez przekierowań, konfigurację atrybucji należy określić podczas rejestracji wyzwalacza.
- Atrybucja: jeśli podczas rejestracji aktywatora określono konfigurację atrybucji, źródła pochodne są generowane w imieniu platformy MMP. Każdy wyzwalacz jest dopasowywany do kwalifikującego się źródła zarejestrowanego bezpośrednio przez MMP lub do kwalifikującego się źródła pochodnego wygenerowanego w imieniu MMP przy użyciu źródeł technologii wyświetlania reklam. Pozostałe źródła, które nie uzyskały atrybucji, są odrzucane i nie mogą już uzyskać atrybucji w przypadku przyszłych konwersji. W innych częściach dokumentacji możesz też spotkać się z określeniem „stracisz raz, stracisz na zawsze”.
- Gdy źródło pochodne utraci atrybucję, interfejs API nie będzie generować kolejnych źródeł pochodnych na podstawie źródła pierwotnego, gdy platforma MMP zarejestruje przyszłe zdarzenia konwersji. Technologia wyświetlania reklam i inne platformy MMP mogą nadal używać pierwotnego źródła do przyszłej atrybucji. Szczegółowo opisujemy to w scenariuszu 6.
- Generowanie raportów: atrybucja prowadzi do generowania raportów o zdarzeniach lub raportów zbiorczych. Pamiętaj, że w przypadku źródeł pochodnych generowane są tylko raporty zbiorcze.
- Dostarczanie raportu: wygenerowane raporty są zaplanowane do dostarczenia.
Scenariusz 1. Atrybucja międzysieciowa z przekierowaniami
Reklamodawca korzysta z 2 technologii wyświetlania reklam i 1 platformy MMP. Gdy użytkownik kliknie reklamy wyświetlane przez technologie reklamowe, technologie te przekierują go do platformy MMP w momencie rejestracji źródła. Gdy użytkownik dokona konwersji w aplikacji, platforma MMP przekieruje go do dostawców technologii reklamowych w momencie rejestracji wywołania.
Platforma MMP otrzyma raport po usunięciu duplikatów z różnych sieci, a każdy dostawca technologii reklamowej wyświetlający reklamy otrzyma raporty o atrybucji własnej.
Oś czasu rejestracji
W momencie t0 użytkownik klika reklamę wyświetloną przez dostawcę technologii reklamowych ad-tech1, który rejestruje źródło Source1 wraz z przekierowaniem Source2 przez mmp-ad-tech:
"Attribution-Reporting-Register-Source": {
"source_event_id": "34532",
"web_destination": "https://destination.example.com",
"priority": "10",
"expiry": "172800",
"aggregation_keys": {
"campaignCounts": "0x1"
}
},
"Attribution-Reporting-Redirect": [
"https://www.mmp-ad-tech.com/source2"
]
// Registered by mmp-ad-tech using redirects
"Attribution-Reporting-Register-Source": {
"source_event_id": "788324",
"web_destination": "https://destination.example.com",
"priority": "30",
"expiry": "172800",
"aggregation_keys": {
"campaignCounts": "0x2",
"geoValue": "0x102"
}
}
W momencie t1 użytkownik klika reklamę wyświetloną przez ad-tech2, aby zarejestrować Source3 wraz z przekierowaniem do mmp-ad-tech (Source4):
"Attribution-Reporting-Register-Source": {
"source_event_id": "6574435",
"web_destination": "https://destination.example.com",
"priority": "10",
"expiry": "172800",
"aggregation_keys": {
"campaignCounts": "0x3"
}
},
"Attribution-Reporting-Redirect": [
"https://www.mmp-ad-tech.com/source"
]
// Registered by mmp-ad-tech using redirects
"Attribution-Reporting-Register-Source": {
"source_event_id": "4532343",
"web_destination": "https://destination.example.com",
"priority": "20",
"expiry": "172800",
"aggregation_keys": {
"campaignCounts": "0x4"
}
}
W momencie t2 działanie użytkownika lub konwersja w aplikacji reklamodawcy powoduje rejestrację wywołania przez mmp-ad-tech (Trigger1), który przekierowuje też do ad-tech1 (Trigger2) i ad-tech2 (Trigger3):
nie zdefiniowano
Wynik
Zarejestrowane źródła mmp-ad-tech Source2 i Source4 konkurują w atrybucji dla zarejestrowanego aktywatora mmp-ad-tech Trigger1. Źródło2 ma wyższy priorytet niż Źródło4. Trigger2 od ad-tech1 jest przypisywany do Source1 od ad-tech1, a Trigger3 od ad-tech2 jest przypisywany do Source3 od ad-tech2.
Konkurencyjne źródła
Pola |
Source1 |
Source2 |
Source3 |
Source4 |
Źródło rejestrujące technologię reklamową |
ad-tech1 |
mmp-ad-tech |
ad-tech2 |
mmp-ad-tech |
source_event_id |
34532 |
788324 |
6574435 |
4532343 |
miejsce docelowe |
https://destination.example.com |
https://destination.example.com |
https://destination.example.com |
https://destination.example.com |
priorytet |
10 |
30 |
10 |
20 |
Zarejestrowane aktywatory
Wynik atrybucji
Atrybuty aktywatora 1 do Źródła 2, atrybuty aktywatora 2 do Źródła 1 i atrybuty aktywatora 3 do Źródła 3.
Atrybucja po uwzględnieniu zignorowanych źródeł
Source4 – w przyszłości nie będzie konkurować o atrybucję.
Raporty o zdarzeniach
URL raportu: https://www.mmp-ad-tech.com/.well-known/attribution-reporting/report-event-attribution
{
"attribution_destination": "https://destination.example.com",
"scheduled_report_time": "800176400",
"source_event_id": "788324",
"trigger_data": "1",
"source_type": "navigation",
"randomized_trigger_rate": 0.0024263
}
Adres URL raportu: https://www.ad-tech1.com/.well-known/attribution-reporting/report-event-attribution
{
"attribution_destination": "https://destination.example.com",
"scheduled_report_time": "800176400",
"source_event_id": "34532",
"trigger_data": "2",
"source_type": "navigation",
"randomized_trigger_rate": 0.0024263
}
Adres URL raportu: https://www.ad-tech2.com/.well-known/attribution-reporting/report-event-attribution
{
"attribution_destination": "https://destination.example.com",
"scheduled_report_time": "800176400",
"source_event_id": "6574435",
"trigger_data": "3",
"source_type": "navigation",
"randomized_trigger_rate": 0.0024263
}
Raporty zagregowane
Adres URL raportu: https://www.mmp-ad-tech.com/.well-known/attribution-reporting/report-aggregate-attribution
{
"attribution_destination": "https://destination.example.com",
"histograms": [
{
"key": "0x104",
"value": 11
}
]
}
Adres URL raportu: https://www.ad-tech1.com/.well-known/attribution-reporting/report-aggregate-attribution
{
"attribution_destination": "https://destination.example.com",
"histograms": [
{
"key": "0x201",
"value": 21
}
]
}
Adres URL raportu: https://www.ad-tech2.com/.well-known/attribution-reporting/report-aggregate-attribution
{
"attribution_destination": "https://destination.example.com",
"histograms": [
{
"key": "0x303",
"value": 31
}
]
}
Scenariusz 2. Atrybucja międzysieciowa bez przekierowań
Reklamodawca korzysta z 2 technologii wyświetlania reklam i 1 platformy MMP. Użytkownik klika reklamę z pierwszej platformy reklamowej, która przekierowuje go do MMP w celu rejestracji źródła. Gdy użytkownik kliknie reklamę z drugiego systemu reklamowego, system ten nie przekierowuje użytkownika, ale z wyprzedzeniem udostępnia MMP podzbiór kluczy agregacji.
Użytkownik dokonuje konwersji w aplikacji, w której platforma MMP rejestruje wywołanie, ale nie przekierowuje do żadnej z technologii reklamowych. Technologia reklamowa, która nie przekierowuje, uzyskuje atrybucję ostatniego kontaktu. Tylko platforma MMP otrzyma podsumowujący raport o konwersjach po usunięciu duplikatów z różnych sieci, który będzie zawierać tę konwersję.
Oś czasu rejestracji
W momencie t0 użytkownik klika reklamę, co powoduje rejestrację w usłudze Źródło1 przez ad-tech1 i rejestrację w usłudze Źródło2 przez mmp-ad-tech za pomocą przekierowania z ad-tech1:
"Attribution-Reporting-Register-Source": {
"source_event_id": "234543",
"web_destination": "https://destination.example.com",
"priority": "20",
"expiry": "172801",
"aggregation_keys": {
"campaignCounts": "0x159"
}
},
"Attribution-Reporting-Redirect": [
"http://www.mmp-ad-tech.com"
]
// Registered by mmp-ad-tech using redirect
"Attribution-Reporting-Register-Source": {
"source_event_id": "45453",
"web_destination": "https://destination.example.com",
"priority": "100",
"expiry": "172801",
"aggregation_keys": {
"campaignCounts": "0x159",
"geoValue": "0x5",
}
}
W momencie t1 użytkownik klika inną reklamę, co powoduje, że źródło Source3 jest powiązane z technologią reklamową ad-tech2, która udostępnia klucze agregacji:
// Registered by ad-tech2
"Attribution-Reporting-Register-Source": {
"source_event_id": "978",
"web_destination": "https://destination.example.com",
"priority": "20",
"expiry": "172801",
"aggregation_keys": {
"campaignCounts": "0x159",
"geoValue": "0x5"
},
"shared_aggregation_keys": [
"campaignCounts"
]
}
W momencie t2 działanie lub konwersja użytkownika powoduje rejestrację wywołania przez mmp-ad-tech, który zawiera konfigurację atrybucji dla ad-tech2:
"Attribution-Reporting-Register-Trigger": {
"event_trigger_data": [
{
"trigger_data": "2",
"priority": "101"
}
],
"aggregatable_trigger_data": [
{
"key_piece": "0x400",
"source_keys": [
"campaignCounts"
],
"x_network_data": {
"key_offset": 10
}
}
],
"aggregatable_values": {
"campaignCounts": 32768
},
"attribution_config": [
{
"source_network": "enrollment-id-ad-tech-2",
"source_priority_range": {
"start": 1,
"end": 1000
},
"priority": "200",
"expiry": "172800"
}
],
"x_network_key_mapping": {
"enrollment-id-ad-tech-2": "0x4"
}
}
Wynik
Source2 dopasowuje rejestrację i miejsce docelowe do aktywatora, dzięki czemu staje się konkurencyjnym źródłem atrybucji. Dodatkowo podczas rejestracji wyzwalacza określono konfigurację atrybucji dla dostawcy technologii reklamowych 2 i źródła 3, używając kluczy agregacji udostępnianych przez dostawcę technologii reklamowych 2. Umożliwia to wygenerowanie źródła pochodnego, Source3', jako konkurencyjnego źródła na potrzeby atrybucji.
Konkurencyjne źródła
Pola |
Source2 |
Źródło3' |
Rejestrowanie technologii reklamowych przez pierwotne źródło |
mmp-ad-tech |
ad-tech2 |
source_event_id |
45453 |
978 |
priorytet |
100 |
200 |
Zarejestrowane aktywatory
Trigger1 od mmp-ad-tech.
Wynik atrybucji
Zdarzenie Trigger1 zostanie przypisane do źródła Source3', ponieważ ma ono wyższy priorytet niż Source2.
Atrybucja po uwzględnieniu zignorowanych źródeł
Source2
Raporty o zdarzeniach
Brak – w przypadku źródeł pochodnych nie są generowane raporty o zdarzeniach.
Raporty zbiorcze
Źródło nadrzędne Źródła3, czyli Źródło3, udostępnia tylko campaignCounts, a kluczowy element wyzwalacza jest obliczany w ten sposób:
(key_piece value) | ((x_network_key_mapping entry) << offset)
0x400 | (0x4 << 10) = 0x1400
Klucz wynikowy jest generowany przez wykonanie operacji OR na kluczu wyzwalającym (0x1400) i kluczu źródłowym (0x159), co daje wartość 0x1559.
Adres URL raportu: http://www.mmp-ad-tech.com/.well-known/attribution-reporting/report-aggregate-attribution
{
"attribution_destination": "https://destination.example.com",
"histograms": [
{
"key": "0x1559",
"value": 32768
}
]
}
Scenariusz 3. Zarejestrowane źródło MMP i kandydat na element nadrzędny źródła pochodnego w tym samym łańcuchu rejestracji
Reklamodawca korzysta z 2 technologii wyświetlania reklam i 1 platformy MMP. Użytkownik klika reklamę z pierwszej platformy reklamowej, która nie przekierowuje użytkownika podczas rejestracji źródła, ale udostępnia klucze agregacji platformie MMP. Użytkownik klika reklamę z drugiej technologii wyświetlania reklam, która przekierowuje do platformy MMP podczas rejestracji źródła i udostępnia jej klucze agregacji.
Oś czasu rejestracji
W momencie t0 użytkownik klika reklamę wyświetloną przez platformę reklamową 1, co rozpoczyna rejestrację źródła 1:
"Attribution-Reporting-Register-Source": {
"source_event_id": "52343",
"web_destination": "https://destination.example.com",
"priority": "20",
"expiry": "172800",
"aggregation_keys": {
"campaignCounts": "0x159",
"geoValue": "0x5"
},
"shared_aggregation_keys": [
"campaignCounts",
"geoValue"
]
}
W momencie t1 w łańcuchu rejestracji 2 platforma ad-tech2 rejestruje źródło Source2 i przekierowuje do rejestracji źródła MMP, Source3:
"Attribution-Reporting-Register-Source": {
"source_event_id": "234456",
"web_destination": "https://destination.example.com",
"priority": "20",
"expiry": "172801",
"aggregation_keys": {
"campaignCounts": "0x159"
},
"shared_aggregation_keys": [
"campaignCounts"
]
},
"Attribution-Reporting-Redirect": [
"http://www.mmp-ad-tech.com"
]
"Attribution-Reporting-Register-Source": {
"source_event_id": "4234",
"web_destination": "https://destination.example.com",
"priority": "100",
"expiry": "172800",
"aggregation_keys": {
"campaignCounts": "0x159"
}
}
W momencie t2 rejestracja aktywatora ma skonfigurowaną atrybucję, która generuje źródła pochodne z technologii reklamowych 1 i 2:
"Attribution-Reporting-Register-Trigger": {
"event_trigger_data": [
{
"trigger_data": "2",
"priority": "101"
}
],
"aggregatable_trigger_data": [
{
"key_piece": "0x400",
"source_keys": [
"campaignCounts"
],
"x_network_data" : {
"key_offset" : 10
}
}
],
"aggregatable_values": {
"campaignCounts": 32768,
"geoValue": 1664
},
"attribution_config": [
{
"source_network": "enrollment-id-ad-tech-1",
"source_priority_range": {
"start": 1,
"end": 1000
},
"priority": "20",
"expiry": "172800"
},
{
"source_network": "enrollment-id-ad-tech-2",
"source_priority_range": {
"start": 1,
"end": 1000
},
"priority": "20",
"expiry": "172800"
}
],
"x_network_key_mapping" : {
"enrollment-id-ad-tech-1" : "0x2",
"enrollment-id-ad-tech-2" : "0x4"
}
}
W rezultacie atrybucję uzyskuje źródło zarejestrowane w platformie MMP w drugim łańcuchu rejestracji. Wynikowy raport zbiorczy będzie wyglądał mniej więcej tak:
Wynik
Źródło pochodne ze źródła 2 (z wartością „source_event_id": "234456”) nie bierze udziału w atrybucji, ponieważ w tym samym łańcuchu rejestracji znajduje się też zarejestrowane źródło mmp-ad-tech.
Konkurencyjne źródła
Pola |
Źródło1' |
Source3 |
Rejestracja technologii reklamowej przez pierwotne źródło |
ad-tech1 |
mmp-ad-tech |
source_event_id |
52343 |
4234 |
priorytet |
20 |
100 |
Zarejestrowane aktywatory
Trigger1 od mmp-ad-tech.
Wynik atrybucji
Wyzwalacz1 zostanie przypisany do źródła Source3, ponieważ ma ono wyższy priorytet niż Source1.
Atrybucja po uwzględnieniu zignorowanych źródeł
Source1' – źródło Source1 nie będzie już brane pod uwagę przy tworzeniu źródła pochodnego dla mmp-ad-tech.
Raporty o zdarzeniach
Adres URL raportu: https://www.ad-tech1.com/.well-known/attribution-reporting/report-event-attribution
{
"attribution_destination": "https://destination.example.com",
"scheduled_report_time": "800176400",
"source_event_id": "4234",
"trigger_data": "2",
"source_type": "navigation",
"randomized_trigger_rate": 0.0024263
}
Raporty zbiorcze
Adres URL raportu: http://www.mmp-ad-tech.com/.well-known/attribution-reporting/report-aggregate-attribution
{
"report_url": "http://www.mmp-example.com",
"payload": {
"attribution_destination": "https://destination.example.com",
"histograms": [
{
"key": "0x559"
"value": 32768
}
]
}
}
Scenariusz 4. Atrybucja w różnych sieciach bez przekierowań z kryteriami wyboru źródła
Reklamodawca korzysta z 4 technologii wyświetlania reklam i 1 platformy MMP. Użytkownik klika reklamę z 1 technologii wyświetlania reklam i wyświetla reklamy z pozostałych 3. Gdy użytkownik dokona konwersji w aplikacji reklamodawcy, MMP rejestruje wywołanie i określa, które zarejestrowane źródła technologii wyświetlania reklam mają być użyte do utworzenia źródeł pochodnych na podstawie tych filtrów:
- priority_range: wybierz źródła o priorytecie w podanym zakresie.
- expiry: wybierz źródła, których ważność wygasa po określonym czasie;
- source_filters: wybierz źródła, których dane filtra pasują do określonych filtrów źródła.
- source_not_filters: wybierz źródła, których not_filters pasują do określonych source_not_filters;
Gdy źródła pochodne zostaną wygenerowane na podstawie kryteriów, mogą brać udział w atrybucji.
Harmonogram rejestracji
W momencie t0 użytkownik klika, co powoduje, że technologia reklamowa1 rejestruje źródło Source1, które przypisuje source_type jako nawigację do tego zarejestrowanego źródła:
"Attribution-Reporting-Register-Source": {
"source_event_id": "87456",
"web_destination": "https://destination.example.com",
"priority": "20",
"expiry": "172801",
"filter_data": {
"filter1": [
"does_not_matter"
],
"filter2": [
"non-match"
]
},
"aggregation_keys": {
"campaignCounts": "0x119",
"geoValue": "0x5"
},
"shared_aggregation_keys": [
"campaignCounts",
"geoValue"
]
}
W momencie t1 użytkownik wyświetla reklamę, co powoduje, że technologia reklamowa 2 rejestruje źródło Source2, które przypisuje do tego zarejestrowanego źródła typ źródła event:
"Attribution-Reporting-Register-Source": {
"source_event_id": "9078",
"web_destination": "https://destination.example.com",
"priority": "2000",
"expiry": "172801",
"filter_data": {
"filter1": [
"does_not_matter"
],
"filter2": [
"match"
]
},
"aggregation_keys": {
"campaignCounts": "0x129",
"geoValue": "0x5"
},
"shared_aggregation_keys": [
"campaignCounts",
"geoValue"
]
}
W momencie t2 wyświetlenie przez użytkownika powoduje zarejestrowanie przez technologię reklamową 3 źródła Source3, które przypisuje do tego zarejestrowanego źródła typ źródła jako zdarzenie:
"Attribution-Reporting-Register-Source": {
"source_event_id": "2413",
"web_destination": "https://destination.example.com",
"priority": "20",
"filter_data": {
"filter1": [
"non-match"
],
"filter2": [
"non-match"
]
},
"aggregation_keys": {
"campaignCounts": "0x159",
"geoValue": "0x5"
},
"shared_aggregation_keys": [
"campaignCounts",
"geoValue"
]
}
W momencie t3 wyświetlenie przez użytkownika powoduje zarejestrowanie przez technologię reklamową4 źródła Źródło4, które przypisuje do tego zarejestrowanego źródła typ źródła jako zdarzenie:
"Attribution-Reporting-Register-Source": {
"source_event_id": "7567",
"web_destination": "https://destination.example.com",
"priority": "20",
"filter_data": {
"filter1": [
"match"
],
"filter2": [
"match"
]
},
"aggregation_keys": {
"campaignCounts": "0x169",
"geoValue": "0x5"
},
"shared_aggregation_keys": [
"campaignCounts",
"geoValue"
]
}
W momencie t4 konwersja użytkownika powoduje, że platforma MMP-ad-tech rejestruje wyzwalacz z konfiguracją atrybucji dla wszystkich innych wymienionych wcześniej źródeł zarejestrowanych przez platformy ad-tech:
"Attribution-Reporting-Register-Trigger": {
"event_trigger_data": [
{
"trigger_data": "2",
"priority": "100"
}
],
"aggregatable_trigger_data": [
{
"key_piece": "0x400",
"source_keys": [
"campaignCounts"
]
}
],
"aggregatable_values": {
"campaignCounts": 32768,
"geoValue": 1664
},
"attribution_config": [
{
"source_network": "enrollment-id-ad-tech-1",
"source_priority_range": {
"start": 1,
"end": 100
},
"source_filters": {
"source_type": [
"event"
]
},
"priority": "100",
"expiry": "172801"
},
{
"source_network": "enrollment-id-ad-tech-2",
"source_priority_range": {
"start": 1,
"end": 1000
},
"source_filters": {
"source_type": [
"navigation"
]
},
"priority": "100",
"expiry": "172801"
},
{
"source_network": "enrollment-id-ad-tech-3",
"source_priority_range": {
"start": 1,
"end": 1000
},
"source_filters": {
"source_type": [
"navigation"
],
"filter1": [
"match"
],
"filter2": [
"match"
]
},
"priority": "50",
"expiry": "172801"
},
{
"source_network": "enrollment-id-ad-tech-4",
"source_priority_range": {
"start": 1,
"end": 1000
},
"source_filters": {
"source_type": [
"navigation"
],
"filter1": [
"match"
],
"filter2": [
"match"
]
},
"priority": "30",
"expiry": "172801"
}
],
"x_network_key_mapping": {
"enrollment-id-ad-tech-1": "0x1",
"enrollment-id-ad-tech-2": "0x2",
"enrollment-id-ad-tech-3": "0x3",
"enrollment-id-ad-tech-4": "0x4"
}
}
Wynik
Te źródła nie kwalifikują się do generowania źródeł pochodnych z powodu niezgodności z kryteriami:
- Źródło1 nie spełnia warunków filtra
source_type:eventw konfiguracji atrybucji platformy ad-tech1 - Źródło 2 ma priorytet ustawiony na 2000, co wykracza poza zakres filtra priorytetu technologii reklamowej 2 (1–1000).
- Source3 nie pasuje do wartości parametru
filter2
Konkurencyjne źródła
Pola |
Źródło4' |
Technologia reklamowa rejestrująca pierwotne źródło |
ad-tech4 |
source_event_id |
7567 |
miejsce docelowe |
https://destination.example.com |
priorytet |
30 |
wygasa |
Czas rejestracji + 2 dni |
Zarejestrowane aktywatory
Trigger1 od mmp-ad-tech.
Wynik atrybucji
Aktywator1 jest przypisywany do „Źródła4”, ponieważ jest to jedyne źródło kwalifikujące się do atrybucji.
Atrybucja po uwzględnieniu zignorowanych źródeł
Brak
Raporty o zdarzeniach
Brak – w przypadku zwycięzcy pochodzącego ze źródła pochodnego nie są generowane raporty o zdarzeniach.
Raporty zbiorcze
Adres URL raportu: http://www.mmp-ad-tech.com
{
"attribution_destination": "https://example.com",
"histograms": [
{
"key": "0x56d",
"value": 32768
},
{
"key": "0x5",
"value": 1664
}
]
}
Scenariusz 5. Atrybucja po instalacji
Reklamodawca korzysta z 2 technologii wyświetlania reklam i 1 platformy MMP. Użytkownik klika reklamę z pierwszej platformy reklamowej i instaluje aplikację reklamodawcy. Podczas atrybucji konwersji po instalacji źródło pochodne z atrybucją instalacji ma pierwszeństwo przed innymi źródłami, nawet jeśli mają one wyższe priorytety.
Harmonogram rejestracji
W momencie t0 interakcja użytkownika powoduje, że platforma ad-tech1 rejestruje Source1:
"Attribution-Reporting-Register-Source": {
"source_event_id": "3645",
"destination": "android-app://com.example.app",
"priority": "20",
"expiry": "172801",
"install_attribution_window": "86400",
"post_install_exclusivity_window": "864000",
"aggregation_keys": {
"campaignCounts": "0x119",
"geoValue": "0x5"
},
"shared_aggregation_keys": [
"campaignCounts",
"geoValue"
]
}
W momencie t1 użytkownik instaluje aplikację com.example.app na swoim urządzeniu.
W momencie t2 interakcja użytkownika powoduje, że technologia reklamowa 2 rejestruje źródło 2:
"Attribution-Reporting-Register-Source": {
"source_event_id": "345789",
"destination": "android-app://com.example.app",
"priority": "100",
"aggregation_keys": {
"campaignCounts": "0x159",
"geoValue": "0x5"
},
"shared_aggregation_keys": [
"campaignCounts",
"geoValue"
]
}
W momencie t3 moduł mmp-ad-tech rejestruje wywołanie z konfiguracjami atrybucji dla dostawców ad-tech1 i ad-tech2:
"Attribution-Reporting-Register-Trigger": {
"event_trigger_data": [
{
"trigger_data": "2",
"priority": "100"
}
],
"aggregatable_trigger_data": [
{
"key_piece": "0x400",
"source_keys": [
"campaignCounts"
]
}
],
"aggregatable_values": {
"campaignCounts": 32768,
"geoValue": 1664
},
"attribution_config": [
{
"source_network": "enrollment-id-ad-tech-1",
"priority": "10",
"expiry": "172801",
"post_install_exclusivity_window": "172800"
},
{
"source_network": "enrollment-id-ad-tech-2",
"priority": "20",
"expiry": "172801"
}
],
"x_network_key_mapping": {
"enrollment-id-ad-tech-1": "0x1",
"enrollment-id-ad-tech-2": "0x3"
}
}
Wynik
Wygenerowane źródła pochodne ze Źródła 1 i Źródła 2 (odpowiednio Źródło 1′ i Źródło 2′), które konkurują o atrybucję.
Konkurencyjne źródła
Pola |
Źródło1' |
Źródło2' |
Rejestracja technologii reklamowej przez pierwotne źródło |
ad-tech1 |
ad-tech2 |
source_event_id |
3645 |
345789 |
miejsce docelowe |
android-app://com.example.app |
android-app://com.example.app |
priorytet |
10 |
20 |
Zwiększanie liczby instalacji aplikacji |
tak |
nie |
Zarejestrowane aktywatory
Trigger1 od mmp-ad-tech.
Wynik atrybucji
Wyzwalacz1 jest przypisywany do „Source1”, ponieważ spowodował instalację aplikacji docelowej. Pamiętaj, że Source2 miał wyższy priorytet.
Atrybucja po uwzględnieniu zignorowanych źródeł
Source2' – źródła pochodne z Source2 nie będą uwzględniane w atrybucji w przypadku żadnych wyzwalaczy zarejestrowanych przez mmp-ad-tech.
Raporty o zdarzeniach
Brak – w przypadku zwycięzcy pochodzącego ze źródła pochodnego nie są generowane raporty o zdarzeniach.
Raporty zbiorcze
Adres URL raportu: http://www.mmp-ad-tech.com/.well-known/attribution-reporting/report-aggregate-attribution
{
"attribution_destination": "android-app://com.example.app",
"histograms": [
{
"key": "0x519",
"value": 32768
},
{
"key": "0x5",
"value": 1664
}
]
}
Scenariusz 6. Jedna przegrana oznacza przegraną na zawsze
Jeśli źródło technologii reklamowej 1 ma źródło, którego źródło pochodne brało udział w atrybucji wywołanej przez technologię reklamową mmp i utraciło atrybucję, źródło technologii reklamowej 1 nie jest już używane do tworzenia źródła pochodnego dla wywołań technologii reklamowej mmp. Oto przykładowa oś czasu:
- W momencie t0 źródło Source1 platformy ad-tech1 jest zarejestrowane w usłudze
"priority": "10". - W momencie t1 źródło Source2 platformy ad-tech2 jest zarejestrowane w usłudze
"priority": "20". - W momencie t2 wywołanie Trigger1 dostawcy mmp-ad-tech jest zarejestrowane w konfiguracjach atrybucji dostawców ad-tech1 i ad-tech2.
- W momencie t3 atrybucja dla aktywatora Trigger1 następuje w miejscu, w którym źródło pochodne z technologii reklamowej 2 wygrywa atrybucję, a źródło technologii reklamowej 1 jest ignorowane.
- W momencie t4 źródło Source3 platformy ad-tech3 jest zarejestrowane w usłudze
"priority": "5". - W momencie t5 funkcja Trigger2 dostawcy mmp-ad-tech jest zarejestrowana w konfiguracjach dostawców ad-tech1 i ad-tech3.
- W momencie t6 następuje atrybucja aktywatora Trigger2, w której wygrywa źródło pochodne z Source3 (Source3’).
Wyjaśnienie wyników
Źródło pochodne ze źródła platformy reklamowej 1 utraciło atrybucję dla aktywatora 1, więc źródło 1 nie zostało użyte do utworzenia źródła pochodnego na potrzeby atrybucji aktywatora 2. Gdyby nie przegrało wcześniej w momencie t3, wygrałoby ze źródłem ad-tech3 ze względu na wyższy priorytet.