[GA4] Wysyłanie wywołań zwrotnych SKAdNetwork do Google Analytics

Z tego artykułu dowiesz się, jak wysyłać do Google Analytics wywołania zwrotne SKAdNetwork za pomocą Measurement Protocol.

Krok 1. Zarejestruj wywołania zwrotne SKAdNetwork dla odpowiednich wersji iOS

Więcej informacji znajdziesz w dokumentacji Apple. Klienci korzystający z pakietu SDK Google Analytics dla Firebase, który przeprowadza automatyczną rejestrację w imieniu aplikacji, mogą pominąć ten krok.

Krok 2. Upewnij się, że otrzymujesz i dekodujesz wywołania zwrotne SKAdNetwork

Więcej informacji znajdziesz w dokumentacji Apple. Jeśli nie masz skonfigurowanego punktu końcowego SKAdNetwork, zrób to, postępując zgodnie z dokumentacją firmy Apple. 

Uwaga: usługi Google Analytics 4 nie można obecnie skonfigurować jako punktu końcowego.

Jeśli punkt końcowy został już skonfigurowany przez zatwierdzonego przez Google partnera uczestniczącego w programie App Attribution Partner (AAP) lub dzięki rozwiązaniu wewnętrznemu, możesz przejść do kroku 3, który przeprowadzi Cię przez proces przekierowywania wyników do Google Analytics za pomocą Measurement Protocol.

Krok 3. Przekieruj wyniki wywołań zwrotnych do Google Analytics za pomocą Measurement Protocol

Aby to zrobić, wyślij do Google Analytics niestandardowe zdarzenie campaign_details za pomocą Measurement Protocol, korzystając z poniższego schematu (przykład: codelab). 

Implementacja SKAdNetwork Measurement Protocol w Google Analytics 4

Wszystkie parametry są wymagane, chyba że oznaczono je jako opcjonalne.

Parametry na poziomie żądania

Parametr	Więcej informacji
firebase_app_id: {gmp_app_id}	W Google Analytics 4 kliknij Administracja > Strumienie danych > wybierz strumień > Identyfikator aplikacji Firebase. Ustaw poza ładunkiem.
api_secret: {api_secret}	Aby utworzyć nowy obiekt tajny, w Google Analytics 4 kliknij Administracja > Strumienie danych > wybierz strumień > Measurement Protocol > Utwórz. Ustaw poza ładunkiem.
timestamp_micros: {timestamp of received SKAN postback}	Opcjonalne, ale jeśli podano, musi przypadać w ciągu ostatnich 72 godzin. Jeśli nie podano, użyjemy sygnatury czasowej kolekcji. Okno kluczowych zdarzeń w Google Analytics 4 w przypadku zdarzeń pozyskania wynosi 30 dni. Wywołania zwrotne należy przesyłać jak najszybciej, aby raporty były jak najbardziej precyzyjne.
app_instance_id: {...}	Wymagany. Wygeneruj unikalny ciąg losowych liczb. Po użyciu tych danych w modelowaniu konwersji ten konkretny ciąg identyfikatora zostanie odrzucony dla rzeczywistych identyfikatorów instancji aplikacji.

Zdarzenie GA

Zdarzenie	Więcej informacji
campaign_details	Zdarzenie niestandardowe.

Parametry Google Analytics (obecne)

Parametr	Więcej informacji
source: {source}	Te parametry są używane do ręcznego tagowania. Tworzenie raportów Google Analytics 4 odbywa się za pomocą domyślnych grupowań kanałów Google Analytics 4. Zalecamy stosowanie ich jako wzorca przy kategoryzowaniu poszczególnych parametrów. Wyślij te parametry dla wszystkich wywołań zwrotnych niepochodzących od Google. Przykład: Wywołanie zwrotne Facebooka: source: facebook medium: cpc|cpm content: ad_version_name kampania: kampania Wiosna ’22 na Facebooku  identyfikator kampanii: bez zmian w przypadku wywołania zwrotnego SKAN W przypadku wywołań zwrotnych Google będziemy dekodować kampanie na podstawie integracji Twojej usługi z Google Ads. Dlatego opisane wyżej parametry są opcjonalne w przypadku wywołań zwrotnych Google. Musisz się upewnić, że usługa w Google Analytics 4 jest połączona z Twoimi kontami reklamowymi Google Ads.  Uwaga: wszystkie wywołania zwrotne SKAdNetwork, nie tylko spoza Google, należy wysyłać do Google Analytics 4.
medium: {medium}
term: {term}  Opcjonalnie
content: {content} Opcjonalnie
campaign_id: {campaign_id}	Wartość wywołania zwrotnego SKAdNetwork.
campaign: {campaign} Opcjonalnie, ale bez tej wartości parametr będzie wyświetlany jako (nie ustawiono)	W przypadku kampanii Google Ads dekodujemy identyfikator i podajemy nazwę kampanii na podstawie połączenia Google Analytics i Google Ads. Na tej podstawie aktualizujemy też parametry źródła i medium. Jeśli konta nie są połączone, nie będziemy dekodować identyfikatorów kampanii Google i użyjemy określonych parametrów źródła i medium. W przypadku kampanii spoza Google Ads możesz dekodować i podać nazwy kampanii. Jeśli go nie znasz, możesz skopiować identyfikator kampanii SKAdNetwork. Uwaga: jeśli wartość nie zostanie podana, będzie wyświetlana jako (nie ustawiono).
source_platform: „apple_skan”	Ważne: musisz dokładnie określić ten ciąg, pamiętając o uwzględnieniu wielkich liter i _.
app_id: {app_id}	Wartość wywołania zwrotnego SKAdNetwork. Jest to identyfikator pakietu aplikacji.
transaction_id: {transaction_id}	Wartość wywołania zwrotnego SKAdNetwork.

