Pierwsze kroki z raportowaniem atrybucji

Ten przewodnik zawiera omówienie i instrukcje konfigurowania raportów atrybucji na poziomie zdarzenia i podsumowujących za pomocą interfejsu Attribution Reporting API.

Na początek dowiesz się, jak:

  • Rozróżnianie typów raportów interfejsu Attribution Reporting API

  • Wykonaj czynności związane z wdrażaniem interfejsu API i generowaniem raportów.

  • Znajdowanie informacji referencyjnych i pomocy w rozwiązywaniu problemów

Wybierz typ raportu

Aby skutecznie mierzyć skuteczność kampanii reklamowych na różnych poziomach szczegółowości i prywatności, interfejs Attribution Reporting API udostępnia 2 rodzaje raportów:

  • Raporty na poziomie zdarzenia: zawierają szczegółowe dane łączące konkretne kliknięcie lub wyświetlenie reklamy (źródło) z odpowiednimi danymi o konwersjach (aktywator). Raporty na poziomie zdarzenia ograniczają ilość danych o konwersjach i dodają do raportów szum. Są one idealne w przypadkach, w których kluczowa jest atrybucja poszczególnych zdarzeń, np. przy pomiarze zasięgu kampanii.

  • Raporty podsumowujące: zawierają zagregowane dane użytkowników i mogą obejmować bardziej szczegółowe informacje o konwersjach z dodatkowym szumem. Są one tworzone na podstawie raportów zbiorczych i oferują bogatszy model danych niż raporty na poziomie zdarzenia. Raporty podsumowujące są szczególnie przydatne w przypadku scenariuszy wymagających zbiorczych statystyk, takich jak obliczanie wartości konwersji lub analizowanie skuteczności kampanii w różnych segmentach użytkowników.

Omówienie wdrożenia

W sekcjach poniżej znajdziesz ogólne instrukcje generowania poszczególnych typów raportów. Możesz też skorzystać z demonstracji interfejsu Attribution Reporting API, aby poznać szczegółowy opis całego procesu.

Wymaganie wstępne: aby rejestrować źródła i wyzwalacze oraz otrzymywać raporty, Twoje witryny muszą mieć certyfikaty SSL/TLS (HTTPS).

Generowanie raportów na poziomie zdarzenia

Poniżej znajdziesz instrukcje generowania raportów na poziomie zdarzenia:

  1. Rejestrowanie źródła: łączy kliknięcie lub wyświetlenie reklamy z informacjami o atrybucji. Szczegółowe instrukcje znajdziesz w sekcjach Rejestrowanie źródeł atrybucji i Rejestracja źródła atrybucji. Pamiętaj, że proces rejestracji różni się nieco w przypadku kliknięć i wyświetleń.

  2. Zarejestruj wywołanie: rejestruje zdarzenie konwersji i łączy je z wcześniej zarejestrowanym źródłem. Instrukcje znajdziesz w sekcji Rejestrowanie wyzwalaczy atrybucji.

  3. Skonfiguruj punkt końcowy raportowania: utwórz na serwerze punkt końcowy, który będzie odbierać raporty na poziomie zdarzenia. Adres URL punktu końcowego powinien mieć format {REPORTING_ENDPOINT}/.well-known/attribution-reporting/report-event-attribution. Przykład kodu metody POST znajdziesz w pliku adtech.js. Więcej informacji o funkcji .well-known znajdziesz w Wikipedii.

Więcej informacji o raportach na poziomie zdarzenia znajdziesz w tym artykule.

Generowanie raportu zbiorczego

  1. Zarejestruj źródło: tak samo jak w przypadku raportów na poziomie zdarzenia. Więcej informacji znajdziesz w sekcjach Rejestrowanie źródeł atrybucji i Rejestracja źródła atrybucji.

  2. Zarejestruj wyzwalacz: tak samo jak w przypadku raportów na poziomie zdarzenia. Zobacz Rejestrowanie aktywatorów atrybucji.

  3. Skonfiguruj punkt końcowy raportowania: utwórz punkt końcowy do odbierania raportów zbiorczych. Adres URL powinien mieć postać: {REPORTING_ENDPOINT}/.well-known/attribution-reporting/report-aggregate-attribution. Przykład metody POST znajdziesz w sekcji adtech.js, a informacje o .well-known – w Wikipedii.

  4. Grupowanie i wysyłanie raportów: grupuj raporty zbiorcze i wysyłaj je do usługi do agregacji w celu przetworzenia. Usługa do agregacji wygeneruje wtedy raporty podsumowujące. Więcej informacji znajdziesz w sekcji Strategie grupowania.

Więcej informacji o raportach podsumowujących znajdziesz w wyjaśnieniu dotyczącym raportów podlegających agregacji.

Oprócz instrukcji wdrażania w planowaniu strategii raportowania zbiorczego pomogą Ci te tematy:

Konfigurowanie filtrów (opcjonalnie)

Aby uzyskać większą kontrolę nad otrzymywanymi danymi o atrybucji, możesz skonfigurować filtry.

Filtrowanie umożliwia dokładniejszą analizę danych, ponieważ wyodrębnia konkretne podzbiory danych, co zmniejsza ilość zakłóceń. Pomaga też śledzić skuteczność konkretnych kampanii reklamowych i zdarzeń powodujących konwersję, aby uzyskać dokładniejsze pomiary.

Informacje o konfigurowaniu filtrowania znajdziesz w sekcji Definiowanie reguł niestandardowych za pomocą filtrów oraz w sekcji wyzwalaczy w artykule Rejestracja wyzwalacza atrybucji, w którym znajdziesz szczegółowe informacje dotyczące raportów z możliwością agregacji.

Sprawdzanie, czy interfejs API jest włączony

Zanim zaczniesz korzystać z interfejsu API, sprawdź, czy jest on włączony, używając tego kodu:

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

Ten test sprawdza, czy interfejs API jest dozwolony w bieżącym kontekście. Ustawienia przeglądarki użytkownika lub inne czynniki mogą jednak nadal uniemożliwiać korzystanie z interfejsu API. Ze względu na ochronę prywatności nie ma programowego sposobu na jednoznaczne potwierdzenie użyteczności interfejsu API.

Dalsze kroki

Więcej informacji o rozpoczynaniu korzystania z raportów atrybucji znajdziesz w sekcjach poniżej.

Implementacja

Tło i koncepcje

Wersje demonstracyjne i narzędzia

Planowanie