Calendrier Rokt

Rokt Calendar est une technologie de marketing de calendrier dynamique qui permet aux marques de diffuser des événements personnalisés et des communications promotionnelles sous forme d’événements de calendrier et de notifications.

L’intégration de Braze et de Rokt Calendar permet à vos abonnés Rokt Calendar et à leurs données d’être poussés vers Braze via le webhook Braze. Vous pouvez ensuite utiliser ces données dans Braze Canvases pour le ciblage des parcours et la segmentation de l’audience à l’aide de l’un des attributs personnalisés suivants du calendrier Rokt.

Conditions préalables

Segmentation de l’audience

Lorsque Rokt Calendar crée un nouvel utilisateur ou fait correspondre un abonné existant avec un utilisateur de Braze, Rokt Calendar envoie les attributs d’abonnement personnalisés suivants que vous pouvez filtrer dans Braze :

Rokt Calendar déclenche également un événement personnalisé subscribe dès que l’utilisateur s’est abonné à votre calendrier Rokt. Cet événement peut être utilisé dans la segmentation Braze ou comme déclencheur d’une campagne ou d’un composant Canvas.

Intégration

Étape 1 : Créer une audience d’abonnés au calendrier

Pour envoyer des événements de calendrier à partir de Canvas, vous devez d’abord avoir configuré un calendrier Rokt avec des utilisateurs déjà abonnés. Pour ce faire, vous devrez indiquer à vos utilisateurs où et comment s’abonner au calendrier. Rokt Calendar vous recommande :

Fournir des points d’intégration des abonnements

Pour créer une audience d’utilisateurs de calendriers, vous devez proposer une destination vers laquelle l’utilisateur peut naviguer et s’abonner. Voici quelques exemples de points d’intégration des abonnements :

• Ajoutez un bouton calendrier à votre site web
• Ajouter un lien vers le calendrier dans un e-mail ou un SMS
• Ajoutez un bouton calendrier à votre application
• Ajoutez un lien vers le calendrier sur les réseaux sociaux.

Promouvoir le calendrier

Pour créer une audience d’abonnés, vous devrez promouvoir le calendrier auprès de votre audience afin qu’elle sache comment s’abonner. Voici quelques exemples de promotion du calendrier :

• Messages sur les réseaux sociaux
• Bulletins d’information et mises à jour par e-mail
• Articles de blog
• Notifications in-app

Étape 2 : Créer un webhook Rokt Calendrier à Braze

Dans Braze, vous pouvez configurer une campagne de webhook ou un webhook dans un Canvas pour soit :

• Envoyez un nouvel événement personnalisé : Permet d’ajouter de nouveaux événements à un segment des calendriers des abonnés.
• Mise à jour d’un événement personnalisé : Permettre la mise à jour d’un événement existant dans les calendriers des utilisateurs.

Pour créer un modèle de webhook Rokt Calendar à utiliser dans de futures campagnes ou Canvases, naviguez vers Modèles > Modèles de webhook dans la plateforme Braze.

Si vous souhaitez créer une campagne webhook du calendrier Rokt unique ou utiliser un modèle existant, sélectionnez Webhook dans Braze lors de la création d’une nouvelle campagne.

• envoyer un nouvel événement
• mise à jour d'un événement existant

En-têtes de requête et méthode

Rokt Calendar requiert un HTTP Header pour l’autorisation qui inclut le nom de votre identifiant de contenu connecté Rokt Calendar. Les éléments suivants sont déjà inclus dans le modèle sous forme de paires clé-valeur, mais dans l’onglet Paramètres, vous devez remplacer <Rokt-Calendar-API> par le nom de l’identifiant trouvé dans Manage Settings > Connected Content > Credential.

• Méthode HTTP: POST
• En-tête de la requête :
  • Autorisation: Porteur {% connected_content https://api.roktcalendar.com/oauth2/token :method post :basic_auth <Rokt-Calendar-API> :body grant_type=client_credentials :save token :retry %}{{token.access_token}}
  • Content-Type: application/json

Corps de la requête

• envoyer un nouvel événement
• mise à jour d'un événement existant
• détails de l'événement

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
{% capture eventId %}Event_0001{% endcapture %}
{% capture eventTitle %}Event Title{% endcapture %}
{% capture eventDescr %}Event Description{% endcapture %}
{% capture eventLocation %}Event Location{% endcapture %}
{% capture eventStart %}2019-02-21T15:00:00{% endcapture %}
{% capture eventEnd %}2019-02-21T15:00:00{% endcapture %}
{% capture notifyBefore %}15{% endcapture %}
{% capture eventTZ %}Eastern Standard Time{% endcapture %}

{
  "event": {
    "eventId": "{{eventId}}_{{${user_id}}}",
    "title": "{{eventTitle}}",
    "description": "{{eventDescr}}",
    "location": "{{eventLocation}}",
    "start": "{{eventStart}}",
    "end": "{{eventEnd}}",
    "timezone": "{{eventTZ}}",
    "notifyBefore": "{{notifyBefore}}"
  },
  "subscriptionIds": ["{{custom_attribute.${rokt:subscription_id}| join: '","'  }}"]
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
{% capture eventId %}Event_0001{% endcapture %}
{% capture eventTitle %}Event Title{% endcapture %}
{% capture eventDescr %}Event Description{% endcapture %}
{% capture eventLocation %}Event Location{% endcapture %}
{% capture eventStart %}2019-02-21T15:00:00{% endcapture %}
{% capture eventEnd %}2019-02-21T15:00:00{% endcapture %}
{% capture notifyBefore %}15{% endcapture %}
{% capture eventTZ %}Eastern Standard Time{% endcapture %}

{
  "event": {
    "eventId": "{{eventId}}_{{${user_id}}}",
    "title": "{{eventTitle}}",
    "description": "{{eventDescr}}",
    "location": "{{eventLocation}}",
    "start": "{{eventStart}}",
    "end": "{{eventEnd}}",
    "timezone": "{{eventTZ}}",
    "notifyBefore": "{{notifyBefore}}"
  }
}

Étape 3 : Prévisualiser la requête

Prévisualisez votre requête dans le panneau Aperçu ou accédez à l’onglet Test, où vous pouvez sélectionner un utilisateur aléatoire, un utilisateur existant ou personnaliser le vôtre pour tester votre webhook.