Connexion (API) Oracle Eloqua

Oracle Eloqua permet aux marketeurs de planifier et d’exécuter des campagnes tout en offrant une expérience client personnalisée pour leurs prospects. Grâce à une gestion intégrée des prospects et à une création de campagnes facile, les marketeurs peuvent interagir avec la bonne audience au bon moment dans le parcours de leur acheteur et s’adapter de manière élégante pour atteindre les audiences par le biais de canaux tels que les emails, la recherche d’affichage, la vidéo et les appareils mobiles. Les équipes commerciales peuvent conclure plus d’offres à un rythme plus rapide, ce qui augmente le retour sur investissement marketing grâce à des informations en temps réel.

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

Oracle Eloqua utilise l’ authentification de base pour communiquer avec l’ Oracle Eloqua API REST. 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 à un public organisé de pistes. L’équipe marketing de la plateforme peut mettre à jour les informations de piste existantes via Adobe Experience Platform, créer des audiences à partir de leurs propres données hors ligne et envoyer ces audiences à Oracle Eloqua, qui peuvent ensuite être utilisées pour envoyer le courrier électronique 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 du groupe de champs de schéma Détails de l’appartenance à l’audiencesi vous avez besoin de conseils sur les états de l’audience.

Conditions préalables de Oracle Eloqua prerequisites-destination

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

De plus, vous avez besoin, au minimum, des "Utilisateurs avancés - Autorisations marketing" pour votre instance Oracle Eloqua. Pour plus d'informations, reportez-vous à la section "Groupes de sécurité" de la page Accès utilisateur sécurisé . L’accès est requis par la destination pour déterminer par programmation l’URL de base 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 :

Informations d’identification
Description
Company Name
Nom de la société associé à votre compte Oracle Eloqua.
Vous utiliserez ensuite Company Name et Oracle Eloqua Username comme chaîne concaténée à utiliser comme nom d’utilisateur lors de l’ authentification à la destination.
Username
Nom d’utilisateur de votre compte Oracle Eloqua.
Password
Mot de passe de votre compte Oracle Eloqua.
Pod
Oracle Eloqua prend en charge plusieurs centres de données, chacun portant un nom de domaine unique. Oracle Eloqua fait référence à ces "capsules", il y en a actuellement sept au total : p01, p02, p03, p04, p06, p07 et p08. Pour obtenir le POD sur lequel vous vous trouvez, connectez-vous à Oracle Eloqua et notez l’URL dans votre navigateur une fois que vous êtes connecté. Par exemple, si l’URL de votre navigateur est secure.p01.eloqua.com, votre pod est p01. Pour plus d’informations, reportez-vous à la page Définition de votre POD .

Pour plus d’informations, reportez-vous à la section Connexion à Oracle Eloqua .

Mécanismes de sécurisation guardrails

NOTE
  • Oracle Eloqua des champs de contact personnalisés sont automatiquement créés à l’aide des noms des audiences sélectionnées lors de l’étape Sélectionner des segments .
  • Oracle Eloqua est limitée à 250 champs de contact personnalisés.

  • Avant d’exporter de nouvelles audiences, assurez-vous que le nombre d’audiences Platform et le nombre d’audiences existantes dans Oracle Eloqua ne dépassent pas cette limite.

  • Si cette limite est dépassée, une erreur se produira dans Experience Platform. Cela est dû au fait que l’API Oracle Eloqua ne parvient pas à valider la requête et répond par un message d’erreur - 400 : une erreur de validation s’est produite - décrivant le problème.

  • Si vous avez atteint la limite spécifiée ci-dessus, vous devez supprimer les mappages existants de votre destination et supprimer les champs de contact personnalisés correspondants dans votre compte Oracle Eloqua avant de pouvoir exporter d’autres segments.

  • Pour plus d’informations sur les limites supplémentaires, reportez-vous à la page Oracle Eloqua Création de champs de contact .

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.

Identité cible
Description
Obligatoire
EloquaId
Identifiant unique du contact.
Oui

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.

É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 souhaités, (par exemple : adresse e-mail, numéro de téléphone, nom), en fonction de votre mappage de champs.
  • Pour chaque audience sélectionnée dans Platform, l’état du segment Oracle Eloqua correspondant est mis à jour avec son état d’audience de Platform.
