Attribution Reporting API: przewodnik po integracji

Podczas czytania dokumentacji dotyczącej Piaskownicy prywatności na Androida użyj przycisku Podgląd dla deweloperów lub Beta, aby wybrać wersję programu, z którą pracujesz, ponieważ instrukcje mogą się różnić.

Interfejs Attribution Reporting API ma obsługiwać najważniejsze przypadki pomiaru konwersji i przypisywania udziału w konwersji w aplikacjach i w internecie bez konieczności korzystania z identyfikatorów użytkowników należących do innych firm. W porównaniu z obecnymi typowymi rozwiązaniami wdrożeni interfejsu Attribution Reporting API powinni wziąć pod uwagę kilka ważnych kwestii ogólnych:

  • Raporty na poziomie zdarzenia zawierają dane o konwersjach o niskiej jakości. Niewielka liczba wartości konwersji sprawdza się dobrze.
  • Raporty możliwe do zsumowania zawierają bardziej szczegółowe dane o konwersjach. Klucze agregacji powinny być projektowane zgodnie z wymaganiami biznesowymi i ograniczeniem 128-bitowym.
  • Modele danych i przetwarzanie Twojego rozwiązania powinny uwzględniać limity szybkości dla dostępnych wyzwalaczy, opóźnienia w wysyłaniu zdarzeń wyzwalających oraz szum wprowadzony przez interfejs API.

Aby ułatwić Ci planowanie integracji, ten przewodnik zawiera obszerne informacje, które mogą obejmować funkcje, które nie zostały jeszcze zaimplementowane na obecnym etapie Piaskownicy prywatności w wersji testowej Androida dla deweloperów. W takich przypadkach podajemy wskazówki dotyczące harmonogramu.

Na tej stronie źródło reprezentuje kliknięcie lub obejrzenie, a wyzwalacz – konwersję.

Wykres poniżej przedstawia różne opcje przepływu pracy dotyczące integracji atrybucji. Sekcje wymienione w tej samej kolumnie (oznaczone na zielono) mogą być rozpatrywane równolegle. Na przykład zaangażowanie partnera może być rozpatrywane jednocześnie z przypisaniem na poziomie zdarzenia w przypadku przejścia z jednej aplikacji do drugiej.

Schemat przepływu pracy w ramach integracji atrybucji

Rysunek 1. Proces integracji atrybucji

Wymagania wstępne i konfiguracja

Aby lepiej zrozumieć interfejs Attribution Reporting API, wykonaj czynności opisane w tej sekcji. Dzięki tym czynnościom możesz uzyskać wiarygodne wyniki podczas korzystania z interfejsu API w ekosystemie technologii reklamowych.

Zapoznanie się z interfejsem API

  1. Aby zapoznać się z interfejsem AttributionReporting API i jego możliwościami, przeczytaj propozycję projektu.
  2. Aby dowiedzieć się, jak włączyć kod i wywołania interfejsu API, których potrzebujesz do swoich zastosowań, przeczytaj przewodnik dla programistów.
  3. Zarejestruj się, aby otrzymywać informacje o atrybucji raportowania interfejsu API. Dzięki temu będziesz na bieżąco z nowymi funkcjami wprowadzanymi w przyszłych wersjach.

