Pierwsze kroki z raportami atrybucji

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:

  1. 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ń.

  2. Zarejestruj regułę. Instrukcje znajdziesz w artykule Rejestrowanie reguł atrybucji.

  3. 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:

  1. 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.

  2. Zarejestruj regułę. Instrukcje znajdziesz w artykule Rejestrowanie reguł atrybucji.

  3. 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.

  4. 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:

  1. Skonfiguruj filtry (opcjonalnie):
    1. Postępuj zgodnie z instrukcjami podanymi w sekcji Definiowanie reguł niestandardowych za pomocą filtrów.
    2. 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

Wprowadzenie

Prezentacje i narzędzia

Planowanie

Jeśli jesteś na etapie planowania, zapoznaj się z tymi dokumentami: