AppsFlyer

AppsFlyer ist eine Analytics-Plattform für Mobile-Marketing und Attribution, die Ihnen hilft, Ihre Apps durch Marketing-Analysen, Mobile-Attribution und Deeplinking zu analysieren und zu optimieren.

Die Integration von Braze und AppsFlyer lässt Sie besser verstehen, wie Sie Ihre Campaigns optimieren und ganzheitlicher gestalten können, indem Sie die mobilen Install-Attribution-Daten von AppsFlyer nutzen.

Mit der AppsFlyer Audiences-Integration können Sie Ihre AppsFlyer-Zielgruppen (Kohorten) direkt an Braze weitergeben, was es Ihnen erlaubt, leistungsstarke Customer-Engagement-Campaigns zu erstellen, die genau auf die richtigen Nutzer:innen zur richtigen Zeit ausgerichtet sind.

Voraussetzungen

Integration

Schritt 1: Geräte-ID abbilden

• android
• ios
• unity

Wenn Sie eine Android-App haben, müssen Sie eine eindeutige Braze-Geräte-ID an AppsFlyer übergeben.

Stellen Sie sicher, dass die folgenden Code-Zeilen an der richtigen Stelle eingefügt werden – nachdem das Braze SDK gestartet wurde und vor dem Initialisierungscode für das AppsFlyer SDK. Weitere Informationen finden Sie im AppsFlyer SDK-Integrationshandbuch für Android.

1
2
3
4
5
val customData = HashMap<String, Any>()
Braze.getInstance(context).getDeviceIdAsync { deviceId ->
   customData["brazeCustomerId"] = deviceId
   setAdditionalData(customData)
}

Wichtig

Vor Februar 2023 verwendete unsere AppsFlyer-Attribution-Integration den Identifier for Vendors (IDFV) als primären Bezeichner, um iOS-Attribution-Daten abzugleichen. Für Braze-Kund:innen, die Objective-C verwenden, ist es nicht notwendig, die Braze device_id abzurufen und sie bei der Installation an AppsFlyer zu senden, da es keine Unterbrechung des Dienstes gibt.

Wenn Sie das Swift SDK v5.7.0+ verwenden und weiterhin IDFV als gegenseitigen Bezeichner verwenden möchten, müssen Sie sicherstellen, dass das Feld useUUIDAsDeviceId auf false gesetzt ist, um eine Unterbrechung der Integration zu vermeiden.

Wenn Sie diese Option auf true setzen, müssen Sie die Abbildung der iOS-Geräte-ID für Swift implementieren, um die Braze device_id bei der Installation der App an AppsFlyer weiterzugeben, damit Braze die iOS-Attributionen richtig zuordnen kann.

• swift
• objective-c

1
2
3
4
5
6
let configuration = Braze.Configuration(
    apiKey: "<BRAZE_API_KEY>",
    endpoint: "<BRAZE_ENDPOINT>")
configuration.useUUIDAsDeviceId = false
let braze = Braze(configuration: configuration)
AppsFlyerLib.shared().customData = ["brazeDeviceId": braze.deviceId]

1
2
3
4
5
6
BRZConfiguration *configurations = [[BRZConfiguration alloc] initWithApiKey:@"BRAZE_API_KEY" endpoint:@"BRAZE_END_POINT"];
[configurations setUseUUIDAsDeviceId:NO];
Braze *braze = [[Braze alloc] initWithConfiguration:configurations];
[[AppsFlyerLib shared] setAdditionalData:@{
    @"brazeDeviceId": braze.deviceId
}];

Um die Geräte-ID in Unity abzubilden, gehen Sie wie folgt vor:

1
2
3
4
Appboy.AppboyBinding.getDeviceId()
Dictionary<string, string> customData = new Dictionary<string, string>();
customData.Add("brazeCustomerId", Appboy.AppboyBinding.getDeviceId());
AppsFlyer.setAdditionalData(customData);

Schritt 2: Datenimport-Schlüssel für Braze abrufen

Navigieren Sie in Braze zu Partnerintegrationen > Technologie-Partner und wählen Sie AppsFlyer aus.

