Pomiar skuteczności kampanii – pakiet SDK na Androida w wersji 2 (starsza wersja)

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:

  1. 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.
  2. 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.
  3. 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 klasy BroadcastReceivers 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.