[Ultimate]{class="badge positive"}

Azure Event Hubs 接続

概要 overview

IMPORTANT
この宛先を使用できるのは Adobe Real-time Customer Data Platform Ultimate の顧客のみです。

Azure Event Hubs は、ビッグデータストリーミングプラットフォームおよびイベント取り込みサービスです。 1 秒あたり数百万のイベントを受信し、処理できます。 イベントハブに送信されたデータは、任意のリアルタイム分析プロバイダーまたはバッチ/ストレージアダプターを使用して変換および保存できます。

へのリアルタイムアウトバウンド接続を作成できます Azure Event Hubs Adobe Experience Platformからデータをストリーミングするストレージ。

UI でのAWS Kinesis

ユースケース use-cases

などのストリーミング宛先を使用する Azure Event Hubsを使用すると、価値の高いセグメント化イベントや関連するプロファイル属性を、選択したシステムに簡単にフィードできます。

例えば、ある見込み客がダウンロードしたホワイトペーパーによって、「コンバージョンする傾向の高い」セグメントに見込み客を選定するとします。 見込み客が含まれるオーディエンスを Azure Event Hubs 宛先の場合、このイベントは Azure Event Hubs. そこで、エンタープライズの IT システムで最も効果が高いと思われる通り、日曜大工のアプローチを採用し、イベントの上にビジネスロジックを記述できます。

サポートされるオーディエンス supported-audiences

この節では、この宛先に書き出すことができるオーディエンスのタイプについて説明します。

オーディエンスオリジン
サポートあり
説明
Segmentation Service
Experience Platformを通じて生成されたオーディエンス セグメント化サービス.
カスタムアップロード
CSV ファイルから Experience Platform に読み込まれたオーディエンス。

書き出しのタイプと頻度 export-type-frequency

宛先の書き出しのタイプと頻度について詳しくは、以下の表を参照してください。

項目
タイプ
メモ
書き出しタイプ
プロファイルベース
宛先のアクティベーションワークフローのプロファイル属性選択画面で選択した目的のスキーマフィールド(例:メールアドレス、電話番号、姓)と共に、セグメントのすべてのメンバーを書き出します。
書き出し頻度
ストリーミング
ストリーミングの宛先は常に、API ベースの接続です。オーディエンス評価に基づいて Experience Platform 内でプロファイルが更新されるとすぐに、コネクタは更新を宛先プラットフォームに送信します。ストリーミングの宛先の詳細についてはこちらを参照してください。

IP アドレスの許可リスト ip-address-allowlist

お客様のセキュリティおよびコンプライアンスの要件を満たすために、Experience Platformでは、次の目的で許可リストに加えるできる静的 IP のリストを提供しています Azure Event Hubs の宛先。 許可リストに使用できる IP のリストについて詳しくは、ストリーミング宛先用 IP アドレスの許可リストを参照してください。

宛先への接続 connect

IMPORTANT
宛先に接続するには、 宛先の表示 および 宛先の管理 アクセス制御権限. 詳しくは、アクセス制御の概要または製品管理者に問い合わせて、必要な権限を取得してください。

この宛先に接続するには、宛先設定のチュートリアルの手順に従ってください。この宛先に接続する際は、次の情報を指定する必要があります。

認証情報 authentication-information

標準認証 standard-authentication

Azure Event Hubs 標準認証の詳細に関する入力済みフィールドを示す UI 画面の画像

を選択した場合、 標準認証 を入力して HTTP エンドポイントに接続し、以下のフィールドを入力して選択します 宛先への接続:

  • SAS キー名:認証ルールの名前(SAS キー名とも呼ばれます)。
  • SAS キー:Event Hubs 名前空間のプライマリキー。 この sasPolicy その sasKey 次に対応する必要があります 管理 event Hubs リストを入力するために設定された権限。 への認証について説明します Azure Event Hubs SAS キーを含む Microsoft ドキュメント.
  • 名前空間:を入力します Azure Event Hubs 名前空間。 について Azure Event Hubs 名前空間: Microsoft ドキュメント.