Fréquence des exportations
Diffusion en continu
  • Les destinations de diffusion en continu sont des connexions basées sur l’API « toujours actives ». Dès qu’un profil est mis à jour dans Experience Platform en fonction de l’évaluation des audiences, le connecteur envoie la mise à jour en aval vers la plateforme de destination. En savoir plus sur les destinations de diffusion en continu.

Se connecter à la destination connect

IMPORTANT
Pour vous connecter à la destination, vous avez besoin des ​et des 🔗 autorisations de contrôle d’accès. Lisez la 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.

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

S’authentifier auprès de la destination authenticate

Renseignez les champs obligatoires ci-dessous. Pour obtenir des conseils, reportez-vous à la section Rassembler Oracle Eloqua les informations d’identification .

  • Mot de passe : mot de passe de votre compte Oracle Eloqua.
  • Nom d’utilisateur : chaîne concaténée composée de votre Oracle Eloqua nom d’entreprise et du Oracle Eloqua nom d’utilisateur.
    La valeur concaténée prend la forme {COMPANY_NAME}\{USERNAME}.
    Remarque : n’utilisez pas d’accolades ou d’espaces et conservez le \.
    Par exemple, si le Oracle Eloqua nom de la société est MyCompany et que le Oracle Eloqua nom d’utilisateur est Username, la valeur concaténée que vous utiliserez dans le champ nom d’utilisateur est MyCompany\Username.

Pour vous authentifier auprès de la destination, sélectionnez Se connecter à la destination.
Capture d’écran montrant comment s’authentifier sur l’interface utilisateur de Platform.

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.
Capture d’écran de l’interface utilisateur de Platform montrant les détails de destination.

  • Nom  : un nom par lequel vous reconnaîtrez cette destination à l’avenir.
  • Description  : une description qui vous aidera à identifier cette destination à l’avenir.
  • Pod : pour obtenir le pod sur lequel vous vous trouvez, connectez-vous à Oracle Eloqua et notez l’URL dans votre navigateur une fois que vous êtes connecté. Par exemple, si l’URL de votre navigateur est secure.p01.eloqua.com, la valeur pod que vous devez sélectionner est p01. Pour plus d’informations, reportez-vous à la section Rassembler Oracle Eloqua les informations d’identification .

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

IMPORTANT
  • 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 🔗.

    Sélectionnez l’espace de noms d’identité en surbrillance dans le workflow pour activer les audiences vers les destinations. {width="100" modal="regular"}

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 Platform et leurs équivalents de la destination cible.

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

  1. Dans l’étape Mappage, sélectionnez Ajouter un nouveau mappage. Une nouvelle ligne de mappage s’affichera à l’écran.

  2. Dans la fenêtre Sélectionner le champ source, choisissez la catégorie Sélectionner les attributs et sélectionnez l’attribut XDM ou l’attribut Sélectionner l’espace de noms d’identité et sélectionnez une identité.

  3. Dans la fenêtre Sélectionner le champ cible, choisissez Sélectionner l’espace de noms d’identité et sélectionnez une identité, ou choisissez Sélectionner des attributs personnalisés et saisissez le nom de l’attribut de votre choix dans le champ Nom de l’attribut. Le nom d’attribut que vous fournissez doit correspondre à un attribut de contact existant dans Oracle Eloqua. Voir create a contact pour connaître les noms d’attributs exacts que vous pouvez utiliser dans Oracle Eloqua.

    • Répétez ces étapes pour ajouter les mappages d’attributs requis et souhaités entre votre schéma de profil XDM et Oracle Eloqua :

      table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 6-row-3 7-row-3 8-row-3 9-row-3 10-row-3
      Champ source Champ cible Obligatoire
      IdentityMap: Eid Identity: EloquaId Oui
      xdm: personalEmail.address Attribute: emailAddress Oui
      xdm: personName.firstName Attribute: firstName
      xdm: personName.lastName Attribute: lastName
      xdm: workAddress.street1 Attribute: address1
      xdm: workAddress.street2 Attribute: address2
      xdm: workAddress.street3 Attribute: address3
      xdm: workAddress.postalCode Attribute: postalCode
      xdm: workAddress.country Attribute: country
      xdm: workAddress.city Attribute: city
    • Un exemple avec les mappages ci-dessus est illustré ci-dessous :

      Exemple de capture d’écran de l’interface utilisateur de Platform avec mappages d’attributs.

