オーディエンスソーシング用の Amazon S3 の設定
Adobe Real-Time CDP Collaboration UI で Amazon S3 ストレージを設定および接続し、アクティベーションと重複分析のためにオーディエンスデータをソースする方法について説明します。
詳細な設定手順については、オーディエンスソーシングのAWS権限の設定 ガイドを参照してください。
概要 overview
このワークフローを使用して、Amazon S3 から直接ファーストパーティオーディエンスをソース化および管理します。 設定後、Collaborationは S3 バケットからオーディエンスを自動的にソース化し、インサイトとアクティベーションで使用できるようにします。
S3 を通じて提供されるオーディエンスは、Adobe Experience Platformから提供されるオーディエンスと同じガバナンスおよびデータ処理ルールに従います。
前提条件 prerequisites
S3 データ接続を設定する前に、次を確認します。
-
Amazon S3オーディエンスソーシング仕様(v1.1) に準拠するオーディエンスファイルを含む アクティブな バケットにアクセスできます。
-
AWSで IAM ロール を作成し、(アクセス/秘密鍵ではなく 想定されるロール メソッドを使用してバケットにアクセスする権限をAdobeに付与しました。 手順について詳しくは、オーディエンスソーシングのAWS権限の設定 を参照してください。 IAM 役割には、次の権限が含まれている必要があります。
ListBucketGetBucketLocationGetObject
-
次の値の準備が整いました。
- IAM ロール Amazon リソース名(ARN)
- S3 バケット名
- フォルダーパス (オーディエンスファイルを含むディレクトリのプレフィックス)
Amazon S3 接続の設定 configure-aws-s3-connection
設定 ワークスペース内の マイオーディエンス タブで、追加アイコン(
初めてオーディエンスを使用する場合は、「追加」オプションを選択することもできます。
オーディエンスを追加ワークフローが表示されます。 新しいデータ接続を追加 を選択してから、「次へ」を選択します。
データ接続として「Amazon S3」を選択します select-aws-s3
データ接続として 0}Amazon S3} を選択し、続いて 次へ を選択します。
オーディエンスファイルの要件を確認する review-audience-requirements
オーディエンスファイルをどのように構造化する必要があるかを説明するダイアログが表示されます。 オーディエンスソーシングの仕様 へのリンクを使用して、Amazon S3 for Collaborationのオーディエンスデータを書式設定および構造化して正しく読み取る方法を確認します。
オーディエンスファイルは、オーディエンスソーシング仕様に準拠している必要があります。 一致キーは、必要な形式に基づいて自動的にマッピングされます。
主な考慮事項は次のとおりです。
- ファイルは、複数の値に対してコンマを区切り文字およびパイプ(
|)として使用し、CSV 形式である必要があります。 - 複数のファイルをアップロードする場合は、すべてのファイルに同じ列が含まれていることを確認します。
- 各オーディエンスレコードには、
AUDIENCE_IDと、少なくとも一致キー(HASHED_EMAIL_SHA_256、HASHED_PHONE_SHA_256、HASHED_IPV4_SHA_256、CRM_ID、LOYALTY_ID、ADFIXUS_IDなど)が含まれている必要があります。 - データ更新は、Collaborationでのソーシング設定での選択内容に基づいて、1 ~ 6 日ごとに行われます。
S3 接続の認証 authenticate-s3-connection
次に、S3 バケットをCollaborationに接続するための Amazon S3 資格情報を指定します。
オーディエンスソーシングのAWS権限の設定 で説明する手順に従って、Adobeへのアクセス権を付与します
Amazon S3 ストレージ。 完了したら、次の UI フィールドに値を入力します。
- IAM 役割
- S3 バケット名
- フォルダーパス
同意確認を確認 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のデータソースとして正常に設定し、接続できました。 このワークフローを完了することで、アクティベーションと重複分析のためのファーストパーティオーディエンスデータの安全なソーシングが可能になりました。
ソーシングが完了すると、オーディエンスが マイオーディエンス ワークスペースに表示され、共同作業やアクティベーションを行う準備が整います。 管理オプションについて詳しくは、 オーディエンスのソースおよび管理ドキュメント を参照してください。