Présentation de la source Oracle Eloqua (V2)
Oracle Eloqua est une puissante plateforme d’automatisation du marketing de niveau entreprise conçue pour aider les organisations, principalement dans l’espace B2B, à automatiser et à personnaliser le processus complexe de gestion des prospects et d’orchestration des parcours d’acheteurs. Il sert de hub central où les équipes marketing peuvent définir, déployer et mesurer des campagnes sophistiquées sur plusieurs canaux numériques, afin de s'assurer que les prospects reçoivent le contenu approprié au moment précis où ils sont le plus engagés. Les objets pris en charge pour l’ingestion via Eloqua sont Contacts, Comptes, Campagnes et Activités. Une fois l’ingestion initiale terminée, toutes les données modifiées sont importées à l’aide d’un processus incrémentiel planifié.
Vous pouvez utiliser la source de Eloqua pour connecter votre compte Eloqua à Adobe Experience Platform. Lisez la documentation ci-dessous pour savoir comment commencer.
Exemples de cas d’utilisation use-case-examples
Vous trouverez ci-dessous un tableau décrivant les objets marketing pris en charge par l’intégration d’Eloqua (V2) à Adobe Experience Platform. Pour chaque objet, vous trouverez une description ainsi que des exemples de cas d’utilisation pour illustrer comment l’intégration des données Eloqua à Real-Time CDP peut améliorer l’efficacité marketing et les résultats des campagnes.
Conditions préalables prerequisites
Lisez les sections ci-dessous pour connaître les conditions préalables à la configuration que vous devez remplir avant de pouvoir connecter votre source à Experience Platform.
Configuration de l’application pour l’authentification
Suivez les étapes ci-dessous pour savoir comment configurer votre compte Eloqua et vous connecter à Experience Platform à l’aide de l’authentification de base.
Pour commencer, connectez-vous à votre instance Eloqua en tant qu’administrateur (ou en tant qu’utilisateur autorisé à créer des utilisateurs, des groupes de sécurité et des applications).
Accédez à Paramètres > Extensions de Platform > Développeur d’App Cloud > Créer une application. Fournissez des détails sur votre application, notamment son nom, sa description, son icône et l’URL de rappel OAuth. Lorsque vous avez terminé, cliquez sur Enregistrer.
Une fois votre application créée, accédez à Authentication to Eloqua et récupérez les Identifiant client et Secret client à partir de l’application nouvellement créée. Ces valeurs seront utilisées ultérieurement lors de la connexion à Experience Platform.
Les groupes de sécurité permettent aux administrateurs de contrôler les niveaux d’accès des utilisateurs aux ressources, fonctionnalités, interfaces, etc. Pour créer un groupe de sécurité, accédez à Paramètres > Utilisateurs. Sélectionnez ensuite l’onglet Groupe dans le panneau de gauche, puis sélectionnez Créer un groupe de sécurité.
Utilisez la fenêtre Security Group Overview pour attribuer un nom et un acronyme à votre groupe de sécurité. Une fois créée, accédez à Action Permissions , ajoutez l’autorisation API Consume dans la liste et sélectionnez Enregistrer.
Pour ingérer des données de campagne, accédez à l’interface Modifier l’utilisateur et ajoutez des Guided Campaigns au groupe de sécurité sélectionné.
Vous pouvez éventuellement créer un utilisateur supplémentaire et l’ajouter à un groupe de sécurité. Pour obtenir des instructions détaillées, consultez la documentation Eloqua sur création d’un utilisateur et affectation d’un utilisateur à un groupe de sécurité.
Collecter les informations d’identification requises
Vous devez fournir des valeurs pour les informations d’identification suivantes afin de Eloqua connecter à Experience Platform.
CompanyName\Username.http:// ni https:// lors de l’authentification.Guide de mappage des Eloqua
- Contacts :
C_DateModified - Comptes:
M_DateModified - Activité:
CreatedAt - Objets personnalisés :
UpdatedAt - Campaign:
updatedAt
Les tableaux suivants fournissent des mappages détaillés entre les champs source Eloqua et leurs champs de destination Modèle de données d’expérience (XDM) correspondants dans Experience Platform. Chaque ligne décrit la logique de transformation, si le champ est immuable, et fournit des notes supplémentaires pour vous aider à comprendre comment vos données Eloqua seront ingérées et structurées dans Experience Platform.
Comptes
"Eloqua""${SOURCE_INSTANCE_ID}"SOURCE_INSTANCE_ID sera automatiquement remplacé par le connecteur .Idconcat(Id, "\\@${SOURCE_INSTANCE_ID}.Eloqua")SOURCE_INSTANCE_ID sera automatiquement remplacé par le connecteur .M_CompanyNameM_CountryM_Address1M_CityM_State_ProvM_Zip_PostalM_BusPhoneM_Fax1M_Account_Engagement_ScoreM_Account_Type1M_Wesbsite1M_Employees1to_decimal(M_Annual_Revenue1)M_DateModifiedM_DateCreatedM_Industry1iif(M_SFDCAccountID != null && M_SFDCAccountID != "", to_object("sourceType", "Salesforce", "sourceInstanceID", "${CRM_INSTANCE_ID}", "sourceID", M_SFDCAccountID, "sourceKey", concat(M_SFDCAccountID, "\\@${CRM_INSTANCE_ID}.Salesforce")), iif(M_MSCRMAccountID != null && M_MSCRMAccountID != "", to_object("sourceType", "Dynamics", "sourceInstanceID", "${CRM_INSTANCE_ID}", "sourceID", M_MSCRMAccountID, "sourceKey", concat(M_MSCRMAccountID, "\\@${CRM_INSTANCE_ID}.Dynamics")), null))${CRM_INSTANCE_ID} par votre ID d’instance CRM réel, soit votre ID d’instance Salesforce, soit votre ID d’instance Dynamics. Lors de l’ingestion, si M_SFDCAccountID est présent, le connecteur génère la clé externe à l’aide de cette valeur et ajoute des \@CRM_INSTANCE_ID.Salesforce. Si ce champ est vide, le connecteur utilise M_MSCRMAccountID et ajoute \@CRM_INSTANCE_ID.Dynamics à la place. Si les deux champs sont vides, ce champ est défini sur null.Activités
"Eloqua""${SOURCE_INSTANCE_ID}"SOURCE_INSTANCE_ID sera automatiquement remplacé par le connecteur .ContactIdconcat(ContactId, "\\@${SOURCE_INSTANCE_ID}.Eloqua")SOURCE_INSTANCE_ID sera automatiquement remplacé par le connecteur .ExternalIdiif(ActivityType!=null && ActivityType!="", iif(ActivityType=="EmailSend", "directMarketing.emailSent", iif(ActivityType=="EmailOpen", "directMarketing.emailOpened", iif(ActivityType=="EmailClickthrough", "directMarketing.emailClicked", iif(ActivityType=="Unsubscribe", "directMarketing.emailUnsubscribed", iif(ActivityType=="Bounceback", "directMarketing.emailBounced", iif(ActivityType=="FormSubmit", "web.formFilledOut", iif(ActivityType=="PageView", "web.webpagedetails.pageViews", ActivityType))))))), null)ActivityDateiif(AssetType == "Email", AssetName, null)iif(AssetType == "Email", to_object("sourceType", "Eloqua", "sourceInstanceID", "${SOURCE_INSTANCE_ID}","sourceID",${AssetId}, "sourceKey", concat(${AssetId},"\\@${SOURCE_INSTANCE_ID}.Eloqua")), null)SOURCE_INSTANCE_ID sera automatiquement remplacé par le connecteur .iif(AssetType == "Email", EmailAddress, null)iif(ActivityType == "Bounceback", SmtpStatusCode, null)iif(AssetType == "Email", SmtpMessage, null)iif(AssetType == "Email", EmailWebLink, null)iif(ActivityType == "FormSubmit", AssetName, null)iif(ActivityType == "FormSubmit", to_object("sourceType", "Eloqua", "sourceInstanceID", "${SOURCE_INSTANCE_ID}","sourceID",${AssetId}, "sourceKey", concat(${AssetId},"\\@${SOURCE_INSTANCE_ID}.Eloqua")), null)SOURCE_INSTANCE_ID sera automatiquement remplacé par le connecteur .iif(ActivityType == "PageView", AssetName, null)iif(ActivityType == "PageView", to_object("sourceType", "Eloqua", "sourceInstanceID", "${SOURCE_INSTANCE_ID}","sourceID",${AssetId}, "sourceKey", concat(${AssetId},"\\@${SOURCE_INSTANCE_ID}.Eloqua")), null)SOURCE_INSTANCE_ID sera automatiquement remplacé par le connecteur .iif(ActivityType == "PageView", Url, null)Campagnes
"Eloqua""${SOURCE_INSTANCE_ID}"SOURCE_INSTANCE_ID sera automatiquement remplacé par le connecteur .idconcat(id, "\\@${SOURCE_INSTANCE_ID}.Eloqua")SOURCE_INSTANCE_ID sera automatiquement remplacé par le connecteur .nameendAtstartAtactualCostbudgetedCostdescriptioncurrentStatuscampaignTypecreatedAtupdatedAtContacts
"Eloqua""${SOURCE_INSTANCE_ID}"SOURCE_INSTANCE_ID sera automatiquement remplacé par le connecteur .Idconcat(Id, "\\@${SOURCE_INSTANCE_ID}.Eloqua"SOURCE_INSTANCE_ID sera automatiquement remplacé par le connecteur .C_CompanyC_Website1C_Job_Title1C_FaxC_MobilePhoneiif(C_SFDCLeadID != null && C_SFDCLeadID != "\\", to_object("sourceType", "Salesforce", "sourceInstanceID", "${CRM_INSTANCE_ID}", "sourceID", C_SFDCLeadID, "sourceKey", concat(C_SFDCLeadID, "\\@${CRM_INSTANCE_ID}.Salesforce")), iif(C_SFDCContactID != null && C_SFDCContactID != "\\", to_object("sourceType", "Salesforce", "sourceInstanceID", "${CRM_INSTANCE_ID}", "sourceID", C_SFDCContactID, "sourceKey", concat(C_SFDCContactID, "\\@${CRM_INSTANCE_ID}.Salesforce")), null))iif(C_MSCRMLeadID != null && C_MSCRMLeadID != "\\", to_object("sourceType", "Dynamics", "sourceInstanceID", "${CRM_INSTANCE_ID}", "sourceID", C_MSCRMLeadID, "sourceKey", concat(C_MSCRMLeadID, "\\@${CRM_INSTANCE_ID}.Dynamics")), iif(C_MSCRMContactID != null && C_MSCRMContactID != "\\", to_object("sourceType", "Dynamics", "sourceInstanceID", "${CRM_INSTANCE_ID}", "sourceID", C_MSCRMContactID, "sourceKey", concat(C_MSCRMContactID, "\\@${CRM_INSTANCE_ID}.Dynamics")), null))"iif(C_SFDCLeadID != null && C_SFDCLeadID != "\\", to_object("sourceType", "Salesforce", "sourceInstanceID", "${CRM_INSTANCE_ID}", "sourceID", C_SFDCLeadID, "sourceKey", concat(C_SFDCLeadID, "\\@${CRM_INSTANCE_ID}.Salesforce")), iif(C_SFDCContactID != null && C_SFDCContactID != "\\", to_object("sourceType", "Salesforce", "sourceInstanceID", "${CRM_INSTANCE_ID}", "sourceID", C_SFDCContactID, "sourceKey", concat(C_SFDCContactID, "\\@${CRM_INSTANCE_ID}.Salesforce")), null))"iif(C_MSCRMLeadID != null && C_MSCRMLeadID != "\\", to_object("sourceType", "Dynamics", "sourceInstanceID", "${CRM_INSTANCE_ID}", "sourceID", C_MSCRMLeadID, "sourceKey", concat(C_MSCRMLeadID, "\\@${CRM_INSTANCE_ID}.Dynamics")), iif(C_MSCRMContactID != null && C_MSCRMContactID != "\\", to_object("sourceType", "Dynamics", "sourceInstanceID", "${CRM_INSTANCE_ID}", "sourceID", C_MSCRMContactID, "sourceKey", concat(C_MSCRMContactID, "\\@${CRM_INSTANCE_ID}.Dynamics")), null))C_DateCreatedC_DateModifiediif(C_SFDCAccountID != null && C_SFDCAccountID != "\\", to_object("sourceType", "Salesforce", "sourceInstanceID", "${CRM_INSTANCE_ID}", "sourceID", C_SFDCAccountID, "sourceKey", concat(C_SFDCAccountID, "\\@${CRM_INSTANCE_ID}.Salesforce")), iif(C_MSCRMAccountID != null && C_MSCRMAccountID != "\\", to_object("sourceType", "Dynamics", "sourceInstanceID", "${CRM_INSTANCE_ID}", "sourceID", C_MSCRMAccountID, "sourceKey", concat(C_MSCRMAccountID, "\\@${CRM_INSTANCE_ID}.Dynamics")), null))iif(C_SFDCAccountID != null && C_SFDCAccountID != "\\", to_object("sourceType", "Salesforce", "sourceInstanceID", "${CRM_INSTANCE_ID}", "sourceID", C_SFDCAccountID, "sourceKey", concat(C_SFDCAccountID, "\\@${CRM_INSTANCE_ID}.Salesforce")), iif(C_MSCRMAccountID != null && C_MSCRMAccountID != "\\", to_object("sourceType", "Dynamics", "sourceInstanceID", "${CRM_INSTANCE_ID}", "sourceID", C_MSCRMAccountID, "sourceKey", concat(C_MSCRMAccountID, "\\@${CRM_INSTANCE_ID}.Dynamics")), null))C_Lead_Source___Original1C_Lead_Source___Original1C_Lead_Status1C_Lead_Status1C_FirstNameC_LastNameC_Middle_Name1C_SalutationC_CityC_CountryC_Zip_PostalC_State_ProvRéférence de mapping du type d’activité
EmailSendEmailOpenEmailClickthroughUnsubscribeBouncebackFormSubmitPageViewOtherEspaces réservés de variable
Les modèles de mappage utilisent les espaces réservés de variable suivants, qui sont remplacés une fois un flux de données exécuté :
${SOURCE_INSTANCE_ID}${CRM_INSTANCE_ID}Connexion de Eloqua à Experience Platform
Continuez pour configurer votre connexion source Eloqua dans Experience Platform. Pour obtenir un guide détaillé sur la configuration de la connexion via l’interface utilisateur, reportez-vous au tutoriel ici. Lisez ce tutoriel pour en savoir plus sur la connexion de votre compte Eloqua, la sélection des données, le mappage des champs, la planification des ingestions et la surveillance des flux de données.