Interfejs Attribution Reporting API umożliwia atrybucję w przypadku źródeł w różnych aplikacjach i w internecie i wyzwalaczy, które występują na tym samym urządzeniu. Przeglądarki takie jak Chrome, może przekazać rejestracje źródłowe i aktywatory do funkcji raportowania atrybucji API for Android, zamiast obsługiwać te rejestracje w przeglądarce. Dzięki temu Android może dopasowywać źródła i reguły w witrynach i aplikacjach.
Z tego przewodnika dowiesz się, jak skonfigurować atrybucję w różnych aplikacjach i w internecie.
Przy konfigurowaniu atrybucji w różnych aplikacjach i witrynach zdecydowanie zalecamy zapoznaj się z dostępnymi rozwiązaniami do debugowania, aby mieć pewność, że działa zgodnie z oczekiwaniami.
Rejestrowanie źródeł i aktywatorów w systemie operacyjnym Android
Atrybucja w różnych aplikacjach i w internecie będzie dostępna tylko wtedy, gdy Interfejs API do raportowania jest włączony zarówno w przeglądarce, jak i w systemie operacyjnym Android urządzenia. Informacje o dostępności interfejsu Android Attribution Reporting API są wysyłane o nagłówku Attribution-Reporting-Support. Ten nagłówek zwróci system operacyjny, internet lub jedno i drugie, w zależności od tego, co jest dostępne na danym urządzeniu. Jeśli oba specjaliści ds. technologii reklamowych będą mogli zarejestrować źródła internetowe i uruchamia się albo w przeglądarce albo w systemie operacyjnym.
Technologia reklamowa musi zdecydować, czy zarejestrować źródło internetowe czy regułę internetową przeglądarki lub systemu operacyjnego.
- W przypadku kampanii kierowanych tylko na strony internetowe specjaliści ds. technologii reklamowych mogą nadal rejestrować zarówno źródła, jak i reguły za pomocą interfejsu Attribution Reporting API w Chrome lub przekazać oba ustawienia do systemu operacyjnego. W przypadku kampanii tylko w internecie, w których źródłem lub wyzwalaczem może być tag WebView, technologie reklamowe muszą przekazać zarówno źródło, jak i aktywowanie rejestracji do oraz system operacyjny. Więcej informacji znajdziesz w sekcji o komponentach WebView.
- Technologie reklamowe nie powinny rejestrować źródeł i reguł w Chrome i API Androida, by uniknąć tworzenia powielonych atrybucji. raportów.
- Atrybucja odbywa się oddzielnie dla przeglądarek i systemu operacyjnego. Jeśli źródło to zarejestrowane w przeglądarce, ale aktywator jest zarejestrowany w systemie operacyjnym, i odwrotnie.
- W przypadku źródeł, które mogą prowadzić do działania aplikacji lub reguły witryny, jest zalecany dla technologii reklamowych w celu przekazywania źródeł internetowych i uruchamiania rejestracji Android Attribution Reporting API.
- W przypadku reguł, które mogły zostać spowodowane przez źródła oparte na aplikacjach, technologia reklamowa może wybrać przekazanie rejestracji aktywatora na stronie Android Attribution Reporting API.
- W przypadku kampanii, w których zarówno źródło, jak i reguła mają miejsce w aplikacji, muszą być zarejestrowane w OS Attribution Reporting API.
Rejestrowanie źródła aplikacji i aktywatora internetowego
W przypadku niektórych kampanii źródło może występować w aplikacji w czasie, gdy reguła będzie występować w aplikacji na stronie internetowej w przeglądarce mobilnej na tym samym urządzeniu.
Przykład
Użytkownik czyta artykuły w ulubionej aplikacji z wiadomościami. Widzi reklamę taniej loty do Paryża i chętnie je zarezerwują. Technologia reklamowa wyświetlająca reklamę w aplikacja z wiadomościami rejestruje źródło kliknięcia za pomocą interfejsu Android Attribution Reporting API. Użytkownik zostanie przekierowany na stronę internetową reklamodawcy w Chrome, gdzie może konwersji. Technologia reklamowa w witrynie reklamodawcy sprawdza, czy interfejs API na poziomie systemu operacyjnego jest i to ona jest. Technologia reklamowa rejestruje regułę konwersji przez instruując Chrome, że ma przekazać rejestrację do systemu operacyjnego, zamiast rejestrować bezpośrednio za pomocą interfejsu Attribution Reporting API w Chrome. Atrybucja na poziomie systemu operacyjnego Interfejs API do raportowania może wtedy dopasować źródło aplikacji i regułę internetową oraz wysłać odpowiednich raportach.
![Proces atrybucji z aplikacji do witryny](https://developers.google.cn/static/privacy-sandbox/private-advertising/attribution-reporting/cross-web-app/a2w_diagram.png?hl=pl)
Rejestracja źródła aplikacji:
Pakiet AdTech SDK w aplikacji Daily News na Androida rejestruje kliknięcie za pomocą:
registerSource()
Interfejs Attribution Reporting API na Androidzie wysyła żądanie do serwera technologii reklamowych Adres URL został udostępniony w domenie
registerSource()
Serwer technologii reklamowych w odpowiedzi przesyła źródło Attribution-Reporting-Register-Source nagłówek, aby dokończyć rejestrację źródła
Rejestracja reguły internetowej:
Technologia reklamowa rejestruje regułę i sprawdza dostępność systemu operacyjnego w Interfejs Attribution Reporting API
Internetowy interfejs ARA zwraca informacje o obsługiwanej platformie
Nagłówek
OS-Trigger
informuje interfejs internetowy ARA API, aby wywołać interfejs OS ARA API funkcjaregisterWebTrigger()
Połączenia z
registerWebTrigger()
odbywają się w tle, a deweloper nie musi bezpośrednio wywoływać funkcjiregisterWebTrigger()
w systemie operacyjnymSystem operacyjny ARA przejmuje kontrolę i wysyła żądanie na URL serwera technologii reklamowych podany przez nagłówek
Attribution-Reporting-Register-OS-Trigger
Technologia reklamowa dokończy rejestrację aktywatora za pomocą interfejsu OS API
OS ARA przeprowadzi atrybucję zgodnie z tą samą logiką atrybucję aplikacji i wysyłanie tych samych raportów
Przepływ pracy
Poniżej znajdziesz więcej informacji o tym, jak wykonać to zadanie:
Technologia reklamowa z aplikacji rejestruje źródło za pomocą atrybucji Androida Interfejs API do raportowania z tymi korektami:
- Aby zarejestrować źródło aplikacji, które prawdopodobnie dokona konwersji w witrynie,
Nagłówek odpowiedzi
Attribution-Reporting-Register-Source
powinien zawierać adres internetowy (eTLD + 1), a nie jako miejsce docelowe aplikacji.
.Attribution-Reporting-Register-Source: { "web_destination": "https://advertiser.example", ... }
- Niektórzy reklamodawcy mogą korzystać z usług kilku dostawców usług pomiarowych (np. za pomocą zewnętrznych narzędzi pomiarowych lub analitycznych) za pomocą łańcuchów przekierowań 302. W niektórych przypadkach interfejs Attribution Reporting API będzie podążać ścieżką przekierowania. określone w nagłówku Attribution-Reporting-Redirect w tle i na stronie Jednocześnie ścieżka przekierowania 302 jest wykonywana na pierwszym planie dla istniejących żądań nawigacji. Żądania te będą trafiać na ten sam adres URL i mogą spowodować u zewnętrznego dostawcy usług pomiaru podwójnego zliczania rejestracji. Do zapobiegają podwójnemu naliczaniu rejestracji, technologie reklamowe mogą zmieniać działanie przekierowań. do wysyłania rejestracji interfejsu Attribution Reporting API do alternatywnego źródła deterministyczny adres URL.
Aby umożliwić takie działanie, specjaliści ds. technologii reklamowych muszą dodać nowy nagłówek HTTP, gdy w odpowiedzi na prośbę o rejestrację:
- Nagłówek to
Attribution-Reporting-Redirect-Config
- Wartość nagłówka powinna być ciągiem znakówredirect-302-to-well-known
"Attribution-Reporting-Redirect-Config": "redirect-302-to-well-known"
- Nagłówek to
Pozostała część procesu rejestracji źródła odbywa się tak samo jak w przypadku standardowego procesu rejestracji. rejestrację źródła między aplikacjami.
- Aby zarejestrować źródło aplikacji, które prawdopodobnie dokona konwersji w witrynie,
Nagłówek odpowiedzi
Technologia reklamowa w witrynie reklamodawcy rejestruje regułę, wysyłając polecenie Chrome, aby przekazać rejestrację do interfejsu Android Attribution Reporting API:
Gdy użytkownik dokona konwersji w witrynie, technologia reklamowa utworzy żądanie zarejestrowania aktywatora w Chrome
Za pomocą piksela lub żądania
fetch()
można wysłać żądanie zarejestrowania aktywatorNagłówek żądania
Attribution-Reporting-Support
jest zwracany przez Chrome. w branży technologii reklamowych. Jeśli interfejs API jest włączony zarówno w przeglądarce Chrome, jak i w na urządzeniu z Androidem, nagłówek będzie zwracać wartośćos, web
.
"Attribution-Reporting-Support": "os, web"
Technologia reklamowa powinna następnie przekazać Chrome prośbę o przekazanie dostępu do systemu operacyjnego za pomocą
Attribution-Reporting-Register-OS-Trigger
, który:Informuje Chrome o przekazaniu rejestracji do systemu operacyjnego
Chrome przekazuje rejestrację do systemu operacyjnego, wywołując funkcję interfejsu OS API
registerWebTrigger()
- Wezwanie do działania
registerWebTrigger()
odbywa się w tle, technologia reklamowa nie musi dzwonić bezpośrednio do:registerWebTrigger()
- Wezwanie do działania
Interfejs API systemu operacyjnego inicjuje dodatkowe wywołanie interfejsu API do przekazywanego identyfikatora URI technologii reklamowej w przeglądarce
"Attribution-Reporting-Register-OS-Trigger": "https://adtech.example/register-trigger", "https://other-adtech.example/register-trigger"
W niektórych przypadkach nagłówek
Attribution-Reporting-Support
jest niedostępny i Nie można wysłać. Gdy tak się dzieje, technologia reklamowa może nadal ustawiać preferencje do obsługi rejestracji aktywatora poprzez dodanie parametru NagłówekAttribution-Reporting-Info
. Klucz to preferowana platforma, a dozwolone wartości toos
iweb
. Przeglądarka będzie używać preferowanej platformy gdy będzie dostępny, i przełączy się z powrotem na platformę internetową, gdy system operacyjny niedostępna.
Attribution-Reporting-Info: preferred-platform=os
- Aby dokończyć rejestrację reguły, punkt końcowy technologii reklamowej powinien odpowiedzieć do żądania Android Attribution Reporting API za pomocą nagłówka odpowiedzi.
Attribution-Reporting-Register-Trigger { "event_trigger_data": [{"trigger_data":"1"}], "aggregatable_trigger_data": [ {"key_piece":"0x400","source_keys":["campaignCounts"]}, {"key_piece":"0xA80","source_keys":["geoValue"]} ], ... }
- Pozostała część rejestracji reguły pozostaje bez zmian.
Rejestrowanie źródła internetowego i aktywatora aplikacji
W przypadku niektórych kampanii źródłem może być witryna w przeglądarce mobilnej, występuje w aplikacji na tym samym urządzeniu.
Przykład
Użytkownik przegląda stronę internetową w przeglądarce Chrome na telefonie z Androidem. Widzi reklamę swetra w jednym ze swoich ulubionych sklepów. Klikają tę ikonę reklama i trafiają do aplikacji, którą już pobrali. Technologia reklamowa witryna, w której została wyświetlona reklama, rejestruje źródło kliknięcia, informując Chrome o tym, aby przekazać rejestrację do Android Attribution Reporting API zamiast za pomocą interfejsu Attribution Reporting API w Chrome. Użytkownik kupuje sweter w: w aplikacji zakupowej. Technologia reklamowa w aplikacji reklamodawcy rejestruje konwersji za pomocą interfejsu Android Attribution Reporting API. Poziom systemu operacyjnego Interfejs Attribution Reporting API może dopasowywać regułę źródłową internetową i regułę aplikacji oraz i wysyłać odpowiednie raporty.
![Proces atrybucji aplikacji internetowej](https://developers.google.cn/static/privacy-sandbox/private-advertising/attribution-reporting/cross-web-app/w2a_diagram.png?hl=pl)
Rejestracja źródła internetowego:
Technologia reklamowa rejestruje źródło i sprawdza dostępność systemu operacyjnego w Interfejs Attribution Reporting API
Internetowy interfejs ARA zwraca informacje o obsługiwanej platformie
Nagłówek
OS-Source
informuje interfejs internetowy ARA API, aby wywołać interfejs OS ARA API funkcjaregisterWebSource()
Połączenie z
registerWebSource()
odbywa się w tle, a deweloper je wykonuje nie trzeba bezpośrednio wywoływaćregisterWebSource()
z systemem operacyjnymSystem operacyjny ARA przejmuje kontrolę i wysyła żądanie na podany URL serwera technologii reklamowych. przy nagłówku
Attribution-Reporting-Register-OS-Source
Technologia reklamowa dokończy rejestrację źródła przy użyciu interfejsu OS API
Rejestracja aktywatora aplikacji:
Pakiet SDK technologii reklamowych w aplikacji Sklep odzieżowy na Androida rejestruje regułę za pomocą parametru AdTech SDK interfejs systemu operacyjnego ARA
Interfejs Attribution Reporting API na Androidzie wysyła żądanie do serwera technologii reklamowych Adres URL został udostępniony w domenie
registerTrigger()
Serwer technologii reklamowych w odpowiedzi przesyła żądanie
Attribution-Reporting-Register-Trigger
nagłówek do zakończenia rejestracji wyzwalaczaOS ARA przeprowadzi atrybucję zgodnie z tą samą logiką atrybucję aplikacji i wysyłanie tych samych raportów
Przepływ pracy
Poniżej znajdziesz więcej informacji o tym, jak wykonać to zadanie:
Technologia reklamowa w witrynie wydawcy rejestruje źródło, przekazując instrukcje Chrome, aby przekazać rejestrację do interfejsu Android Attribution Reporting API:
- W przypadku użycia w przypadku połączenia witryny z aplikacją, przy rejestrowaniu źródła
parametru źródłowego należy podać bezpośrednio, za pomocą parametru
attributionsrc
lub przy użyciu rejestracji JavaScript. - Poniższy przykład używa tagu
attributionsrc
do określenia parametr źródłowy:
<img src="https://adtech.example/conversionpixel" attributionsrc="https://adtech.example/register-source?purchase=12">
- W przypadku użycia w przypadku połączenia witryny z aplikacją, przy rejestrowaniu źródła
parametru źródłowego należy podać bezpośrednio, za pomocą parametru
Nagłówek żądania
Attribution-Reporting-Support
jest zwracany przez Chrome do interfejsu technologii reklamowej. Jeśli interfejs API jest włączony zarówno w przeglądarce Chrome, jak i na urządzeniu z Androidem, nagłówek zwrócios, web
."Attribution-Reporting-Support": "os, web"
Technologia reklamowa powinna przekazać Chrome dostęp do interfejsu API systemu operacyjnego za pomocą
Attribution-Reporting-Register-OS-Source
, który:- Informuje Chrome o przekazaniu rejestracji do systemu operacyjnego
- Chrome przekazuje rejestrację do systemu operacyjnego, wywołując funkcję interfejsu OS API
registerWebSource()
- Wywołanie funkcji
registerWebSource()
odbywa się w tle, technologia reklamowa nie trzeba dzwonić bezpośrednio do:registerWebSource()
- Interfejs API systemu operacyjnego inicjuje dodatkowe wywołanie interfejsu API do identyfikatora URI technologii reklamowej przekazywanego z przeglądarka
"Attribution-Reporting-Register-OS-Source": "https://adtech.example/register-source"
- W niektórych przypadkach nagłówek
Attribution-Reporting-Support
jest niedostępny. Gdy tak się dzieje, technologia reklamowa może ustawić preferowaną platformę do obsługi reklam. rejestrację źródła, dodając nagłówekAttribution-Reporting-Info
. Klucz to preferowana platforma, a dozwolone wartości toos
iweb
. przeglądarka będzie używać preferowanej platformy, gdy będzie dostępna, i przełączy się na platformy internetowej, gdy system operacyjny jest niedostępny.
Attribution-Reporting-Info: preferred-platform=os
- Aby można było dokończyć rejestrację źródła, punkt końcowy technologii reklamowej powinien odpowiedzieć
do żądania do interfejsu Android Attribution Reporting API z nagłówkiem odpowiedzi
Attribution-Reporting-Register-Source
Odpowiedź powinna też określać miejsce docelowe aplikacji w polu „Miejsce docelowe”.
Attribution-Reporting-Register-Source { "source_event_id":"123001", "destination":"android-app://com.example.advertiser", ... }
- Aby obsługiwać przekierowania w przypadku rejestracji źródeł, Chrome będzie przestrzegać i wywołują interfejsy API kontekstu internetowego w przypadku każdego przeskoku.
- Pozostała część rejestracji źródła pozostaje bez zmian.
Technologia reklamowa w aplikacji reklamodawcy rejestruje regułę w Androidzie Interfejs Attribution Reporting API:
- W przypadku reguł występujących w aplikacjach rejestrują one reguły z parametrem Android Attribution Reporting API.
Kampanie, które mają potencjalne miejsca docelowe zarówno w aplikacjach, jak i w internecie.
Skonfiguruj podwójne miejsca docelowe
- Niektóre kampanie mogą być skonfigurowane pod kątem konwersji w aplikacji reklamodawcy lub w zależności od różnych czynników, takich jak to, czy użytkownik ma zainstalowaną aplikację.
- W takich przypadkach zaleca się przekazanie rejestracji źródła do System operacyjny, jeśli jest dostępny, aby można było poprawnie przypisać źródło niezależnie miejsca, w którym występuje reguła. Przy rejestrowaniu źródła w systemie operacyjnym, zarówno w odpowiednich parametrach można określić miejsce docelowe aplikacji i witryny.
- Miejsce docelowe aplikacji powinno znajdować się w polu
destination
- Miejsce docelowe sieci powinno znajdować się w polu
web_destination
- Programiści Chrome powinni pamiętać, że pole
destination
dotyczące systemu operacyjnego Interfejs Attribution Reporting API powinien być pakietem aplikacji, a nie adresem URL.
Attribution-Reporting-Register-Source { "source_event_id":"123001", "destination":"android-app://com.example.advertiser", "web_destination": "https://example.advertiser" ... }
- W następnej sekcji poświęconej raportowaniu przybliżonemu wyjaśnimy, jak korzystanie z funkcji podwójnych miejsc docelowych może wpłynąć na zakłócenia w raportach.
Używaj raportowania przybliżonego, aby zmniejszyć szum w raportach na poziomie zdarzenia dla źródła docelowe:
- Jeśli w źródle określono zarówno system operacyjny (aplikacja), jak i miejsce docelowe w internecie rejestracji, raporty na poziomie zdarzenia będą określać, czy zdarzenie miało miejsce w domyślnej witrynie lub aplikacji. Aby jednak zapewnić prywatności, do tych raportów zostaną dodane dodatkowe szumy.
- Technologie reklamowe mogą używać pola
coarse_event_report_destinations
w kolumnieAttribution-Reporting-Register-Source
, aby włączyć ogólne raportowanie i zmniejszyć szum. Jeśli źródło z parametremcoarse_event_report_destinations
określone pole wygra atrybucję, wynikowy raport będzie zawierał zarówno dane o aplikacji, i miejsc docelowych w sieci, nie różniąc się tym, gdzie faktyczny element wystąpiło, ale z mniejszym szumem niż w raportach, w których aplikacja lub strona docelowa jest określony. - Raporty zbiorcze pozostaną niezmienione.
Aplikacje korzystające z kart niestandardowych Chrome
Niektóre aplikacje mogą używać kart niestandardowych do renderowania treści z internetu. Zachowanie kart niestandardowych podobnie jak zwykłe strony internetowe przy pomiarze w aplikacjach i witrynach mobilnych.
- Zarejestruj źródło aplikacji i aktywator karty niestandardowej:
- Wykonaj instrukcje rejestrowania źródła aplikacji i reguły internetowej.
- Rejestrowanie źródła karty niestandardowej i aktywatora aplikacji:
- Postępuj zgodnie z instrukcjami, aby zarejestrować źródło internetowe i aktywator aplikacji.
- Zarejestruj źródło CCT i aktywator CCT
- Jest to traktowane tak samo jak każda atrybucja witryn w internecie w Chrome.
Aplikacje korzystające z komponentu WebView
Niektóre aplikacje mogą używać komponentu WebView do wyświetlania treści. Istnieje wiele różnych zastosowań na potrzeby komponentu WebView, np. renderowania reklam, hostowania treści internetowych lub aplikacji niestandardowej funkcje lepiej dostosowane do formatu internetowego.
W komponencie WebView dostępna jest tylko atrybucja na poziomie systemu operacyjnego. Nagłówek Attribution-Reporting-Support zwraca tylko system operacyjny i tylko wtedy, gdy Interfejs Android Attribution Reporting API jest dostępny.
Podczas przekazywania uprawnień do systemu operacyjnego komponent WebView może używać właściwości
registerSource
lubregisterWebSource
iregisterTrigger
lubregisterWebTrigger
. Które metody używane przez WebView jest ustawiany przez aplikację renderującą komponent WebView i jest określany na na podstawie WebView.- Różnica między
registerSource
aregisterWebSource
jest tym, jest rejestrowane jako wydawca. Przy opcjiregisterSource
aplikacja jest rejestrowana jako wydawca, Przykład zastosowania parametruregisterSource
to aplikacji wydawcy, która wyświetla reklamę renderowaną za pomocą WebView. NaregisterWebSource
, witryna hostowana w komponencie WebView jest rejestrowana jako publisher (wydawca), Przykład zastosowaniaregisterWebSource
to aplikacja, która hostuje komponent WebView, a witryna renderowana przez ten komponent to wyświetlanie reklam.registerTrigger
iregisterWebTrigger
działają podobnie. wykres w punkcie 3 ze szczegółami różnych scenariuszy, w których deweloper aplikacji lub pakietu SDK chce skonfigurować interfejs API tak, aby używałregisterSource
lubregisterWebSource
, iregisterTrigger
lubregisterWebTrigger
.
- Różnica między
Domyślnie WebView używa komponentów
registerSource
iregisterWebTrigger
, gdy Android Attribution Reporting API. Powoduje to powiązanie źródeł z atrybutem aplikacji i uruchamia się ze źródłem najwyższego poziomu adresu URL w WebView, gdy zachodzi zdarzenie aktywujące.- Jeśli aplikacja wymaga innego działania, będzie musiała użyć nowej metody
setAttributionRegistrationBehavior w interfejsie androidx.webkit.WebViewSettingsCompat
zajęcia. Ta metoda określa, czy komponent WebView powinien wywoływać
registerWebSource()
lubregisterWebTrigger()
, a nieregisterSource()
lubregisterTrigger()
.- To zachowanie należy skonfigurować dla każdego inicjowanego komponentu WebView.
- Jeśli pakiet SDK technologii reklamowych inicjuje komponent WebView, musi ustawić to domyślne zachowanie.
- W przypadku aplikacji, które chcą używać uprawnienia
registerWebSource()
do powiązania źródła do rejestracji w witrynie w komponencie WebView, a nie w aplikacji, dołączyć do listy dozwolonych aplikacji internetowych. Aby dołączyć do listy dozwolonych, wypełnij ten formularz. ma na celu ochronę prywatności Budowanie zaufania do kontekstu internetowego.
- Opcje parametru setAttributionRegistrationBehavior
Wartość Opis Przykład zastosowania APP_SOURCE_AND_WEB_TRIGGER (domyślnie) Umożliwia aplikacjom rejestrowanie źródeł aplikacji (źródeł powiązanych z nazwą pakietu aplikacji) i wyzwalaczy internetowych (reguł powiązanych z eTLD+1) z komponentu WebView. aplikacje, które używają komponentu WebView do wyświetlania reklam, zamiast umożliwiać przeglądanie internetu. WEB_SOURCE_AND_WEB_TRIGGER Zezwala aplikacjom na rejestrowanie źródeł sieciowych i aktywatorów internetowych z komponentu WebView. aplikacje przeglądarki oparte na WebView, w których zarówno wyświetlenia reklam, jak i konwersje mogą mieć miejsce na stronach internetowych w komponencie WebView. APP_SOURCE_AND_APP_TRIGGER Zezwala aplikacjom na rejestrowanie źródeł aplikacji i wyzwalaczy aplikacji z komponentu WebView. Aplikacje oparte na WebView, w których wyświetlenia reklam i konwersje powinny być zawsze powiązane z aplikacją, a nie z eTLD + 1 komponentu WebView. WYŁĄCZONE Wyłącza rejestrację źródła i aktywatora z komponentu WebView. - Jeśli aplikacja wymaga innego działania, będzie musiała użyć nowej metody
setAttributionRegistrationBehavior w interfejsie androidx.webkit.WebViewSettingsCompat
zajęcia. Ta metoda określa, czy komponent WebView powinien wywoływać
Źródła i rejestracje aktywujące z komponentu WebView
Technologie reklamowe powinny reagować na rejestracje źródła za pomocą Nagłówek
Attribution-Reporting-Register-OS-Source
. Na podstawie zestawu ustawień dla komponentu WebView wywoła parametrregisterSource()
lubregisterWebSource()
. i zainicjować dodatkowe wywołanie interfejsu API z poziomu Atrybucji Androida Interfejs API służący do raportowania identyfikatora URI technologii reklamowej- Aby dokończyć rejestrację źródła, punkt końcowy technologii reklamowej powinien odpowiedzieć na żądanie Android Attribution Reporting API za pomocą tagu nagłówek odpowiedzi.
Attribution-Reporting-Register-OS-Source { "source_event_id":"123001", "destination":"android-app://com.example.advertiser", ... }
Pozostała część rejestracji źródła pozostaje bez zmian.
Technologie reklamowe powinny odpowiadać na rejestracje za pomocą Nagłówek
Attribution-Reporting-Register-OS-Trigger
. Na podstawie zestawu ustawień dla komponentu WebView wywoła parametrregisterTrigger()
lubregisterWebTrigger()
. i zainicjować dodatkowe wywołanie interfejsu API z Rb do identyfikatora URI technologii reklamowej.- Aby dokończyć rejestrację reguły, punkt końcowy technologii reklamowej powinien odpowiadają na żądanie Android Attribution Reporting API, podając odpowiedź nagłówek.
Attribution-Reporting-Register-OS-Trigger { "event_trigger_data": [{"trigger_data":"1"}], "aggregatable_trigger_data": [ {"key_piece":"0x400","source_keys":["campaignCounts"]}, {"key_piece":"0xA80","source_keys":["geoValue"]} ], ... }
- Reszta procesu rejestracji reguł pozostaje bez zmian.
Debugowanie
Przy konfigurowaniu implementacji kodu z aplikacji na stronę internetową zalecamy skonfigurowanie debugowania , by sprawdzić, czy źródła i reguły są prawidłowo rejestrowane oraz czy nie są zarejestrowane, aby otrzymać informacje o przyczynach.
Ogólne instrukcje debugowania raportowania Attribution znajdziesz w książce kucharskiej dotyczącej debugowania.