Pomiar skuteczności kampanii – pakiet SDK na Androida

Ważne: w tym dokumencie opisano starszą wersję pakietu SDK. Nowi użytkownicy powinni używać najnowszego pakietu SDK.

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.

Korzystasz z automatycznego tagowania Google Ads? Jeśli linki do Sklepu Google Play zostały automatycznie otagowane, nie musisz wykonywać żadnych dodatkowych czynności. Dowiedz się, jak włączyć automatyczne tagowanie Google Ads

Kreator adresów URL w Google Play

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