Ta strona została przetłumaczona przez Cloud Translation API.

Przewodnik po implementacji interfejsu Attribution Reporting API w różnych witrynach i aplikacjach

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.

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 funkcja registerWebTrigger()
Połączenia z registerWebTrigger() odbywają się w tle, a deweloper nie musi bezpośrednio wywoływać funkcji registerWebTrigger() w systemie operacyjnym
System 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",
    ...
}
```
Uwaga: w przypadku kampanii, które mogą generować konwersje w internecie LUB miejsce docelowe aplikacji – zobacz sekcję o podwójnych miejscach docelowych
.
- 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"
```
  Uwaga: wszystkie kolejne przekierowania następujące po tym nagłówku identyfikator .well-known jest dołączony na początku ścieżki identyfikatora URI przekierowania.
- 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.
.
Uwaga: jeśli Ty lub aplikacja do publikowania korzystacie z komponentu WebView dotyczące wyświetlania reklamy natywnej w aplikacji na Androida znajdziesz w sekcji WebView
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
  1. Za pomocą piksela lub żądania fetch() można wysłać żądanie zarejestrowania aktywator
  2. Nagłó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:
  1. Informuje Chrome o przekazaniu rejestracji do systemu operacyjnego
  2. 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()
  3. 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łówek Attribution-Reporting-Info. Klucz to preferowana platforma, a dozwolone wartości to os i web. 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.
.
Uwaga: zarówno Attribution-Reporting-Register-Trigger, nagłówek zawierający informacje dotyczące rejestracji w internecie oraz Nagłówek Attribution-Reporting-Register-OS-Trigger zawierający rejestrację systemu operacyjnego powinny być zwracane przy określaniu preferowanej platformy, aby zapewnić prawidłowe jak będzie można zarejestrować się na platformie. Rejestracje systemu operacyjnego i sieci muszą być tak, aby w przypadku, gdy preferowana platforma nie jest dostępna, wymagane dla metody zastępczej.
```
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 — Proces atrybucji witryn w aplikacji

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 funkcja registerWebSource()
Połączenie z registerWebSource() odbywa się w tle, a deweloper je wykonuje nie trzeba bezpośrednio wywoływać registerWebSource() z systemem operacyjnym
System 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 wyzwalacza
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 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">
```
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óci os, web.
```
"Attribution-Reporting-Support": "os, web"
```
Uwaga: musi być włączony interfejs Attribution Reporting API w systemie operacyjnym Android, aby dokonywać pomiarów w aplikacjach i internecie.
Technologia reklamowa powinna przekazać Chrome dostęp do interfejsu API systemu operacyjnego za pomocą Attribution-Reporting-Register-OS-Source, który:
1. Informuje Chrome o przekazaniu rejestracji do systemu operacyjnego
2. Chrome przekazuje rejestrację do systemu operacyjnego, wywołując funkcję interfejsu OS API registerWebSource()
3. Wywołanie funkcji registerWebSource() odbywa się w tle, technologia reklamowa nie trzeba dzwonić bezpośrednio do: registerWebSource()
4. 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łówek Attribution-Reporting-Info. Klucz to preferowana platforma, a dozwolone wartości to os i web. 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.
.
Uwaga: zarówno Attribution-Reporting-Register-Source, nagłówek zawierający informacje dotyczące rejestracji w internecie oraz Nagłówek Attribution-Reporting-Register-OS-Source zawierający rejestrację systemu operacyjnego powinny być zwracane przy określaniu preferowanej platformy, aby zapewnić prawidłowe jak będzie można zarejestrować się na platformie. Rejestracje systemu operacyjnego i sieci muszą być tak, aby w przypadku, gdy preferowana platforma nie jest dostępna, wymagane dla metody zastępczej.
```
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 kolumnie Attribution-Reporting-Register-Source, aby włączyć ogólne raportowanie i zmniejszyć szum. Jeśli źródło z parametrem coarse_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.

Uwaga: aby zastosować atrybucję w Chrome i komponencie WebView, rejestracje źródeł i aktywatorów w Chrome muszą zostać przekazane do systemu operacyjnego ponieważ w przypadku WebView obsługiwana jest tylko atrybucja oparta na systemie operacyjnym.
Podczas przekazywania uprawnień do systemu operacyjnego komponent WebView może używać właściwości registerSource lub registerWebSource i registerTrigger lub registerWebTrigger. 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 a registerWebSource jest tym, jest rejestrowane jako wydawca. Przy opcji registerSource aplikacja jest rejestrowana jako wydawca, Przykład zastosowania parametru registerSource to aplikacji wydawcy, która wyświetla reklamę renderowaną za pomocą WebView. Na registerWebSource, witryna hostowana w komponencie WebView jest rejestrowana jako publisher (wydawca), Przykład zastosowania registerWebSource to aplikacja, która hostuje komponent WebView, a witryna renderowana przez ten komponent to wyświetlanie reklam. registerTrigger i registerWebTrigger 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 lub registerWebSource, i registerTrigger lub registerWebTrigger.

Domyślnie WebView używa komponentów registerSource i registerWebTrigger, 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() lub registerWebTrigger(), a nie registerSource() lub registerTrigger().
- 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.

Ź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 parametr registerSource() lub registerWebSource(). 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 parametr registerTrigger() lub registerWebTrigger(). 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.