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 raportach na poziomie zdarzenia tego nie robią.

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 typy raportów interfejsów Attribution Reporting API i Private Aggregation API. Podsumowanie zawiera zbiorcze dane o użytkownikach, które mogą zawierać szczegółowe dane o konwersjach (bez szumu). Raporty podsumowujące składają się z raportów zbiorczych. Raporty podsumowania zapewniają większą elastyczność i bogatszy model danych niż raportowanie na poziomie zdarzenia, zwłaszcza w przypadku niektórych zastosowań, np. wartości konwersji.

Implementacja

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

Pamiętaj, że dla danego źródła zdarzeń można wygenerować zarówno na poziomie zdarzenia i zagregowanego. demo przeprowadzi Cię przez 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
    Zapoznaj się z przykładowym kodem w pliku adtech.js, aby poznać metodę POST, oraz w 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
    Zapoznaj się z przykładowym kodem w pliku adtech.js, aby poznać metodę POST, oraz w 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. Konfigurowanie filtrów (opcjonalnie):
    1. Postępuj zgodnie z instrukcjami podanymi w artykule Definiowanie reguł niestandardowych za pomocą filtrów.
    2. Przejrzyj szczegóły dotyczące filtrów raportów agregowanych w: w sekcji reguł Wyjaśnienie.

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ł wyłączyć interfejs API 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

Tło

Prezentacje i narzędzia

Planowanie

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