Connexion SendGrid

Présentation

SendGrid est une plateforme de communication client populaire pour les emails transactionnels et marketing.

Ceci Adobe Experience Platform destination tire parti de SendGrid Marketing Contacts API, qui vous permet d’exporter vos profils de messagerie propriétaires et de les activer dans un nouveau segment SendGrid en fonction des besoins de votre entreprise.

SendGrid utilise des jetons de support d’API comme mécanisme d’authentification pour communiquer avec l’API SendGrid.

Conditions préalables

Les éléments suivants sont requis avant de commencer à configurer la destination.

  1. Vous devez disposer d’un compte SendGrid.
    • Accédez à SendGrid. inscription pour enregistrer et créer un compte SendGrid, le cas échéant.
  2. Une fois connecté au portail SendGrid, vous devez également générer un jeton API.
  3. Accédez au site web de SendGrid et accédez au Settings > API Keys page. Vous pouvez également vous reporter à la section Documentation SendGrid pour accéder à la section appropriée dans l’application SendGrid.
  4. Enfin, sélectionnez l’option Create API Key bouton .
    • Reportez-vous à la section Documentation SendGrid, si vous avez besoin de conseils sur les actions à effectuer.
    • Si vous souhaitez générer votre clé API par programmation, reportez-vous à la section Documentation SendGrid.

Avant d’activer des données vers la destination SendGrid, vous devez disposer d’un schema, un dataset, et segments créé dans Experience Platform. Reportez-vous également à la section limites plus loin dans cette page.

IMPORTANT

  • L’API SendGrid utilisée pour créer la liste de diffusion à partir des profils de messagerie nécessite que des adresses électroniques uniques soient fournies dans chaque profil. Cela n’est pas nécessaire, qu’il soit utilisé comme valeur pour email ou courrier électronique alternatif. Comme la connexion SendGrid prend en charge les mappages pour les adresses électroniques et les autres valeurs d’adresse électronique, veillez à ce que toutes les adresses électroniques utilisées soient uniques dans chaque profil de Jeu de données. Dans le cas contraire, lorsque les profils de courrier électronique sont envoyés à SendGrid, une erreur se produit et ce profil ne sera pas présent dans l’exportation des données.

  • Actuellement, aucune fonctionnalité n’est en place pour supprimer des profils de SendGrid lorsqu’ils sont supprimés des segments dans Experience Platform.

Identités prises en charge

SendGrid prend en charge l’activation des identités décrites dans le tableau ci-dessous. En savoir plus sur identités.

Identité cible Description Considérations
adresse e-mail Adresse e-mail Notez que le texte brut et les adresses électroniques hachées SHA256 sont pris en charge par Adobe Experience Platform. Si le champ source Experience Platform contient des attributs non hachés, vérifiez la variable Appliquer la transformation option, pour avoir Platform hachage automatique des données lors de l’activation.

Notez que SendGrid ne prend pas en charge les adresses électroniques hachées. Par conséquent, seules les données en texte brut sans transformation sont envoyées à la destination.

Type et fréquence d'export

Reportez-vous au tableau ci-dessous pour plus d’informations sur le type et la fréquence d’exportation des destinations.

Élément Type Notes
Type d’exportation Basé sur les profils Vous exportez tous les membres d’un segment, ainsi que les champs de schéma de votre choix (par exemple : adresse électronique, numéro de téléphone, nom), tel que sélectionné dans l’écran de sélection des attributs de profil de la fonction workflow d’activation de destination.
Fréquence des exports Diffusion en continu Les destinations de diffusion en continu sont "toujours sur" des connexions basées sur l’API. Dès qu’un profil est mis à jour dans Experience Platform en fonction de l’évaluation des segments, le connecteur envoie la mise à jour en aval vers la plateforme de destination. En savoir plus sur destinations de diffusion en continu.

Cas d'utilisation

Pour vous aider à mieux comprendre comment et à quel moment utiliser la destination SendGrid, voici des exemples d’utilisation qui Experience Platform les clients peuvent résoudre ce problème en utilisant cette destination.

Création d’une liste marketing pour plusieurs activités marketing

Les équipes marketing qui utilisent SendGrid peuvent créer une liste de diffusion dans SendGrid et la remplir avec des adresses électroniques. La liste de diffusion désormais créée dans SendGrid peut être utilisée par la suite pour plusieurs activités marketing.

Se connecter à la destination

IMPORTANT

Pour vous connecter à la destination, vous avez besoin de l’événement Gestion des destinations autorisation de contrôle d’accès. Lisez le présentation du contrôle d’accès ou contactez votre administrateur de produit pour obtenir les autorisations requises.

Pour vous connecter à cette destination, procédez comme décrit dans le tutoriel sur la configuration des destinations. Dans le workflow de configuration des destinations, renseignez les champs répertoriés dans les deux sections ci-dessous.

Authentification à la destination

  1. Dans le Adobe Experience Platform console, accédez à Destinations.

  2. Sélectionnez la Catalogue et recherchez SendGrid. Sélectionnez Configuration. Après avoir établi une connexion à la destination, le libellé de l’interface utilisateur passe à Activation des segments.

  3. Un assistant vous aide à configurer la destination SendGrid. Créez la destination en sélectionnant Configuration d’une nouvelle destination.

  4. Sélectionnez la Nouveau compte et renseignez la variable Jeton porteur . Cette valeur est SendGrid. Clé API mentionnée précédemment dans la variable section conditions préalables.

  5. Sélectionner Se connecter à la destination. Si SendGrid Clé API Si la variable fournie est valide, l’interface utilisateur affiche une Connecté avec une coche verte, vous pouvez ensuite passer à l’étape suivante pour remplir d’autres champs d’informations.

