オーディエンスソーシング用にAmazon S3を設定

Adobe Real-Time CDP Collaboration UIでAmazon S3 ストレージを設定し、ソースオーディエンスデータに接続してアクティベーションおよび重複分析を行う方法について説明します。

IMPORTANT
このガイドに従う前に、AWS アカウント内でAdobeのIAM ロールを認証する手順を完了している必要があります。
ステップバイステップの設定手順については、「オーディエンスソーシング用AWS権限の設定 ガイド」を参照してください。

概要 overview

このワークフローを使用して、Amazon S3から直接1st パーティオーディエンスを取得および管理します。 設定後、CollaborationはS3 バケットからオーディエンスを自動的にソースし、インサイトとアクティベーションに利用できるようにします。

S3を通じてソースされたオーディエンスは、Adobe Experience Platformからソースされたオーディエンスと同じガバナンスおよびデータ処理ルールに従います。

前提条件 prerequisites

S3 データ接続を設定する前に、次の点を確認してください。

  • Audience Sourcing Specification (v1.1)​に準拠するオーディエンスファイルを含むアクティブな​ Amazon S3バケット ​にアクセスできます。

  • AWSで​ IAM ロール ​を作成しました。このロールは、想定されたロール メソッド (アクセス/秘密鍵ではありません)を使用してバケットへのアクセス権をAdobeに付与します。 詳しい手順については、オーディエンスソーシングに対するAWS権限の設定​を参照してください。 IAMの役割には、次の権限を含める必要があります。

    • ListBucket
    • GetBucketLocation
    • GetObject
  • 次の値を用意しています。

    • IAM ロール Amazon リソース名(ARN)
    • S3 バケット名
    • フォルダーパス (オーディエンスファイルを含むディレクトリ接頭辞)
NOTE
オーディエンスファイルは、承認済みS3 バケットの​ ルートフォルダーパス ​に配置する必要があります。 サブフォルダー構造はサポートされていません。

Amazon S3接続の設定 configure-aws-s3-connection

セットアップ ワークスペース内の​マイオーディエンス タブから、追加アイコン( 追加アイコン ​)を選択します。 Audience​を選択します。

これが初めてのオーディエンスの場合は、追加 オプションを選択することもできます。

追加アイコンと「オーディエンスを追加」オプションが表示された設定ワークスペースの「マイオーディエンス」タブ。

オーディエンスを追加ワークフローが表示されます。 「新しいデータ接続を追加」を選択し、「次へ」を選択します。

新しいデータ接続を追加オプションがハイライト表示されたオーディエンスを追加ワークスペース。{modal="regular"}

データ接続としてAmazon S3を選択 select-aws-s3

Amazon S3​をデータ接続として選択し、次に​ ​を選択します。

選択可能なオプションとしてAmazon S3を含むデータ接続の選択画面。

オーディエンスファイルの要件の確認 review-audience-requirements

オーディエンスファイルの構造化を説明するダイアログが表示されます。 Audience Sourcing Specification​へのリンクを使用して、Collaborationでオーディエンスデータを正しく読み取るためにAmazon S3からオーディエンスデータを書式設定および構造化する方法を説明します。

IMPORTANT
AdobeがAmazon S3 ストレージからデータを取得して処理できるように、Amazon S3 ユーザーとしてAdobeを承認している必要があります。

オーディエンスファイルは、オーディエンスソーシング仕様に準拠している必要があります。 一致キーは、必要な形式に基づいて自動的にマッピングされます。

主要な検討事項は次のとおりです。

  • ファイルはCSV形式で、複数の値に対してカンマを区切り記号として使用し、パイプ (|)を使用する必要があります。
  • 複数のファイルをアップロードする場合は、すべてのファイルに同じ列が含まれていることを確認します。
  • 各オーディエンスレコードにはAUDIENCE_IDと、少なくともHASHED_EMAIL_SHA_256HASHED_PHONE_SHA_256HASHED_IPV4_SHA_256CRM_IDLOYALTY_IDADFIXUS_IDなどの一致キーが含まれている必要があります。
  • Collaborationのソーシング設定時に、選択した内容に基づいて1~6日ごとにデータが更新されます。

