Intégration de l’entrepôt de données

1. Assurez-vous que l’accès à Braze est autorisé pour les tables Redshift que vous souhaitez synchroniser. Braze se connectera à Redshift via l’internet.
2. Dans votre instance Redshift, configurez la ou les tables ou vues que vous souhaitez synchroniser avec Braze.
3. Créez une nouvelle intégration dans le tableau de bord de Braze.
4. Testez l’intégration et débutez la synchronisation.

Étape 1 : Configurer le tableau

De manière optionnelle, définissez une nouvelle base de données et un nouveau schéma pour contenir votre tableau source

1
2
CREATE DATABASE BRAZE_CLOUD_PRODUCTION;
CREATE SCHEMA BRAZE_CLOUD_PRODUCTION.INGESTION;

Créer un tableau (ou vue) à utiliser pour votre intégration CDI

1
2
3
4
5
6
7
8
9
10
11
12
13
14
CREATE TABLE BRAZE_CLOUD_PRODUCTION.INGESTION.USERS_ATTRIBUTES_SYNC (
   updated_at timestamptz default sysdate,
   --at least one of external_id, alias_name and alias_label, or braze_id is required
   external_id varchar,
   --if using user alias, both alias_name and alias_label are required
   alias_label varchar,
   alias_name varchar,
   --braze_id can only be used to update existing users created through the Braze SDK
   braze_id varchar,
   --If you include both email and phone, we will use the email as the primary identifier
   email varchar,
   phone varchar,
   payload varchar(max)
)

Vous pouvez donner le nom que vous désirez à la base de données, au schéma et au tableau, mais les noms de colonnes doivent correspondre aux définitions ci-dessus.

