DOTS.ECO

DOTS.ECO vous permet de récompenser les utilisateurs qui ont un impact environnemental réel grâce à des certificats numériques traçables. Chaque certificat peut inclure des métadonnées telles qu’une URL de certificat et une URL d’image partageables, afin que les utilisateurs puissent voir (et revoir) leur preuve d’impact.

Cette intégration est maintenue par DOTS.ECO.

À propos de cette intégration

Braze et DOTS.ECO connectent les parcours d’engagement client à des récompenses d’impact dans le monde réel. À partir d’une étape de Braze Canvas ou d’une campagne, vous pouvez déclencher une demande de création de certificat DOTS.ECO à l’aide de Connected Content. DOTS.ECO renvoie des métadonnées de certificat (telles que certificate_url et certificate_image_url) que vous pouvez stocker sur le profil utilisateur en tant qu’attributs personnalisés et réutiliser sur des canaux tels que les messages in-app, les notifications push et les messages in-app.

Cas d’utilisation

• Déclenchez un certificat d’impact lorsqu’un utilisateur réalise un événement clé (achat, achèvement d’un niveau, abonnement, recommandation).
• Affichez une image de certificat personnalisé dans un message in-app après la réussite de l’étape Contenu connecté.
• Ajoutez une carte de contenu “Voir votre certificat” avec l’URL du certificat pour un accès ultérieur.
• Stockez les métadonnées des certificats (telles que certificate_url, certificate_image_url, certificate_header, et greeting) en tant qu’attributs personnalisés pour les réutiliser dans des envois de messages ultérieurs.
• Attribuez des certificats à l’aide d’un ID d’utilisateur distant afin que les utilisateurs puissent réclamer et visualiser leur impact ultérieurement.
• Effectuez des tests A/B sur les messages d’impact (différentes copies/images) tout en conservant le même flux de mise à jour de l’utilisateur DOTS.ECO.

Conditions préalables

Avant de commencer, vous devez disposer des éléments suivants :

Intégration DOTS.ECO

Étape 1 : Créez un canvas et ajoutez une étape de mise à jour de l’utilisateur.

Dans le tableau de bord de Braze, créez un nouveau Canvas qui se déclenche lorsqu’un utilisateur réalise un événement clé (tel qu’un achat, un abonnement ou un jalon).

Ajoutez une étape de mise à jour de l’utilisateur juste après l’étape d’entrée. Cette étape servira à appeler l’API DOTS.ECO via le contenu connecté et à stocker les données de certificat renvoyées dans le profil utilisateur.

Utilisez cette étape pour appeler l’API DOTS.ECO via le contenu connecté et stocker les données de certificat renvoyées sur le profil utilisateur.

Étape 2 : Composez du JSON avancé : Faites une demande POST à DOTS.ECO en utilisant le contenu connecté

À l’étape de la mise à jour de l’utilisateur, passez à l’éditeur JSON avancé et utilisez le contenu connecté pour effectuer une demande POST à l’API du certificat DOTS.ECO.

Utilisez l’étiquette capture et une demande de contenu connecté pour appeler l’endpoint de certificat de DOTS.ECO. Enregistrez ensuite la réponse dans le profil utilisateur en tant qu’attributs personnalisés.

Exemple de contenu connecté et de mise à jour par l’utilisateur

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
{% capture post_body %} 
{  
  "remote_user_email": "{{${email_address} | default: '[email protected]'}}",  
  "app_token": "YOUR_DOTS.ECO_APP_TOKEN",  
  "impact_qty": 1,  
  "remote_user_id": "{{${user_id} | default: ${braze_id}}}",  
  "allocation_id": "YOUR_DOTS.ECO_ALLOCATION_ID"  
}  
{% endcapture %}

{% connected_content https://impact.dots.eco/api/v1/certificate/add?format=sdk  
  :method post  
  :headers { "auth-token": "YOUR_DOTS.ECO_AUTH_TOKEN" }  
  :body {{post_body}}  
  :content_type application/json  
  :save result  
%}

{  
  "attributes": [  
    {  
      "certificate_image_url": "{{result.certificate_image_url}}",  
      "certificate_url": "{{result.certificate_url}}",  
      "certificate_id": "{{result.certificate_id}}"  
    }  
  ]  
}  

Envoyez la demande à https://impact.dots.eco/api/v1/certificate/add?format=sdk.

Étape 3 : Afficher le certificat dans les messages

Lorsque les attributs du certificat sont stockés dans le profil utilisateur, ils peuvent être référencés dans les étapes du message canvas en aval.

Par exemple :

• Affichez l’image du certificat dans un message in-app à l’aide de la fonction {{custom_attribute.${certificate_image_url}}}
• Lien vers le certificat hébergé à l’aide de {{custom_attribute.${certificate_url}}}

Vous pouvez ainsi personnaliser les messages in-app, les cartes de contenu ou les notifications push avec confirmation d’impact.

Résolution des problèmes

Passez en revue les erreurs de contenu connecté dans le tableau de bord de Braze, sous Paramètres > Journal d’activité des messages.

• Le contenu connecté renvoie un message vide: Confirmez que :save result est défini et que vous faites référence aux champs de réponse attendus.
• Les attributs n’apparaissent pas dans l’étape Message :
  • Confirmez que les noms des attributs personnalisés dans Braze correspondent exactement aux attributs que vous avez définis à l’étape Mise à jour de l’utilisateur.
  • Dans l’étape Mise à jour de l’utilisateur, utilisez l’onglet Prévisualisation et test pour confirmer que les attributs sont bien renseignés. Ensuite, envoyez un test à un utilisateur et confirmez que les attributs sont enregistrés sur son profil utilisateur.
• 422 erreur (entité non traitable): Confirmez que votre jeton d’application et votre quantité d’impact sont valides.
• 401 erreur: Confirmez que le jeton d’authentification est présent et correct.
• Pas de prévisualisation de l’image dans l’étape Message : Sélectionnez Envoyer le test à l’utilisateur dans l’étape Mise à jour de l’utilisateur, puis prévisualisez le message en utilisant ce même utilisateur.