共有アクセス署名(SAS)認証 sas-authentication

Azure Event Hubs 標準認証の詳細に関する入力済みフィールドを示す UI 画面の画像

を選択した場合、 標準認証 を入力して HTTP エンドポイントに接続し、以下のフィールドを入力して選択します 宛先への接続:

  • SAS キー名:認証ルールの名前(SAS キー名とも呼ばれます)。
  • SAS キー:Event Hubs 名前空間のプライマリキー。 この sasPolicy その sasKey 次に対応する必要があります 管理 event Hubs リストを入力するために設定された権限。 への認証について説明します Azure Event Hubs SAS キーを含む Microsoft ドキュメント.
  • 名前空間:を入力します Azure Event Hubs 名前空間。 について Azure Event Hubs 名前空間: Microsoft ドキュメント.
  • イベントハブ名:を入力します Azure Event Hub の名前。 について Azure Event Hubs の名前 Microsoft ドキュメント.

宛先の詳細の入力 destination-details

宛先の詳細を設定するには、以下の必須フィールドとオプションフィールドに入力します。UI のフィールドの横のアスタリスクは、そのフィールドが必須であることを示します。

Azure Event Hubs 宛先の詳細に関する入力済みフィールドを示す UI 画面の画像

  • 名前:への接続の名前を入力します Azure Event Hubs.
  • 説明:接続の説明を入力します。 例:「Premium 層のお客様」、「Kitesheving に興味のあるお客様」。
  • eventHubName:ストリームの名前を指定します Azure Event Hubs の宛先。
  • セグメント名を含める:書き出すオーディエンスの名前をデータの書き出しに含めるかどうかを切り替えます。 このオプションを選択したデータの書き出しの例については、書き出されたデータの節を参照してください。
  • セグメントのタイムスタンプを含める:オーディエンスが作成および更新された際の UNIX タイムスタンプと、アクティブ化のためにオーディエンスが宛先にマッピングされた際の UNIX タイムスタンプをデータの書き出しに含めるかどうかを切り替えます。 このオプションを選択したデータの書き出しの例については、書き出されたデータの節を参照してください。

アラートの有効化 enable-alerts

アラートを有効にすると、宛先へのデータフローのステータスに関する通知を受け取ることができます。リストからアラートを選択して、データフローのステータスに関する通知を受け取るよう登録します。アラートについて詳しくは、UI を使用した宛先アラートの購読についてのガイドを参照してください。

宛先接続の詳細の入力を終えたら「次へ」を選択します。

この宛先に対してオーディエンスをアクティブ化 activate

IMPORTANT
  • データをアクティブ化するには、 宛先の表示, 宛先のアクティブ化, プロファイルの表示、および セグメントの表示 アクセス制御権限. アクセス制御の概要を参照するか、製品管理者に問い合わせて必要な権限を取得してください。
  • 同意ポリシーの評価 は現在、Azure Event Hubs 宛先への書き出しではサポートされていません。 詳細情報

参照: ストリーミングプロファイル書き出し宛先に対するオーディエンスデータの有効化 この宛先に対してオーディエンスをアクティブ化する手順については、を参照してください。

プロファイルの書き出し動作 profile-export-behavior

Experience Platformは、へのプロファイル書き出し動作を最適化します Azure Event Hubs 宛先(オーディエンスの選定または他の重要なイベントに続いてプロファイルに関連する更新が発生した場合にのみデータを書き出す場合)。 プロファイルは、以下の状況で宛先に書き出されます。

  • 宛先にマッピングされた 1 つ以上のオーディエンスのオーディエンスメンバーシップの変更によって、プロファイルの更新が決定された場合。 例えば、プロファイルは、宛先にマッピングされたいずれかのオーディエンスに適合しているか、宛先にマッピングされたいずれかのオーディエンスから退出しています。
  • プロファイルの更新が、ID マップの変更によって決定する場合。例えば、宛先にマッピングされたオーディエンスの 1 つに対して既に適合しているプロファイルの ID マップ属性に新しい ID が追加されたとします。
  • プロファイルの更新は、宛先にマッピングされた属性のうち、少なくとも 1 つの属性が変更されたことで判断されました。例えば、マッピング手順で宛先にマッピングされた属性の 1 つがプロファイルに追加されます。