• UPDATED_AT : L’heure à laquelle la rangée a été mise à jour ou ajoutée au tableau. Nous ne synchroniserons que les rangées qui ont été ajoutées ou mises à jour depuis la dernière synchronisation.
• Colonnes d’identifiant utilisateur. Votre tableau peut contenir une ou plusieurs colonnes d’identifiants utilisateur. Chaque ligne ne doit contenir qu’un seul identifiant (soit un external_id, la combinaison d’un alias_name et d’un alias_label, soit un braze_id. Un tableau source peut comporter des colonnes pour un, deux ou les trois types d’identifiants.
  • EXTERNAL_ID : Ceci identifie l’utilisateur que vous désirez mettre à jour. Cela doit correspondre à la valeur external_id utilisée dans Braze.
  • ALIAS_NAME et ALIAS_LABEL : Ces deux colonnes créent un objet d’alias d’utilisateur. alias_name doit être un identifiant unique et alias_label spécifie le type d’alias. Les utilisateurs peuvent avoir plusieurs alias avec différentes étiquettes, mais seulement un alias_name par alias_label.
  • BRAZE_ID : L’identifiant d’utilisateur Braze. Celui-ci est généré par le SDK de Braze, et il n’est pas possible de créer de nouveaux utilisateurs à l’aide d’un ID de Braze par le biais de l’ingestion de données dans le cloud. Pour créer de nouveaux utilisateurs, spécifiez un ID utilisateur externe ou un alias utilisateur.
  • EMAIL - L’adresse e-mail de l’utilisateur. S’il existe plusieurs profils avec la même adresse e-mail, le profil le plus récemment mis à jour sera prioritaire pour les mises à jour. Si vous indiquez à la fois l’e-mail et le téléphone, nous utiliserons l’e-mail comme identifiant principal.
  • PHONE - Le numéro de téléphone de l’utilisateur. S’il existe plusieurs profils avec le même numéro de téléphone, le profil le plus récemment mis à jour sera mis à jour en priorité.
• PAYLOAD : Il s’agit d’une chaîne de caractères JSON des champs que vous désirez synchroniser à l’utilisateur dans Braze.

Étape 2 : Créer un utilisateur et lui accorder des autorisations

1
2
3
CREATE USER braze_user PASSWORD '{password}';
GRANT USAGE ON SCHEMA BRAZE_CLOUD_PRODUCTION.INGESTION to braze_user;
GRANT SELECT ON TABLE USERS_ATTRIBUTES_SYNC TO braze_user;

Il s’agit des autorisations minimales requises pour cet utilisateur. Si vous créez plusieurs intégrations CDI, vous souhaiterez peut-être accorder des autorisations à un schéma ou gérer les autorisations à l’aide d’un groupe.

Étape 3 : Autoriser l’accès aux IP de Braze

Si vous avez mis en place un pare-feu ou d’autres politiques réseau, vous devez donner à Braze un accès réseau à votre instance Redshift. Un exemple d’endpoint URL Redshift est “exemple-cluster.ap-northeast-2.redshift.amazonaws.com”.

Quelques points importants à connaître :

• Vous devrez peut-être également modifier vos groupes de sécurité pour permettre à Braze d’accéder à vos données dans Redshift.
• Veillez à autoriser explicitement le trafic entrant sur les IP du tableau et sur le port utilisé pour interroger votre cluster Redshift (5439 par défaut). Vous devez explicitement autoriser la connectivité TCP Redshift sur ce port, même si les règles d’entrée sont définies sur « Autoriser tout ».
• L’endpoint du cluster Redshift doit être accessible au public pour que Braze puisse se connecter à votre cluster.
  • Si vous ne souhaitez pas que votre cluster Redshift soit accessible au public, vous pouvez configurer un VPC et une instance EC2 pour utiliser un tunnel SSH afin d’accéder aux données Redshift. Pour plus d’informations, consultez cet article du Centre de connaissances AWS.

Autorisez l’accès à partir des IP suivantes correspondant à la région de votre tableau de bord de Braze.

Allez dans Intégrations partenaires > Partenaires technologiques . Accédez à la page Redshift et sélectionnez Create new import sync (Créer une nouvelle synchronisation d’importation).

Étape 1 : Ajouter les informations de connexion Redshift et la table source

Saisissez les informations relatives à votre entrepôt de données Redshift et à votre table source. Si vous utilisez un tunnel de réseau privé, basculez le curseur et saisissez les informations relatives au tunnel. Passez ensuite à l’étape suivante.

Étape 2 : Configurer les détails de la synchronisation

Choisissez ensuite un nom pour votre synchronisation et entrez les e-mails de contact. Nous utiliserons ces coordonnées pour vous informer de toute erreur d’intégration, telle que la suppression inattendue de l’accès à la table.

Les e-mails de contact ne recevront que les notifications d’erreurs globales ou au niveau de la synchronisation, telles que les tables manquantes, les autorisations et autres. Ils ne recevront pas de problèmes au niveau de la ligne. Les erreurs globales indiquent des problèmes critiques avec la connexion qui empêchent l’exécution des synchronisations. Ces problèmes peuvent être les suivants :

• Problèmes de connectivité
• Manque de ressources
• Problèmes de permissions
• (Pour les synchronisations de catalogues uniquement) Le niveau de catalogue n’a plus d’espace.

Vous choisirez également le type de données et la fréquence de synchronisation. La fréquence peut être définie une fois toutes les 15 minutes jusqu’à une fois par mois. Nous utiliserons le fuseau horaire configuré dans votre tableau de bord de Braze pour planifier la synchronisation récurrente. Les types de données pris en charge sont les attributs personnalisés, les événements personnalisés et les événements d’achat. Le type de données d’une synchronisation ne peut pas être modifié après sa création.

Retournez dans le tableau de bord de Braze et sélectionnez Tester la connexion. Si vous avez réussi, vous pourrez voir un aperçu des données. Si, pour une raison quelconque, nous ne pouvons pas nous connecter, nous afficherons un message d’erreur pour vous aider à résoudre le problème.

Vous pouvez également définir plusieurs intégrations avec Braze, mais chaque intégration devra être configurée pour se synchroniser à un tableau différent. Lors de la création de synchronisations supplémentaires, vous pouvez réutiliser les identifiants existants si vous vous connectez au même compte Snowflake ou Redshift.

Si vous réutilisez le même utilisateur dans plusieurs intégrations, vous ne pouvez pas le supprimer dans le tableau de bord Braze tant qu’il n’a pas été supprimé de toutes les synchronisations actives.

Lorsqu’elle est activée, votre synchronisation s’effectuera selon la planification configurée lors de la configuration. Si vous souhaitez exécuter la synchronisation en dehors de la planification normale des tests ou récupérer les données les plus récentes, sélectionnez Synchroniser maintenant. Cette exécution n’aura pas d’impact sur les synchronisations futures et habituelles planifiées.