Wymagane nowe parametry

Uwaga: nowe parametry możesz skonfigurować w interfejsie Google Analytics 4, nie jest to jednak wymagane. Jeśli chcesz widzieć raporty o wymiarach niestandardowych wygenerowane na podstawie tych parametrów, musisz je zarejestrować w Google Analytics 4.

Parametr	Więcej informacji
version: {version}	Wartość wywołania zwrotnego SKAdNetwork
conversion_value: {conversion_value}	Wartość wywołania zwrotnego SKAdNetwork
fidelity_type: {fidelity_type}	Wartość wywołania zwrotnego SKAdNetwork.
attribution_signature: {attribution_signature}	Wartość wywołania zwrotnego SKAdNetwork. Uwaga: jest to funkcja zabezpieczeń. Wywołania zwrotne SKAdNetwork są podpisane kryptograficznie.
redownload: {redownload}	Wartość wywołania zwrotnego SKAdNetwork.
source_app_id: {source_app_id}	Wartość wywołania zwrotnego SKAdNetwork. Uwaga: jest to identyfikator aplikacji, w której kliknięto reklamę, co doprowadziło do instalacji.
did_win: {did_win}	Wartość wywołania zwrotnego SKAdNetwork. Uwaga: reklamodawcy otrzymują tylko wygrane wywołania zwrotne. Miejsca, w których AdTech będzie otrzymywać wygrane wywołania zwrotne i wywołania z drugiej pozycji lub wywołania wspomagające.
ad_network_id: {ad_network_id} Gdzie {ad_network_id} reprezentuje wartość wywołania zwrotnego.	Wartość wywołania zwrotnego SKAdNetwork. Pokazuje sieć reklamową, która wyświetliła Twoją reklamę. Przydaje się to także do określania wymiaru „source”.

 

Krok 4. Sprawdź, czy odbierasz działania Marketing Platform

Zdarzenia campaign_details nie są wyświetlane bezpośrednio w Google Analytics. Wywołania zwrotne SKAdNetwork są zamiast tego przekształcane w zdarzenia i uwzględniane w zdarzeniach kluczowych i raportowaniu zdarzeń first_open. Można je segmentować, dodając platformę źródłową wymiaru (source platform = SKAN).

Jeśli chcesz się upewnić, że działania są wysyłane, zalecamy zarejestrowanie zdarzeń testowych, duplikując zdarzenia campaign_details przy użyciu innej nazwy zdarzenia (np. campaign_details_skan_test). Następnie możesz sprawdzić, czy zdarzenia testowe pojawiają się w raporcie Czas rzeczywisty w Google Analytics 4. Jeśli zarejestrujesz zdarzenie testowe i parametry, pojawią się one nie tylko w raporcie Czas rzeczywisty, ale też w raportach bieżących.

Uwagi:

• Jeśli chcesz, aby wszystkie wywołania zwrotne SKAdNetwork pojawiały się w raportach, musisz nie tylko wysłać je jako zdarzenia campaign.details, ale także zarejestrować zduplikowane zdarzenie i parametry w sposób opisany powyżej. Jeśli to zrobisz, wywołania zwrotne SKAdNetwork nadal będą musiały być wysyłane za pomocą zdarzenia campaign.details. W przeciwnym razie Google Analytics ich nie rozpozna i nie będzie mieć możliwości modelowania atrybucji w celu ulepszenia raportowania first_open w iOS. 
• Wywołania zwrotne SKAdNetwork muszą zostać wysłane w ciągu 4 dni od ich otrzymania, aby usługa Google Analytics mogła wykorzystać je w modelowaniu i raportowaniu konwersji.

Dowiedz się więcej o ogólnych krokach weryfikacji.