上記のすべての場合で、適切な更新が行われたプロファイルのみが宛先に書き出されます。例えば、宛先フローにマッピングされたオーディエンスに 100 人のメンバーがいて、5 つの新しいプロファイルがセグメントに適合している場合、宛先への書き出しは増分で行われ、5 つの新しいプロファイルのみが含まれます。

変更箇所に関わらず、マッピングされたすべての属性がプロファイルに対して書き出されることに注意してください。 したがって、上の例では、属性自体が変更されていない場合でも、これら 5 つの新しいプロファイルに対してマッピングされた属性がすべて書き出されます。

データの書き出しを決定する要素と、書き出しに含まれる内容 what-determines-export-what-is-included

特定のプロファイルについて書き出されるデータに関しては、の 2 つの異なる概念を理解することが重要です へのデータ書き出しを決定する要素 Azure Event Hubs 宛先 および 書き出しに含めるデータ.

宛先の書き出しを決定する要素
宛先の書き出しに含まれる内容
  • マッピングされた属性とオーディエンスは、宛先の書き出しのキューとして機能します。つまり、マッピングされたオーディエンスのステータスが(null から realized に、または realized から exiting に)変更されたり、マッピングされた属性が更新されたりすると、宛先の書き出しが開始されます。
  • ID は現在にマッピングできないので、 Azure Event Hubs 宛先、特定のプロファイルの ID の変更も、宛先の書き出しを決定します。
  • 属性の変更は、同じ値であるかどうかに関わらず、属性に対する更新として定義されます。つまり、値自体が変更されていない場合でも、属性の上書きは変更と見なされます。
  • segmentMembership オブジェクトには、アクティブ化データフローでマッピングされたオーディエンスが含まれます。このオーディエンスについて、プロファイルのステータスが選定またはオーディエンス離脱イベントの後に変更されました。なお、これらのオーディエンスが、アクティブ化データフローでマッピングされたオーディエンスと同じ結合ポリシーに属する場合、プロファイルが対象となっていた、他のマッピングされていないオーディエンスを宛先の書き出しに含めることができます。
  • のすべての ID identityMap オブジェクトも含まれます(Experience Platformは現在、での ID マッピングをサポートしていません) Azure Event Hubs 宛先)。
  • マッピングされた属性のみが宛先の書き出しに含まれます。

例えば、次のようなデータフローを次の条件に当てはめることができます Azure Event Hubs 宛先:データフローで 3 つのオーディエンスが選択され、4 つの属性が宛先にマッピングされます。

Amazon Kinesisの宛先のデータフロー

宛先へのプロファイルの書き出しは、3 つのマッピングされたセグメント ​のいずれかに適合またはいずれかを離脱するプロファイルによって決定されます。ただし、データの書き出しでは、 segmentMembership オブジェクト( 書き出されたデータ 以下の節を参照)、その特定のプロファイルがメンバーであり、書き出しをトリガーしたオーディエンスと同じ結合ポリシーを共有している場合、マッピングされていない他のオーディエンスが表示されることがあります。 プロファイルが次に該当するかどうか デロリアン車を保有しているお客様 オーディエンスですが、のメンバーでもあります 「バック・トゥ・ザ・フューチャー」を見た ムービーと SF ファン セグメントが含まれる場合、この他の 2 つのオーディエンスも segmentMembership データ書き出しのオブジェクト (これらがデータフローでマッピングされていない場合であっても、これらがで同じ結合ポリシーを共有している場合) デロリアン車を保有しているお客様 セグメント。

プロファイル属性の観点から、上記でマッピングした 4 つの属性に対する変更によって、書き出しの宛先が決定し、プロファイルに存在する 4 つのマッピング済み属性のいずれかがデータ書き出しに表示されます。

履歴データのバックフィル historical-data-backfill

