W tym dokumencie znajdziesz omówienie sposobu pomiaru kampanii i źródeł wizyt za pomocą pakietu SDK Google Analytics na Androida w wersji 3.
Przegląd
Pomiar kampanii w Google Analytics umożliwia przypisywanie kampanii i źródeł wizyt do działań użytkowników w aplikacji. W przypadku atrybucji kampanii i źródeł wizyt w pakiecie SDK Google Analytics na Androida dostępne są te opcje:
- Atrybucja kampanii w Google Play – możesz sprawdzać, które kampanie, witryny i inne aplikacje kierują użytkowników do Sklepu Google Play, gdzie mogą pobrać Twoją aplikację.
- Ogólna atrybucja kampanii i źródeł wizyt – możesz sprawdzać, które kampanie lub strony odsyłające uruchamiają Twoją aplikację po jej zainstalowaniu.
W sekcjach poniżej opisujemy, kiedy i jak wdrażać poszczególne rodzaje pomiarów kampanii w aplikacji.
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.
Tabela poniżej zawiera dostępne parametry 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 reklam. Ta wartość jest generowana dynamicznie i nie należy jej modyfikować. |
Ogólna atrybucja kampanii i źródeł wizyt
Po zainstalowaniu aplikacji może ona zostać uruchomiona przez odesłania z kampanii reklamowych, witryn lub innych aplikacji. W takim przypadku źródła wizyt z odesłań lub kampanie marketingowe można przypisać do aktywności użytkownika w kolejnych sesjach, ustawiając pola kampanii bezpośrednio w module śledzenia.
Na przykład ta implementacja sprawdza intencję, która uruchomiła aplikację, pod kątem parametrów kampanii Google Analytics:
package com.example.app; import com.google.analytics.tracking.android.Fields; import com.google.analytics.tracking.android.GoogleAnalytics; import com.google.analytics.tracking.android.MapBuilder; import com.google.analytics.tracking.android.Tracker; import android.app.Activity; import android.content.Intent; import android.net.Uri; import android.os.Bundle; import java.util.Map; /* * An example of how to implement general campaign attribution in Android. * * If the intent that launched the Activity has a URI, parse it for campaign * parameters and send the referring data to Google Analytics. */ public class MainActivity extends Activity { private static final String GA_PROPERTY_ID = "UA-XXXX-Y"; private static final String SCREEN_LABEL = "Home Screen"; // This examples assumes the use of Google Analytics campaign // "utm" parameters, like "utm_source". private static final String CAMPAIGN_SOURCE_PARAM = "utm_source"; Tracker mTracker; @Override public void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); mTracker = GoogleAnalytics.getInstance(this).getTracker(GA_PROPERTY_ID); } @Override public void onStart() { super.onStart(); // Set screen name on tracker so that all subsequent hits will use this // value. mTracker.set(Fields.SCREEN_NAME, SCREEN_LABEL); // Get the intent that started this Activity. Intent intent = this.getIntent(); Uri uri = intent.getData(); // Send a screenview using any available campaign or referrer data. MapBuilder.createAppView().setAll(getReferrerMapFromUri(uri)); } /* * Given a URI, returns a map of campaign data that can be sent with * any GA hit. * * @param uri A hierarchical URI that may or may not have campaign data * stored in query parameters. * * @return A map that may contain campaign or referrer * that may be sent with any Google Analytics hit. */ Map<String,String> getReferrerMapFromUri(Uri uri) { MapBuilder paramMap = new MapBuilder(); // If no URI, return an empty Map. if (uri == null) { return paramMap.build(); } // Source is the only required campaign field. No need to continue if not // present. if (uri.getQueryParameter(CAMPAIGN_SOURCE_PARAM) != null) { // MapBuilder.setCampaignParamsFromUrl parses Google Analytics campaign // ("UTM") parameters from a string URL into a Map that can be set on // the Tracker. paramMap.setCampaignParamsFromUrl(uri.toString()); // If no source parameter, set authority to source and medium to // "referral". } else if (uri.getAuthority() != null) { paramMap.set(Fields.CAMPAIGN_MEDIUM, "referral"); paramMap.set(Fields.CAMPAIGN_SOURCE, uri.getAuthority()); } return paramMap.build(); } }
Jeśli masz informacje o kampanii w innej formie niż parametry kampanii w Google Analytics, możesz je ustawić na Map
i wysłać ręcznie:
// May return null if EasyTracker has not yet been initialized with a property ID. EasyTracker easyTracker = EasyTracker.getInstance(this); easyTracker.set(Fields.SCREEN_NAME, "Home Screen"); // In this example, campaign information is set using a Map, rather than // a url string with Google Analytics campaign parameters. // Note that Fields.CAMPAIGN_KEYWORD is not necessary for this campaign. HashMap<String, String> campaignData = new HashMap<String, String>(); campaignData.put(Fields.CAMPAIGN_SOURCE, "email"); campaignData.put(Fields.CAMPAIGN_MEDIUM, "email marketing"); campaignData.put(Fields.CAMPAIGN_NAME, "summer_campaign"); campaignData.put(Fields.CAMPAIGN_CONTENT, "email_variation_1"); MapBuilder paramMap = MapBuilder.createAppView(); // Campaign data sent with this hit. // Note that the campaign data is set on the Map, not the tracker. easyTracker.send(paramMap .setAll(campaignData).build() );
Atrybucja 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, aby wszyscy deweloperzy zaimplementowali pomiar kampanii w Sklepie Google Play.
Wdrażanie atrybucji w kampaniach w Google Play
Gdy aplikacja zostanie pobrana ze Sklepu Google Play, podczas instalacji wyświetli się komunikat INTENT_REFERRER
. Ta intencja zawiera wartość parametru referrer
linku, który prowadzi do strony Twojej aplikacji w Sklepie Google Play (jeśli taka strona występowała).
Aby przypisać kampanii pobranie aplikacji, musisz dodać parametr referrer
do wszystkich linków prowadzących do Sklepu Google Play oraz dodać BroadcastReceiver
do aplikacji, aby otrzymywać i ustawiać informacje o kampanii zawarte w intencji w module śledzenia Google Analytics.
Zalecamy, aby większość deweloperów korzystała z pakietu BroadcastReceiver
w pakiecie SDK. Aby wdrożyć pomiar kampanii w Sklepie Google Play za pomocą uwzględnionego odbiornika:
1. Dodaj odbiornik Google Analytics do pliku AndroidManifest.xml
. Aby dodać odbiornik Google Analytics do pliku manifestu, skopiuj i wklej te znaczniki:
<!-- Used for Google Play Store Campaign 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 Google Analytics do adresów URL w Google Play
Następnie dodaj parametr referrer
do wszystkich adresów URL, które będą prowadzić bezpośrednio do Sklepu Google Play, i ustaw jego wartość na ciąg parametrów kampanii Google Analytics opisujących źródło, 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%3Dpodcast%252Bapps %26utm_content%3DdisplayAd1 %26utm_campaign%3Dpodcast%252Bgeneralkeywords
Aby dowiedzieć się, jak utworzyć ciągi parametrów kampanii, skorzystaj z Kreatora adresów URL w Google Play lub przeczytaj sekcję z informacjami o parametrach kampanii.
Kreator adresów URL w Google Play
Użyj tego narzędzia, aby wygenerować adresy URL na potrzeby pomiaru kampanii w Google Play.