​ オーディエンスソーシング仕様へのリンクを含む「ソーシング用にデータを準備」ダイアログ。

S3 接続の認証 authenticate-s3-connection

次に、S3 バケットをCollaborationに接続するためのAmazon S3資格情報を入力します。

オーディエンスソーシングに対するAWS権限の設定​で説明されている手順に従って、Adobeにユーザーへのアクセス権を付与します。
Amazon S3 ストレージ。 完了したら、次のUI フィールドに値を入力します。

  • IAM 役割
  • S3 バケット名
  • フォルダーパス

IAMの役割、S3 バケット名、フォルダーパスのフィールドを含むAmazon S3接続フォーム。

次に、続行する前に、同意オプトアウトが削除されたことを確認する必要があります。 確認ボックスにチェックを入れ、OK​にチェックを入れて確認します。

続行する前に確認が必要な同意オプトアウト確認ダイアログ。

認証結果を検証 validate-authentication

接続後、システムは資格情報を検証し、次のいずれかのメッセージを表示します。

ステータス
メッセージ
説明
成功
認証が成功しました
Amazon S3への接続が正常に確立されました。
失敗
認証に失敗しました
資格情報を確認して、もう一度試してください。
アクセスが拒否されました
アクセスが拒否されました
このAmazon S3 バケットにアクセスするために必要な権限が資格情報にありません。 アクセス設定を確認するか、管理者にお問い合わせください。
無効なファイル形式
無効なファイル形式
オーディエンスデータが予期された構造と一致しません。 ファイルがオーディエンスソーシング仕様に準拠していることを確認してください。
オーディエンスファイルが見つかりません
オーディエンスファイルが見つかりません
オーディエンスファイルが指定されたフォルダーパスに存在し、パスにアクセスできることを確認してください。
内部エラー
内部エラーが発生しました
再試行してください。 問題が解決しない場合は、カスタマーサポートにお問い合わせください。

接続の詳細を提供 provide-connection-details

S3 データ接続のわかりやすい名前とオプションの説明を入力します。 次のUI フィールドに値を入力します。

  • データ接続名 (必須)
  • データ接続の説明 (オプション)

接続名と説明のフィールドを含むデータ接続の詳細フォーム。

自動マッピングされたID フィールドの確認 auto-mapped-fields

マッピング​画面は読み取り専用です。 変換を追加、削除、または適用することはできません。 Collaborationは、オーディエンスソーシング仕様に基づいて、オーディエンスファイルのソース ID フィールドをターゲットフィールドに自動的にマッピングします。

マッピングされたフィールドを視覚的に確認し、次へ​を選択して続行します。

自動マッピングされたソースおよびターゲット ID フィールドを表示するフィールドマッピング画面。

スケジュール更新頻度と日付範囲 schedule-refresh

スケジュール ビューが表示されます。 ドロップダウンメニューを使用して、1日から6日の間の更新頻度を選択し、アクティブな日付範囲を設定します。 カレンダーアイコンを使用して、開始日と終了日を指定します。

IMPORTANT
Collaboration クレジットを効果的に管理するには、更新の頻度を、基礎となるS3 データの更新頻度と一致するか、それを超えるように設定します。 サポートされる最小の更新間隔は、6日ごとに1回です。

更新頻度オプションと日付範囲の設定を含むスケジュール設定画面。

接続を確認して完了 review-and-complete

最後に、サマリー画面で設定を確認します。 このビューには、次のセクションの概要が含まれています。

  • データ接続:設定したIAMの役割、S3 バケット名、フォルダーパスが表示されます。
  • 詳細: データ接続の名前とオプションの説明を表示して、後で識別できるようにします。
  • マッピング: アップロードしたオーディエンスファイルのソースフィールド(HASHED_EMAILなど)が、Collaborationで使用されるターゲットフィールド(ハッシュ化された電子メールなど)にどのようにマッピングされるかを一覧表示します。
  • スケジュール:接続がオーディエンスデータを更新する頻度と、ソーシング用にアクティブな日付範囲を要約します。

セクションを編集する必要がある場合は、鉛筆アイコンを選択します。 すべてのセクションを確認するには、完了​を選択します。

​ データ接続、詳細、マッピング、スケジュールのセクションを表示するレビューの概要画面。

データ接続が正常に作成され、オーディエンスのソーシングが進行中であることを示すダイアログ確認が表示されます。

ソース別オーディエンスの確認 review-sourced-audiences

設定が完了すると、CollaborationはS3 バケットからオーディエンスのソーシングを開始します。 Amazon S3 バケットを介してソースされたオーディエンスは、マイオーディエンス タブに表示され、Experience Platformからソースされたオーディエンスと同じ機能と情報を持ちます。

オーディエンスのソーシングが進行中の場合は、画面の上部にバナーが表示されます。 個々のオーディエンスは、ソーシング完了後にのみ表示されます。

​ 「オーディエンス」タブには、Amazon S3人のオーディエンスのソーシングが進行中であることが表示されます。

S3 オーディエンスがソースされると、利用可能なオーディエンスのリストが表形式またはカードビューで提供されます。

TIP
オーディエンスのソーシング時間は、S3 データのサイズと設定した更新頻度によって異なります。 データセットが大きい場合や更新スケジュールの頻度が低い場合は、自分のオーディエンス ワークスペースに表示されるまでに時間がかかる場合があります。

​ ソース別オーディエンスの表形式のリストを表示する「オーディエンス」タブ。

グリッド表示またはテーブル表示で、行アイテムを選択するか、オーディエンスを表示​して、特定のオーディエンスの概要を表示します。 オーディエンスのステータス、ソース、データ接続名が表示され、次の詳細パネルが表示されます。

ID: データが使用可能になると、合計ID数と分類が表示されます。
カテゴリ: オーディエンスの整理またはフィルタリングに使用されるタグを一覧表示します。
接続アクセス: オーディエンスがプライベート、パブリック、または特定の共同作業者と共有されているかどうかを示します。
メタデータの可視化:共同作業者に表示されるオーディエンス情報(ID数、重複率、インデックスなど)を定義します。

このビューを使用して、コラボレーションプロジェクトでオーディエンスを使用する前に、オーディエンスの設定と表示設定を確認します。

詳しくは、​ オーディエンスダッシュボードの表示ドキュメント ​を参照してください。

S3 データ接続の表示 view-s3-connection

新しく追加されたAmazon S3接続は、データ接続 タブですぐに利用できます。 オーディエンスソースはAmazon S3として表示されます。

S3 データ接続には、他のオーディエンスデータ接続と同じ機能と詳細が含まれていますが、このビューからオーディエンスを直接追加または編集することはできません。

NOTE
Amazon S3 データ接続は編集できません。 接続が作成されると、更新頻度などの設定を変更することはできません。 設定を更新するには、既存の接続を削除し、新しい接続を作成する必要があります。

​ ソーシングステータス情報を含むAmazon S3 データ接続を示す「My data connections」タブ。

次の手順 next-steps

これで、CollaborationのデータソースとしてAmazon S3 ストレージを正常に設定および接続しました。 このワークフローを完了することで、アクティベーションや重複分析のために、ファーストパーティのオーディエンスデータを安全にソーシングすることが可能になりました。

代わりにGoogle Cloud Storageを使用するには、​ オーディエンスソーシング用GCSの設定を参照してください。

ソーシングが完了すると、オーディエンスは​マイオーディエンス ワークスペースに表示され、コラボレーションとアクティベーションの準備が整います。 管理オプションについて詳しくは、​ オーディエンスのソースと管理に関するドキュメント ​を参照してください。

recommendation-more-help
real-time-cdp-collaboration-help-guide