Kampagnenauswertung

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:

Tool zur URL-Erstellung für Google Play

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