Oracle Crowdtwist

Oracle Crowdtwist es una solución líder de fidelización de clientes nativa en la nube que permite a las marcas ofrecer experiencias del cliente personalizadas. Su solución ofrece más de 100 vías de interacción listas para usar, lo que permite a los especialistas en marketing desarrollar rápidamente una visión más completa del cliente.

La característica Data Push de Oracle Crowdtwist permite pasar metadatos de usuarios o eventos cada vez que se produce una actualización en la plataforma Crowdtwist.

Esta guía describe cómo integrar las fuentes push en vivo de perfil de usuario, actividad de usuario y canje de usuarios de Oracle Crowdtwist en tu entorno Braze. Existen dos tipos adicionales de Data Push que no se tratan explícitamente en esta documentación, pero su configuración sigue los mismos principios que se describen a continuación.

• Perfil de usuario push en vivo: Incluye la creación de nuevos perfiles y la actualización de los existentes.

• Actividad de usuario push en vivo: Incluye datos sobre la finalización de la actividad de los usuarios.

• Canje de usuarios push en vivo: Incluye datos sobre los canjes de recompensas de los usuarios.

Utilizando una plantilla de Transformación de Datos Braze, puedes filtrar los elementos del Data Push que no son relevantes para Braze, y asignar los valores necesarios en Braze para que puedan ser aprovechados por los “destinos” disponibles.

Por ejemplo, utiliza un Push de datos para pasar eventos y atributos personalizados relevantes a Braze, como cuando un usuario cambia de nivel de fidelización o canjea una recompensa. También puedes utilizarlo para registrar atributos personalizados en Braze en cuanto se actualicen esos datos en el perfil de usuario de un miembro, como el saldo de puntos de un usuario.

Requisitos previos

Integración

Braze y Oracle Crowdtwist han creado plantillas de Transformación de Datos para ayudar a nuestros clientes a desarrollar sus propias Transformaciones de Datos que aprovechen los eventos Perfil de Usuario, Canje de Usuario y Actividad de Usuario.

Paso 1: Crear transformación de datos a partir de la plantilla Oracle Crowdtwist

Ve a Configuración de datos > Transformación de datos > Crear transformaciones > Utilizar una plantilla > y selecciona la plantilla “BRAZE <> CROWDTWIST” que prefieras.

Encontrarás cuatro plantillas: una para transformar los eventos Perfil de usuario, Actividad de usuario y Canje de usuario, y una plantilla maestra que utiliza la lógica condicional para aplicarla a varios eventos Push de datos.

Como se muestra en la documentación de Oracle Crowdtwist sobre Data Push, los objetos Data Push contienen metadatos diferentes, por lo que cada uno requiere su propio código de transformación para crear los objetos Braze adecuados. La plantilla maestra ilustra cómo configurar una única Transformación de datos para que acepte cada uno de los tres tipos de objetos y crea una salida adecuada con valores de cada objeto.

Paso 2: Actualizar y probar la plantilla

A continuación, verás las plantillas anotadas. El cuerpo de estas plantillas está diseñado para aplicarse al destino /users/track. Las anotaciones están marcadas con el inicio de línea // y texto verde, y puedes borrarlas sin que ello afecte al funcionamiento del código de transformación.

La transformación utiliza JavaScript, que construye un objeto llamado “brazecall”. En este objeto se crea el cuerpo de la solicitud que se envía a un punto final de la API REST de Braze. Para orientarte sobre las estructuras requeridas de las solicitudes a estos destinos, consulta los enlaces de la sección “destinos”.

Plantillas de transformación de datos

• 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 "tierInfo" below 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");
}

Destinos

Las plantillas de esta guía se han creado para entregar al destino “Seguimiento de usuarios”, pero puedes diseñar tu plantilla para enviar a cualquiera de los puntos finales enumerados en la guía de Transformación de datos de Braze, con el apoyo de la documentación de la API REST asociada.

Pruebas

Después de modificar la plantilla a tu gusto, debes validar que funciona correctamente. Haz clic en “Validar” para obtener una vista previa de la salida de tu código y comprobar si es una solicitud aceptable para el destino elegido.

Cuando estés satisfecho con el objeto que ves en el campo “salida”, haz clic en Activar para que el punto final de Transformación de Datos esté listo para aceptar datos.

Encontrarás la URL del webhook de tu Transformación de Datos en el panel lateral izquierdo. Cópialo y utilízalo para la configuración dentro del Hub de Integración de Oracle Crowdtwist.

Las Transformaciones de Datos son una herramienta muy dinámica y puedes diseñarlas para fines que vayan más allá de lo expuesto en este documento con conocimientos de JavaScript y con la orientación de nuestra documentación de la API REST. Para obtener ayuda o solución de problemas sobre cambios complejos en tus plantillas de Transformación de datos, habla con tu administrador del éxito del cliente para conocer la orientación que tienes a tu disposición.