Connexion SendGrid
Présentation overview
SendGrid est une plateforme de communication client populaire pour les emails transactionnels et marketing.
Cette Adobe Experience Platform destination tire parti de SendGrid Marketing Contacts API, ce qui vous permet d’exporter vos profils de messagerie propriétaires et de les activer dans une nouvelle audience SendGrid en fonction de vos besoins professionnels.
SendGrid utilise des jetons de support d’API comme mécanisme d’authentification pour communiquer avec l’API SendGrid.
Conditions préalables prerequisites
Les éléments suivants sont requis avant de commencer à configurer la destination.
-
Vous devez disposer d’un compte SendGrid.
- Accédez à la page SendGrid signup pour enregistrer et créer un compte SendGrid, si ce n’est déjà fait.
-
Une fois connecté au portail SendGrid, vous devez également générer un jeton API.
-
Accédez au site web SendGrid et accédez à la page Settings > API Keys . Vous pouvez également vous reporter à la documentation SendGrid pour accéder à la section appropriée dans l’application SendGrid.
-
Enfin, cliquez sur le bouton Create API Key .
- Reportez-vous à la documentation SendGrid si vous avez besoin de conseils sur les actions à exécuter.
- Si vous souhaitez générer votre clé API par programmation, reportez-vous à la documentation SendGrid.
Avant d’activer des données vers la destination SendGrid, vous devez avoir un schéma, un jeu de données et des segments créés dans Experience Platform. Reportez-vous également à la section limites ci-dessous sur cette page.
-
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 autre email. 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 du 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 audiences dans Experience Platform.
Identités prises en charge supported-identities
SendGrid prend en charge l’activation des identités décrites dans le tableau ci-dessous. En savoir plus sur les identités.
Notez que SendGrid ne prend pas en charge les adresses électroniques hachées. Dès lors, seules les données en texte brut sans transformation sont envoyées à la destination.
Type et fréquence d’exportation export-type-frequency
Reportez-vous au tableau ci-dessous pour plus d’informations sur le type et la fréquence d’exportation des destinations.
Cas d’utilisation use-cases
Pour vous aider à mieux comprendre comment et à quel moment utiliser la destination SendGrid, voici des exemples de cas d’utilisation que les clients Experience Platform peuvent résoudre à l’aide de 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 connect
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.
S’authentifier auprès de la destination authenticate
-
Dans la console Adobe Experience Platform, accédez à Destinations.
-
Sélectionnez l’onglet Catalogue et recherchez SendGrid. Sélectionnez ensuite Configurer. Après avoir établi une connexion à la destination, l’étiquette de l’interface utilisateur passe à Activer les segments.
-
Un assistant vous aide à configurer la destination SendGrid. Créez la nouvelle destination en sélectionnant Configurer une nouvelle destination.
-
Sélectionnez l’option New Account et renseignez la valeur Bearer Token . Cette valeur est la clé API de SendGrid mentionnée précédemment dans la section des conditions préalables.
-
Sélectionnez Se connecter à la destination. Si la clé API de SendGrid que vous avez fournie est valide, l’interface utilisateur affiche un état Connecté avec une coche verte, vous pouvez passer à l’étape suivante pour remplir des champs d’informations supplémentaires.
Renseigner les détails de la destination destination-details
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 à l’avenir.
Activer les alertes enable-alerts
Vous pouvez activer les alertes pour recevoir des notifications sur le statut de votre 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 l’abonnement aux alertes des destinations dans l’interface utilisateur.
Lorsque vous avez terminé de renseigner les détails sur votre connexion de destination, sélectionnez Suivant.
Activer des audiences vers cette destination activate
- Pour activer les données, vous avez besoin des , Activer les destinations, et autorisations de contrôle d’accès. Lisez la présentation du contrôle d’accès ou contactez votre administrateur ou administratrice du produit pour obtenir les autorisations requises.
- Pour exporter des identités, vous avez besoin de l'autorisation Afficher le graphique d'identités 🔗.
Consultez la section Activer les profils et les audiences vers les destinations d’exportation d’audiences en flux continu pour obtenir des instructions sur l’activation des audiences vers cette destination.
Reportez-vous aux images ci-dessous pour plus de détails sur cette destination.
-
Sélectionnez une ou plusieurs audiences à exporter vers SendGrid.
-
À l’étape Mapping, après avoir sélectionné Ajouter un nouveau mappage, la page de mappage s’affiche pour mapper les champs XDM source 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 le champ Source Email doit être mappé au champ cible external_id comme illustré ci-dessous.
-
De même, mappez les attributs Adobe Experience Platform que vous souhaitez exporter vers la destination SendGrid.
-
Après avoir effectué les mappages, sélectionnez Suivant pour accéder à l’écran de révision.
-
Sélectionnez Terminer pour terminer la configuration.
La liste complète des mappages d’attributs pris en charge pouvant être configurés pour l’ API de contacts marketing SendGrid > Ajouter ou mettre à jour les contacts est ci-dessous.
homeAddress.street1
address_line_1
100 caractères
homeAddress.street2
address_line_2
100 caractères
_extconndev.alternate_emails
alternate_emails
- Max. : 5 éléments
- Min. : 0 élément
homeAddress.city
city
60 caractères
homeAddress.country
country
50 caractères
external_id
254 caractères
person.name.firstName
first_name
50 caractères
person.name.lastName
last_name
50 caractères
homeAddress.postalCode
postal_code
homeAddress.stateProvince
state_province_region
50 caractères
Validation de l’exportation des données dans SendGrid validate
Pour vérifier que vous avez correctement configuré la destination, procédez comme suit :
-
Sélectionnez Destinations > Parcourir pour accéder à la liste des destinations.
-
Sélectionnez la destination et vérifiez que le statut est activé.
-
Passez à l’onglet Activation data, puis sélectionnez un nom d’audience.
-
Surveillez la synthèse de l’audience et vérifiez le nombre de profils correspondant au nombre créé dans le jeu de données.
-
L’API SendGrid Marketing List > Create List est utilisée pour créer des listes de contacts uniques dans SendGrid en associant la valeur de l’attribut 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.
-
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.
-
De plus, vérifiez également quelques emails pour vérifier si le mappage des champs est correct.
Utilisation et gouvernance des données data-usage-governance
Lors de la gestion de vos données, toutes les destinations Adobe Experience Platform se conforment aux politiques 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, lisez la présentation de la gouvernance des données.
Ressources supplémentaires additional-resources
Cette destination SendGrid utilise les API suivantes :
Limites limits
- L’ SendGrid Marketing Contacts > Add ou Update Contact API peut accepter 30 000 contacts, ou 6 Mo de données, selon la valeur la plus basse.