Oracle Eloqua 資格情報の収集
Oracle Eloqua の宛先に対して認証を行う前に、以下の項目をメモしておきます。
| 資格情報 | 説明 |
|---|---|
Company Name | Oracle Eloqua アカウントに関連付けられた会社名。 後で Company Name と Oracle Eloqua Username を、 宛先への認証時に Username として使用される連結文字列として使用します。 |
Username | Oracle Eloqua アカウントのユーザー名。 |
Password | Oracle Eloqua アカウントのパスワード。 |
Pod | Oracle Eloqua では、それぞれ一意のドメイン名を持つ複数のデータセンターをサポートしています。 現在、こ Oracle Eloqua らを「ポッド」と呼び、p01、p02、p03、p04、p06、p07、p08 の合計 7 つがあります。 使用しているポッドを取得するには、Oracle Eloqua にログインし、正常にログインしたらブラウザーに URL をメモします。 例えば、ブラウザーの URL が secure.p01.eloqua.com の場合、pod は p01 です。 詳しくは、POD の決定ページを参照してください。 |
詳しくは、 へのログイン Oracle Eloqua を参照してください。
ガードレール
NOTE- カスタム連絡先フィールド Oracle Eloqua、セグメントの選択 手順で選択したオーディエンスの名前を使用して自動的に作成されます。
-
Oracle Eloqua には、最大 250 個のカスタム連絡先フィールドという制限があります。
-
新しいオーディエンスを書き出す前に、Experience Platform オーディエンスの数と Oracle Eloqua 内の既存のオーディエンスの数がこの制限を超えないようにしてください。
-
この制限を超えると、Experience Platformでエラーが発生します。 これは、Oracle Eloqua API がリクエストを検証できず、- 400：検証エラーが発生しました – 問題を説明するエラーメッセージと応答するからです。
-
上記の上限に達した場合、さらにセグメントを書き出す前に、既存のマッピングを宛先から削除し、Oracle Eloqua アカウントの対応するカスタム連絡先フィールドを削除する必要があります。
-
追加の制限について詳しくは、Oracle Eloqua 連絡先フィールドの作成ページを参照してください。
サポートされる ID
Oracle Eloqua では、以下の表で説明する ID の更新をサポートしています。ID についての詳細情報。
| ターゲット ID | 説明 | 必須 |
|---|---|---|
EloquaId | 連絡先の一意の ID。 | ○ |
書き出しのタイプと頻度
宛先の書き出しのタイプと頻度について詳しくは、以下の表を参照してください。
| 項目 | タイプ | メモ |
|---|---|---|
| 書き出しタイプ | プロファイルベース |
|
| 書き出し頻度 | ストリーミング |
|
宛先への接続
この宛先に接続するには、宛先設定のチュートリアルの手順に従ってください。宛先の設定ワークフローで、以下の 2 つのセクションにリストされているフィールドに入力します。
宛先／カタログ 内で (API) Oracle Eloqua を検索します。または、「メールマーケティング」カテゴリの下に配置することもできます。
宛先に対する認証
以下の必須のフィールドに入力します。詳しくは、Gather Oracle Eloqua credentials の節を参照してください。
- パスワード:Oracle Eloqua アカウントのパスワード。
- Username:Oracle Eloqua の会社名と Oracle Eloqua のユーザー名を連結した文字列です。
連結された値は、{COMPANY_NAME}\{USERNAME}の形式になります。
注意：中括弧やスペースを使用せず、\を保持します。
例えば、Oracle Eloqua の会社名がMyCompanyで Oracle Eloqua ユーザー名がUsernameの場合、「ユーザー名」フィールドで使用する連結された値はMyCompany\Usernameです。
宛先を認証するには、「 宛先に接続」を選択します。
指定した詳細が有効な場合、UI で 接続済み ステータスに緑色のチェックマークが付きます。その後、次の手順に進むことができます。
宛先の詳細を入力
宛先の詳細を設定するには、以下の必須フィールドとオプションフィールドに入力します。UI のフィールドの横にアスタリスクが表示される場合は、そのフィールドが必須であることを示します。
- 名前：今後この宛先を認識するための名前。
- 説明：今後この宛先を識別するのに役立つ説明。
- ポッド：現在の
podを取得するには、Oracle Eloqua にログインし、正常にログインしたらブラウザーに URL をメモします。 例えば、ブラウザーの URL がsecure.p01.eloqua.comの場合、選択する必要があるpodの値はp01です。 追加のガイダンスについては、Gather Oracle Eloqua credentials の節を参照してください。
アラートの有効化
アラートを有効にすると、宛先へのデータフローのステータスに関する通知を受け取ることができます。リストからアラートを選択して、データフローのステータスに関する通知を受け取るよう登録します。アラートについて詳しくは、UI を使用した宛先アラートの購読についてのガイドを参照してください。
宛先接続の詳細の入力を終えたら「次へ」を選択します。
この宛先に対してオーディエンスをアクティブ化
この宛先にオーディエンスをアクティベートする手順は、ストリーミングオーディエンスの書き出し宛先へのプロファイルとオーディエンスのアクティベートを参照してください。
マッピングの考慮事項と例
Adobe Experience Platform から Oracle Eloqua 宛先にオーディエンスデータを正しく送信するには、フィールドマッピングの手順を実行する必要があります。マッピングは、Experience Platform アカウント内の Experience Data Model （XDM）スキーマフィールドと、ターゲット宛先から対応する同等のスキーマフィールドとの間にリンクを作成して構成されます。
XDM フィールドを Oracle Eloqua の宛先フィールドにマッピングするには、次の手順に従います。
-
マッピング 手順で、「新しいマッピングを追加」を選択します。画面に新しいマッピング行が表示されます。
-
ソースフィールドを選択 ウィンドウで、属性を選択 カテゴリを選択して XDM 属性を選択するか、ID 名前空間を選択 を選択して ID を選択します。
-
ターゲットフィールドを選択 ウィンドウで、ID 名前空間を選択 を選択して ID を選択するか、カスタム属性を選択 を選択して 属性名 フィールドに目的の属性名を入力します。 指定する属性名は、Oracle Eloqua の既存の連絡先属性と一致する必要があります。 Oracle Eloqua で使用できる正確な属性名については、create a contact を参照してください。
-
これらの手順を繰り返して、XDM プロファイルスキーマと Oracle Eloqua の間に必要な属性マッピングと必要な属性マッピングの両方を追加します。
ソースフィールド ターゲットフィールド 必須 IdentityMap: EidIdentity: EloquaId○ xdm: personalEmail.addressAttribute: emailAddress○ xdm: personName.firstNameAttribute: firstNamexdm: personName.lastNameAttribute: lastNamexdm: workAddress.street1Attribute: address1xdm: workAddress.street2Attribute: address2xdm: workAddress.street3Attribute: address3xdm: workAddress.postalCodeAttribute: postalCodexdm: workAddress.countryAttribute: countryxdm: workAddress.cityAttribute: city -
上記のマッピングの例を以下に示します。
-
IMPORTANT- ターゲットフィールド で指定する属性には、リクエスト本文を形成するので、Create a contact で指定されたとおりに正確に名前を付ける必要があります。
- Source フィールドで指定された属性は そのような制限には従いません。 必要に応じてマッピングできますが、Oracle Eloqua にプッシュした際にデータ形式が正しくない場合は、エラーが発生します。 例えば、Source フィールド ID 名前空間
contact keyなABC IDをマッピングできます。 ターゲットフィールド へ：ID 値が Oracle Eloqua で受け入れられる形式と一致することを確認した後、EloquaIdします。 - ID に対応する属性を更新するには、
EloquaIDマッピングが必須です。 emailAddressマッピングが必要です。 ない場合、次に示すように、API はエラーをスローします。
{
"type":"ObjectValidationError",
"container":{
"type":"ObjectKey",
"objectType":"Contact"
},
"property":"emailAddress",
"requirement":{
"type":"EmailAddressRequirement"
},
"value":"<null>"
}
宛先接続のマッピングの指定を終えたら「次へ」を選択します。
NOTE
