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.

Ceci Adobe Experience Platform destination tire parti de Mettre à jour un contact de la fonction Oracle Eloqua API REST, qui vous permet de mise à jour des identités dans un segment dans Oracle Eloqua.

Oracle Eloqua uses Authentification de base pour communiquer avec le 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

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 segments à partir de leurs propres données hors ligne et envoyer ces segments à Oracle Eloqua, qui peut ensuite être utilisé pour envoyer l’email de la campagne marketing.

Conditions préalables

Conditions préalables d’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 Groupe de champs Détails de l’appartenance à un segment si vous avez besoin d’instructions sur les états de segment.

Conditions préalables de Oracle Eloqua

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

En outre, vous avez besoin, au minimum, de l’événement "Utilisateurs avancés - Autorisations marketing" pour votre Oracle Eloqua instance. Reportez-vous à la section "Groupes de sécurité" de la section Accès sécurisé des utilisateurs à titre indicatif. L’accès est requis par la destination pour déterminer votre URL de base ; lors de l’appel de la fonction Oracle Eloqua API.

Collectez les informations d’identification de Oracle Eloqua.

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

Informations d’identification Description
Company Name Le nom de la société associé à votre Oracle Eloqua compte .
Vous utiliserez ensuite la variable Company Name et Oracle Eloqua Username comme chaîne concaténée à utiliser comme Nom d’utilisateur when authentification à la destination.
Username Le nom d’utilisateur de votre Oracle Eloqua compte .
Password Le mot de passe de votre Oracle Eloqua compte .
Pod Oracle Eloqua prend en charge plusieurs centres de données, chacun portant un nom de domaine unique. Oracle Eloqua désigne ces groupes comme des "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 connectez, 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 your pod is p01. Reportez-vous à la section détermination du POD pour plus d’informations.

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

Mécanismes de sécurisation

REMARQUE
  • Oracle Eloqua les champs de contact personnalisés sont automatiquement créés à partir des noms des segments sélectionnés lors de la Sélection de segments étape .
  • Oracle Eloqua ne peut pas contenir plus de 250 champs de contact personnalisés.

  • Avant d’exporter de nouveaux segments, vérifiez le nombre de segments Platform et le nombre de segments existants dans Oracle Eloqua ne dépasse pas cette limite.

  • Si cette limite est dépassée, une erreur se produira dans Experience Platform. En effet, la variable Oracle Eloqua L’API ne valide pas la requête et répond par un - 400 : Une erreur de validation s’est produite - message d’erreur 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 vos Oracle Eloqua avant d’exporter d’autres segments.

  • Reportez-vous à la section Oracle Eloqua Création de champs de contact pour plus d’informations sur les limites supplémentaires.

Identités prises en charge

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

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 segment sélectionné dans Platform, la variable Oracle Eloqua l’état du segment est mis à jour avec son état de segment depuis 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 segments, 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

IMPORTANT

Pour vous connecter à la destination, vous devez disposer de l’autorisation de contrôle d’accès Gérer les destinations. 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 le Marketing par e-mail catégorie.

S’authentifier auprès de la destination

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

  • Mot de passe: Le mot de passe de votre Oracle Eloqua compte .
  • Nom d’utilisateur: Chaîne concaténée composée de votre Oracle Eloqua Nom de la société et 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 la variable \.
    Par exemple, si la variable Oracle Eloqua Nom de la société MyCompany et Oracle Eloqua Le nom d’utilisateur est Username, la valeur concaténée que vous utiliserez dans la variable 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

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.
  • Capsule: Pour obtenir laquelle pod vous êtes activé, 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 la valeur que vous devez sélectionner est p01. Reportez-vous à la section Collecte Oracle Eloqua informations pour plus d’informations.

Activer les alertes

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 segments vers cette destination

IMPORTANT

Pour activer les données, vous avez besoin des autorisations de contrôle d’accès pour les fonctions Gérer les destinations, Activer les destinations, Afficher les profils, et Afficher les segments. Lisez la présentation du contrôle d’accès ou contactez votre administrateur de produit pour obtenir les autorisations requises.