Renseignement des détails de destination

Pendant la configuration de cette destination, vous devez fournir les informations suivantes :

  • Nom: Nom par lequel vous reconnaîtrez cette destination à l’avenir.
  • Description: Description facultative qui vous aidera à identifier cette destination ultérieurement.

Activer les alertes

Vous pouvez activer les alertes pour recevoir des notifications sur l’état du flux de données vers votre destination. Sélectionnez une alerte dans la liste et abonnez-vous à des notifications concernant le statut de votre flux de données. Pour plus d’informations sur les alertes, consultez le guide sur les abonnement aux alertes de destinations à l’aide de l’interface utilisateur.

Lorsque vous avez terminé de fournir des détails sur votre connexion de destination, sélectionnez Suivant.

Activer des segments vers cette destination

IMPORTANT

Pour activer les données, vous avez besoin de l’événement Gestion des destinations, Activation des destinations, Afficher les profils, et Affichage de segments autorisations de contrôle d’accès. Lisez le présentation du contrôle d’accès ou contactez votre administrateur de produit pour obtenir les autorisations requises.

Lecture Activation des profils et des segments vers des destinations d’exportation de segments en continu pour obtenir des instructions sur l’activation des segments d’audience vers cette destination.

Reportez-vous aux images ci-dessous pour plus de détails sur cette destination.

  1. Sélectionnez un ou plusieurs segments à exporter vers SendGrid.

  2. Dans le Mappage , après avoir sélectionné Ajouter un nouveau mappage, la page de mappage s’affiche pour mapper les champs XDM sources aux champs cibles de l’API SendGrid. Les images ci-dessous montrent comment mapper des espaces de noms d’identité entre Experience Platform et SendGrid. Assurez-vous que la variable Champ source Email doit être mappé à la propriété Champ cible external_id comme illustré ci-dessous.



  3. De même, mappez les Adobe Experience Platform attributs que vous souhaitez exporter vers la destination SendGrid.

  4. Une fois les mappages terminés, sélectionnez Suivant pour accéder à l’écran de révision.

  5. Sélectionner Terminer pour terminer la configuration.

Liste complète des mappages d’attributs pris en charge pouvant être configurés pour la variable SendGrid Marketing Contacts > Add or Update Contact API est ci-dessous.

Champ source Champ cible Type Description Limites
xdm :
homeAddress.street1		 xdm :
address_line_1		 Chaîne La première ligne de l’adresse. Longueur max. :
100 caractères
xdm :
homeAddress.street2		 xdm :
address_line_2		 Chaîne Une seconde ligne facultative pour l’adresse. Longueur max. :
100 caractères
xdm :
_extconndev.alternate_emails		 xdm :
alternate_emails		 Tableau de chaîne Emails supplémentaires associés au contact.
  • Max : 5 éléments
  • Min : 0 élément
xdm :
homeAddress.city		 xdm :
city		 Chaîne La ville du contact. Longueur max. :
60 caractères
xdm :
homeAddress.country		 xdm :
country		 Chaîne Le pays du contact. Il peut s’agir d’un nom complet ou d’une abréviation. Longueur max. :
50 caractères
identityMap :
Email		 Identité :
external_id		 Chaîne L'Principal email du contact. Il doit s’agir d’un email valide. Longueur max. :
254 caractères
xdm :
person.name.firstName		 xdm :
first_name		 Chaîne Nom du contact Longueur max. :
50 caractères
xdm :
person.name.lastName		 xdm :
last_name		 Chaîne Nom de famille du contact Longueur max. :
50 caractères
xdm :
homeAddress.postalCode		 xdm :
postal_code		 Chaîne Code postal du contact ou autre code postal.
xdm :
homeAddress.stateProvince		 xdm :
state_province_region		 Chaîne État, province ou région du contact. Longueur max. :
50 caractères

Validation de l’exportation des données dans SendGrid

Pour vérifier que vous avez correctement configuré la destination, procédez comme suit :

  1. Sélectionner Destinations > Parcourir pour accéder à la liste des destinations.

  2. Sélectionnez la destination et vérifiez que l’état est enabled.

  3. Basculez vers le Activation data , puis sélectionnez un nom de segment.

  4. Surveillez le résumé du segment et vérifiez que le nombre de profils correspond au nombre créé dans le jeu de données.

  5. Le Listes marketing SendGrid > API Create List est utilisé pour créer des listes de contacts uniques dans SendGrid en associant la valeur de la variable list_name et l’horodatage de l’exportation des données. Accédez au site SendGrid et vérifiez si la nouvelle liste de contacts conforme au modèle de nom est créée.

  6. Sélectionnez la nouvelle liste de contacts et vérifiez si le nouvel enregistrement email du jeu de données que vous avez créé est renseigné dans la nouvelle liste de contacts.

  7. De plus, vérifiez également quelques emails pour vérifier si le mappage des champs est correct.

Utilisation et gouvernance des données

Lors de la gestion de vos données, toutes les destinations Adobe Experience Platform se conforment aux stratégies d’utilisation des données. Pour obtenir des informations détaillées sur la manière dont Adobe Experience Platform applique la gouvernance des données, voir Présentation de la gouvernance des données.

Ressources supplémentaires

Cette destination SendGrid utilise les API suivantes :

Limites

Sur cette page