![Cours Braze] (/docs/fr/assets/img/bl_icon3.png?90e224bc203230fce2ea8b5e0093b685) {: style=”float:right;width:120px;border:0;” class=”noimgborder”}Looker

Looker, une plateforme d’aide à la décision et d’analyse de big data, vous permet de facilement explorer, analyser et partager des analyses commerciales en temps réel.

L’intégration de Braze et Looker permet aux utilisateurs de Braze de tirer parti du signalement des utilisateurs Blocs Looker et Actions Looker via l’API REST. Ces utilisateurs signalés peuvent être ajoutés à des segments pour cibler les futures campagnes Braze ou Canvases. Pour utiliser Looker avec Braze, nous vous recommandons d’envoyer vos données Braze à un entrepôt de données à l’aide de flux Currents de Braze, puis d’utiliser les blocs Looker de Braze pour modéliser et visualiser rapidement vos données Braze dans Looker.

Prérequis

Restrictions

• Ce processus ne fonctionne qu’avec les données qui n’ont pas été pivotées.
• L’API traite un maximum de 100 000 lignes à la fois.
• Le nombre final de drapeaux d’un utilisateur peut être inférieur en raison de doublons ou de non-utilisateurs.

Intégration

Blocs Looker

Nos Looker Blocks aident les clients de Braze à accéder rapidement à une vue des données granulaires que nous proposons via Currents. Nos blocs fournissent des visualisations et une modélisation prédéfinies pour les données Currents afin que les clients de Braze puissent facilement mettre en œuvre des modèles analytiques tels que la rétention, évaluer la livrabilité des messages, examiner plus en détail le comportement des utilisateurs, etc.

Pour mettre en œuvre les blocs Looker, suivez les instructions fournies dans les fichiers README du code GitHub.

• Fichier README du bloc analytique de l’engagement des messages
• Bloquer le fichier README pour l’analyse analytique du comportement des utilisateurs

Les deux intégrations supposent que votre intégration Braze initiale, ainsi que votre intégration Braze avec un entrepôt de données compatible Looker, sont correctement configurées pour capturer et envoyer les données nécessaires.

Blocs disponibles

Actions du Looker

Les Looker Actions vous permettent de signaler les utilisateurs dans Braze via l’endpoint de l’API REST à partir d’un Looker Look. Les actions nécessitent qu’une dimension soit balisée avecbraze_id. L’action ajoutera la valeur signalée à l’looker_exportattribut personnalisé de l’utilisateur.

Étape 1 : Configurez une action Braze Looker

Configurez une action Braze Looker avec votre clé API Braze REST et votre endpoint REST.

Étape 2 : Configurer Looker Develop

Dans Looker Develop, sélectionnez les vues appropriées. Ajoutez braze_id à l’étiquette dimensions et validez les modifications. Cette balise braze_id est utilisée pour déterminer quel champ est la clé unique.

1
2
3
4
5
6
dimension: external_id {
    type: string
    primary_key: yes
    sql: ${TABLE}.external_id ;;
    tags: ["braze_id"]
}

Assurez-vous de valider les modifications. Looker Action ne fonctionnera qu’avec les paramètres de production.

Étape 3 : Définir les attributs utilisateur dans les tags

N’importe quel attribut peut être défini à l’aide d’une balise braze[] avec le nom de l’attribut entre crochets. Par exemple, si vous souhaitez qu’un attribut user_segment personnalisé soit envoyé, la balise seraitbraze[user_segment].

Notez les limites suivantes :

• Les attributs ne seront envoyés que s’ils sont inclus en tant que champ dans l’apparence.
• Les types pris en charge sont Strings Boolean, Numbers etDates.
• Les noms d’attributs distinguent les majuscules et minuscules.
• Les attributs standard peuvent également être définis à condition qu’ils correspondent exactement aux noms de profil utilisateur standard.
• L’étiquette complète doit être mise en forme entre guillemets. Par exemple,tags: ["braze[first_name]"]. D’autres tags peuvent également être attribués mais seront ignorés.
• Des informations supplémentaires sont disponibles sur GitHub.

Étape 4 : Envoyer l’action Looker

1. Dans un bloc Looker dont une dimension braze_id est sélectionnée, cliquez sur la roue dentée ( ) en haut à droite, puis sélectionnez Envoyer….
2. Sélectionnez l’action Braze personnalisée.
3. Sous Clé unique, indiquez la clé de mappage utilisateur principale pour le compte Braze (external_id ou braze_id).
4. Donnez un nom à l’exportation. Si aucun nom n’est fourni, LOOKER_EXPORT sera utilisé.
5. Sous Options avancées, sélectionnez Résultats dans le tableau ou Tous les résultats, puis Envoyer.
   
   
   
   Si l’exportation a été correctement envoyée, elle LOOKER_EXPORT devrait apparaître dans le profil de l’utilisateur sous la forme d’un attribut personnalisé avec la valeur que vous avez saisie dans l’action.
   
   

Exemple d’API sortante

Voici un exemple d’appel d’API sortant, qui sera envoyé au /users/track/endpoint.

En-tête

1
Authorization: Bearer [API_KEY]

Corps

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
{
   "attributes" : [
      {
        "external_id" : "user_01",
        "_update_existing_only" : true,
        "looker_export" : { "add" : ["LOOKER"] }
      },
      {
        "external_id" : "user_02",
        "_update_existing_only" : true,
        "looker_export" : { "add" : ["LOOKER"] }
      },
      {
        "external_id" : "user_03",
        "_update_existing_only" : true,
        "looker_export" : { "add" : ["LOOKER"] }
      },
      .....
   ]
}

Segmentez les utilisateurs dans Braze

Dans Braze, pour créer un segment de ces utilisateurs signalés, accédez à Segments sous Engagement, nommez votre segment et sélectionnez Looker_Export comme filtre. Ensuite, utilisez l’option « inclut la valeur » et fournissez le drapeau d’attribut personnalisé que vous avez attribué dans Looker.

Une fois enregistré, vous pouvez faire référence à ce segment lors de la création d’un canvas ou d’une campagne à l’étape du ciblage des utilisateurs.

Résolution des problèmes

Si vous rencontrez des problèmes avec l’action Looker, ajoutez un utilisateur test aux [groupes internes] ]16 et vérifiez les points suivants :

• La clé API possède les autorisations users.track nécessaires.
• L’endpoint REST correct est saisi, par exemple en tant que https://rest.iad-01.braze.com.
• Une balise braze_id est définie dans la vue dimensionnelle.
• Votre requête inclut la dimension ou l’attribut Id sous forme de colonne.
• Les résultats de Looker ne sont pas pivotés.
• La clé unique est correctement sélectionnée. Habituellement, leexternal_id.
• L’ID de Braze braze_id dans la dimension est différent de l’ID de Braze braze_id de l’API. braze_id dans la dimension est utilisé pour indiquer qu’il s’agit du champ id de l’API Braze. Dans la plupart des cas, lors de l’envoi external_id est la clé primaire.
• L’external_idutilisateur existe sur la plateforme Braze.
• Le champ looker_export est défini comme Automatically Detect sousBraze Platform > Settings > Manage Settings > Custom Attributes.
• Les modifications sont enregistrées dans l’environnement de production. Looker Action fonctionne sur les paramètres de production.