Consultez Activer les profils et les segments vers les destinations d’exportation de segments de diffusion en continu pour obtenir des instructions sur l’activation des segments d’audience vers cette destination.

Considérations sur le mappage et exemple

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 issus de la destination cible.

Pour mapper vos champs XDM à Oracle Eloqua champs de destination, 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 le Sélectionner le champ source , choisissez la Sélectionner des attributs et sélectionnez l’attribut XDM ou choisissez l’option Sélectionner un espace de noms d’identité et sélectionnez une identité.
  3. Dans le Sélectionner le champ cible , choisissez Sélectionner un 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 souhaité dans la variable Nom de l’attribut champ . Le nom de l’attribut que vous fournissez doit correspondre à un attribut de contact existant dans Oracle Eloqua. Voir create a contact pour 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: | 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
  • Attributs spécifiés dans la variable Champ cible doit être nommé exactement comme indiqué dans la variable Create a contact car ces attributs forment le corps de la requête.
  • Attributs spécifiés dans la variable Champ source ne suivez 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 cela entraînera une erreur. Par exemple, vous pouvez mapper la variable Champ source namespace d’identité contact key, ABC ID etc. to Champ cible : EloquaId après avoir vérifié que les valeurs d’ID correspondent au format accepté par Oracle Eloqua.
  • Le EloquaID est obligatoire pour mettre à jour les attributs correspondant à l’identité.
  • Le emailAddress est requis. Sans elle, l’API renvoie une erreur comme illustré ci-dessous :
{
     "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.

REMARQUE

La destination ajoute automatiquement un identifiant unique aux noms de segment sélectionnés lors de chaque exécution lors de l’envoi des informations du champ de contact à Oracle Eloqua. Cela permet de s’assurer que les noms des champs de contact correspondant à vos noms de segment ne se chevauchent pas. Reportez-vous à la section Validation de l’exportation des données capture d’écran d’une section exemple d’une Oracle Eloqua Page Détails du contact avec un champ de contact personnalisé créé à l’aide des noms de segment.

Valider l’exportation des données

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

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

  2. Sélectionnez ensuite la destination et passez au Données d’activation , puis sélectionnez un nom de segment.
    Exemple de capture d’écran de l’interface utilisateur de Platform montrant les données d’activation des destinations.

  3. Surveillez le résumé du segment 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 Oracle Eloqua , puis accédez au Présentation des contacts pour vérifier si les profils du segment ont été ajoutés. Pour afficher l’état du segment, accédez à une Détails du contact et vérifiez si le champ de contact avec le nom du segment 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 du segment.

Utilisation et gouvernance des données

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

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 à la section 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

Pour plus d’informations, voir Oracle Eloqua documentation :

Journal des modifications

Cette section capture les fonctionnalités et les mises à jour importantes de la documentation apportées à ce connecteur de destination.

 Afficher le journal des modifications
Mois de publication Type de mise à jour Description
Avril 2023 Mise à jour de la documentation
  • Nous avons mis à jour la variable use-case 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 variable mapping avec des exemples clairs de mappages obligatoires et facultatifs.
  • Nous avons mis à jour la variable Connexion à la destination avec un exemple de construction de la valeur concaténée pour la variable Nom d’utilisateur à l’aide du champ Oracle Eloqua Nom de la société et Oracle Eloqua Nom d’utilisateur. (PLATIR-28343)
  • Nous avons mis à jour la variable Collecte Oracle Eloqua informations et le Renseignement des détails de destination sections contenant des conseils sur Oracle Eloqua Capsule sélection. Le "Capsule" est utilisée par la destination pour construire l’URL de base des appels API. Le Oracle Eloqua conditions préalables Mise à jour de la section avec des conseils sur l’attribution "Utilisateurs avancés - Autorisations marketing" comme requis "Groupes de sécurité" pour votre Oracle Eloqua instance.
Mars 2023 Version initiale Version initiale de la destination et publication de la documentation.

Sur cette page