Oracle Crowdtwist

Oracle Crowdtwist ist eine führende Cloud-native Lösung zur Kundenbindung, mit der Marken personalisierte Kundenerlebnisse anbieten können. Die Lösung bietet mehr als 100 sofort einsatzbereite Engagement-Pfade, die Marketern eine schnellere Wertschöpfung ermöglichen, um eine umfassendere Sicht auf die Kund:innen zu entwickeln.

Das Feature Data Push von Oracle Crowdtwist erlaubt die Übermittlung von Nutzer:innen- oder Event-Metadaten, sobald ein Update in der Crowdtwist-Plattform stattfindet.

In diesem Leitfaden wird beschrieben, wie Sie die Live-Push-Feeds für Kundenprofil, Nutzeraktivität und Nutzereinlösung von Oracle Crowdtwist in Ihre Braze-Umgebung integrieren. Es gibt zwei weitere Data-Push-Typen, die in dieser Dokumentation nicht explizit behandelt werden, deren Einrichtung jedoch den gleichen Prinzipien folgt, die in diesem Leitfaden beschrieben sind.

• Live Push Kundenprofil: Umfasst die Erstellung neuer Profile und Updates für bestehende Profile.

• Live Push Nutzeraktivität: Enthält Daten über abgeschlossene Nutzeraktivitäten.

• Live Push Nutzereinlösung: Enthält Daten über eingelöste Prämien von Nutzer:innen.

Mit einem Braze-Datentransformations-Template können Sie die Elemente des Data Push herausfiltern, die für Braze nicht relevant sind, und die in Braze benötigten Werte zuweisen, damit sie von den verfügbaren „Zielen“ genutzt werden können.

Verwenden Sie zum Beispiel einen Data Push, um relevante angepasste Events und Attribute an Braze zu übermitteln, z. B. wenn Nutzer:innen die Treuestufe wechseln oder eine Prämie einlösen. Sie können es auch verwenden, um angepasste Attribute in Braze zu protokollieren, sobald diese Daten im Kundenprofil eines Mitglieds aktualisiert werden, z. B. der Punktestand von Nutzer:innen.

Voraussetzungen

Integration

Braze und Oracle Crowdtwist haben Datentransformations-Templates erstellt, um unseren Kund:innen zu helfen, ihre eigenen Datentransformationen zu entwickeln, die die Events Kundenprofil, Nutzereinlösung und Nutzeraktivität nutzen.

Schritt 1: Datentransformation aus Oracle CrowdTwist-Template erstellen

Navigieren Sie zu Dateneinstellungen > Datentransformation > Transformationen erstellen > Template verwenden und wählen Sie das „BRAZE <> CROWDTWIST“-Template Ihrer Wahl aus.

Sie finden vier Templates – jeweils eines für die Transformation von Nutzerprofil-, Nutzeraktivitäts- und Nutzereinlösungs-Events sowie ein Master-Template, das bedingte Logik verwendet, um verschiedene Data-Push-Events zu verarbeiten.

Wie in der Data-Push-Dokumentation von Oracle CrowdTwist beschrieben, enthalten Data-Push-Objekte unterschiedliche Metadaten, sodass jedes seinen eigenen Transformations-Code benötigt, um die entsprechenden Braze-Objekte zu erstellen. Das Master-Template zeigt, wie Sie eine einzelne Datentransformation einrichten, die jeden der drei Objekttypen akzeptiert und eine passende Ausgabe mit Werten aus jedem Objekt erzeugt.

Schritt 2: Template aktualisieren und testen

In diesem Abschnitt sehen Sie die annotierten Templates. Der Hauptteil dieser Templates ist darauf ausgelegt, auf das Ziel /users/track angewendet zu werden. Annotationen sind durch // am Zeilenanfang und grünen Text gekennzeichnet und können ohne Auswirkungen auf die Funktionsweise des Transformationscodes gelöscht werden.

Die Transformation verwendet JavaScript und erstellt ein Objekt namens „brazecall“. In diesem Objekt erstellen Sie den Anfragekörper, der an einen Braze-REST-API-Endpunkt gesendet wird. Hinweise zu den erforderlichen Strukturen der Anfragen an diese Ziele finden Sie unter den Links im Abschnitt „Ziele“.

Hinweis

