Kampagnenanalyse – Android SDK Version 2 (alte Version)

In diesem Dokument erhalten Sie eine Übersicht über die Analyse von Kampagnen und Besucherquellen mit dem Google Analytics SDK for Android Version 2.

Überblick

Durch das Messen von Kampagnen in Google Analytics können Sie den Wert Ihrer Marketingkanäle steigern, indem Sie die Attribution von Kampagnen und Besucherquellen zur Nutzeraktivität innerhalb Ihrer App aktivieren.

Im Google Analytics SDK for Android stehen verschiedene Arten der Kampagnenanalyse zur Verfügung:

• Google Play-Kampagnenanalyse – Hier siehst du, über welche Kampagnen, Websites und Apps Nutzer auf die Google Play Store-Seite deiner App weitergeleitet wurden, um deine App herunterzuladen.
• Allgemeine Kampagnen messen – Hier sehen Sie, über welche Kampagnen oder Besucherquellen Ihre App gestartet wurde.
• Verweise messen: Hier sehen Sie, über welche verweisende Besucherquelle, z. B. Websites oder andere Apps, Ihre App nach der Installation gestartet hat.

In den folgenden Abschnitten erfahren Sie, wann und wie Sie die einzelnen Arten von Kampagnenanalysen in Ihrer App implementieren.

Google Play-Kampagnenanalyse

Mit der Kampagnenanalyse bei Google Play können Sie feststellen, über welche Kampagnen und Besucherquellen Nutzer Ihre App im Google Play Store herunterladen. Wir empfehlen allen Entwicklern, die Kampagnenanalyse im Google Play Store zu implementieren.

So funktioniert die Google Play-Kampagnenanalyse

Für die Google Play Store-Kampagnenanalyse werden Kampagnenparameter verwendet, um Informationen zu Kampagnen und Besucherquellen an Ihre App zu übergeben, wenn diese aus dem Google Play Store heruntergeladen wird.

Im Folgenden finden Sie eine vollständige Beschreibung der Funktionsweise der Google Play-Kampagnenanalyse:

1. Ein Nutzer klickt auf einen Link in einer Anzeige, auf einer Website oder in einer App, über den er zur Google Play Store-Seite deiner App gelangt. Der Link ist mit Kampagnenparametern gekennzeichnet.
2. Nachdem der Nutzer Ihre App heruntergeladen und installiert hat, sendet der Google Play Store einen INSTALL_REFERRER-Intent auf dem Gerät, der dieselben Kampagnenparameter enthält.
3. Ihre App reagiert dann auf diesen Intent mit dem unten angegebenen BroadcastReceiver-Objekt, liest die Kampagnenparameter aus und verwendet sie, um die Google Analytics-Kampagneninformationen zu aktualisieren.

Die Google Play-Kampagnenmessung wird implementiert,

So implementieren Sie die Kampagnenanalyse für den Google Play Store:

1. Einen neuen BroadcastReceiver zur Datei „AndroidManifest.xml“ hinzufügen

Mit dem folgenden BroadcastReceiver kann deine App auf den INSTALL_REFERRER-Intent-Broadcast vom Google Play Store reagieren, wenn deine App installiert wird. Fügen Sie ihn der Datei AndroidManifest.xml so hinzu:

<!-- 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. Google Play Store-Verknüpfungen Kampagnenparameter hinzufügen

Kampagnenparameter werden verwendet, um Informationen zur Kampagne oder Besucherquelle zu übergeben, über die ein Nutzer auf die Google Play Store-Seite Ihrer App gelangt ist, und an die Google Analytics-Implementierung Ihrer App übergeben.

Wie Sie einen String für Kampagnenparameter erstellen, erfahren Sie im Tool zur URL-Erstellung für Google Play. Alternativ können Sie auch den Referenzabschnitt Kampagnenparameter lesen.

Nachdem Sie den String für den Kampagnenparameter erstellt haben, fügen Sie ihn Ihren Google Play Store-URLs als Wert des Parameters referrer hinzu, wie im folgenden Beispiel gezeigt:

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

Der Google Play Store übergibt den Wert des referrer-Parameters nur an die Google Analytics-Implementierung Ihrer App. Daher ist es wichtig, dass er in Ihren Google Play Store-Links vorhanden ist.

Allgemeine Kampagnen messen

Mit der allgemeinen Kampagnenanalyse können Sie Nutzern, die Ihre App bereits installiert haben, eine Kampagne oder Besucherquellen zuordnen.

Wenn Sie beispielsweise eine bezahlte Kampagne durchführen, um bestehende Nutzer zu erreichen, die Ihre App bereits installiert haben, können Sie mithilfe der allgemeinen Kampagnenanalyse messen, welche App-Starts das Ergebnis dieser Kampagne waren.

Allgemeine Kampagnenmessung implementieren

Wenn Sie Kampagnenwerte für eine allgemeine Kampagne festlegen möchten, rufen Sie setCampaign() auf und übergeben Sie einen Kampagnenparameter-String als Argument.

In einer typischen Implementierung wird beim Start der App setCampaign() aufgerufen und der Intent geprüft, mit dem die App gestartet wurde, um festzustellen, ob gültige Kampagnenparameter vorhanden sind:

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.
  }
}

Verweise messen

Die Messung von Empfehlungen ähnelt anderen Arten der Kampagnenmessung insofern, als Sie damit eine Verweisquelle messen können, über die Ihre App auf dem Gerät eines Nutzers gestartet wurde. Allerdings wird für die Verweismessung statt eines Strings mit Kampagnenparametern ein einfacher String wie "google.com" oder "myOtherApp" verwendet.

Wenn Sie eine Verweisquelle wie google.com festlegen, wird die Dimension „Quelle“ auf „google.com“ und die Dimension „Medium“ implizit auf „referrer“ festgelegt.

Wie bei der Kampagnenanalyse wird durch das Festlegen einer Verweisquelle standardmäßig der nächste Sendeaufruf veranlasst, eine neue Sitzung zu starten.

Im folgenden Code-Snippet wird davon ausgegangen, dass Sie alle Links zum Öffnen Ihrer App entweder mit Google Analytics-Kampagnenparametern oder mit einem einfachen referrer-Parameter getaggt haben, der die Verweisquelle beschreibt. Ist der referrer-Parameter ohne andere Kampagnenparameter vorhanden, werden die Kampagneninformationen des Nutzers mit der neuen verweisenden Quelle aktualisiert:

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.
  }
}

Bekannte Probleme

• Die Javadoc für CampaignTrackingReceiver verwendet im Anwendungsbeispiel einen falschen Klassenpfad. Informationen zur korrekten Verwendung finden Sie unter Google Play-Kampagnenmessung implementieren.
• Pro App kann nur eine BroadcastReceiver-Klasse angegeben werden. Wenn du zwei oder mehr BroadcastReceivers aus verschiedenen SDKs einbinden musst, musst du deine eigene BroadcastReceiver-Klasse erstellen, die alle Broadcasts empfängt, und die entsprechende BroadcastReceivers für jede Art von Übertragung aufrufen.
• Bei der Google Play-Kampagnenanalyse werden derzeit keine Web-to-Device-Installationen unterstützt, die über den Play Store im Web initiiert werden.

Kampagnenparameter

Kampagnenparameter werden verwendet, um Informationen zu den Besucherquellen und Kampagnen zu übergeben, über die Nutzer zu Ihrer App gelangen.

• Im Allgemeinen wird bei der Kampagnenmessung ein nicht codierter String für den Kampagnenparameter als Argument an setCampaign() übergeben.
• In der Google Play-Kampagnenanalyse wird ein referrer-Parameter mit einem codierten Kampagnenparameterstring als Wert an alle URLs angehängt, die auf die Play Store-Seite Ihrer App verweisen.

Das folgende Beispiel zeigt einen gültigen, nicht codierten Kampagnenstring, der für die allgemeine Kampagnenmessung verwendet werden kann:

"utm_campaign=my_campaign&utm_source=google&utm_medium=cpc&utm_term=my_keyword&utm_content=ad_variation1"

In der folgenden Tabelle finden Sie eine vollständige Liste der verfügbaren Kampagnenparameter, die in Google Play oder bei der allgemeinen Kampagnenanalyse verwendet werden können.

Tool zur URL-Erstellung für Google Play

Mit dem Tool zur URL-Erstellung für Google Play lassen sich URLs für die Google Play-Kampagnenanalyse generieren.