Skip to content

Singular

Singular ist eine einheitliche Analytics-Plattform für Marketing, die Attribution, Kostenaggregation, Marketing-Analysen, kreative Berichte und Workflow-Automatisierung bereitstellt.

Diese Integration wird von Singular gepflegt.

Über die Integration

Die Integration von Braze und Singular erlaubt es Ihnen, Daten zur bezahlten Install-Attribution zu importieren, um innerhalb Ihrer Lebenszyklus-Kampagnen intelligent zu segmentieren.

Voraussetzungen

Anforderung Beschreibung
Singular-Konto Um die Vorteile dieser Partnerschaft zu nutzen, benötigen Sie ein Singular-Konto.
iOS- oder Android-App Diese Integration unterstützt iOS- und Android-Apps. Je nach Plattform können Code-Snippets in Ihrer Anwendung erforderlich sein. Einzelheiten zu diesen Anforderungen finden Sie in Schritt 1 des Integrationsprozesses.
Singular SDK Neben dem erforderlichen Braze SDK müssen Sie auch das Singular SDK installieren.

Integration

1. Schritt: Nutzer:innen-IDs zuordnen

Android

Wenn Sie eine Android-App haben, müssen Sie den folgenden Code-Snippet einfügen, der eine eindeutige Braze-Nutzer-ID an Singular weitergibt.

1
2
3

String appboyDeviceId = Braze.getInstance(context).getDeviceId();
SingularConfig config = new SingularConfig("SDK KEY", "SDK SECRET")
  .withGlobalProperty(“brazeDeviceID”, appboyDeviceId, true);

iOS

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, damit die Integration nicht unterbrochen wird.

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 Singular zu übergeben, damit Braze die iOS-Attributionen richtig zuordnen kann.

1
2
3
4
5
6

SingularConfig* config = [[SingularConfig
  alloc] initWithApiKey:SDKKEY andSecret:SDKSECRET];

  [config setGlobalProperty:@"brazeDeviceId" withValue:brazeDeviceId
  overrideExisting:YES];
  [Singular start:config];

1

config.setGlobalProperty("brazeDeviceId", withValue: brazeDeviceId, overrideExisting: true)

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

Navigieren Sie in Braze zu Partner Integrations > Technology Partners und wählen Sie Singular aus.

Hier finden Sie den REST-Endpunkt und können Ihren Braze-Datenimport-Schlüssel generieren. Nachdem der Schlüssel generiert wurde, können Sie einen neuen Schlüssel erstellen oder einen bestehenden Schlüssel ungültig machen.

Sie müssen den Datenimport-Schlüssel und den REST-Endpunkt an Ihren Singular Account Manager weitergeben, um die Integration abzuschließen.

Dieses Bild zeigt das Feld „Datenimport für Install-Attribution“ auf der Singular-Technologieseite. In diesem Feld werden Ihnen der Datenimport-Schlüssel und der REST-Endpunkt angezeigt.

3. Schritt: Integration bestätigen

Nachdem Braze Attribution-Daten von Singular erhalten hat, ändert sich der Status der Verbindungsanzeige auf der Singular-Technologie-Partnerseite in Braze von „Nicht verbunden“ zu „Verbunden“ und enthält einen Zeitstempel der letzten erfolgreichen Anfrage.

Dieser Status ändert sich erst, wenn Braze Daten über eine attributierte Installation erhält. Braze ignoriert organische Installationen (schließt sie aus dem Singular-Postback aus) und zählt sie nicht, wenn es darum geht, ob die Verbindung erfolgreich war.

Attribution-Daten von Facebook und X (ehemals Twitter)

Attribution-Daten für Facebook- und X-Kampagnen (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.

Singular-Click-Tracking-URLs in Braze (optional)

Wenn Sie Click-Tracking-Links in Ihren Braze-Kampagnen verwenden, können Sie leicht erkennen, welche Kampagnen zu App-Installationen und erneuter Interaktion führen. So können Sie Ihre Marketing-Bemühungen effektiver messen und datengestützte Entscheidungen darüber treffen, wo Sie mehr Ressourcen für einen maximalen ROI investieren sollten.

Um mit Singular-Click-Tracking-Links zu beginnen, besuchen Sie deren Dokumentation. Sie können die Singular-Click-Tracking-Links direkt in Ihre Braze-Kampagnen einfügen. Singular verwendet dann seine probabilistischen Attributionsmethoden, um die Nutzer:innen zuzuordnen, die auf den Link geklickt haben. Wir empfehlen, Ihre Singular-Tracking-Links mit einem Geräte-Bezeichner zu versehen, um die Genauigkeit der Attributionen Ihrer Braze-Kampagnen zu verbessern. Dadurch werden die Nutzer:innen, die auf den Link geklickt haben, deterministisch attributiert.

Für Android erlaubt Braze den Kund:innen, sich für die Sammlung der Google Advertising ID (GAID) zu entscheiden. Die GAID wird auch nativ über die Singular-SDK-Integration erfasst. Sie können die GAID in Ihre Singular-Click-Tracking-Links einfügen, indem Sie die folgende Liquid-Logik verwenden:

1
2
3

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

Für iOS erfassen sowohl Braze als auch Singular den IDFV automatisch und nativ über unsere SDK-Integrationen. Dies kann als Geräte-Bezeichner verwendet werden. Sie können den IDFV in Ihre Singular-Click-Tracking-Links einfügen, indem Sie die folgende Liquid-Logik verwenden:

1
2
3

{% if most_recently_used_device.${platform} == 'ios' %}
idfv={{most_recently_used_device.${id}}}
{% endif %}
New Stuff!