Beachten Sie, dass die „Werte“ jedes „Schlüssels“ mit payload. beginnen. Die Payload stellt das von Oracle Crowdtwist empfangene Datenobjekt dar. Verwenden Sie die JavaScript-Punktnotation, um auszuwählen, welches Datenelement die Elemente Ihres Braze-Objekts befüllen soll. Wenn Sie beispielsweise external_id: payload.thirdPartyId sehen, bedeutet das, dass die externe Braze-ID durch den in Oracle Crowdtwist gespeicherten Wert third_party_id festgelegt wird. Weitere Informationen zum Schema oder Aufbau der von Oracle Crowdtwist kommenden Objekte finden Sie in der Dokumentation von Oracle.

Wichtig

Verwenden Sie die von Oracle Crowdtwist gesendeten Objekte, um Nutzer:innen in Braze zu erstellen. Durch Einbindung des Schlüssels update_existing_only mit dem Wert false erstellt Braze ein Nutzerprofil mit den im Event- oder Attribut-Objekt enthaltenen Attributen, wenn ein Attribut- oder Event-Objekt einen Bezeichner enthält, der in Braze nicht existiert. Wenn Sie bevorzugen, dass Oracle Crowdtwist nur bereits in Braze existierende Profile aktualisiert, setzen Sie dieses Attribut in jedem Attribut- oder Event-Objekt auf true.

Datentransformations-Templates

• user profile event template
• user activity event template
• redemption event template
• master template

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45

let brazecall = {
 "attributes": [
   {
     //You must include an appropriate identifier for your attribute or event object from data available in Oracle Crowdtwist. This could be an external ID, Braze ID, user alias, phone, or email address for attribute or event objects.
     "external_id": payload.thirdPartyId,
     "email": payload.emailAddress,
   // **Important** To allow Oracle Crowdtwist events to create users in Braze, set the value of "_update_existing_only" to false. Otherwise, set this value to true in your event and attribute objects.
     "_update_existing_only": false,
     "crowdtwist_loyalty_points": payload.redeemablePoints,
 //In this example, the "tierInfo" object from Crowdtwist is transformed into a Braze Nested Custom Attribute. Use the "_merge_objects" value to avoid duplications in a data point efficient manner.
 //The "tierinfo_current_level" attribute is a flat Braze custom attribute, while the following "tierInfo" value is a nested object mirroring the Crowdtwist payload; the difference in capitalization is intentional.
     "tierinfo_current_level": payload.tierInfo.currentLevel,
     "_merge_objects" : true,
     "tierInfo" : {
       "resetDate": payload.tierInfo.resetDate,
       "dateReached":payload.tierInfo.dateReached,
        "scoreNeededToReach": payload.tierInfo.scoreNeededToReach,
        "nextLevel":{
        "minValue":payload.tierInfo.nextLevel.minValue,
        "maxValue":payload.tierInfo.nextLevel.maxValue,
        "title":payload.tierInfo.nextLevel.title
     }
     }
   }
 ]
,
//Below we show how to create both custom attributes and events from a single Crowdtwist User Profile object.
 "events": [
   {
     "external_id": payload.thirdPartyId,
     "email": payload.emailAddress,
     "name": "assignedByEvent",
//Below we can see how to write a timestamp in your object, which is a required value for some objects, like the Event Object.
     "time": new Date().toISOString(),
     "properties": {
       "assigned_by_event": payload.tierInfo.assignedByEvent,
       "date_assigned": payload.tierInfo.dateAssigned
     },
           "_update_existing_only": false
   }
 ]
};
// After the /users/track request is assigned to brazecall, return brazecall to create an output.
return brazecall;

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

let brazecall = {
"events": [
   {
     "external_id": payload.thirdPartyId,
     "_update_existing_only": false,
     "activityId": payload.activityId,
     "name": payload.activityName,
     "time": new Date().toISOString(),
     "properties": {
       "description": payload.description,
       "date_assigned": payload.dateAwarded
     }
   }
 ]
};
return brazecall;

1
2
3
4
5
6
7
8
9
10
11
12
13
14

let brazecall = {
 "attributes": [
   {
   "external_id": payload.thirdPartyId,
   //A user redemption event may not have a third party id, in which case you can instead provide the opportunity to include a user alias.
   "user_alias": { "alias_name" : "crowdtwist_redemption_username", "alias_label" : payload.userName},
   "_update_existing_only": false,
   "redeemed_coupon": payload.couponCode,
   "total_points_redeemed": payload.totalPointsRedeemed
      }
]
}
return brazecall;

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78

//The master template uses JavaScript's conditional operators to determine the output of the Data Transformation. This example shows how to apply JavaScript to your transformation to allow for a dynamic range of sources or inputs.

 // We open the transformation with a simple "if" function. We're checking if the value "payload.tierInfo" is present. "tierInfo" is a value that is always populated in the User Profile Live Push object, but is not present in the others.

