• Accueil / Marketing Cloud / Créer des extensions…
, Créer des extensions de données dans Marketing Cloud via une API<span class="wtr-time-wrap after-title"><span class="wtr-time-number">9</span> minutes de lecture</span>

Créer des extensions de données dans Marketing Cloud via une API9 minutes de lecture


Une grande partie de la magie de Marketing Cloud repose sur des extensions de données invisibles appelées Data Views. Ce sont des extensions de données qui hébergent les données d’envois, d’ouvertures, de clics, d’abonnés, de trajets, etc. Cependant, elles ne sont pas immédiatement visibles par l’utilisateur. Il existe des moyens d’extraire ces données à l’aide de rapports ou d’extraits de données. Vous pouvez également tirer parti de ces données en utilisant les fonctionnalités intégrées d’Einstein, comme Einstein Send Time Optimization et Einstein Engagement splits dans Journey Builder.

Cependant, il peut arriver que vous souhaitiez extraire ces données sans générer de rapports ni écrire de requêtes SQL uniques. Par exemple, vous souhaiterez peut-être utiliser une extension de données de suppression dans un Salesforce Envoyer lorsque vous excluez toute personne ayant déjà ouvert un e-mail le jour de l’envoi. Ou il y a cet exemple écrit par Emily où vous transmettez les données Bounce à Sales Cloud via Journey Builder avec des informations de la vue des données Bounce. Voici un aperçu des données de Journey Builder rédigées par Nathalie.

Bien que les vues de données ne soient pas visibles, Salesforce documente toutes les vues de données et leurs champs afin que vous puissiez les répliquer vous-même. Cependant, la création d’extensions de données qui répliquent les vues de données peut être assez fastidieuse. Alors, voici un dépôt GitHub avec l’API SOAP pour presque toutes les vues de données. Au moment d’écrire ces lignes, j’en ai encore quelques-unes à construire. Ce ne sont pas ceux que je n’ai pas encore utilisés, donc je ne les ai pas encore atteints (mais je le ferai).

Et voici la façon la plus simple de créer des extensions de données à la volée:

Tout d’abord, si vous n’avez pas Postman, téléchargez-le maintenant.

Ensuite, créez un package API dans Marketing Cloud.

  • Dans Marketing Cloud, accédez à Configuration → Outils de la plateforme → Applications → Packages installés
  • Créez un nouveau package. Le nom que vous choisissez pour ce package apparaîtra comme le nom «Créé par» sur les extensions de données, alors gardez cela à l’esprit lorsque vous choisissez un nom.
  • Une fois le package créé, sélectionnez Ajouter un composant. Choisissez Server-to-Server comme type d’API et autorisez le composant pour au moins la lecture et l’écriture sous Data Extensions.
  • Une fois ce composant ajouté, vous aurez l’ID client, le secret client, l’URI de base d’authentification, l’URI de base REST et l’URI de base SOAP.
  • Ouvrez Postman et dans le coin supérieur droit, cliquez sur l’icône d’engrenage.
, Créer des extensions de données dans Marketing Cloud via une API<span class="wtr-time-wrap after-title"><span class="wtr-time-number">9</span> minutes de lecture</span>
  • Sélectionnez «Ajouter» sous Gérer les environnements et nommez l’environnement. Ajoutez les variables suivantes: AuthenticationBaseURI, ClientId, ClientSecret, RESTBaseURI, SOAPBaseURI et accessToken. Vous pouvez créer un environnement pour chaque organisation que vous utilisez et basculer entre eux selon vos besoins.
, Créer des extensions de données dans Marketing Cloud via une API<span class="wtr-time-wrap after-title"><span class="wtr-time-number">9</span> minutes de lecture</span>
  • Remplissez la colonne de valeur initiale dans chacune d’entre elles, à l’exception de la variable accessToken, avec les informations de votre composant API Marketing Cloud. Après avoir cliqué sur le bouton orange Ajouter, fermez les paramètres d’environnement et vous reviendrez à la configuration de bienvenue. Assurez-vous de sélectionner l’environnement que vous venez de créer dans le menu déroulant à côté des icônes œil et engrenage.
  • Cliquez sur Créer une demande ou ouvrez simplement un nouvel onglet.
, Créer des extensions de données dans Marketing Cloud via une API<span class="wtr-time-wrap after-title"><span class="wtr-time-number">9</span> minutes de lecture</span>
  • La première chose que nous allons faire est d’obtenir le jeton d’accès de Marketing Cloud. Nous le faisons avec l’URI de base d’authentification et l’ID client + secret client. La première chose que vous devez faire est de définir la méthode de requête sur POST. Remplissez ensuite l’URL de la demande avec les éléments suivants:
{{AuthenticationBaseURI}}/v2/token
  • Sous En-têtes, vous n’ajouterez que les éléments suivants
Content-Type: application/json
  • Combiné avec les têtes préexistantes, vous verrez ceci:
, Créer des extensions de données dans Marketing Cloud via une API<span class="wtr-time-wrap after-title"><span class="wtr-time-number">9</span> minutes de lecture</span>
  • Maintenant, passez à l’onglet Corps, sélectionnez le bouton radio «brut» et collez ce qui suit:
{
"grant_type": "client_credentials",
"client_id": "{{ClientId}}",
"client_secret": "{{ClientSecret}}"
}
  • Si vous cliquez sur le bouton Code dans le coin droit de l’écran, vous obtiendrez une fenêtre contextuelle de la demande entièrement remplie de variables.