Konfigurowanie i testowanie przykładowej aplikacji

  1. Gdy będziesz gotowy do rozpoczęcia integracji, użyj najnowszej wersji podglądu dla programistów w Android Studio.
  2. Skonfiguruj punkty końcowe serwera symulowanego na potrzeby rejestracji zdarzeń i przesyłania raportów. Udostępniliśmy makiety, których możesz używać w połączeniu z dostępnymi w internecie narzędziami.
  3. Pobierz i uruchom kod w naszej przykładowej aplikacji, aby zapoznać się z rejestrowaniem źródeł i wyzwalaniem.
    1. Ustaw przedział czasu na wysyłanie raportów. Interfejs API obsługuje okresy 2, 7 dni lub niestandardowy okres w zakresie od 2 do 30 dni.
    2. Gdy zarejestrujesz źródła i reguły, uruchamiając i korzystając z próbnej aplikacji, oraz upewnisz się, że upłynął ustawiony okres, sprawdź, czy otrzymałeś/otrzymałaś raport na poziomie zdarzenia i zaszyfrowany raport zbiorczy. Jeśli chcesz debugować raporty, możesz je generować szybciej, wymusając wykonanie zadań raportowania.
    3. Sprawdź wyniki atrybucji z jednej aplikacji do drugiej. Sprawdź, czy dane w tych wynikach są zgodne z oczekiwaniami w przypadku zarówno ostatniego kontaktu, jak i przypadku po instalacji.

  4. Gdy już zapoznasz się z działaniem interfejsu API po stronie klienta i serwera, możesz skorzystać z przykładowej aplikacji jako wskazówki do własnej integracji. Skonfiguruj własny serwer produkcyjny i dodaj do aplikacji wywołania rejestracji zdarzeń.

Przed integracją

Zarejestruj swoją organizację w Piaskownicy prywatności na Androida. Ta rejestracja ma na celu zapobieganie niepotrzebnemu powielaniu platform technologicznych reklam, które mogłoby umożliwić dostęp do większej liczby informacji o czynnościach użytkownika niż jest to konieczne.

Współpraca z partnerem

Partnerzy technologiczni (MMP/SSP/DSP) często tworzą zintegrowane rozwiązania do atrybucji. W tej sekcji znajdziesz wskazówki, które pomogą Ci nawiązać skuteczną współpracę z partnerami z branży adtech.

  1. Umów się na rozmowę z najlepszymi partnerami dokonującymi pomiarów, aby omówić testowanie i wdrażanie interfejsu Attribution Reporting API. Partnerzy świadczący usługi pomiarowe to sieci reklamowe, platformy SSP, platformy DSP, reklamodawcy i inni partnerzy, z którymi obecnie współpracujesz lub z którymi chcesz współpracować.
  2. Współpracuj z partnerami świadczącymi usługi pomiaru, aby określić harmonogram integracji, od wstępnego testowania do wdrożenia.
  3. Ustal ze swoimi partnerami świadczącymi usługi pomiarowe, które obszary będziecie obejmować w swoich projektach dotyczących atrybucji.
  4. Ustanowić kanały komunikacji między partnerami ds. pomiarów na potrzeby synchronizacji harmonogramów i kompleksowego testowania.
  5. Zaprojektuj ogólne przepływy danych między partnerami świadczącymi usługi pomiarowe. Najważniejsze kwestie:
    • Jak partnerzy świadczący usługi pomiarów będą rejestrować źródła atrybucji za pomocą interfejsu Attribution Reporting API?
    • Jak sieci reklamowe będą rejestrować wyzwalacze za pomocą interfejsu Attribution Reporting API?
    • W jaki sposób każda firma zajmująca się technologiami reklamowymi będzie weryfikować żądania interfejsu API i zwracać odpowiedzi na pełne rejestracje źródeł i wyzwalania?
    • Czy są jakieś raporty, które należy udostępniać partnerom poza interfejsem Attribution Reporting API?
    • Czy są jakieś inne punkty integracji lub wymagane dostosowanie wśród partnerów? Na przykład czy Ty i Twoi partnerzy musicie pracować nad usuwaniem duplikatów konwersji czy nad dostosowaniem kluczy agregacji?
  6. Jeśli atrybucja z aplikacji do witryny jest odpowiednia, umów się na rozmowę z partnerami zajmującymi się pomiarem w internecie, aby omówić projektowanie, testowanie i wdrażanie interfejsu Attribution Reporting API. Zanim rozpoczniesz rozmowy z partnerami internetowymi, zapoznaj się z pytaniami z poprzedniego kroku.

Prototyp atrybucji na poziomie zdarzenia z aplikacji do aplikacji

