Pomiar kampanii – pakiet SDK do Androida

W tym dokumencie znajdziesz przegląd sposobu mierzenia kampanii i źródeł wizyt za pomocą pakietu SDK Google Analytics na Androida w wersji 3.

Omówienie

Pomiar kampanii w Google Analytics umożliwia atrybucję kampanii i źródeł wizyt dla działań użytkowników w aplikacji. W pakiecie SDK Google Analytics na Androida dostępne są te opcje atrybucji kampanii i źródła wizyt:

W sekcjach poniżej opisujemy, kiedy i jak implementować w aplikacji różne rodzaje pomiarów.

Parametry kampanii

Parametry kampanii służą do przekazywania informacji o źródłach wizyt i kampaniach, które przyciągają użytkowników do Twojej aplikacji.

Poniższa tabela zawiera dostępne parametry kampanii, których można używać w Google Play i w ogólnych pomiarach kampanii:

Parametr Opis Przykłady
utm_campaign Nazwa kampanii używana do analizy słów kluczowych w celu zidentyfikowania promocji produktu lub kampanii strategicznej. utm_campaign=spring_sale
utm_source Źródło kampanii używane do identyfikowania wyszukiwarki, newslettera lub innego źródła. utm_source=google
utm_medium Medium kampanii – służy do identyfikowania medium, np. e-mail lub koszt kliknięcia (CPC) utm_medium=cpc
utm_term Hasło kampanii; używane w płatnych wynikach wyszukiwania do podawania słów kluczowych do reklam utm_term=running+shoes
utm_content Treść kampanii; używana do testów A/B i reklam kierowanych na treść do rozróżniania reklam lub linków prowadzących do tego samego adresu URL utm_content=logolink
utm_content=textlink
gclid Parametr automatycznego tagowania Google Ads służący do pomiaru reklam. Ta wartość jest generowana dynamicznie i nie należy jej zmieniać.

Ogólna atrybucja kampanii i źródeł wizyt

Po zainstalowaniu aplikacji może ona być uruchamiana przez odesłania z kampanii reklamowych, witryn lub innych aplikacji. W tym scenariuszu źródła wizyt lub kampanie marketingowe można przypisać do działań użytkowników w kolejnych sesjach, ustawiając pola kampanii bezpośrednio w narzędziu do śledzenia.

Poniższa implementacja sprawdza intencję, która wprowadziła aplikację na potrzeby 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 informacje o kampanii mają inny format niż parametry kampanii Google Analytics, możesz też umieścić je w tagu Map i przesł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 w kampaniach w Google Play

Dzięki pomiarowi skuteczności kampanii w Google Play możesz sprawdzić, które kampanie i źródła wizyt kierują użytkowników do pobrania Twojej aplikacji ze Sklepu Google Play. Zalecamy, aby wszyscy deweloperzy zastosowali pomiar kampanii w Sklepie Google Play.

Implementacja atrybucji kampanii w Google Play

Gdy aplikacja pobiera aplikację ze Sklepu Google Play, podczas jej instalowania aplikacja INTENT_REFERRER rozpowszechnia jej wiadomość. Ta intencja zawiera wartość parametru referrer linku używanego do otwarcia strony aplikacji w Sklepie Google Play (jeśli był on dostępny).

Aby przypisać aplikację do kampanii, musisz dodać parametr referrer do wszystkich linków wskazujących Sklep Google Play i dodać do aplikacji tag BroadcastReceiver, aby odbierać i ustawiać informacje o kampanii zawarte w tagu śledzenia Google Analytics.

Zalecamy, aby większość deweloperów korzystała z pakietu BroadcastReceiver podanego w pakiecie SDK. Aby wdrożyć pomiar kampanii w Sklepie Google Play za pomocą dołączonego odbiornika:

1. Dodaj odbiornik Google Analytics do pliku AndroidManifest.xml. Aby dodać do pliku manifestu odbiornik Google Analytics, 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, tak 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 tworzyć ciągi parametrów kampanii, skorzystaj z kreatora adresów URL w Google Play lub zapoznaj się z sekcją Parametry kampanii.

Kreator adresów URL Google Play

Użyj tego narzędzia, aby wygenerować adresy URL do pomiaru kampanii w Google Play.