この宛先は次の場所でのみ使用できます: Adobe Real-time Customer Data Platform Ultimate 顧客。
この Kinesis Data Streams サービス Amazon Web Services を使用すると、大量のデータレコードをリアルタイムで収集して処理できます。
へのリアルタイムアウトバウンド接続を作成できます Amazon Kinesis Adobe Experience Platformからデータをストリーミングするためのストレージ。
次のようなストリーミング宛先を使用する Amazon Kinesisを使用すると、高価値のセグメントイベントや関連するプロファイル属性を、選択したシステムに簡単にフィードできます。
例えば、見込み客がホワイトペーパーをダウンロードし、それを「コンバージョン傾向が高い」セグメントに認定したとします。 見込み客が属するセグメントを Amazon Kinesis の宛先に指定した場合、このイベントは Amazon Kinesis. 企業の IT システムに最適に対応できると思われるように、このイベントの上に、自らのアプローチを使用し、ビジネスロジックを説明することができます。
宛先の書き出しのタイプと頻度について詳しくは、以下の表を参照してください。
項目 | タイプ | メモ |
---|---|---|
書き出しタイプ | プロファイルベース | セグメントのすべてのメンバーを、目的のスキーマフィールド ( 例:(電子メールアドレス、電話番号、姓)。「プロファイル属性を選択」画面で選択します。 宛先のアクティベーションワークフロー. |
書き出し頻度 | ストリーミング | ストリーミングの宛先は常に、API ベースの接続です。セグメント評価に基づいて Experience Platform 内でプロファイルが更新されるとすぐに、コネクタは更新を宛先プラットフォームに送信します。ストリーミングの宛先の詳細についてはこちらを参照してください。 |
お客様のセキュリティおよびコンプライアンス要件を満たすために、Experience Platformは、 Amazon Kinesis 宛先。 参照: ストリーミング先の IP アドレス許可リスト :する IP の完全なリストを表示しま許可リストす。
データを正常に接続してに書き出すには、以下を実行します。 Amazon Kinesis ストリーム、Experience Platformには次のアクションに対する権限が必要です:
kinesis:ListStreams
kinesis:PutRecord
kinesis:PutRecords
これらの権限は、 Kinesis コンソールとは、Platform ユーザーインターフェイスでKinesisの宛先を設定すると、Platform によって確認されます。
次の例は、データをに正常に書き出すために必要な最小限のアクセス権を示しています Kinesis 宛先。
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"kinesis:ListStreams",
"kinesis:PutRecord",
"kinesis:PutRecords"
],
"Resource": [
"arn:aws:kinesis:us-east-2:901341027596:stream/*"
]
}
]
}
プロパティ | 説明 |
---|---|
kinesis:ListStreams |
Amazon Kinesisのデータストリームをリストするアクション。 |
kinesis:PutRecord |
単一のデータレコードをKinesisデータストリームに書き込むアクション。 |
kinesis:PutRecords |
1 回の呼び出しで複数のデータレコードをKinesisデータストリームに書き込むアクション。 |
のアクセス制御の詳細 Kinesis データストリーム、以下を読む Kinesis 文書.
この宛先に接続するには、宛先設定のチュートリアルの手順に従ってください。この宛先に接続する際は、次の情報を指定する必要があります。
以下のフィールドを入力し、「 」を選択します。 宛先に接続:
access key - secret access key
ペアを使用して、 Amazon Kinesis アカウント 詳しくは、 Amazon Web Servicesドキュメント.宛先の詳細を設定するには、以下の必須フィールドとオプションフィールドに入力します。UI のフィールドの横にアスタリスクが表示される場合は、そのフィールドが必須であることを示します。
アラートを有効にすると、宛先へのデータフローのステータスに関する通知を受け取ることができます。リストからアラートを選択して、データフローのステータスに関する通知を受け取るよう登録します。アラートについて詳しくは、UI を使用した宛先アラートの購読についてのガイドを参照してください。
宛先接続の詳細の入力を終えたら「次へ」を選択します。
データをアクティブ化するには、宛先の管理、宛先のアクティブ化、プロファイルの表示およびセグメントの表示に対するアクセス制御権限が必要です。詳しくは、アクセス制御の概要または製品管理者に問い合わせて、必要な権限を取得してください。
詳しくは、 ストリーミングプロファイルの書き出し先に対するオーディエンスデータのアクティブ化 を参照してください。
Experience Platformにより、 Amazon Kinesis 宛先:セグメントの選定やその他の重要なイベントに従ってプロファイルに関連する更新が発生した場合にのみ、宛先にデータを書き出します。 プロファイルは、次の状況で宛先に書き出されます。
上記のすべての場合、関連する更新がおこなわれたプロファイルのみが宛先にエクスポートされます。 例えば、宛先フローにマッピングされたセグメントのメンバーが 100 人で、5 つの新しいプロファイルがセグメントの対象として認定されている場合、宛先への書き出しは増分で、5 つの新しいプロファイルのみが含まれます。
変更内容がどこにあっても、プロファイルに対してマッピングされたすべての属性が書き出されることに注意してください。 したがって、上の例では、属性自体が変更されていない場合でも、これら 5 つの新しいプロファイルに対してマッピングされたすべての属性が書き出されます。
特定のプロファイルに対して書き出されるデータに関しては、 が、 Amazon Kinesis 宛先 および エクスポートに含まれるデータ.
宛先の書き出しを決定する要素 | 宛先の書き出しに含まれる内容 |
---|---|
|
|
例えば、このデータフローを Amazon Kinesis 宛先。この宛先では、3 つのセグメントがデータフローで選択され、4 つの属性が宛先にマッピングされます。
宛先へのプロファイルエクスポートは、いずれかの 3 つのマッピングされたセグメント. ただし、データエクスポートでは、 segmentMembership
オブジェクト ( 書き出されたデータ の節を参照 )、その特定のプロファイルがそのメンバーの場合は、その他のマッピングされていないセグメントが表示されることがあります。 プロファイルが DeLorean Cars セグメントで顧客の資格を得ている一方で、「Back to the Future」映画や SF ファンセグメントのメンバーでもある場合、他の 2 つのセグメントも segmentMembership
データエクスポートのオブジェクト(データフローでマッピングされていない場合)。
プロファイル属性の観点から、上でマッピングした 4 つの属性に対する変更によって、書き出し先が決まり、プロファイルに存在する 4 つのマッピング済み属性のいずれかがデータ書き出しに表示されます。
新しいセグメントを既存の宛先に追加する場合、または新しい宛先を作成してセグメントをマッピングする場合、Experience Platformは宛先にセグメントの資格情報の履歴データをエクスポートします。 セグメントに適合するプロファイル 前 セグメントが宛先に追加され、約 1 時間以内に宛先に書き出されます。
エクスポート済み Experience Platform データは、 Amazon Kinesis の宛先を JSON 形式で指定します。 例えば、以下のエクスポートには、特定のセグメントに適合し、別の 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":"existing"
},
"947c1c46-008d-40b0-92ec-3af86eaf41c1":{
"lastQualificationTime":"2021-08-25T23:37:33Z",
"status":"existing"
},
"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"
}
]
}
}
次に、 セグメント名を含める および セグメントのタイムスタンプを含める options:
segmentMembership
セクション"segmentMembership": {
"ups": {
"5b998cb9-9488-4ec3-8d95-fa8338ced490": {
"lastQualificationTime": "2019-04-15T02:41:50+0000",
"status": "existing",
"createdAt": 1648553325000,
"updatedAt": 1648553330000,
"mappingCreatedAt": 1649856570000,
"mappingUpdatedAt": 1649856570000,
"name": "First name equals John"
}
}
}
segmentMembership
セクション"segmentMembership": {
"ups": {
"5b998cb9-9488-4ec3-8d95-fa8338ced490": {
"lastQualificationTime": "2019-04-15T02:41:50+0000",
"status": "existing",
"createdAt": 1648553325000,
"updatedAt": 1648553330000,
"mappingCreatedAt": 1649856570000,
"mappingUpdatedAt": 1649856570000,
}
}
}
95%の確率で、Experience Platformは、各データフローから HTTP 宛先への各リクエストの 1 秒あたり 10,000 リクエスト未満の割合で正常に送信されたメッセージに対して、10 分未満のスループット遅延を提供しようとします。
HTTP API 宛先へのリクエストが失敗した場合、Experience Platformは失敗したリクエストを保存し、リクエストをエンドポイントに送信するために 2 回再試行します。