IMPORTANT
  • Les attributs spécifiés dans le champ cible doivent être nommés exactement comme spécifiés dans le Create a contact car ces attributs formeront le corps de la requête.
  • Les attributs spécifiés dans le champ Source ne suivent aucune restriction de ce type. Vous pouvez le mapper en fonction de vos besoins, mais si le format de données n’est pas correct lorsqu’il est envoyé vers Oracle Eloqua, une erreur se produira. Par exemple, vous pouvez mapper l’espace de noms d’identité Champ Source contact key, ABC ID etc. à Champ cible : EloquaId après avoir vérifié que les valeurs d'identifiant correspondent au format accepté par Oracle Eloqua.
  • Le mappage EloquaID est obligatoire pour mettre à jour les attributs correspondant à l’identité.
  • Le mappage emailAddress est requis. Sans elle, l’API renvoie une erreur comme illustré ci-dessous :
code language-json
{
     "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.

NOTE
La destination ajoute automatiquement un identifiant unique aux noms d’audience sélectionnés lors de chaque exécution lors de l’envoi des informations du champ de contact à Oracle Eloqua. Ainsi, les noms des champs de contact correspondant aux noms de vos audiences ne se chevauchent pas. Reportez-vous à l’exemple d’écran de la section Valider l’export de données d’une page Oracle Eloqua Détails du contact avec un champ de contact personnalisé créé à l’aide des noms d’audience.

Valider l’exportation des données exported-data

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

  1. Sélectionnez Destinations > Parcourir et accédez à la liste des destinations.

  2. Ensuite, sélectionnez la destination et passez à l’onglet Données d’activation , puis sélectionnez un nom d’audience.
    Exemple de capture d’écran de l’interface utilisateur de Platform montrant les données d’activation des destinations.

  3. Surveillez la synthèse de l’audience et assurez-vous que le nombre de profils correspond au nombre dans le segment.
    Exemple de capture d’écran de l’interface utilisateur de Platform montrant le segment.

  4. Connectez-vous au site web Oracle Eloqua, puis accédez à la page Présentation des contacts pour vérifier si les profils de l’audience ont été ajoutés. Pour afficher l’état de l’audience, accédez à une page Détails du contact et vérifiez si le champ de contact avec le nom de l’audience sélectionné comme préfixe a été créé.

Oracle de la capture d’écran de l’interface utilisateur Eloqua affichant la page Détails du contact avec le champ de contact personnalisé créé avec le nom de l’audience.

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

Lors de 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 Barrières de sécurité . Pour corriger cette erreur, veillez à ne pas dépasser la limite du champ de contact personnalisé dans Oracle Eloqua.
Copie d’écran de l’interface utilisateur de Platform affichant l’erreur.

Reportez-vous aux 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, voir 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.

Afficher le journal des modifications
table 0-row-3 1-row-3 2-row-3 layout-auto
Mois de publication Type de mise à jour Description
Avril 2023 Mise à jour de la documentation
  • Nous avons mis à jour la section Cas d’utilisation avec un exemple plus clair de à quel moment les clients pourraient bénéficier de l’utilisation de cette destination.
  • Nous avons mis à jour la section mapping avec des exemples clairs de mappages obligatoires et facultatifs.
  • Nous avons mis à jour la section Se connecter à la destination avec un exemple de construction de la valeur concaténée pour le champ Nom d’utilisateur à l’aide du Oracle Eloqua nom d’entreprise et du Oracle Eloqua nom d’utilisateur. (PLATIR-28343)
  • Nous avons mis à jour les sections Rassembler Oracle Eloqua les informations d’identification et Remplir les détails de destination avec des instructions sur la sélection Oracle Eloqua Pod. La valeur "Pod" est utilisée par la destination pour construire l’URL de base des appels API. La section Oracle Eloqua Conditions préalables requises a également été mise à jour avec des conseils sur l’attribution de "Utilisateurs avancés - Autorisations marketing" en tant que "Groupes de sécurité" requis pour votre instance Oracle Eloqua.
Mars 2023 Version initiale Version initiale de la destination et publication de la documentation.
recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6