Pierwsze kroki z raportami atrybucji

Z tego artykułu dowiesz się, od czego zacząć, w tym jak ją skonfigurować i będzie zawierać krótkie omówienie.

Wybierz typ raportu

Za pomocą Attribution Reporting API możesz generować 2 rodzaje raportów: raporty na poziomie zdarzenia i raporty podsumowujące. Raporty na poziomie zdarzenia wymagają mniej konfiguracji niż raporty agregujące i raporty podsumowujące, więc mogą stanowić dobry punkt wyjścia. Raporty podsumowujące wymagają integracji z usługą agregacji, w przeciwieństwie do raportów na poziomie zdarzenia.

Możesz skonfigurować raportowanie zarówno na poziomie zdarzenia, jak i raportów podsumowujących. Są one uzupełniające.

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

Aby rozpocząć, wykonaj poniższe czynności.

Pamiętaj, że w przypadku danego źródła zdarzeń możesz wygenerować zarówno raport na poziomie zdarzenia, jak i raport agregowany. Prezentacja ułatwi Ci cały proces.

Generowanie raportu na poziomie zdarzenia

Aby wygenerować takie raporty na poziomie zdarzenia, musisz:

  1. Zarejestruj źródło. Instrukcje znajdziesz w artykule Rejestrowanie źródeł atrybucji. Pamiętaj, że kroki różnią się w przypadku kliknięć i wyświetleń.

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

  3. Skonfiguruj punkt końcowy o tym adresie URL:
    {REPORTING_ENDPOINT}/.well-known/attribution-reporting/report-event-attribution.
    Zajrzyj do przykładowego kodu w pliku adtech.js, aby poznać metodę POST, oraz zajrzyj do Wikipedii, aby dowiedzieć się więcej na temat .well-known.

Więcej informacji znajdziesz w objaśnieniu raportu na poziomie zdarzenia.

Generowanie raportu podsumowującego

Aby wygenerować raporty podsumowujące, wykonaj te ogólne czynności:

  1. Zarejestruj źródło. Instrukcje znajdziesz w artykule Rejestrowanie źródeł atrybucji. Pamiętaj, że kroki różnią się w przypadku kliknięć i wyświetleń. Więcej informacji znajdziesz w artykule Rejestracja źródła atrybucji.

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

  3. Skonfiguruj punkt końcowy na potrzeby raportów agregowanych o tym adresie URL:
    {REPORTING_ENDPOINT}/.well-known/attribution-reporting/report-aggregate-attribution.
    Zajrzyj do przykładowego kodu w pliku adtech.js, aby poznać metodę POST, oraz zajrzyj do Wikipedii, aby dowiedzieć się więcej na temat .well-known.

  4. Zbiorczo i wysyłać raporty do dalszego przetwarzania przez usługę agregacji, co spowoduje generowanie raportów podsumowujących. Przeczytaj artykuł o raportach agregowanych zbiorczo.

Więcej szczegółów znajdziesz w objaśnieniu raportu agregowanego.

Z serii debugowania dotyczącego raportowania atrybucji dowiesz się, jak skonfigurować raporty debugowania.

Podsumowanie raportów dodatkowych

Zapoznanie się z opisanymi tu etapami implementacji pomoże Ci zaplanować strategię tworzenia raportów podsumowujących, wykorzystując następujące zagadnienia:

Kroki opcjonalne:

  1. Skonfiguruj filtry (opcjonalnie):
    1. Wykonaj instrukcje podane w artykule Definiowanie reguł niestandardowych za pomocą filtrów.
    2. Szczegóły dotyczące filtrów raportów agregowanych znajdziesz w sekcji reguł w tym objaśnieniu.

Pamiętaj o wykrywaniu cech

Zanim użyjesz tego interfejsu API, sprawdź, czy nie został on zablokowany na stronie za pomocą zasad dotyczących uprawnień. Aby to zrobić, uruchom ten kod:

if (document.featurePolicy.allowsFeature('attribution-reporting')) {
  // the Attribution Reporting API is enabled
}

Jeśli kontrola wykrywania cech zwraca wartość „prawda”, interfejs API jest dozwolony w kontekście (na stronie), w którym przeprowadza się kontrolę.

Pamiętaj, że samo sprawdzenie nie gwarantuje, że interfejs API może być używany na danej stronie. Użytkownik mógł go wyłączyć w ustawieniach przeglądarki lub mieć inne ustawienia, które uniemożliwiają korzystanie z tego interfejsu. Ze względu na ochronę prywatności użytkowników nie można sprawdzić tego automatycznie.

Dalsze kroki

Jeśli chcesz rozpocząć implementację, przejrzyj te dokumenty:

Konfiguracja

Wprowadzenie

Prezentacje i narzędzia

Planowanie

Jeśli jesteś jeszcze na etapie planowania, zajrzyj do poniższych dokumentów: