バッチプロファイルの書き出し宛先に対してオーディエンスをアクティブ化する
概要 overview
この記事では、クラウドストレージやメールマーケティングの宛先など、バッチプロファイルファイルベースの宛先に対してAdobe Experience Platformでオーディエンスをアクティブ化するために必要なワークフローについて説明します。
前提条件 prerequisites
宛先へのオーディエンスをアクティブ化するには、正常に 宛先に接続されている必要があります。 まだ接続していない場合は、宛先カタログに移動し、サポートされている宛先を参照し、使用する宛先を設定します。
書き出しでサポートされているファイル形式 supported-file-formats-export
オーディエンスを書き出す場合、次のファイル形式がサポートされます。
- CSV
- JSON
- PARQUET
CSV ファイルの書き出しでは、書き出したファイルの構造をより柔軟に指定できます。 詳しくは、CSV ファイルのファイル形式設定を参照してください。
ファイルベースの宛先への接続を作成する際に、書き出すファイル形式を選択します。
宛先の選択 select-destination
-
接続/宛先 に移動し、「カタログ」タブを選択します。
-
以下の画像に示すように、オーディエンスをアクティベートする宛先に対応するカードで「オーディエンスをアクティベート」を選択します。
-
オーディエンスをアクティベートするために使用する宛先接続を選択し、「次へ」を選択します。
-
次の節の「オーディエンスを選択 に移動しす。
オーディエンスを選択 select-audiences
宛先に対してアクティブ化するオーディエンスを選択するには、オーディエンス名の左側にあるチェックボックスを使用し、「次へ」を選択します。
接触チャネルに応じて、複数のタイプのオーディエンスから選択できます。
- セグメント化サービス:セグメント化サービスによってExperience Platform内で生成されたオーディエンス。 詳しくは、 セグメント化ドキュメントを参照してください。
- カスタムアップロード:Experience Platform以外で生成され、CSV ファイルとして Platform にアップロードされたオーディエンス。 外部オーディエンスについて詳しくは、 オーディエンスの読み込みに関するドキュメントを参照してください。
- Audience Manager などの他のAdobeソリューションから発生する、その他のタイプのオーディエンス。
オーディエンスの書き出しのスケジュール scheduling
Adobe Experience Platform は、メールマーケティングおよびクラウドストレージの宛先のデータを 様々なファイルタイプとして書き出します。 スケジュール ページでは、書き出す各オーディエンスのスケジュールとファイル名を設定できます。
Experience Platformは、各ファイル書き出しのデフォルトのスケジュールを自動的に設定します。 各スケジュールの横にある鉛筆アイコンを選択し、カスタムスケジュールを定義することで、必要に応じてデフォルトのスケジュールを変更できます。
複数のスケジュールを同時に編集するには、画面の左側のチェックボックスを使用してオーディエンスを選択し、「スケジュールを編集」を選択します。 設定したスケジュールは、選択したオーディエンスの書き出されたすべてのファイルに適用されます。
filename.csv
、filename_2.csv
、filename_3.csv
のように、分割ファイル名には、ファイルが大きな書き出しの一部であることを示す数字が付加されます。完全ファイルを書き出し export-full-files
「完全ファイルを書き出し」を選択して、選択したオーディエンスに対する、すべてのプロファイル選定の完全なスナップショットを含むファイルの書き出しをトリガーにします。
-
「頻度」セレクターを使用して、書き出しの頻度を選択します。
- 1 回:オンデマンドによる 1 回限りの完全ファイルの書き出しをスケジュールします。
- 毎日:指定した時刻に、毎日 1 回、完全ファイルの書き出しをスケジュールします。
-
時間 切り替えスイッチを使用して、書き出しをオーディエンス評価直後に実行するか、指定した時間にスケジュールに沿って実行するかを選択します。 「スケジュール済み」オプションを選択すると、セレクターを使用して書き出しを実行する時刻を UTC 形式で選択できます。
「セグメントの評価後」オプションを使用して、毎日の Platform バッチセグメント化ジョブが完了した直後にアクティベーションジョブをを実行します。このオプションを使用すると、アクティベーションジョブが実行されたときに、最新のプロファイルが確実に宛先に書き出されます。 これにより、オーディエンスが、アクションに基づいて 1 日に複数回書き出される可能性があります。
note important IMPORTANT セグメント評価後にアクティベートするように既に設定されているオーディエンスに対して 柔軟なオーディエンス評価を実行した場合、オーディエンスは、以前の日別アクティベーションジョブに関係なく、柔軟なオーディエンス評価ジョブが終了するとすぐにアクティベートされます。 これにより、オーディエンスが、アクションに基づいて 1 日に複数回エクスポートされる可能性があります。
「スケジュール済み」オプションを使用して、特定の時間にアクティベーションジョブを実行します。 このオプションを選択すると、Experience Platformプロファイルデータが毎日同じ時間に書き出されます。 ただし、アクティベーションジョブが開始される前にバッチセグメント化ジョブが完了しているかどうかに応じて、書き出すプロファイルが最新でない場合があります。 -
「日付」セレクターを使用して、書き出しを実行する日または間隔を選択します。日常の書き出しでのベストプラクティスは、開始日と終了日を、ダウンストリームプラットフォームのキャンペーンの期間に合わせて設定することです。
note important IMPORTANT 書き出し間隔を選択する場合、その間隔の最終日は書き出しに含まれません。例えば、1 月 4 日から 11 日までの間隔を選択した場合、最後のファイルエクスポートは 1 月 10 日に実行されます。 -
「作成」を選択して、スケジュールを保存します。
増分ファイルの書き出し
「増分ファイルのエクスポート」を選択して、エクスポートをトリガーにします。最初のファイルは、選択したオーディエンスに対するすべてのプロファイル資格の完全なスナップショットであり、それ以降のファイルは、前回のエクスポート以降の増分プロファイル資格です。
。
-
頻度 セレクターを使用して、エクスポートする頻度を選択します。
- 毎日:増分ファイルのエクスポートを、毎日 1 回指定した時刻にスケジュールします。
- 毎時:増分ファイルのエクスポートを、3 時間、6 時間、8 時間、または 12 時間ごとにスケジュールします。
-
時間 セレクターを使用して、ファイルが書き出される時刻を UTC 形式で指定します。
-
日付 セレクターを使用して、書き出しが行われる間隔を選択します。ベストプラクティスは、開始日と終了日を、ダウンストリームプラットフォームのキャンペーンの期間に合わせて設定することです。
note important IMPORTANT 間隔の最終日はエクスポートに含まれません。例えば、1 月 4 日から 11 日までの間隔を選択した場合、最後のファイルエクスポートは 1 月 10 日に実行されます。 -
「作成」を選択して、スケジュールを保存します。
ファイル名の設定 configure-file-names
ほとんどの宛先では、デフォルトのファイル名は、宛先名、オーディエンス ID、日時インジケーターで構成されます。 例えば、書き出したファイル名を編集して、異なるキャンペーンを区別したり、データの書き出し時間をファイルに追加したりできます。一部の宛先開発者は、別のデフォルトのファイル名追加オプションを宛先に表示するように選択する場合があります。
モーダルウィンドウを開き、ファイル名を編集するには、鉛筆アイコンを選択します。 ファイル名は 255 文字までに制限されています。
ファイル名エディターで、別のコンポーネントを選択してファイル名に追加できます。
宛先名とオーディエンス ID をファイル名から削除することはできません。 これらのオプションに加えて、次のオプションを追加できます。
MMDDYYYY_HHMMSS
形式で追加するか、UNIX の 10 桁で追加するかを選択します。 増分書き出しのたびにファイル名を動的に生成したい場合は、次のオプションのいずれかを選択します。複数のファイル名を同時に編集するには、画面左側のチェックボックスを使用してオーディエンスを選択し、「ファイル名を編集」を選択します。 設定するファイル名オプションは、選択したオーディエンスの書き出されたすべてのファイルに適用されます。
変更を適用 を選択して、確定します。
すべてのオーディエンスの設定が完了したら、「次へ」を選択して続行します。
マッピング mapping
この手順では、ターゲットの宛先に書き出すファイルに追加する、プロファイル属性を選択する必要があります。 書き出すプロファイル属性と ID を選択するには:
-
マッピング ページで「新しいマッピングを追加」を選択します。
-
ソースフィールド エントリの右側の矢印を選択します。
-
ソースフィールドを選択 ページで、宛先へ書き出したファイルに含めるプロファイル属性と ID を選択してから、「選択」を選択します。
note tip TIP 次の画像に示すように、検索フィールドを使用して、選択を絞り込むことができます。 「データを含むフィールドのみを表示」切替スイッチを使用すると、値が入力されたスキーマフィールドのみを表示できます。 デフォルトでは、入力されたスキーマフィールドのみが表示されます。
-
書き出し用に選択したフィールドがマッピングビューに表示されます。 必要に応じて、書き出したファイルのヘッダーの名前を編集できます。 それには、ターゲットフィールドでアイコンを選択します。
-
ターゲットフィールドを選択 ページで、書き出したファイルでヘッダーに目的の名前を入力し、「選択」をクリックします。
-
書き出し用に選択したフィールドがマッピングビューに表示され、編集したヘッダーが書き出したファイルに表示されます。
-
(オプション) UI でマッピングされたフィールドの順序は、書き出された CSV ファイルの列の順序で(上から下に)反映されます。一番上の行は CSV ファイルの左端の列です。 以下に示すように、マッピングされた行をドラッグ&ドロップすることで、マッピングされたフィールドを任意の方法で並べ替えることができます。
note note NOTE この機能はベータ版で、一部のお客様のみご利用いただけます。 この機能へのアクセス権をリクエストするには、Adobe担当者にお問い合わせください。 -
(オプション)書き出されたフィールドを必須キーまたは 重複排除キーのどちらにするかを選択できます。
-
書き出すフィールドをさらに追加するには、上記の手順を繰り返します。
必須の属性 mandatory-attributes
必須属性は、選択した属性がすべてのプロファイルレコードに含まれるようにする、ユーザーが有効にしたチェックボックスです。例:書き出されるすべてのプロファイルには、メールアドレスが含まれます。
Platform が特定の属性を含むプロファイルのみを書き出すよう、属性を必須としてマークすることができます。その結果、追加のフィルタリング形式として使用できます。属性を必須としてマークする必要は ありません。
必須属性を選択しない場合、属性に関係なく、すべての対象プロファイルを書き出します。
属性の 1 つをスキーマの一意の ID にすることをお勧めします。必須属性について詳しくは、メールマーケティングの宛先ドキュメントの ID の節を参照してください。
重複排除キー deduplication-keys
重複排除キーは、ユーザーがプロファイルの重複排除する ID を決定する、ユーザー定義のプライマリキーです。
重複排除キーを使用すると、同一プロファイルの複数のレコードが 1 つの書き出しファイルに含まれる可能性がなくなります。
Platform で重複排除キーを使用する方法は 3 つあります。
- 重複排除キーとして、単一の ID 名前空間を使用する
- 重複排除キーとして、XDM プロファイルから単一のプロファイル属性を使用する
- 複合キーとして、XDM プロファイルから 2 つのプロファイル属性の組み合わせを使用する
重複排除の例 deduplication-example
次の例は、選択した重複排除キーに応じた重複排除の仕組みを示しています。
次の 2 つのプロファイルについて考えてみましょう。
プロファイル A
{
"identityMap": {
"Email": [
{
"id": "johndoe_1@example.com"
},
{
"id": "doejohn_1@example.com"
}
]
},
"segmentMembership": {
"ups": {
"fa5c4622-6847-4199-8dd4-8b7c7c7ed1d6": {
"status": "realized",
"lastQualificationTime": "2021-03-10 10:03:08"
}
}
},
"person": {
"name": {
"lastName": "Doe",
"firstName": "John"
}
},
"personalEmail": {
"address": "johndoe@example.com"
}
}
プロファイル B
{
"identityMap": {
"Email": [
{
"id": "johndoe_2@example.com"
},
{
"id": "doejohn_2@example.com"
}
]
},
"segmentMembership": {
"ups": {
"fa5c4622-6847-4199-8dd4-8b7c7c7ed1d6": {
"status": "realized",
"lastQualificationTime": "2021-04-10 11:33:28"
}
}
},
"person": {
"name": {
"lastName": "D",
"firstName": "John"
}
},
"personalEmail": {
"address": "johndoe@example.com"
}
}
重複排除の使用例 1:重複排除なし deduplication-use-case-1
重複排除を使用しない場合、書き出しファイルには次のエントリが含まれます。
重複排除の使用例 2:ID 名前空間に基づく重複排除 deduplication-use-case-2
Email 名前空間の重複排除を指定した場合、書き出しファイルには次のエントリが含まれます。プロファイル B はオーディエンスに適合する最新のプロファイルなので、唯一書き出されます。
重複排除のユースケース 3:単一のプロファイル属性に基づく重複排除 deduplication-use-case-3
personal Email
属性による重複排除を仮定した場合、エクスポートファイルには次のエントリが含まれます。プロファイル B はオーディエンスに適合する最新のプロファイルなので、唯一書き出されます。
重複排除のユースケース 4:2 つのプロファイル属性に基づく重複排除 deduplication-use-case-4
複合キー personalEmail + lastName
による重複排除を仮定した場合、エクスポートファイルには次のエントリが含まれます。
CRM ID やメールアドレスなどの ID 名前空間を重複排除キーとして選択して、すべてのプロファイルレコードが必ず一意に識別されるようにすることをお勧めします。
- フィールドは、オーディエンス定義で使用されます。
- フィールドは、ターゲット先の予測属性として設定されます。
person.name.firstName
に宛先のマーケティングアクションと競合する特定のデータ使用ラベルがある場合、レビュー手順でデータ使用ポリシー違反が表示されます。詳しくは、Adobe Experience Platform でのデータガバナンスを参照してください。[Beta]{class="badge informative"} 計算フィールドから配列をエクスポートします export-arrays-calculated-fields
一部のベータ版のお客様は、Experience Platformからクラウドストレージの宛先に配列オブジェクトを書き出すことができます。 詳しくは、 配列と計算フィールドの書き出しを参照し、機能にアクセスするにはAdobe担当者にお問い合わせください。
既知の制限事項 known-limitations
新しい マッピング ページには次の既知の制限事項があります。
マッピングワークフローでは、オーディエンスメンバーシップの属性を選択できません
既知の制限により、現在、フィールドを選択 ウィンドウを使用して、segmentMembership.seg_namespace.seg_id.status
をファイル書き出しに追加できません。 代わりに、手動で値 xdm: segmentMembership.seg_namespace.seg_id.status
をスキーマフィールドに貼り付ける必要があります(下図を参照)。
segmentMembership.seg_namespace.seg_id.status
segmentMembership.seg_namespace.seg_id.lastQualificationTime
ファイルのエクスポートは、segmentMembership.seg_namespace.seg_id.status
が選択されているかどうかによって、次のように異なります。
segmentMembership.seg_namespace.seg_id.status
フィールドを選択した場合、エクスポートされたファイルには、最初の完全スナップショットでは アクティブ メンバーが含まれ、その後の増分エクスポートでは新しく アクティブ および 期限切れ メンバーが含まれます。segmentMembership.seg_namespace.seg_id.status
フィールドを選択しない場合、エクスポートされたファイルには、最初の完全スナップショットとその後の増分エクスポートで、アクティブ メンバーのみが含まれます。
詳しくは、 ファイルベースの宛先のプロファイル書き出し動作を参照してください。
ID 名前空間は現在、書き出し用に選択できません
以下の画像に示すように、ID 名前空間を書き出し用に選択する機能は、現在サポートされていません。 書き出し用の ID 名前空間を選択すると、レビュー 手順でエラーが発生します。
ベータ版の間に書き出したファイルに ID 名前空間を追加する必要がある場合の一時的な回避策として、次のいずれかを実行できます。
- 書き出しに ID 名前空間を含めるデータフローに、従来のクラウドストレージの宛先を使用する
- ID を属性として Experience Platform にアップロードし、クラウドストレージの宛先に書き出します。
プロファイル属性の選択 select-attributes
プロファイルベースの宛先の場合、ターゲット宛先に送信するプロファイル属性を選択する必要があります。
-
属性を選択 ページで「新しいフィールドを追加」を選択します。
-
「スキーマフィールド」エントリの右側の矢印を選択します。
-
フィールドを選択 ページで、宛先に送信する XDM 属性または ID 名前空間を選択してから 選択 を選択します。
-
さらにマッピングを追加するには、手順 1~3 を繰り返します。
person.name.firstName
、person.name.lastName
、personalEmail.address
、segmentMembership.seg_namespace.seg_id.status
)を事前に選択します。
segmentMembership.seg_namespace.seg_id.status
をファイル書き出しに追加できません。 代わりに、手動で値 xdm: segmentMembership.seg_namespace.seg_id.status
をスキーマフィールドに貼り付ける必要があります(下図を参照)。ファイルのエクスポートは、segmentMembership.seg_namespace.seg_id.status
が選択されているかどうかによって、次のように異なります。
segmentMembership.seg_namespace.seg_id.status
フィールドを選択した場合、エクスポートされたファイルには、最初の完全スナップショットでは アクティブ メンバーが含まれ、その後の増分エクスポートでは アクティブ および 期限切れ のメンバーが含まれます。segmentMembership.seg_namespace.seg_id.status
フィールドを選択しない場合、エクスポートされたファイルには、最初の完全スナップショットとその後の増分エクスポートで、アクティブ メンバーのみが含まれます。
エンリッチメント属性を選択 select-enrichment-attributes
エンリッチメント属性は、Experience Platformに カスタムアップロード として取り込まれた、カスタムアップロードされたオーディエンスに対応します。 この手順では、選択した外部オーディエンスごとに、宛先に書き出す属性を選択できます。
各外部オーディエンスのエンリッチメント属性を選択するには、次の手順に従います。
- エンリッチメント属性 列で、「 (編集)」ボタンを選択します。
- エンリッチメント属性を追加 を選択します。 新しい空のスキーマフィールドが表示されます。
- 空のフィールドの右側にあるボタンを選択して、フィールド選択画面を開きます。
- オーディエンス用に書き出す属性を選択します。
- 書き出すすべての属性を追加したら、「保存して閉じる を選択し す。
- 外部オーディエンスごとに、これらの手順を繰り返します。
属性を書き出さずに宛先に対して外部オーディエンスをアクティブ化する場合は、「エンリッチメント属性を除外 切替スイッチを有効に ます。 このオプションでは、外部オーディエンスからプロファイルが書き出されますが、対応する属性は宛先に送信されません。
「次へ」を選択して、「 レビューステップに移動します。
レビュー review
「レビュー」ページには、選択内容の概要が表示されます。「キャンセル」を選択してフローを分割するか、「戻る」を選択して設定を変更する、または、「完了」を選択して確定し、宛先へのデータの送信を開始します。
同意ポリシーの評価 consent-policy-evaluation
組織で Adobe Healthcare Shield または Adobe Privacy & Security Shield を購入した場合、適用可能な同意ポリシーを表示 を選択すると、どの同意ポリシーが適用され、その結果、いくつのプロファイルがアクティベーションに含まれるかを確認することができます。詳しくは、 同意ポリシーの評価を参照してください。
データ使用ポリシーのチェック data-usage-policy-checks
レビュー 手順では、Experience Platformはデータ使用ポリシーの違反がないことも確認します。 ポリシーに違反した場合の例を次に示します。違反を解決するまで、Audience Activation ワークフローを完了することはできません。 ポリシー違反の解決方法については、データガバナンスに関するドキュメントの データ使用ポリシー違反を参照してください。
オーディエンスのフィルタリング filter-audiences
また、この手順では、ページで使用可能なフィルターを使用して、このワークフローの一環としてスケジュールまたはマッピングが更新されたオーディエンスのみを表示できます。 また、表示するテーブル列を切り替えることもできます。
選択内容に満足し、ポリシー違反が検出されていない場合は、「完了」を選択して選択内容を確定し、宛先へのデータの送信を開始します。
Audience Activation の検証 verify
オーディエンスをクラウドストレージの宛先に書き出す場合、Adobe Experience Platformは、指定されたストレージの場所に .csv
、.json
または .parquet
ファイルを作成します。 ワークフローで設定したスケジュールに従って、ストレージの場所に新しいファイルが作成されます。デフォルトのファイル形式を以下に示しますが、 ファイル名のコンポーネントを編集できます。<destinationName>_segment<segmentID>_<timestamp-yyyymmddhhmmss>.csv
例えば、書き出し頻度を毎日に選択した場合、連続した 3 日間に受け取るファイルは次のようになります。
Salesforce_Marketing_Cloud_segment12341e18-abcd-49c2-836d-123c88e76c39_20200408061804.csv
Salesforce_Marketing_Cloud_segment12341e18-abcd-49c2-836d-123c88e76c39_20200409052200.csv
Salesforce_Marketing_Cloud_segment12341e18-abcd-49c2-836d-123c88e76c39_20200410061130.csv
これらのファイルがストレージの場所に存在すれば、アクティベーションは成功しています。エクスポートされるファイルの構造を理解するには、サンプルの .csv ファイルをダウンロードすることができます。このサンプルファイルには、プロファイル属性 person.firstname
、person.lastname
、person.gender
、person.birthyear
および personalEmail.address
が含まれています。