Kampagnenauswertung

Dieses Dokument bietet einen Überblick über die Messung von Kampagnen und Besucherquellen mit dem Google Analytics SDK Version 4 für Android.

Übersicht

Durch das Messen von Kampagnen in Google Analytics können Kampagnen und Besucherquellen Nutzeraktivitäten innerhalb Ihrer App zugeordnet werden. Im Google Analytics SDK Version 4 für Android sind folgende Optionen für die Attribution von Kampagnen und Besucherquellen verfügbar:

In den folgenden Abschnitten wird beschrieben, wann und wie die einzelnen Arten der Kampagnenmessung in Ihrer App implementiert werden.

Google Play-Kampagnenattribution

Mit der Google Play-Kampagnenanalyse kannst du sehen, über welche Kampagnen und Besucherquellen Nutzer zu dem Download deiner App im Google Play Store gelangen. Wir empfehlen allen Entwicklern, die Google Play Store-Kampagnenanalyse zu implementieren.

Google Play-Kampagnenattribution implementieren

Im Google Play Store steht Entwicklern eine Install Referrer API zur Verfügung, über die sich Empfehlungsinhalte sicher von Google Play abrufen lassen. Diese API gibt den Wert des Referrer-Parameters zurück, mit dem die Google Play Store-Seite Ihrer App erreicht wird, sofern vorhanden.

Wenn Sie einen App-Download einer Kampagne zuordnen möchten, müssen Sie allen Links, die auf den Google Play Store verweisen, einen Verweisparameter hinzufügen. Fügen Sie außerdem die Google Play Install Referrer API zu Ihrer App hinzu, damit die im Intent von Google Analytics enthaltenen Kampagneninformationen empfangen und festgelegt werden können.

1. Entfernen Sie den Google Analytics-Empfänger aus der Datei „AndroidManifest.xml“.

Wenn Sie auch den Google Tag Manager-Empfänger implementiert haben, entfernen Sie diesen aus Ihrem Manifest.

2. Fügen Sie eine Abhängigkeit zur Bibliothek „Install Referrer API“ 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 App-Startaktivität auf.

Mit der Install Referrer API können Sie die Verweis-URL des installierten App-Pakets abrufen und den URL-Wert dann an einen Google Analytics- oder Google Tag Manager-Empfänger übergeben. Verwenden Sie eine ähnliche Implementierung wie der folgende Code, um die Install Referrer API in den Veröffentlichungsaktivitäten Ihrer App zu verwenden.

Wenn Sie mehrere Einstiegspunkte in die App haben, z. B. Deeplinks zu bestimmten Teilen, können Sie die vorgesehenen 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 setzen den Wert dieses Parameters auf einen String von Google Analytics-Kampagnenparametern, die die Quelle beschreiben. Hier ein 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 Kampagnenparameterstrings finden Sie im Tool zur URL-Erstellung für Google Play oder im Referenzabschnitt zu Kampagnenparametern.

Allgemeine Attribution von Kampagnen und Besucherquellen

Nachdem eine App installiert wurde, kann sie durch Verweise von Werbekampagnen, Websites oder anderen Apps gestartet werden. In diesem Szenario können verweisende Besucherquellen oder Marketingkampagnen der Nutzeraktivität in nachfolgenden Sitzungen zugeordnet werden. Dazu werden die Kampagnenparameter für einen Tracker direkt mit der Methode setCampaignParamsFromUrl 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

Mithilfe von Kampagnenparametern werden Informationen zu Besucherquellen und Kampagnen übergeben, über die Nutzer zu Ihrer App gelangen.

In der folgenden Tabelle sind die Kampagnenparameter aufgeführt, die in Google Play und der allgemeinen Kampagnenanalyse verwendet werden können:

Parameter Beschreibung Beispiel(e)
utm_source Kampagnenquelle; dient zur Identifizierung einer Suchmaschine, eines Newsletters oder einer anderen Quelle utm_source=google
utm_medium Kampagnenmedium; wird verwendet, um ein Medium wie E-Mail oder Cost-per-Click (CPC) zu identifizieren utm_medium=cpc
utm_term Kampagnenbegriff; wird zusammen mit der bezahlten Suche verwendet, um die Keywords für Anzeigen bereitzustellen utm_term=running+shoes
utm_content Kampagneninhalte; werden 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 Produktwerbung oder strategische Kampagne zu identifizieren utm_campaign=spring_sale
gclid Parameter für das automatische Tagging von Google Ads wird zum Messen von Anzeigen verwendet. Dieser Wert wird dynamisch generiert und sollte niemals geändert werden.

Tool zur URL-Erstellung für Google Play

Generieren Sie mit dem Tool unten URLs für die Analyse von Google Play-Kampagnen.