if (payload.tierInfo) {
let brazecall = {
 "attributes": [
   {
     "external_id": payload.thirdPartyId,
     "email": payload.emailAddress,
     "_update_existing_only": false,
     "crowdtwist_loyalty_points": payload.redeemablePoints,
     "tierinfo_current_level": payload.tierInfo.currentLevel,
     "_merge_objects" : true,
     "tierInfo" : {
       "resetDate": payload.tierInfo.resetDate,
       "dateReached":payload.tierInfo.dateReached,
        "scoreNeededToReach": payload.tierInfo.scoreNeededToReach,
        "nextLevel":{
        "minValue":payload.tierInfo.nextLevel.minValue,
        "maxValue":payload.tierInfo.nextLevel.maxValue,
        "title":payload.tierInfo.nextLevel.title
     }
     }
   }
 ]
,
 "events": [
   {
     "external_id": payload.thirdPartyId,
     "email": payload.emailAddress,
     "name": "assignedByEvent",
     "time": new Date().toISOString(),
     "properties": {
       "assigned_by_event": payload.tierInfo.assignedByEvent,
       "date_assigned": payload.tierInfo.dateAssigned
     },
           "_update_existing_only": false
   }
 ]
};
return brazecall;
//Now we use an "else if" operator to change the "brazecall" body if the object is a User Activity event by checking if the unique key "activityId" has been populated.
} else if (payload.activityId) {
 let brazecall = {
"events": [
   {
     "external_id": payload.thirdPartyId,
     "_update_existing_only": false,
     "activityId": payload.activityId,
     "name": payload.activityName,
     "time": new Date().toISOString(),
     "properties": {
       "description": payload.description,
       "date_assigned": payload.dateAwarded
     }
   }
 ]
};
return brazecall;
//Finally, this conditional statement triggers if the Data Push object is a User Redemption event, based on whether a value populates in the key "rewardId".
} else if (payload.rewardId) {
 let brazecall = {
 "attributes": [
   {
   "external_id": payload.thirdPartyId,
   "_update_existing_only": false,
   "redeemed_coupon": payload.couponCode,
   "total_points_redeemed": payload.totalPointsRedeemed
      }
]
}
return brazecall;
} else {
 //Include this error message to help with troubleshooting in the log if a call fails. Replace the text in the parentheses with anything that might be clearer to your team based on your Data Transformation.
 throw new Error("No appropriate Identifiers found");
}

Ziele

Die Templates in diesem Leitfaden sind so konzipiert, dass sie an das Ziel „Track Users“ geliefert werden. Sie können Ihr Template jedoch so gestalten, dass es an jeden der Endpunkte sendet, die im Datentransformations-Leitfaden von Braze aufgeführt sind, unterstützt durch die zugehörige REST-API-Dokumentation.

Testen

Nachdem Sie das Template nach Ihren Wünschen angepasst haben, müssen Sie prüfen, ob es korrekt funktioniert. Wählen Sie im Transformationseditor Validate aus, um eine Vorschau im Abschnitt Output zu generieren, und bestätigen Sie, dass Braze die gemappte Anfrage für Ihr gewähltes Ziel akzeptiert.

Wenn Sie mit dem Objekt zufrieden sind, das Sie im Feld Output sehen, wählen Sie Activate aus, damit der Datentransformations-Endpunkt bereit ist, Daten zu empfangen.

Die Webhook-URL Ihrer Datentransformation finden Sie im Detailbereich der Transformation. Kopieren Sie diese und verwenden Sie sie für die Konfiguration im Integration Hub von Oracle Crowdtwist.

Wichtig

Die Braze-Datentransformations-Endpunkte haben ein Rate-Limit von 1.000 Anfragen pro Minute. Überlegen Sie, wie schnell diese Daten in Braze verfügbar sein sollen, und sprechen Sie mit Ihrem Braze Account Manager, wenn Sie ein höheres Rate-Limit für Datentransformationen benötigen.

Datentransformationen sind ein sehr dynamisches Tool, und Sie können sie mit JavaScript-Kenntnissen und mithilfe unserer REST-API-Dokumentation für Zwecke gestalten, die über das in diesem Dokument Beschriebene hinausgehen. Für Support oder Fehlerbehebung bei komplexen Änderungen an Ihren Datentransformations-Templates wenden Sie sich an Ihren Customer-Success-Manager, um mehr über die Ihnen verfügbare Unterstützung zu erfahren.