Connexion (API) Oracle Eloqua

Oracle Eloqua permet aux spécialistes marketing de planifier et d’exécuter des campagnes tout en offrant une expérience client personnalisée à leurs prospects. Grâce à la gestion de piste intégrée et à la création facile de campagnes, il permet aux marketeurs d’impliquer la bonne audience au bon moment dans le parcours de leur acheteur et se dimensionne de manière élégante pour atteindre les audiences sur l’ensemble des canaux, y compris les e-mails, la recherche d’affichage, les vidéos et les appareils mobiles. Les équipes commerciales peuvent conclure plus d’offres plus rapidement, ce qui accroît le retour sur investissement marketing grâce à insight en temps réel.

Cette Adobe Experience Platform destination tire parti de l’opération Mettre à jour un contact de l’API Oracle Eloqua REST, qui vous permet de mettre à jour les identités d’une audience dans Oracle Eloqua.

Oracle Eloqua utilise l’authentification de base pour communiquer avec l’API REST Oracle Eloqua. Les instructions vous permettant de vous authentifier sur votre instance Oracle Eloqua sont plus loin dans la section Authentifier à la destination.

Cas d’utilisation use-cases

Le service marketing d’une plateforme en ligne souhaite diffuser une campagne marketing par e-mail à une audience de prospects organisée. L’équipe marketing de la plateforme peut mettre à jour les informations de prospect existantes par l’intermédiaire de Adobe Experience Platform, créer des audiences à partir de leurs propres données hors ligne et envoyer ces audiences à Oracle Eloqua, qui peut ensuite être utilisée pour envoyer l’e-mail de campagne marketing.

Conditions préalables prerequisites

Conditions préalables d’Experience Platform prerequisites-in-experience-platform

Avant d’activer des données dans la destination Oracle Eloqua, vous devez avoir un schéma, un jeu de données, ainsi que des segments créés dans Experience Platform.

Reportez-vous à la documentation Experience Platform pour le groupe de champs de schéma Détails sur l’appartenance à une audience si vous avez besoin de conseils sur les statuts de l’audience.

Conditions préalables de Oracle Eloqua prerequisites-destination

Pour exporter des données d’Experience Platform vers votre compte Oracle Eloqua, vous devez disposer d’un compte Oracle Eloqua.

En outre, vous avez besoin, au minimum, de la « Utilisateurs avancés - Autorisations marketing » pour votre instance Oracle Eloqua. Reportez-vous à la section « Groupes de sécurité » sur la page Accès utilisateur sécurisé pour obtenir des conseils. L’accès est requis par la destination pour déterminer votre URL de base par programmation lors de l’appel de l’API Oracle Eloqua.

Collectez les informations d’identification de Oracle Eloqua. gather-credentials

Notez les éléments ci-dessous avant de vous authentifier à la destination Oracle Eloqua :

Reportez-vous à la section Connexion à Oracle Eloqua pour obtenir des conseils.

Mécanismes de sécurisation guardrails

Identités prises en charge supported-identities

Oracle Eloqua prend en charge la mise à jour des identités décrites dans le tableau ci-dessous. En savoir plus sur les identités.

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.

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.

Dans Destinations > Catalogue, recherchez (API) Oracle Eloqua. Vous pouvez également localiser cet élément dans la catégorie Marketing par e-mail.

S’authentifier auprès de la destination authenticate

Renseignez les champs obligatoires ci-dessous. Reportez-vous à la section Collecter Oracle Eloqua informations d’identification pour obtenir des conseils.

Pour vous authentifier auprès de la destination, sélectionnez Se connecter à la destination.

Si les détails fournis sont valides, l’interface utilisateur affiche un statut Connecté avec une coche verte. Vous pouvez ensuite passer à l’étape suivante.

Renseigner les détails de la destination destination-details

Pour configurer les détails de la destination, renseignez les champs obligatoires et facultatifs ci-dessous. Un astérisque situé en regard d’un champ de l’interface utilisateur indique que le champ est obligatoire.

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

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.

Considérations sur le mappage et exemple mapping-considerations-example

Pour envoyer correctement vos données d’audience d’Adobe Experience Platform vers la destination Oracle Eloqua, vous devez passer par l’étape de mappage des champs. Le mappage consiste à créer un lien entre vos champs de schéma de modèle de données d’expérience (XDM) dans votre compte Experience Platform et leurs équivalents issus de la destination cible.

Pour mapper vos champs XDM aux champs de destination Oracle Eloqua, procédez comme suit :

{
     "type":"ObjectValidationError",
     "container":{
           "type":"ObjectKey",
           "objectType":"Contact"
     },
     "property":"emailAddress",
     "requirement":{
           "type":"EmailAddressRequirement"
     },
     "value":"<null>"
}

Lorsque vous avez terminé de fournir les mappages pour votre connexion de destination, sélectionnez Suivant.

Valider l’exportation des données exported-data

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

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.

Erreurs et résolution des problèmes errors-and-troubleshooting

Pendant la création de la destination, vous pouvez recevoir l’un des messages d’erreur suivants : 400: There was a validation error ou 400 BAD_REQUEST. Cela se produit lorsque vous dépassez la limite de 250 champs de contact personnalisés, comme décrit dans la section mécanismes de sécurisation. Pour corriger cette erreur, veillez à ne pas dépasser la limite de champ de contact personnalisé dans Oracle Eloqua.

Consultez les pages Oracle Eloqua Codes d’état HTTP et Oracle Eloqua Erreurs de validation pour obtenir une liste complète des codes d’état et d’erreur avec des explications.

Ressources supplémentaires additional-resources

Pour plus d’informations, consultez la documentation Oracle Eloqua :

Journal des modifications

Cette section répertorie les nouvelles fonctionnalités et les mises à jour importantes de la documentation consacrée au connecteur de destination.