既存の宛先に新しいオーディエンスを追加する場合、または新しい宛先を作成し、その宛先にオーディエンスをマッピングする場合、Experience Platformは、履歴オーディエンスの選定データを宛先に書き出します。 オーディエンスに適合したプロファイル 次の前 宛先に追加されたオーディエンスは、約 1 時間以内に宛先に書き出されます。

書き出したデータ exported-data

書き出された Experience Platform データは、JSON 形式で Azure Event Hubs の宛先に格納されます。例えば、以下の書き出しには、特定のセグメントに適合し、別の 2 つのセグメントのメンバーであり、別のセグメントから離脱したプロファイルが含まれています。 書き出しには、プロファイル属性の名、姓、生年月日、個人メールアドレスも含まれます。 このプロファイルの ID は、ECID とメールです。

{
  "person": {
    "birthDate": "YYYY-MM-DD",
    "name": {
      "firstName": "John",
      "lastName": "Doe"
    }
  },
  "personalEmail": {
    "address": "john.doe@acme.com"
  },
  "segmentMembership": {
   "ups":{
      "7841ba61-23c1-4bb3-a495-00d3g5fe1e93":{
         "lastQualificationTime":"2022-01-11T21:24:39Z",
         "status":"exited"
      },
      "59bd2fkd-3c48-4b18-bf56-4f5c5e6967ae":{
         "lastQualificationTime":"2022-01-02T23:37:33Z",
         "status":"realized"
      },
      "947c1c46-008d-40b0-92ec-3af86eaf41c1":{
         "lastQualificationTime":"2021-08-25T23:37:33Z",
         "status":"realized"
      },
      "5114d758-ce71-43ba-b53e-e2a91d67b67f":{
         "lastQualificationTime":"2022-01-11T23:37:33Z",
         "status":"realized"
      }
   }
},
  "identityMap": {
    "ecid": [
      {
        "id": "14575006536349286404619648085736425115"
      },
      {
        "id": "66478888669296734530114754794777368480"
      }
    ],
    "email_lc_sha256": [
      {
        "id": "655332b5fa2aea4498bf7a290cff017cb4"
      },
      {
        "id": "66baf76ef9de8b42df8903f00e0e3dc0b7"
      }
    ]
  }
}

書き出されたデータのその他の例を以下に示します。これらは「セグメント名を含める」および「セグメントのタイムスタンプを含める」オプションに対して接続データフローで選択した UI 設定によって異なります。

以下のデータの書き出しの例では、オーディエンス名がで segmentMembership セクション
code language-json
"segmentMembership": {
        "ups": {
          "5b998cb9-9488-4ec3-8d95-fa8338ced490": {
            "lastQualificationTime": "2019-04-15T02:41:50+0000",
            "status": "realized",
            "createdAt": 1648553325000,
            "updatedAt": 1648553330000,
            "mappingCreatedAt": 1649856570000,
            "mappingUpdatedAt": 1649856570000,
            "name": "First name equals John"
          }
        }
      }
以下のデータの書き出しの例では、オーディエンスのタイムスタンプがに含まれています segmentMembership セクション
code language-json
"segmentMembership": {
        "ups": {
          "5b998cb9-9488-4ec3-8d95-fa8338ced490": {
            "lastQualificationTime": "2019-04-15T02:41:50+0000",
            "status": "realized",
            "createdAt": 1648553325000,
            "updatedAt": 1648553330000,
            "mappingCreatedAt": 1649856570000,
            "mappingUpdatedAt": 1649856570000,
          }
        }
      }

制限と再試行ポリシー limits-retry-policy

Experience Platform は 95% の確率で、HTTP 宛先の各データフローにおいて、送信に成功したメッセージのスループット待ち時間を 10 分未満、リクエスト数を 1 秒あたり 10,000 件未満で提供しようと試みます。

HTTP API 宛先へのリクエストが失敗した場合、Experience Platform は失敗したリクエストを保存し、リクエストをエンドポイントに送信するために 2 回再試行します。

recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6