オーディエンスのソーシング用にAmazon S3を設定
Adobe Real-Time CDP Collaboration UIでAmazon S3 ストレージを設定して接続し、アクティベーションおよび重複分析のためにオーディエンスデータをソースする方法について説明します。
手順ごとの設定手順については、「オーディエンスソーシング用にAWS権限を設定する」ガイドを参照してください。
概要 overview
このワークフローを使用して、Amazon S3から直接1st パーティオーディエンスを調達および管理します。 設定後、CollaborationはS3 バケットからオーディエンスを自動的にソースし、インサイトとアクティベーションに利用できるようにします。
S3を通じてソースされたオーディエンスは、Adobe Experience Platformからソースされたオーディエンスと同じガバナンスおよびデータ処理ルールに従います。
前提条件 prerequisites
S3 データ接続を設定する前に、次の点を確認してください。
-
オーディエンスソーシング仕様(v1.1)に準拠するオーディエンスファイルを含むアクティブな Amazon S3バケット にアクセスできます。
-
想定ロール メソッドを使用してバケットにアクセスする権限をAdobeに付与する IAM ロール がAWSに作成されました(アクセス/秘密鍵ではありません)。 詳しい手順については、オーディエンスのソーシングに対するAWS権限の設定を参照してください。 IAMの役割には、次の権限を含める必要があります。
ListBucketGetBucketLocationGetObject
-
次の値を用意しています。
- IAM ロール Amazon リソース名(ARN)
- S3 バケット名
- フォルダーパス (オーディエンスファイルを含むディレクトリ接頭辞)
Amazon S3接続の設定 configure-aws-s3-connection
セットアップ ワークスペース内の「自分のオーディエンス」タブから、追加アイコン(
初めてのオーディエンスの場合は、追加 オプションを選択することもできます。
The Add audience workflow appears. Select Add a new data connection and then select Next.
Select Amazon S3 as the data connection select-aws-s3
Select Amazon S3 as a data connection, followed by Next.
オーディエンスファイルの要件の確認 review-audience-requirements
A dialog appears that explains how your audience files must be structured. Use the link to the Audience Sourcing Specification to learn how to format and structure audience data from Amazon S3 for Collaboration to read it correctly.
Your audience files must comply with the Audience Sourcing Specification. The match keys are automatically mapped based on the required format.
Key considerations include:
- Files must be in CSV format, using commas as delimiters and pipes (
|) for multiple values. - If uploading multiple files, ensure all files contain identical columns.
- Each audience record must include an
AUDIENCE_IDand at least on match key, such asHASHED_EMAIL_SHA_256,HASHED_PHONE_SHA_256,HASHED_IPV4_SHA_256,CRM_ID,LOYALTY_ID, orADFIXUS_ID. - Data refreshes occur every 1–6 days based on your selection during the sourcing setup in Collaboration.
S3 接続の認証 authenticate-s3-connection
Next, provide your Amazon S3 credentials to connect your S3 bucket to Collaboration.
Follow the steps outlined in Configure AWS permissions for audience sourcing to grant Adobe access to your
Amazon S3 storage. Once complete, input your values into the following UI fields:
- IAM 役割
- S3 Bucket Name
- Folder Path
Confirm consent acknowledgment confirm-consent
次に、続行する前に、同意オプトアウトが削除されたことを確認する必要があります。 確認ボックスにチェックを入れ、OKにチェックを入れて確認します。
認証結果を検証 validate-authentication
接続後、システムは資格情報を検証し、次のいずれかのメッセージを表示します。
接続の詳細を提供 provide-connection-details
S3 データ接続のわかりやすい名前とオプションの説明を入力します。 次のUI フィールドに値を入力します。
- データ接続名 (必須)
- データ接続の説明 (オプション)
自動マッピングされたID フィールドの確認 auto-mapped-fields
マッピング画面は読み取り専用です。 変換を追加、削除、または適用することはできません。 Collaborationは、オーディエンスソーシング仕様に基づいて、オーディエンスファイルのソース ID フィールドをターゲットフィールドに自動的にマッピングします。
マッピングされたフィールドを視覚的に確認し、次へを選択して続行します。
スケジュール更新頻度と日付範囲 schedule-refresh
スケジュール ビューが表示されます。 ドロップダウンメニューを使用して、1日から6日の間の更新頻度を選択し、アクティブな日付範囲を設定します。 カレンダーアイコンを使用して、開始日と終了日を指定します。
接続を確認して完了 review-and-complete
最後に、サマリー画面で設定を確認します。 このビューには、次のセクションの概要が含まれています。
- データ接続: IAMの役割、S3 バケット名、設定したフォルダーパスが表示されます。
- 詳細: データ接続の名前とオプションの説明を表示して、後で識別できるようにします。
- マッピング: アップロードしたオーディエンスファイルのソースフィールド(例:
HASHED_EMAIL)が、Collaborationで使用されるターゲットフィールド(例:ハッシュ化された電子メール)にどのようにマッピングされるかを一覧表示します。 - スケジュール:接続がオーディエンスデータを更新する頻度と、ソーシング用にアクティブな日付範囲を要約します。
セクションを編集する必要がある場合は、鉛筆アイコンを選択します。 完了を選択して、すべてのセクションを確認します。
データ接続が正常に作成され、オーディエンスのソーシングが進行中であることを示すダイアログ確認が表示されます。
ソース別オーディエンスの確認 review-sourced-audiences
設定が完了すると、CollaborationはS3 バケットからオーディエンスのソーシングを開始します。 Amazon S3 バケットを介してソースされたオーディエンスは、「マイオーディエンス」タブに表示され、Experience Platformからソースされたオーディエンスと同じ機能と情報を持ちます。
オーディエンスのソーシングが進行中の場合は、画面の上部にバナーが表示されます。 個々のオーディエンスは、ソーシング完了後にのみ表示されます。
S3 オーディエンスがソースされると、利用可能なオーディエンスのリストが表形式またはカードビューで提供されます。
グリッド表示またはテーブル表示で、行アイテムまたは オーディエンスを表示 を選択すると、特定のオーディエンスの概要が表示されます。 オーディエンスのステータス、ソース、データ接続名が表示され、次の詳細パネルが表示されます。
ID: データが使用可能になると、合計ID数と分類が表示されます。
カテゴリー: オーディエンスの整理またはフィルタリングに使用されるタグを一覧表示します。
接続アクセス: オーディエンスがプライベート、パブリック、または特定の共同作業者と共有されているかどうかを示します。
メタデータの表示:共同作業者に表示されるオーディエンス情報(ID数、重複率、インデックスなど)を定義します。
このビューを使用して、コラボレーションプロジェクトでオーディエンスを使用する前に、オーディエンスの設定と表示設定を確認します。
詳しくは、「 オーディエンスダッシュボードを表示」のドキュメント「」を参照してください。
S3 データ接続の表示 view-s3-connection
新しく追加されたAmazon S3接続は、データ接続 タブですぐに利用できます。 オーディエンスソースは、Amazon S3と表示されます。
S3 データ接続には、他のオーディエンスデータ接続と同じ機能と詳細が含まれていますが、このビューからオーディエンスを直接追加または編集することはできません。
次の手順 next-steps
これで、Amazon S3 ストレージをデータソースとしてCollaborationに正常に設定し、接続できました。 このワークフローを完了することで、アクティベーションや重複分析のために、ファーストパーティのオーディエンスデータを安全にソーシングすることが可能になりました。
ソーシングが完了すると、オーディエンスはマイオーディエンス ワークスペースに表示され、コラボレーションとアクティベーションの準備が整います。 管理オプションについて詳しくは、「 オーディエンスのソースと管理」ドキュメント を参照してください。