W tej sekcji znajdziesz wskazówki, jak skonfigurować podstawową atrybucję aplikacji do aplikacji za pomocą raportów na poziomie zdarzenia w aplikacji lub pakiecie SDK. Przed rozpoczęciem prototypowania atrybucji serwera agregacji musisz wypełnić tę sekcję.

  1. Skonfiguruj serwer zbierania danych o zdarzeniach. Możesz to zrobić, używając specyfikacji, aby wygenerować serwer testowy, lub skonfigurować własny serwer za pomocą przykładowego kodu serwera.
  2. Dodaj do pakietu SDK lub aplikacji wywołania zdarzenia register source, gdy wyświetlane są reklamy.
    • Najważniejsze kwestie:
      • Upewnij się, że identyfikatory zdarzeń źródła są dostępne i są prawidłowo przekazywane do wywołań interfejsu API rejestracji źródła.
      • Upewnij się, że możesz też przekazać zdarzenie InputEvent, aby zarejestrować źródła kliknięć.
      • Określ, jak skonfigurujesz priorytet źródła dla różnych typów zdarzeń. Możesz na przykład przypisać wysoki priorytet zdarzeniom, które są uznawane za zdarzenia o wysokiej wartości, takim jak kliknięcia zamiast wyświetleń.
      • Wartość domyślna dla daty wygaśnięcia jest odpowiednia do testowania. Możesz też skonfigurować różne okresy ważności.
      • Na potrzeby testów filtry i okna atrybucji mogą pozostać domyślne.
    • Opcjonalne kwestie do rozważenia:
      • Zaprojektuj klucze agregacji, jeśli są Ci potrzebne.
      • Określając sposób współpracy z innymi partnerami świadczącymi usługi pomiarowe, zastanów się nad strategią przekierowań.
  3. Aby rejestrować zdarzenia konwersji, dodaj do pakietu SDK lub aplikacji zdarzenia inicjujące rejestrację.
    • Najważniejsze kwestie:
    • Opcjonalne kwestie do rozważenia:
      • Pomiń tworzenie kluczy deduplikacji, dopóki nie przeprowadzisz testów dokładności.
      • Pomiń tworzenie kluczy i wartości agregacji, dopóki obsługa testowania symulacji nie będzie gotowa.
      • Pomiń przekierowania, dopóki nie ustalisz, jak chcesz współpracować z innymi partnerami pomiarowymi.
      • Priorytet wyzwalacza nie jest niezbędny do testowania.
      • Filtry można pominąć podczas wstępnego testowania.
  4. Sprawdź, czy zdarzenia źródłowe są generowane w przypadku reklam i czy wyzwalacze prowadzą do tworzenia raportów zdarzeń.

Testowanie symulacji

W tej sekcji znajdziesz instrukcje testowania wpływu przeniesienia obecnych konwersji na raporty o wydarzeniu i raporty podlegające agregacji na systemy raportowania i optymalizacji. Dzięki temu możesz rozpocząć testy wpływu przed zakończeniem integracji.

Testowanie polega na symulowaniu generowania raportów o zdarzeniach i zbiorczych na podstawie posiadanych przez Ciebie historycznych rekordów konwersji, a następnie uzyskiwaniu zbiorczych wyników z symulowanego serwera agregacji. Możesz je porównać z historycznymi liczbami konwersji, aby sprawdzić, jak zmieni się dokładność raportowania.

