W tym dokumencie znajdziesz omówienie sposobu pomiaru kampanii i źródeł wizyt za pomocą pakietu SDK Google Analytics na Androida w wersji 2.
Przegląd
Pomiar kampanii w Google Analytics pomaga zwiększać wartość kanałów marketingowych, umożliwiając przypisywanie kampanii i źródeł wizyt do aktywności użytkowników w aplikacji.
Pakiet SDK Google Analytics na Androida udostępnia kilka rodzajów pomiarów kampanii:
- Pomiary kampanii w Google Play – możesz sprawdzać, które kampanie, witryny i aplikacje odsyłają użytkownika do strony Twojej aplikacji w Sklepie Google Play, by pobrać aplikację.
- Pomiary kampanii ogólnych – możesz sprawdzać, w których kampaniach lub źródłach wizyt została uruchomiona aplikacja, w której została zainstalowana.
- Pomiary odesłań – sprawdź, które źródło odesłania, np. witryny lub inne aplikacje, uruchomiło Twoją aplikację po jej zainstalowaniu.
W sekcjach poniżej opisujemy, kiedy i jak wdrażać poszczególne rodzaje pomiarów kampanii w aplikacji.
Pomiary kampanii w Google Play
Dzięki pomiarowi kampanii w Google Play możesz sprawdzać, które kampanie i źródła wizyt zachęcają użytkowników do pobrania Twojej aplikacji ze Sklepu Google Play. Zalecamy wszystkim deweloperom wdrożenie pomiaru kampanii w Sklepie Google Play.
Jak działa pomiar kampanii w Google Play
Pomiary kampanii w Sklepie Google Play wykorzystują parametry kampanii, by przekazywać do aplikacji informacje o kampaniach i źródłach wizyt w momencie pobierania jej ze Sklepu Google Play.
Poniżej znajdziesz kompleksowy opis sposobu pomiaru kampanii w Google Play:
- Użytkownik klika link w reklamie, witrynie lub aplikacji, który prowadzi na stronę aplikacji w Sklepie Google Play. Link jest oznaczony tagiem Parametry kampanii.
- Gdy użytkownik pobierze i zainstaluje Twoją aplikację, Sklep Google Play przekaże na urządzenie intencję
INSTALL_REFERRER
, która będzie zawierać te same parametry kampanii. - Aplikacja zareaguje na tę intencję, korzystając z podanego poniżej obiektu
BroadcastReceiver
, odczytując parametry kampanii i używając ich do aktualizowania informacji o kampanii w Google Analytics.
Wdrożenie pomiarów kampanii w Google Play
Aby wdrożyć pomiar kampanii w Sklepie Google Play:
1. Dodaj nowy obiekt BroadcastReceivedr do pliku AndroidManifest.xml
Ten tag BroadcastReceiver
pozwala aplikacji odpowiadać na intencję INSTALL_REFERRER
przesłaną przez Sklep Google Play podczas jej instalacji. Dodaj go do pliku AndroidManifest.xml
w ten sposób:
<!-- Used for install referral measurement--> <service android:name="com.google.analytics.tracking.android.CampaignTrackingService"/> <receiver android:name="com.google.analytics.tracking.android.CampaignTrackingReceiver" android:exported="true"> <intent-filter> <action android:name="com.android.vending.INSTALL_REFERRER" /> </intent-filter> </receiver>
2. Dodaj parametry kampanii do linków do Sklepu Google Play
Parametry kampanii służą do przekazywania informacji o kampanii lub źródle wizyt, które odesłało użytkownika na stronę aplikacji w Sklepie Google Play, do jej implementacji Google Analytics.
Aby dowiedzieć się, jak utworzyć ciąg parametrów kampanii, skorzystaj z Kreatora adresów URL w Google Play lub przeczytaj sekcję z informacjami o parametrach kampanii.
Po utworzeniu ciągu parametrów kampanii dodaj go do adresów URL sklepu Google Play jako wartość parametru referrer
, jak w tym przykładzie:
https://play.google.com/store/apps/details?id=com.example.app &referrer=utm_source%3Dgoogle %26utm_medium%3Dcpc %26utm_term%3Drunning%252Bshoes %26utm_content%3DdisplayAd1 %26utm_campaign%3Dshoe%252Bcampaign
Sklep Google Play przekazuje wartość parametru referrer
tylko do implementacji Google Analytics w Twojej aplikacji, dlatego ważne jest, aby ten parametr znajdował się w linkach do Sklepu Google Play.
Pomiary kampanii ogólnych
Ogólny pomiar kampanii może służyć do powiązania kampanii lub źródła wizyt z użytkownikiem, który już zainstalował Twoją aplikację.
Jeśli na przykład prowadzisz płatną kampanię, aby dotrzeć do obecnych użytkowników, którzy zainstalowali już Twoją aplikację, możesz użyć ogólnego pomiaru kampanii, aby sprawdzić, które uruchomienia aplikacji były jej efektem.
Wdrażanie ogólnego pomiaru kampanii
Aby ustawić wartości kampanii w przypadku ogólnej kampanii, wywołaj funkcję setCampaign()
i przekaż ciąg znaków parametr kampanii jako argument.
Typowa implementacja może wywołać metodę setCampaign()
po uruchomieniu aplikacji i sprawdzić intencję, która ją uruchomiła, w celu sprawdzenia, czy są w niej dostępne prawidłowe parametry kampanii:
public class SampleActivity extends Activity { @Override public void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); // Get the intent that started this Activity. Intent intent = this.getIntent(); Uri uri = intent.getData(); // Call setContext() here so that we can access EasyTracker // to update campaign information before calling activityStart(). EasyTracker.getInstance().setContext(this); if (intent.getData() != null) { EasyTracker.getTracker().setCampaign(uri.getPath()); } ... // The rest of your onCreate() code. } @Override public void onStart() { super.onStart(); EasyTracker.getInstance().activityStart(this); ... // The rest of your onStart() code. } @Override public void onStop() { super.onStop(); EasyTracker.getInstance().activityStop(this); ... // The rest of your onStop() code. } }
Pomiar odesłań
Pomiar liczby odesłań jest podobny do innych rodzajów pomiarów kampanii, ponieważ umożliwia pomiar źródła odsyłającego, które uruchomiło aplikację na urządzeniu użytkownika. Jednak pomiar odesłań używa prostego ciągu znaków, np. „google.com” czy „mojaInnaaplikacja”, zamiast ciągu parametrów kampanii.
Gdy ustawisz źródło odesłań, np. „google.pl”, wymiarem źródła będzie „google.pl”, a jako wymiar medium – „strona odsyłająca”.
Tak jak przy pomiarze kampanii, ustawienie źródła odesłań będzie domyślnie powodować rozpoczęcie nowej sesji od następnego połączenia.
W tym fragmencie kodu zakładamy, że wszystkie linki, które otwierałyby Twoją aplikację, zostały otagowane za pomocą parametrów kampanii Google Analytics lub prostego parametru referrer
opisującego źródło odesłań. Jeśli parametr referrer
występuje, gdy nie ma innych parametrów kampanii, informacje o kampanii użytkownika zostaną zaktualizowane o nowe źródło odsyłające:
public class SampleActivity extends Activity { @Override public void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); // Get the intent that started this Activity. Intent intent = this.getIntent(); Uri uri = intent.getData(); // Call setContext() here so that we can access EasyTracker // to update campaign information before activityStart() is called. EasyTracker.getInstance().setContext(this); if (uri != null) { if(uri.getQueryParmeter("utm_source") != null) { // Use campaign parameters if avaialble. EasyTracker.getTracker().setCampaign(uri.getPath()); } else if (uri.getQueryParameter("referrer") != null) { // Otherwise, try to find a referrer parameter. EasyTracker.getTracker().setReferrer(uri.getQueryParameter("referrer")); } } } @Override public void onStart() { super.onStart(); EasyTracker.getInstance().activityStart(this); ... // The rest of your onStart() code. } @Override public void onStop() { super.onStop(); EasyTracker.getInstance().activityStop(this); ... // The rest of your onStop() code. } }
Znane problemy
- W pliku javadoc dotyczącym
CampaignTrackingReceiver
użyto w swoim przykładzie użycia nieprawidłowej ścieżki klasy. Informacje o prawidłowym stosowaniu tych pomiarów znajdziesz w artykule Wdrażanie pomiaru skuteczności kampanii w Google Play. - Dla każdej aplikacji można określić tylko jedną klasę
BroadcastReceiver
. Jeśli chcesz zastosować co najmniej 2 klasyBroadcastReceivers
z różnych pakietów SDK, musisz utworzyć własną klasęBroadcastReceiver
, która będzie odbierać wszystkie transmisje i wywoływać odpowiednią metodęBroadcastReceivers
dla każdego typu transmisji. - Pomiar kampanii w Google Play nie obsługuje obecnie instalacji z sieci na urządzenie inicjowanych ze Sklepu Play.
Parametry kampanii
Parametry kampanii służą do przekazywania informacji o źródłach wizyt i kampaniach, które zachęcają użytkowników do korzystania z aplikacji.
- Ogólnie do pomiaru skuteczności kampanii do funkcji
setCampaign()
przekazywany jest niezakodowany ciąg parametrów kampanii. - W pomiarze kampanii w Google Play parametr
referrer
z zakodowanym ciągiem znaków kampanii w postaci wartości jest dołączany do wszystkich adresów URL prowadzących do strony aplikacji w Sklepie Play.
Oto przykład prawidłowego, niezakodowanego ciągu znaków kampanii, którego można używać do ogólnego pomiaru skuteczności kampanii:
"utm_campaign=my_campaign&utm_source=google&utm_medium=cpc&utm_term=my_keyword&utm_content=ad_variation1"
Tabela poniżej zawiera pełną listę dostępnych parametrów kampanii, których można używać w Google Play i do ogólnego pomiaru kampanii.
Parametr | Opis | Przykłady |
---|---|---|
utm_campaign |
Nazwa kampanii służy do analizy słów kluczowych w celu identyfikacji określonej promocji produktu lub kampanii strategicznej | utm_campaign=spring_sale |
utm_source |
Źródło kampanii; służy do identyfikacji wyszukiwarki, newslettera lub innego źródła | utm_source=google |
utm_medium |
Medium kampanii; służy do identyfikacji medium, np. e-maila lub kosztu kliknięcia (cpc) | utm_medium=cpc |
utm_term |
Hasło kampanii; używane w płatnych wynikach wyszukiwania do dostarczania słów kluczowych do reklam | utm_term=running+shoes |
utm_content |
Treść kampanii; używana do testów A/B oraz reklam kierowanych na treść strony w celu rozróżnienia reklam lub linków kierujących do tego samego adresu URL |
utm_content=logolink
utm_content=textlink
|
gclid |
Parametr automatycznego tagowania Google Ads; służy do pomiaru Google Ads. Ta wartość jest generowana dynamicznie i nie należy jej modyfikować. |
Kreator adresów URL w Google Play
Za pomocą Kreatora adresów URL w Google Play wygeneruj adresy URL na potrzeby pomiaru kampanii w Google Play.