, Créer des extensions de données dans Marketing Cloud via une API<span class="wtr-time-wrap after-title"><span class="wtr-time-number">9</span> minutes de lecture</span>
  • À ce stade, si vous cliquez sur Envoyer, vous récupérez le jeton d’accès. Ce jeton durera 20 minutes.
, Créer des extensions de données dans Marketing Cloud via une API<span class="wtr-time-wrap after-title"><span class="wtr-time-number">9</span> minutes de lecture</span>
  • Vous pouvez copier et coller cette réponse dans ce que vous allez faire ensuite, ou vous pouvez la stocker dans cette variable d’environnement accessToken que nous avons créée précédemment. Pour ce faire, accédez à l’onglet Tests et collez ce qui suit:
var data = JSON.parse(responseBody);
postman.setEnvironmentVariable("accessToken", data.access_token);
  • Ce petit morceau de Javascript récupérera la réponse access_token et la stockera dans la variable accessToken. Exécutez à nouveau la demande et vous verrez maintenant le jeton d’accès dans les variables d’environnement. Pour afficher cela, cliquez sur l’œil à côté de la liste déroulante Environnement.
  • Maintenant, pour la demande de création d’extension de données. Ouvrez un nouvel onglet dans Postman en cliquant sur le bouton +.
  • Nous utiliserons des demandes SOAP pour tous nos besoins d’extension de données. Commencez par changer à nouveau la méthode de demande en POST. Cette fois, vous remplirez l’URL de la demande avec votre point de terminaison SOAP:
{{SOAPBaseURI}}/Service.asmx
  • Ajoutez les en-têtes suivants:
Authorization: Bearer {{accessToken}}
SoapAction: Create
Content-Type: text/xml
  • Voici à quoi ressemblera la disposition complète de l’en-tête. Notez que le type de contenu préexistant est barré en faveur de ce que nous avons ajouté. Vous pouvez décocher la case à côté de l’en-tête dont vous n’avez pas besoin afin de ne pas envoyer d’informations contradictoires dans votre demande:
, Créer des extensions de données dans Marketing Cloud via une API<span class="wtr-time-wrap after-title"><span class="wtr-time-number">9</span> minutes de lecture</span>
  • Sous l’onglet Corps, choisissez à nouveau «brut» et vous déposerez simplement exactement ce que j’ai écrit dans les fichiers GitHub. Par exemple, voici à quoi ressemblera le début de la vue des données de rebond:
, Créer des extensions de données dans Marketing Cloud via une API<span class="wtr-time-wrap after-title"><span class="wtr-time-number">9</span> minutes de lecture</span>
  • Si vous cliquez à nouveau sur «Code», vous verrez la demande complète avec le jeton d’accès rempli. Les fichiers sur GitHub répliqueront exactement les vues de données Marketing Cloud. Cependant, il y a plusieurs choses que vous voudrez peut-être ajuster avant de créer. Vous pouvez modifier le nom de l’extension de données. Vous pouvez ajouter ou supprimer des champs pour répondre à vos besoins. Par exemple, j’ai un client où je les ai construits avec le ContactId ajouté en tant que champ supplémentaire afin que je puisse ajouter le Salesforce ID à ces extensions de données, car elles utilisent l’adresse e-mail comme SubscriberKey, plutôt que Salesforce Id.
  • Maintenant, appuyez simplement sur Envoyer et vous recevrez une réponse indiquant que l’extension de données a été créée.
, Créer des extensions de données dans Marketing Cloud via une API<span class="wtr-time-wrap after-title"><span class="wtr-time-number">9</span> minutes de lecture</span>
  • Vous pouvez obtenir une erreur, mais cela devrait être facile à résoudre. Par exemple, si le jeton arrive à expiration, il vous suffit de revenir au premier onglet et d’exécuter à nouveau cette demande pour actualiser le jeton, ce qui mettra à jour la variable.
  • Une fois que vous les avez construits, vous souhaitez les remplir avec des requêtes SQL. Par exemple, vous pouvez simplement remplir l’extension de données que nous venons de créer avec ceci:
SELECT *
FROM _bounce
  • Vous pouvez limiter la plage de dates que vous interrogez avec une simple modification. Les informations suivantes vous donneront les 7 derniers jours de données:
SELECT * 
FROM _bounce
WHERE EventDate BETWEEN GETDATE()-7 AND GETDATE() 
  • Vous voudrez peut-être plus de spécifications sur ces extensions de données et voici votre ressource complète. Par exemple, je n’ai pas de jeu de rétention de données pour ces tables. Vous pouvez le faire manuellement dans Contact Builder ou vous pouvez ajouter des spécifications de rétention à la demande SOAP.
  • Il n’y a pas non plus de clé primaire sur ces extensions de données. Si vous voulez pouvoir exécuter une mise à jour, plutôt qu’une réécriture, vous devrez déterminer comment et où vous pouvez ajouter des clés primaires.



Source de l’article traduit automatiquement en Français