Hier finden Sie den REST-Endpunkt und generieren Ihren Datenimport-Schlüssel für Braze. Nachdem der Schlüssel generiert wurde, können Sie einen neuen Schlüssel erstellen oder einen bestehenden Schlüssel ungültig machen. Der Datenimport-Schlüssel und der REST-Endpunkt werden im nächsten Schritt verwendet, wenn Sie ein Postback im AppsFlyer-Dashboard einrichten.

Schritt 3: Braze im Dashboard von AppsFlyer konfigurieren

1. Navigieren Sie in AppsFlyer auf die Seite Integrated Partners in der linken Leiste. Suchen Sie dann nach Braze und wählen Sie das Braze-Logo aus, um ein Konfigurationsfenster zu öffnen.
2. Schalten Sie auf dem Tab Integration die Option Activate Partner ein.
3. Geben Sie den Datenimport-Schlüssel und den REST-Endpunkt an, den Sie im Braze-Dashboard gefunden haben.
4. Schalten Sie Advanced Privacy aus und speichern Sie Ihre Konfiguration.

Wichtig

Wenn Sie den Braze-REST-Endpunkt im Tab „Integration“ von AppsFlyer eingeben, geben Sie nur die Domain ein (z. B. rest.fra-02.braze.eu) ohne das Protokoll https:// und ohne den Pfad /attribution/appsflyer. AppsFlyer stellt das Protokoll automatisch voran und hängt den Pfad an. Wenn Sie eines von beiden in Ihre Eingabe aufnehmen, führt dies zu Postback-Fehlern.

Weitere Informationen zu diesen Anweisungen finden Sie in der AppsFlyer-Dokumentation.

Schritt 4: Integration bestätigen

Auf der AppsFlyer-Technologie-Partnerseite in Braze zeigt der Verbindungsindikator Not Connected an, bis Sie in Schritt 2 einen Datenimport-API-Schlüssel generieren. Nachdem Sie den Schlüssel generiert haben, ändert sich der Indikator zu Connected und zeigt einen Zeitstempel an. Dieser Zeitstempel gibt an, wann die Integration erstmals in Braze eingerichtet wurde (als der Datenimport-Schlüssel erstellt wurde), nicht wann AppsFlyer zuletzt ein Postback gesendet hat.

Um zu bestätigen, dass Install-Attribution-Daten von AppsFlyer fließen, verwenden Sie Schritt 5, um zu überprüfen, ob nicht-organische Installationsdaten in den Braze-Segmentfiltern erscheinen. Braze ignoriert organische Installationen aus AppsFlyer-Postbacks und speichert sie nicht als attributierte Installationsdaten.

Schritt 5: Daten zur Nutzer:innen-Attribution anzeigen

Verfügbare Datenfelder

Wenn Ihre Integration erfolgreich war, bildet Braze alle nicht-organischen Installationsdaten in Segmentfiltern ab.

Im Braze-Dashboard können Sie Ihre Nutzerbasis anhand von Attributionsdaten segmentieren, indem Sie die Filter für Install-Attribution verwenden.

Außerdem sind die Attributionsdaten für eine bestimmte Nutzer:in auf dem Profil jeder Nutzer:in im Braze-Dashboard verfügbar.

Hinweis

Attribution-Daten für Facebook- und X-Campaigns (ehemals Twitter) sind nicht über unsere Partner verfügbar. Diese Medienquellen erlauben ihren Partnern nicht, Attribution-Daten an Dritte weiterzugeben, und daher können unsere Partner diese Daten nicht an Braze senden.

AppsFlyer mit Braze für Deeplinking integrieren

Deeplinks – Links, die Nutzer:innen zu einer bestimmten Seite oder Stelle innerhalb einer App oder Website weiterleiten – werden eingesetzt, um ein maßgeschneidertes Nutzererlebnis zu schaffen.