Modele optymalizacji, takie jak obliczenia przewidywanej skuteczności konwersji, można trenować na podstawie tych raportów, aby porównywać dokładność tych modeli z modelami utworzonymi na podstawie bieżących danych. To też okazja do eksperymentowania z różnymi strukturami kluczy agregacji i ich wpływem na wyniki.

  1. Skonfiguruj bibliotekę symulacji pomiarów na komputerze lokalnym.
  2. Zapoznaj się ze specyfikacją dotyczącą formatu danych konwersji, który musi być zgodny z generowaniem raportów symulowanych.
  3. Zaprojektuj klucze agregacji zgodnie z wymaganiami biznesowymi.
    • Najważniejsze kwestie:
      • Zastanów się, które kluczowe wymiary muszą agregować Twoi klienci lub partnerzy, i skoncentruj się na nich podczas oceny.
      • Określ minimalną liczbę wymiarów zbiorczych i kardinalności, których potrzebujesz.
      • Upewnij się, że fragmenty klucza po stronie źródła i strona wyzwalacza nie przekraczają 128 bitów.
      • Jeśli Twoje rozwiązania składają się z wielu wartości na zdarzenie uruchamiające, pamiętaj, aby skalować wartości zgodnie z maksymalnym budżetem udziału (L1). Pomoże to zminimalizować wpływ szumu.
      • Przykład pokazujący ustawienie klucza do zbierania zbiorczych liczb konwersji na poziomie kampanii oraz klucza do zbierania zbiorczych wartości zakupów na poziomie geograficznym.
  4. Uruchom generator raportów, aby utworzyć raporty zdarzeń i raporty podlegające agregacji.
  5. Aby uzyskać raporty zbiorcze, uruchom raporty podlegające agregacji na symulowanych serwerach agregacji.
  6. Przeprowadzanie eksperymentów dotyczących użyteczności:
    • Aby określić dokładność raportowania konwersji, porównaj łączne liczby konwersji w raportach na poziomie zdarzenia i w raportach podsumowujących z danymi o konwersjach z danych historycznych. Aby uzyskać najlepsze wyniki, przeprowadzaj testy raportowania i porównania na dużej, reprezentatywnej próbie reklamodawców.
    • przetrenować modele na podstawie danych z raportów na poziomie zdarzenia i ewentualnie danych z raportów podsumowujących; Porównaj dokładność modeli utworzonych na podstawie historycznych danych treningowych.
    • Wypróbuj różne strategie grupowania i sprawdź, jak wpływają one na Twoje wyniki.
      • Najważniejsze kwestie:
      • Harmonogramy raportów podsumowujących do dostosowywania stawek.
      • Średnia częstotliwość zdarzeń przypisanych do urządzenia. Na przykład powracających użytkowników na podstawie danych o historycznych zdarzeniach zakupu.
      • Poziom hałasu. Więcej partii oznacza mniejsze agregacje, a mniejsze agregacje oznaczają stosowanie większego szumu.

Atrybucja na serwerze agregacji prototypu: konfiguracja

Dzięki temu będziesz otrzymywać raporty z możliwością agregacji z źródła i zdarzeń uruchamiających.

  1. Skonfiguruj serwer agregacji:
    • Skonfiguruj konto AWS.
    • Zarejestruj się w usłudze agregacji u swojego koordynatora.
    • Skonfiguruj serwer agregacji w AWS na podstawie dostarczonych plików binarnych.
  2. Zaprojektuj klucze agregacji zgodnie z wymaganiami biznesowymi. Jeśli to zadanie zostało już wykonane w sekcji Przekazywanie danych między aplikacjami na poziomie zdarzenia, możesz pominąć ten krok.
  3. Skonfiguruj serwer zbiorczy do zbierania danych. Jeśli masz już utworzone takie zdarzenie w sekcji Zdarzenia między aplikacjami, możesz je ponownie użyć.

Prototyp atrybucji serwera agregacji: integracja

Aby przejść dalej, musisz wypełnić sekcję Prototypowy pomiar skuteczności serwera agregacji: konfiguracja lub Prototypowy pomiar skuteczności aplikacji na poziomie zdarzenia**.

  1. Dodaj do źródła dane klucza agregacji i wyzwalaj zdarzenia. Prawdopodobnie będzie to wymagać przekazania do pakietu SDK lub aplikacji większej ilości danych o zdarzeniu reklamy, np. identyfikatora kampanii, aby można było uwzględnić je w kluczu agregacji.
  2. Zbieraj raporty z możliwością agregacji między aplikacjami z źródła i wyzwalaj zdarzenia, które zostały zarejestrowane za pomocą danych klucza agregacji.
  3. Podczas uruchamiania tych raportów na serwerze agregacji możesz testować różne strategie grupowania i sprawdzać, jak wpływają one na wyniki.

