Znajdziesz tu informacje o tym, od czego zacząć, m.in. od konfiguracji i krótkie omówienie.
Wybierz typ raportu
Za pomocą interfejsu Attribution Reporting API możesz generować 2 typy raportów: raporty na poziomie zdarzenia i raporty podsumowujące. Raporty na poziomie zdarzenia wymagają mniej konfiguracji niż raporty zbiorcze i zbiorcze, więc mogą być dobrym punktem wyjścia. Raporty podsumowania wymagają integracji z usługą agregacji, a raporty na poziomie zdarzenia nie wymagają integracji.
Możesz konfigurować raporty zarówno na poziomie zdarzenia, jak i raportów podsumowujących. Wspomagają się.
Raporty na poziomie zdarzenia
Raporty na poziomie zdarzenia przypisują określone kliknięcie lub wyświetlenie reklamy (po stronie reklamy) do danych po stronie konwersji. Aby chronić prywatność użytkowników przez ograniczenie łączenia ich tożsamości z różnych witryn, dane o konwersjach są bardzo ograniczone, a dane niedokładne.
Raporty podsumowujące
Raport podsumowujący to typ raportu Attribution Reporting API i interfejsu Private Aggregation API. Raport podsumowujący zawiera zbiorcze dane użytkowników i może zawierać szczegółowe dane o konwersjach (z uwzględnieniem szumu). Raporty zbiorcze składają się z raportów zbiorczych.
Implementacja
Możesz zacząć od wykonania poniższych czynności.
Pamiętaj, że w przypadku danego źródła zdarzeń możesz wygenerować zarówno raport na poziomie zdarzenia, jak i raport zbiorczy. Prezentacja przeprowadzi Cię przez cały proces.
Generowanie raportu na poziomie zdarzenia
Aby wygenerować raporty na poziomie zdarzenia, wykonaj te czynności:
Zarejestruj źródło. Instrukcje znajdziesz w artykule Rejestrowanie źródeł atrybucji. Pamiętaj, że czynności różnią się w przypadku kliknięć i wyświetleń.
Zarejestruj regułę. Instrukcje znajdziesz w artykule Rejestrowanie reguł atrybucji.
Skonfiguruj punkt końcowy pod tym adresem URL:
{REPORTING_ENDPOINT}/.well-known/attribution-reporting/report-event-attribution
Aby zobaczyć metodępost
, zapoznaj się z przykładowym kodem w adtech.js. Więcej informacji o .well-known znajdziesz tutaj.
Więcej informacji o raportach na poziomie zdarzenia znajdziesz tutaj.
Generowanie raportu podsumowującego
Aby wygenerować raporty podsumowujące, wykonaj następujące ogólne czynności:
Zarejestruj źródło. Instrukcje znajdziesz w artykule Rejestrowanie źródeł atrybucji. Pamiętaj, że czynności różnią się w przypadku kliknięć i wyświetleń. Dodatkowe informacje znajdziesz w artykule Rejestracja źródła atrybucji.
Zarejestruj regułę. Instrukcje znajdziesz w artykule Rejestrowanie reguł atrybucji.
Skonfiguruj punkt końcowy na potrzeby raportów zbiorczych pod tym adresem URL:
{REPORTING_ENDPOINT}/.well-known/attribution-reporting/report-aggregate-attribution
Aby zobaczyć metodępost
, zapoznaj się z przykładowym kodem w adtech.js. Więcej informacji o .well-known znajdziesz tutaj.Zbiorcze i wysyłane raporty do dalszego przetworzenia przez usługę agregacji, co pozwoli wygenerować raporty podsumowujące. Więcej informacji znajdziesz w artykule o zbiorczych raportach zbiorczych.
Więcej informacji o raportach podsumowujących znajdziesz tutaj.
Więcej informacji o konfigurowaniu raportów debugowania znajdziesz w serii dotyczącej debugowania raportów atrybucji.
W podsumowaniu znajdują się dodatkowe pojęcia
Oprócz znajomości opisanych tu etapów wdrażania pomogą Ci też te koncepcje, które pomogą Ci zaplanować strategię raportowania podsumowującego:
Kroki opcjonalne:
- Skonfiguruj filtry (opcjonalnie):
- Postępuj zgodnie z instrukcjami podanymi w sekcji Definiowanie reguł niestandardowych za pomocą filtrów.
- Szczegółowe informacje o filtrach raportów zbiorczych znajdziesz w sekcji dotyczącej reguł w objaśnieniu.
Nie zapomnij o wykrywaniu funkcji
Przed użyciem interfejsu API sprawdź, czy nie został on zablokowany na stronie przy użyciu zasady Permissions-Policy. Aby to zrobić, uruchom ten kod:
if (document.featurePolicy.allowsFeature('attribution-reporting')) {
// the Attribution Reporting API is enabled
}
Jeśli to sprawdzanie wykrywania cech zwraca wartość „prawda”, interfejs API jest dozwolony w kontekście (stronie), w którym przeprowadzane jest sprawdzanie.
Pamiętaj, że samo sprawdzenie nie gwarantuje, że interfejs API może działać na danej stronie. Użytkownik mógł go wyłączyć w ustawieniach przeglądarki lub mieć inne ustawienia, które uniemożliwiają jego używanie. Ze względu na ochronę prywatności użytkowników nie można sprawdzać tego automatycznie.
Dalsze kroki
Jeśli chcesz rozpocząć implementację, zapoznaj się z tą dokumentacją:
Konfiguracja
- Rejestrowanie źródła atrybucji
- Rejestrowanie reguły atrybucji
- Nadawanie priorytetów określonym kliknięciom, wyświetleniom lub konwersjom
- Debugowanie raportów atrybucji
- Klucze agregacji
Wprowadzenie
- Raportowanie atrybucji w raportach na poziomie zdarzenia
- Raporty atrybucji za pomocą raportów zbiorczych
- Ograniczenia dotyczące danych do raportu agregacji
- Interpretowanie szumu
- Praca z szumem
Prezentacje i narzędzia
- Prezentacja interfejsu Attribution Reporting API
- Laboratorium szumu
- Walidator nagłówków raportów atrybucji
Planowanie
Jeśli jesteś na etapie planowania, zapoznaj się z tymi dokumentami: