In diesem Dokument erhalten Sie eine Übersicht über die Analyse von Kampagnen und Besucherquellen mit dem Google Analytics SDK Version 4 für Android.
Überblick
Wenn Sie Kampagnen in Google Analytics messen, können Sie Kampagnen und Besucherquellen den Nutzeraktivitäten in Ihrer App zuordnen. Diese Optionen sind für die Attribution von Kampagnen und Besucherquellen im Google Analytics SDK Version 4 für Android verfügbar:
- Google Play-Kampagnenattribution – Hier siehst du, über welche Kampagnen, Websites und andere Apps Nutzer an den Google Play Store weitergeleitet werden, um deine App herunterzuladen.
- Allgemeine Attribution zu Kampagnen und Besucherquellen: Hier sehen Sie, über welche Kampagnen oder Verweis-URLs Ihre App nach der Installation gestartet wird.
In den folgenden Abschnitten erfahren Sie, wann und wie Sie die einzelnen Arten von Kampagnenanalysen in Ihrer App implementieren.
Google Play-Kampagnenattribution
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.
Google Play-Kampagnenattribution implementieren
Im Google Play Store steht Entwicklern eine Install Referrer API zur Verfügung, mit der sie Verweisinhalte sicher aus Google Play abrufen können. Diese API gibt den Wert des Referrer-Parameters zurück, der zum Aufrufen der Google Play Store-Seite Ihrer App verwendet wurde, sofern vorhanden.
Um einen App-Download einer Kampagne zuzuordnen, müssen Sie allen Links, die auf den Google Play Store verweisen, einen Verweisparameter hinzufügen. Fügen Sie außerdem Ihrer App die Install Referrer API von Google Play hinzu, damit die im Intent enthaltenen Kampagneninformationen in Ihrem Google Analytics-Tracker empfangen und festgelegt werden können.
1. Entfernen Sie den Google Analytics-Empfänger aus der Datei „AndroidManifest.xml“.
Wenn Sie außerdem den Google Tag Manager-Empfänger implementiert haben, entfernen Sie diesen ebenfalls aus Ihrem Manifest.
2. Fügen Sie eine Abhängigkeit von der Install Referrer API-Bibliothek hinzu.
Fügen Sie Folgendes in build.gradle ein, um die Abhängigkeit hinzuzufügen:
dependencies { ... implementation 'com.android.installreferrer:installreferrer:1.1' }
3. Rufe die Install Referrer API in der Startaktivität deiner App auf.
Rufen Sie mithilfe der Install Referrer API die Verweis-URL des installierten App-Pakets ab und übergeben Sie den URL-Wert dann an einen Google Analytics- oder Google Tag Manager-Empfänger. Führen Sie die Implementierung wie im folgenden Code aus, um die Install Referrer API in der Startaktivität Ihrer App zu verwenden.
Wenn Sie mehrere Einstiegspunkte in die App haben, z. B. Deeplinks zu bestimmten Teilen, können Sie die vorgeschriebenen Methoden in einer ActivityLifecycleListener
implementieren, die von ActivityLifecycleCallbacks
ausgelöst wird.
package com.example.myapplication; import static com.android.installreferrer.api.InstallReferrerClient.InstallReferrerResponse; import androidx.appcompat.app.AppCompatActivity; import android.content.Intent; import android.net.Uri; import android.os.Bundle; import android.os.Handler; import android.os.RemoteException; import com.android.installreferrer.api.InstallReferrerClient; import com.android.installreferrer.api.InstallReferrerStateListener; import com.android.installreferrer.api.ReferrerDetails; import com.google.android.gms.analytics.CampaignTrackingReceiver; import com.google.tagmanager.InstallReferrerReceiver; import java.util.concurrent.Executor; import java.util.concurrent.Executors; public class MainActivity extends AppCompatActivity { private final Executor backgroundExecutor = Executors.newSingleThreadExecutor(); @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_main); checkInstallReferrer(); } // TODO: Change this to use whatever preferences are appropriate. The install referrer should // only be sent to the receiver once. private final String prefKey = "checkedInstallReferrer"; void checkInstallReferrer() { if (getPreferences(MODE_PRIVATE).getBoolean(prefKey, false)) { return; } InstallReferrerClient referrerClient = InstallReferrerClient.newBuilder(this).build(); backgroundExecutor.execute(() -> getInstallReferrerFromClient(referrerClient)); } void getInstallReferrerFromClient(InstallReferrerClient referrerClient) { referrerClient.startConnection(new InstallReferrerStateListener() { @Override public void onInstallReferrerSetupFinished(int responseCode) { switch (responseCode) { case InstallReferrerResponse.OK: ReferrerDetails response = null; try { response = referrerClient.getInstallReferrer(); } catch (RemoteException e) { e.printStackTrace(); return; } final String referrerUrl = response.getInstallReferrer(); // TODO: If you're using GTM, call trackInstallReferrerforGTM instead. trackInstallReferrer(referrerUrl); // Only check this once. getPreferences(MODE_PRIVATE).edit().putBoolean(prefKey, true).commit(); // End the connection referrerClient.endConnection(); break; case InstallReferrerResponse.FEATURE_NOT_SUPPORTED: // API not available on the current Play Store app. break; case InstallReferrerResponse.SERVICE_UNAVAILABLE: // Connection couldn't be established. break; } } @Override public void onInstallReferrerServiceDisconnected() { } }); } // Tracker for Classic GA (call this if you are using Classic GA only) private void trackInstallReferrer(final String referrerUrl) { new Handler(getMainLooper()).post(new Runnable() { @Override public void run() { CampaignTrackingReceiver receiver = new CampaignTrackingReceiver(); Intent intent = new Intent("com.android.vending.INSTALL_REFERRER"); intent.putExtra("referrer", referrerUrl); receiver.onReceive(getApplicationContext(), intent); } }); } // Tracker for GTM + Classic GA (call this if you are using GTM + Classic GA only) private void trackInstallReferrerforGTM(final String referrerUrl) { new Handler(getMainLooper()).post(new Runnable() { @Override public void run() { InstallReferrerReceiver receiver = new InstallReferrerReceiver(); Intent intent = new Intent("com.android.vending.INSTALL_REFERRER"); intent.putExtra("referrer", referrerUrl); receiver.onReceive(getApplicationContext(), intent); } }); } }
4. Google Analytics-Kampagnenparameter zu Google Play-URLs hinzufügen
Als Nächstes fügen Sie allen URLs, die direkt mit dem Google Play Store verknüpft werden, einen referrer
-Parameter hinzu und legen Sie den Wert dieses Parameters auf einen String von Google Analytics-Kampagnenparametern fest, die die Quelle beschreiben. Beispiel:
https://play.google.com/store/apps/details?id=com.example.application &referrer=utm_source%3Dgoogle %26utm_medium%3Dcpc %26utm_term%3Drunning%252Bshoes %26utm_content%3Dlogolink %26utm_campaign%3Dspring_sale
Informationen zum Erstellen von Strings für Kampagnenparameter finden Sie im Tool zur URL-Erstellung für Google Play oder in der Referenz zu Kampagnenparametern.
Allgemeine Kampagnen- und Besucherquellenzuordnung
Nachdem eine App installiert wurde, kann sie über Verweise von Werbekampagnen, Websites oder anderen Apps gestartet werden. In diesem Szenario können verweisende Besucherquellen oder Marketingkampagnen in nachfolgenden Sitzungen möglicherweise Nutzeraktivitäten zugeordnet werden. Dazu werden die Kampagnenparameter mithilfe der Methode setCampaignParamsFromUrl
direkt in einem Tracker festgelegt.
// Get tracker. Tracker t = ((AnalyticsSampleApp) getActivity().getApplication()).getTracker( TrackerName.APP_TRACKER); // Set screen name. t.setScreenName(screenName); // In this example, campaign information is set using // a url string with Google Analytics campaign parameters. // Note: This is for illustrative purposes. In most cases campaign // information would come from an incoming Intent. String campaignData = "http://examplepetstore.com/index.html?" + "utm_source=email&utm_medium=email_marketing&utm_campaign=summer" + "&utm_content=email_variation_1"; // Campaign data sent with this hit. t.send(new HitBuilders.ScreenViewBuilder() .setCampaignParamsFromUrl(campaignData) .build() );
Weitere Informationen zur Methode getTracker
finden Sie unter
Erweiterte Konfiguration.
Kampagnenparameter
Kampagnenparameter werden verwendet, um Informationen zu den Besucherquellen und Kampagnen zu übergeben, über die Nutzer zu Ihrer App gelangen.
Die folgende Tabelle enthält die verfügbaren Kampagnenparameter, die in Google Play oder bei der allgemeinen Kampagnenmessung verwendet werden können:
Parameter | Beschreibung | Beispiel(e) |
---|---|---|
utm_source |
Kampagnenquelle; zur Identifizierung einer Suchmaschine, eines Newsletters oder einer anderen Quelle | utm_source=google |
utm_medium |
Kampagnenmedium; zur Identifizierung eines Mediums wie E-Mail oder Cost-per-Click (CPC) | utm_medium=cpc |
utm_term |
Kampagnenbegriff; wird bei bezahlter Suche verwendet, um die Keywords für Anzeigen bereitzustellen | utm_term=running+shoes |
utm_content |
Kampagneninhalte; wird für A/B-Tests und inhaltsbezogene Anzeigen verwendet, um Anzeigen oder Links zu unterscheiden, die auf dieselbe URL verweisen |
utm_content=logolink
utm_content=textlink
|
utm_campaign |
Kampagnenname; wird für die Keyword-Analyse verwendet, um eine bestimmte Werbeaktion oder strategische Kampagne zu identifizieren | utm_campaign=spring_sale |
gclid |
Google Ads-Parameter für das automatische Tagging; wird zur Analyse von Anzeigen verwendet Dieser Wert wird dynamisch generiert und sollte nie geändert werden. |
Tool zur URL-Erstellung für Google Play
Mit dem folgenden Tool lassen sich URLs für die Google Play-Kampagnenanalyse generieren.