ulepszać projekt, dodając opcjonalne funkcje;

Poniżej znajdziesz dodatkowe funkcje, które możesz uwzględnić w swoim rozwiązaniu do pomiarów.

  1. Ustawienie klucza debugowania pozwoli Ci otrzymywać niezmieniony raport o źródle lub zdarzeniu wywołującym wraz z raportami generowanymi przez Attribution Reporting API. Kluczy debugowania możesz używać do porównywania raportów i wyszukiwania błędów podczas integracji.

Dostosowywanie zachowań atrybucji

  1. Atrybucja w przypadku reguł po instalacji
    • Tej funkcji można używać w przypadku, gdy wyzwalacze po instalacji muszą zostać przypisane do tego samego źródła atrybucji, które spowodowało instalację, nawet jeśli istnieją inne kwalifikujące się źródła atrybucji, które wystąpiły później.
    • Może się np. zdarzyć, że użytkownik kliknie reklamę, która prowadzi do instalacji. Po zainstalowaniu użytkownik klika inną reklamę i kupuje produkt. W takim przypadku firma technologiczna zajmująca się reklamami może chcieć, aby zakup został przypisany do pierwszego kliknięcia, a nie do kliknięcia w celu ponownego zaangażowania.
  2. Używanie filtrów do dokładnego dopasowywania danych w raportach na poziomie zdarzenia
    • Filtry konwersji mogą ignorować wybrane reguły i wykluczać je z raportów zdarzeń. Ze względu na ograniczenia dotyczące liczby wyzwalaczy na źródło atrybucji filtry umożliwiają uwzględnianie w raportach o zdarzeniach tylko tych wyzwalaczy, które dostarczają najbardziej przydatnych informacji.
    • Filtrów możesz też używać do selektywnego odfiltrowywania niektórych reguł, co oznacza, że będą one ignorowane. Jeśli np. masz kampanię kierowaną na instalacje aplikacji, możesz odfiltrować wyzwalacze po instalacji, aby nie były przypisywane do źródeł z tej kampanii.
    • Filtrów możesz też używać do dostosowywania danych reguły na podstawie danych źródłowych. Źródło może na przykład określić "product" : ["1234"], gdzie product jest kluczem filtra, a 1234 jest wartością. Każdy wyzwalacz z kluczem filtra „product” o wartości innej niż „1234” jest ignorowany.
  3. Priorytet źródła i wyzwalacza
    • Jeśli z regułą można powiązać wiele źródeł atrybucji lub jeśli źródło może być przypisane do wielu reguł, możesz użyć przypisanej liczby całkowitej 64-bitowej, aby nadać priorytet niektórym regułom/źródłom.

Współpraca z usługami MMP i innymi usługami

  1. Przekierowanie do innych firm zewnętrznych w przypadku zdarzeń źródłowych i wyzwalaczy
    • Możesz ustawić adresy URL przekierowań, aby umożliwić rejestrowanie żądania przez wiele platform reklamowych. Możesz go użyć, aby włączyć usuwanie duplikatów w przypisaniu między sieciami.
  2. Klucze deduplikacji
    • Gdy reklamodawca używa kilku platform technologii reklamowych do rejestrowania tego samego zdarzenia uruchamiającego, może użyć klucza deduplikacji, aby odróżnić te powtarzające się raporty. Jeśli nie podasz klucza deduplikacji, zduplikowane wyzwalacze mogą być raportowane do każdej platformy technologicznej reklam jako unikalne.

Praca z pomiarami na wielu platformach

  1. Atrybucja w wielu aplikacjach i na stronie internetowej (dostępna pod koniec IV kwartału)
    • Obsługuje przypadki, gdy użytkownik widzi reklamę w aplikacji, a potem dokonuje konwersji w przeglądarce mobilnej lub przeglądarce w aplikacji albo odwrotnie.