Obwohl sie weit verbreitet sind, können Probleme auftreten, wenn per E-Mail versendete Deeplinks zusammen mit Klick-Tracking verwendet werden – einem weiteren wichtigen Feature zur Erfassung von Nutzerdaten. Diese Probleme entstehen dadurch, dass E-Mail-Anbieter (ESPs) Deeplinks in eine Klick-Tracking-Domain einbetten, wodurch der ursprüngliche Link beschädigt wird. Daher erfordert die Unterstützung von Deeplinks eine zusätzliche Einrichtung.

AppsFlyer bietet einen Dienst an, der diese Probleme vermeidet, indem AppsFlyer als Vermittler zwischen dem E-Mail-Anbieter-Server und Ihrem Domainnamen fungiert. In der Rolle als Proxy ermöglicht er die Bereitstellung von Assoziationsdateien (AASA/Asset Links), die das Deeplinking erleichtern.

Schritt 1 – Eine Klick-Tracking-Domain erstellen

Erstellen Sie gemäß den grundlegenden Elementen der E-Mail-Einrichtungsanleitung von Braze eine E-Mail-Versanddomain und eine Klick-Tracking-Domain. Für Unterstützung können Sie über das Braze-Dashboard ein Ticket erstellen, um die Einrichtung der neuen CTD mit dem Braze-E-Mail-Team zu starten.

Die Erstellung einer neuen CTD ist Pflicht, auch wenn Sie bereits eine bestehende verwenden. So wird sichergestellt, dass der Traffic aktuell laufender E-Mail-Campaigns nicht beeinträchtigt wird.

Wichtig

AppsFlyer erstellt das SSL-Zertifikat. In dieser Phase sind E-Mail-Links wahrscheinlich noch nicht gesichert, d. h. das URL-Präfix ist HTTP statt HTTPS. Dies wird in späteren Schritten behoben.

Schritt 2 – OneLink-Template in AppsFlyer erstellen

Erstellen Sie ein OneLink-Template und konfigurieren Sie Universal Links/App Links unter „When app is installed“. Dieses Template wird später verwendet, um OneLink-Links für Ihre E-Mail-Campaigns zu erstellen.

Hinweis

Wenn Sie bereits ein vorhandenes OneLink-Template konfiguriert haben, das Universal Links/App Links aktiviert, können Sie dieses verwenden.

Schritt 3 – Braze-Integration in AppsFlyer einrichten

Jetzt ist es an der Zeit, Ihre Braze-Integration in AppsFlyer einzurichten. Dieser Schritt und der folgende („Ihre App konfigurieren“) können gleichzeitig durchgeführt werden. So richten Sie Ihre Braze-Integration in AppsFlyer ein:

1. Wählen Sie in AppsFlyer im Seitenmenü Engage > E-Mail-Anbieter integration aus. {#1-in-appsflyer-from-the-side-menu-select-engage-esp-integration}

2. Wählen Sie Braze aus. {#2-select-braze}

3. Wählen Sie das OneLink-Template aus, das Sie für E-Mail-Campaigns verwenden möchten, und klicken Sie dann auf Next. {#3-select-the-onelink-template-you-want-to-use-for-email-campaigns-then-click-next}

4. Geben Sie Ihre Click-Tracking-Domain und den Wert für „Braze endpoint“ ein, der mit der neuen CTD aus Schritt 1 bereitgestellt wurde, und klicken Sie dann auf Validate connection. {#4-enter-your-click-tracking-domain-and-braze-endpoint-value-which-was-provided-with-the-new-ctd-created-in-step-1-then-click-validate-connection}

Damit wird überprüft, ob die Click-Tracking-Domain auf den von Ihnen eingegebenen Endpunkt verweist.

Mit „Braze Endpoint“ fragt AppsFlyer nach den Details, die Braze in Schritt 1 dieser Anleitung bereitgestellt hat – konkret nach der neuen CTD.

Klicken Sie dann auf Validate connection, um zu überprüfen, ob die Click-Tracking-Domain auf den von Ihnen eingegebenen Endpunkt verweist. Klicken Sie anschließend auf Next.

5. Link-Traffic an AppsFlyer weiterleiten: {#5-route-link-traffic-to-appsflyer}

a. Kopieren Sie die angepassten vorgefertigten Anweisungen in AppsFlyer und senden Sie sie an Ihre IT-Abteilung oder Ihren Domain-Administrator.

Ihr Administrator muss den Traffic Ihrer E-Mail-Campaigns von den E-Mail-Anbieter-Servern zu den AppsFlyer-Servern umleiten, indem er Ihre DNS-CNAME-Einträge mit der neuen Domain aktualisiert, die AppsFlyer bereitgestellt hat.

Dadurch wird jeder Klick auf einen Link an AppsFlyer weitergeleitet, das den Klick wiederum an den E-Mail-Anbieter-Endpunkt weiterleitet.

b. Klicken Sie nach dem Kopieren und Senden der Anweisungen auf Done.

Ihre Braze-Integration wurde erstellt.

Wichtig

Der Status Ihrer Braze-Integration ist „Ausstehend“ und wird erst aktiv, nachdem der CNAME-Eintrag zugeordnet wurde. Es kann bis zu 24 Stunden nach der Zuordnung dauern, bis eine neue Integration funktionsfähig und aktiv wird.

Schritt 4: App konfigurieren (Entwickler-Aufgabe)

AppsFlyer bietet eine Anleitung zur korrekten App-Konfiguration, die von Ihren Web- oder App-Teams befolgt werden sollte, um Universal Linking zu unterstützen.

Schritt 5: Bestätigen, dass SSL-Klick-Tracking bei Braze aktiviert ist

In dieser Phase empfehlen wir Ihnen, nach dem Teilen und Validieren der CTD-Details in AppsFlyer einen Testversand durchzuführen, um zu bestätigen, ob Ihre OneLink-Versanddomain über ein SSL-Zertifikat verfügt. Dies steht im Einklang mit unserem Leitfaden zum E-Mail-Setup.

Sie können Qualitätssicherung und Fehlerbehebung durchführen, indem Sie einen Deeplink über OneLink senden. Weitere Informationen zur Verwendung von OneLink finden Sie in der AppsFlyer-Dokumentation.

Wenn CTD-Links als HTTP erkannt werden, wenden Sie sich an das E-Mail-Ops-Team von Braze, um das SSL-Klick-Tracking zu aktivieren. Dadurch wird sichergestellt, dass alle HTTP-Links automatisch in HTTPS konvertiert werden. Sie können den folgenden Beispielnachrichtentext verwenden, wenn Sie sich an Ihren CSM wenden, oder indem Sie wie in Schritt 1 ein Ticket im Braze-Dashboard erstellen:

1
2
Hi Team,
Could you please enable SSL click tracking for CTD XXX? It is currently set to HTTP instead of HTTPS.

AppsFlyer-Klick-Tracking-URLs in Braze (optional)

Sie können die OneLink-Attribution-Links von AppsFlyer in Braze-Campaigns über Push, E-Mail und weitere Kanäle verwenden. Dadurch können Sie Install- oder Re-Engagement-Attributionsdaten aus Ihren Braze-Campaigns an AppsFlyer zurücksenden. So können Sie Ihre Marketingmaßnahmen effektiver messen und datengestützte Entscheidungen treffen.

Sie können einfach Ihre OneLink-Tracking-URL in AppsFlyer erstellen und direkt in Ihre Braze-Campaigns einfügen. AppsFlyer nutzt dann seine probabilistischen Attributionsmethoden, um die Nutzer:innen zuzuordnen, die auf den Link geklickt haben. Wir empfehlen, Ihre AppsFlyer-Tracking-Links mit einem Gerätebezeichner zu ergänzen, um die Genauigkeit der Attributionen aus Ihren Braze-Campaigns zu verbessern. Dadurch werden die Nutzer:innen, die auf den Link geklickt haben, deterministisch zugeordnet.

• android
• ios

1
2
3
{% if most_recently_used_device.${platform} == 'android' %}
aifa={{most_recently_used_device.${google_ad_id}}}
{% endif %}

1
2
3
{% if most_recently_used_device.${platform} == 'ios' %}
idfv={{most_recently_used_device.${id}}}
{% endif %}