Oracle Eloqua (V2) ソースの概要
Oracle Eloquaは、主にB2B分野の組織が、リードの管理とバイヤージャーニーのオーケストレーションという複雑なプロセスを自動化およびパーソナライズできるように設計された、強力なエンタープライズグレードのマーケティングオートメーションプラットフォームです。 マーケティングチームが複数のデジタルチャネルをまたいで高度なキャンペーンを定義、展開、測定できる中心的なハブとして機能し、見込み客が最もエンゲージしている的確なタイミングで適切なコンテンツを受け取れるようにします。 Eloquaを通じて取り込むためにサポートされているオブジェクトは、連絡先、アカウント、キャンペーン、および アクティビティ です。 最初の取り込みが完了すると、変更されたデータはすべて、スケジュールされた増分プロセスを使用して取り込まれます。
Eloqua ソースを使用して、Eloqua アカウントをAdobe Experience Platformに接続できます。 詳しくは、以下のドキュメントを参照してください。
ユースケースの例 use-case-examples
次の表は、Eloqua (V2)とAdobe Experience Platformの統合でサポートされるマーケティングオブジェクトの概要を示しています。 各オブジェクトには、Eloqua データをReal-Time CDPと統合して、マーケティングの効果とキャンペーンの成果を向上させる方法を示す説明とユースケースの例が記載されています。
前提条件 prerequisites
ソースをExperience Platformに接続する前に必要な前提条件の設定については、以下の節を参照してください。
認証用アプリケーションの設定
以下の手順に従って、Eloqua アカウントを設定し、基本認証を使用してExperience Platformに接続する方法を説明します。
開始するには、管理者(またはユーザー、セキュリティグループ、アプリを作成するアクセス権を持つユーザー)としてEloqua インスタンスにログインします。
設定 > Platform Extensions > App Cloud Developer > アプリを作成に移動します。 アプリの名前、説明、アイコン、OAuth コールバック URLなど、アプリの詳細を入力します。 完了したら、「保存」をクリックします。
アプリを作成したら、Authentication to Eloquaに移動し、新しく作成したアプリから クライアント ID と クライアントシークレット を取得します。 これらの値は、後でExperience Platformに接続する際に使用されます。
セキュリティグループを使用すると、管理者は、ユーザーがアセット、機能、インターフェイスなどに対してどのようなレベルのアクセス権を持つかを制御できます。 セキュリティグループを作成するには、設定 > ユーザーに移動します。 次に、左側のパネルで「グループ」タブを選択し、「新しいセキュリティグループを作成」を選択します。
「Security Group Overview」ウィンドウを使用して、セキュリティグループの名前と略語を指定します。 作成したら、Action Permissionsに移動し、リストからConsume API権限を追加して、保存を選択します。
キャンペーンデータを取り込むには、ユーザーの編集 インターフェイスに移動し、選択したセキュリティグループにGuided Campaignsを追加します。
オプションで、追加のユーザーを作成し、そのユーザーをセキュリティグループに追加できます。 詳細な手順については、Eloqua ユーザーの作成および セキュリティグループへのユーザーの割り当てに関する ドキュメントを参照してください。
必要な資格情報の収集
EloquaをExperience Platformに接続するには、次の資格情報の値を指定する必要があります。
CompanyName\Usernameの形式に従っています。http://またはhttps://を含めることはできません。Eloqua マッピングガイド
- 連絡先:
C_DateModified - アカウント:
M_DateModified - アクティビティ:
CreatedAt - キャンペーン:
updatedAt
次の表は、Experience PlatformのEloqua ソースフィールドと、対応するExperience Data Model (XDM)宛先フィールドとの間の詳細なマッピングを示しています。 各行には、フィールドが不変かどうかを問わず、変換ロジックの概要が示され、Experience PlatformでEloqua データがどのように取り込まれ、構造化されるかを理解するのに役立つメモが追加されています。
アカウント
"Eloqua""${SOURCE_INSTANCE_ID}"SOURCE_INSTANCE_IDは自動的にコネクタに置き換えられます。Idconcat(Id, "\\@${SOURCE_INSTANCE_ID}.Eloqua")SOURCE_INSTANCE_IDは自動的にコネクタに置き換えられます。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}を実際のCRM インスタンス ID (SalesforceまたはDynamics インスタンス ID)に手動で置き換える必要があります。 取り込み中にM_SFDCAccountIDが存在する場合、コネクタはその値を使用して外部キーを生成し、\@CRM_INSTANCE_ID.Salesforceを追加します。 そのフィールドが空の場合、コネクタはM_MSCRMAccountIDを使用し、代わりに\@CRM_INSTANCE_ID.Dynamicsを追加します。 両方のフィールドが空の場合、このフィールドはnullに設定されます。アクティビティ
"Eloqua""${SOURCE_INSTANCE_ID}"SOURCE_INSTANCE_IDは自動的にコネクタに置き換えられます。ContactIdconcat(ContactId, "\\@${SOURCE_INSTANCE_ID}.Eloqua")SOURCE_INSTANCE_IDは自動的にコネクタに置き換えられます。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は自動的にコネクタに置き換えられます。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は自動的にコネクタに置き換えられます。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は自動的にコネクタに置き換えられます。iif(ActivityType == "PageView", Url, null)キャンペーン
"Eloqua""${SOURCE_INSTANCE_ID}"SOURCE_INSTANCE_IDは自動的にコネクタに置き換えられます。idconcat(id, "\\@${SOURCE_INSTANCE_ID}.Eloqua")SOURCE_INSTANCE_IDは自動的にコネクタに置き換えられます。nameendAtstartAtactualCostbudgetedCostdescriptioncurrentStatuscampaignTypecreatedAtupdatedAt連絡先
"Eloqua""${SOURCE_INSTANCE_ID}"SOURCE_INSTANCE_IDは自動的にコネクタに置き換えられます。Idconcat(Id, "\\@${SOURCE_INSTANCE_ID}.Eloqua"SOURCE_INSTANCE_IDは自動的にコネクタに置き換えられます。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_Provアクティビティタイプマッピングリファレンス
EmailSendEmailOpenEmailClickthroughUnsubscribeBouncebackFormSubmitPageViewOther変数プレースホルダー
マッピングテンプレートでは、データフローの実行後に置き換えられる次の変数プレースホルダーを使用します。
${SOURCE_INSTANCE_ID}${CRM_INSTANCE_ID}EloquaをExperience Platformに接続
Experience Platform内でEloqua ソース接続の設定に進みます。 UIによる接続の設定に関するステップバイステップガイドについては、 チュートリアル()を参照してください。 このチュートリアルでは、Eloqua アカウントの接続、データの選択、フィールドのマッピング、取り込みのスケジュール設定、データフローの監視について説明します。