Pierwsze kroki z raportowaniem atrybucji

W tym przewodniku znajdziesz omówienie i instrukcje konfigurowania raportów na poziomie zdarzenia i podsumowania przy użyciu interfejsu Attribution Reporting API.

Na początek dowiesz się, jak:

  • Różnice między typami raportów Attribution Reporting API

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

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

Wybierz typ raportu

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

  • Raporty na poziomie zdarzenia: możesz w nich podawać szczegółowe dane łączące konkretne kliknięcie lub wyświetlenie reklamy (źródło) z odpowiednimi danymi o konwersji (wyzwalacz). Raporty na poziomie zdarzenia ograniczają ilość danych o konwersjach i wprowadzają do nich zakłócenia. Są one idealne do zastosowań, w których kluczowe znaczenie ma atrybucja pojedynczego zdarzenia, np. mierzenie zasięgu kampanii.

  • Raporty podsumowujące: zawierają zagregowane dane użytkowników i mogą zawierać bardziej szczegółowe informacje o konwersjach z dodatkowym szumem. Wykorzystują one zarówno interfejs Attribution Reporting API, jak i interfejs Private Aggregation API. Są tworzone na podstawie raportów zbiorczych i zawierają bogatszy model danych niż raporty na poziomie zdarzenia. Raporty podsumowania są szczególnie przydatne w sytuacjach wymagających zbiorczych statystyk, np. obliczania wartości konwersji lub analizowania skuteczności kampanii w różnych segmentach użytkowników.

Omówienie wdrażania

W poniższych sekcjach znajdziesz ogólne instrukcje tworzenia poszczególnych typów raportów. Możesz też obejrzeć prezentację interfejsu Attribution Reporting API, aby zapoznać się ze szczegółowym przebiegiem całego procesu.

Warunek wstępny: zanim zarejestrujesz źródła, reguły i zaczniesz otrzymywać raporty, Twoje witryny muszą mieć certyfikaty SSL/TLS (HTTPS).

Generowanie raportów na poziomie zdarzenia

Aby wygenerować raporty na poziomie zdarzenia:

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

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

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

Więcej informacji o raportach na poziomie zdarzenia znajdziesz w artykule Wyjaśnienie raportów na poziomie zdarzenia.

Generowanie raportu zbiorczego

  1. Rejestrowanie źródła: to samo co w przypadku raportów na poziomie zdarzenia. Więcej informacji znajdziesz w artykułach Rejestrowanie źródeł atrybucji i Rejestrowanie źródła atrybucji.

  2. Rejestrowanie reguły: tak samo jak w przypadku raportów na poziomie zdarzenia. Zobacz artykuł Rejestrowanie aktywatorów atrybucji.

  3. Konfigurowanie punktu końcowego 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 artykule adtech.js, a informacje o metodie .well-known – w Wikipedii.

  4. Przesyłanie raportów zbiorczych w partiach: raporty zbiorcze są grupowane i przesyłane do usługi agregującej w celu przetwarzania. Usługa agregująca wygeneruje raporty podsumowujące. Więcej informacji znajdziesz w artykule Strategie grupowania.

Więcej informacji o raportach podsumowujących znajdziesz w artykule Wyjaśnienie raportów możliwych do zsumowania.

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

Konfigurowanie filtrów (opcjonalnie)

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

Filtrowanie zapewnia dokładną analizę danych, która pozwala wyodrębnić określone podzbiory danych na potrzeby analizy, co zmniejsza ilość zakłóceń. Pomaga też śledzić skuteczność konkretnych kampanii reklamowych i zdarzeń konwersji, co pozwala na dokładniejsze pomiary.

Aby skonfigurować filtrowanie, zapoznaj się z artykułem Definiowanie reguł niestandardowych za pomocą filtrów oraz z sekcją dotyczącą reguł w artykule Rejestracja reguły reguły atrybucji, w której znajdziesz szczegółowe informacje o raportach możliwych do agregacji.

Sprawdzanie, czy interfejs API jest włączony

Zanim użyjesz interfejsu API, sprawdź, czy jest on włączony, za pomocą tego kodu:

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

To sprawdzenie wskazuje, czy interfejs API jest dozwolony w bieżącym kontekście. Jednak ustawienia przeglądarki użytkownika lub inne czynniki mogą uniemożliwić korzystanie z interfejsu API. Ze względu na ochronę prywatności nie ma możliwości jednoznacznego potwierdzenia możliwości użycia interfejsu API za pomocą kodu.

Dalsze kroki

W sekcjach poniżej znajdziesz więcej informacji o tym, jak zacząć korzystać z raportowania atrybucji.

Implementacja

Wprowadzenie i koncepcje

Demonstracje i narzędzia

Planowanie