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.
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
Parametry na poziomie żądania
Parametr | Więcej informacji |
firebase_app_id: {gmp_app_id} |
|
api_secret: {api_secret} |
|
timestamp_micros: {timestamp of received SKAN postback} |
|
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:
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.
- 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ą zdarzeniacampaign.details
. W przeciwnym razie Google Analytics ich nie rozpozna i nie będzie mieć możliwości modelowania atrybucji w celu ulepszenia raportowaniafirst_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.