この記事では、クラウドストレージや電子メールマーケティングの宛先など、Adobe Experience Platformのバッチプロファイルベースの宛先でオーディエンスをアクティブ化するために必要なワークフローについて説明します。
オーディエンスを宛先に対してアクティブ化するには、次の条件を満たす必要があります。 宛先に接続されている. まだ接続していない場合は、宛先カタログに移動し、サポートされている宛先を参照し、使用する宛先を設定します。
接続/宛先に移動し、「カタログ」タブを選択します。
選択 オーディエンスをアクティブ化 オーディエンスをアクティブ化する宛先に対応するカード(下図を参照)。
オーディエンスのアクティブ化に使用する宛先接続を選択し、「 」を選択します。 次へ.
次のセクションに移動: オーディエンスを選択.
宛先に対してアクティブ化するオーディエンスを選択するには、オーディエンス名の左側にあるチェックボックスを使用して、 次へ.
オリジンに応じて、複数のタイプのオーディエンスから選択できます。
元のオーディエンスの選択 カスタムアップロード を自動的に有効にする エンリッチメント属性を選択 手順
Adobe Experience Platform は、メールマーケティングおよびクラウドストレージの宛先のデータを CSV ファイルの形式で書き出します。Adobe Analytics の スケジュール ページでは、書き出す各オーディエンスのスケジュールおよびファイル名を設定できます。 スケジュールの設定は必須ですが、ファイル名の設定はオプションです。
Adobe Experience Platform は、書き出しファイルを1 ファイルあたり 500 万件のレコード(行)で自動的に分割します。各行は 1 つのプロファイルを表します。
filename.csv
、filename_2.csv
、filename_3.csv
のように、分割ファイル名には、ファイルが大きな書き出しの一部であることを示す数字が付加されます。
を選択します。 スケジュールを作成 ボタンをクリックします。
選択 完全なファイルを書き出し :選択したオーディエンスに対するすべてのプロファイル認定の完全なスナップショットを含むファイルの書き出しをトリガーします。
「頻度」セレクターを使用して、書き出しの頻度を選択します。
以下を使用します。 時間 オーディエンス評価の直後に書き出しを実行するか、スケジュールに沿って、指定した時間に書き出しを実行するかを選択します。 「スケジュール済み」オプションを選択すると、セレクターを使用して書き出しを実行する時刻を UTC 形式で選択できます。
The セグメント評価後 以下に説明するオプションは、一部のベータ版のお客様のみが利用できます。
「セグメントの評価後」オプションを使用して、毎日の Platform バッチセグメント化ジョブが完了した直後にアクティベーションジョブをを実行します。このオプションを使用すると、アクティベーションジョブを実行する際に、最新のプロファイルが確実に宛先に書き出されます。
「スケジュール済み」オプションを使用して、特定の時間にアクティベーションジョブを実行します。 このオプションを使用すると、Experience Platformプロファイルデータが毎日同時に書き出されます。 ただし、アクティベーションジョブが開始される前にバッチセグメントジョブが完了しているかどうかによっては、書き出すプロファイルが最新でない場合があります。
「日付」セレクターを使用して、書き出しを実行する日または間隔を選択します。日常の書き出しでのベストプラクティスは、開始日と終了日を、ダウンストリームプラットフォームのキャンペーンの期間に合わせて設定することです。
書き出し間隔を選択する場合、その間隔の最終日は書き出しに含まれません。例えば、1 月 4 日から 11 日の間隔を選択した場合、最後のファイルエクスポートは 1 月 10 日におこなわれます。
「作成」を選択して、スケジュールを保存します。
選択 増分ファイルの書き出し 最初のファイルが、選択したオーディエンスに対するすべてのプロファイル認定の完全なスナップショットであるエクスポートをトリガーし、それ以降のファイルは、前回のエクスポート以降の増分プロファイル認定です。
最初に書き出された増分ファイルには、オーディエンスの資格を持つすべてのプロファイルが含まれ、バックフィルとして機能します。
頻度セレクターを使用して、エクスポートする頻度を選択します。
時間セレクターを使用して、ファイルが書き出される時刻を UTC 形式で指定します。
日付セレクターを使用して、書き出しが行われる間隔を選択します。ベストプラクティスは、開始日と終了日を、ダウンストリームプラットフォームのキャンペーンの期間に合わせて設定することです。
間隔の最終日はエクスポートに含まれません。例えば、1 月 4 日から 11 日の間隔を選択した場合、最後のファイルエクスポートは 1 月 10 日におこなわれます。
「作成」を選択して、スケジュールを保存します。
ほとんどの宛先では、デフォルトのファイル名は、宛先名、オーディエンス ID、日付と時刻のインジケーターで構成されます。 例えば、書き出したファイル名を編集して、異なるキャンペーンを区別したり、データの書き出し時間をファイルに追加したりできます。一部の宛先開発者は、別のデフォルトのファイル名追加オプションを宛先に表示するように選択する場合があります。
モーダルウィンドウを開いてファイル名を編集するには、鉛筆アイコンを選択します。 ファイル名は 255 文字までに制限されています。
次の画像は Amazon S3 の宛先のファイル名を編集する方法を示していますが、プロセスはすべてのバッチ宛先 (SFTP、Azure Blob Storage または Google Cloud Storage など)で同じです。
ファイル名エディターで、別のコンポーネントを選択してファイル名に追加できます。
宛先名とオーディエンス ID は、ファイル名から削除できません。 これらのオプションに加えて、次のオプションを追加できます。
ファイル名オプション | 説明 |
---|---|
オーディエンス名 | エクスポートされたオーディエンスの名前。 |
日時 | 追加する項目を選択 MMDDYYYY_HHMMSS 形式または UNIX の 10 桁のタイムスタンプ。 増分書き出しのたびにファイル名を動的に生成したい場合は、次のオプションのいずれかを選択します。 |
カスタムテキスト | ファイル名に追加する任意のカスタムテキスト。 |
宛先 ID | オーディエンスのエクスポートに使用する宛先データフローの ID。 |
宛先名 | オーディエンスのエクスポートに使用する宛先データフローの名前。 |
組織名 | Experience Platform 内の組織名。 |
サンドボックス名 | オーディエンスの書き出しに使用するサンドボックスの ID。 |
変更を適用を選択して、確定します。
日時コンポーネントを選択しない場合、ファイル名は固定され、新しくエクスポートされたファイルは、エクスポートのたびに保存場所にある以前のファイルを上書きします。ストレージの場所からメールマーケティングプラットフォームへのインポートジョブを繰り返し実行する場合は、このオプションをお勧めします。
すべてのオーディエンスの設定が完了したら、 次へ をクリックして続行します。
この手順では、ターゲットの宛先に書き出すファイルに追加する、プロファイル属性を選択する必要があります。 書き出すプロファイル属性と ID を選択するには:
マッピングページで「新しいフィールドを追加」を選択します。
ソースフィールドエントリの右側の矢印を選択します。
ソースフィールドを選択ページで、宛先へ書き出したファイルに含めるプロファイル属性と ID を選択してから、「選択」を選択します。
次の画像に示すように、検索フィールドを使用して、選択を絞り込むことができます。
書き出し用に選択したフィールドがマッピングビューに表示されます。 必要に応じて、書き出したファイルのヘッダーの名前を編集できます。 それには、ターゲットフィールドでアイコンを選択します。
ターゲットフィールドを選択ページで、書き出したファイルでヘッダーに目的の名前を入力し、「選択」をクリックします。
書き出し用に選択したフィールドがマッピングビューに表示され、編集したヘッダーが書き出したファイルに表示されます。
(オプション)書き出されたフィールドを必須キーまたは 重複排除キーのどちらにするかを選択できます。
書き出すフィールドをさらに追加するには、上記の手順を繰り返します。
必須属性は、選択した属性がすべてのプロファイルレコードに含まれるようにする、ユーザーが有効にしたチェックボックスです。例:書き出されるすべてのプロファイルには、メールアドレスが含まれます。
Platform が特定の属性を含むプロファイルのみを書き出すよう、属性を必須としてマークすることができます。その結果、追加のフィルタリング形式として使用できます。属性を必須としてマークする必要はありません。
必須属性を選択しない場合、属性に関係なく、すべての対象プロファイルを書き出します。
属性の 1 つをスキーマの一意の ID にすることをお勧めします。必須属性について詳しくは、メールマーケティングの宛先ドキュメントの ID の節を参照してください。
重複排除キーは、ユーザーがプロファイルの重複排除する ID を決定する、ユーザー定義のプライマリキーです。
重複排除キーを使用すると、同一プロファイルの複数のレコードが 1 つの書き出しファイルに含まれる可能性がなくなります。
Platform で重複排除キーを使用する方法は 3 つあります。
単一の ID 名前空間を宛先に書き出すことができ、名前空間は自動的に重複排除キーとして設定されます。複数の名前空間を宛先に送信することはサポートされていません。
ID 名前空間とプロファイル属性の組み合わせを重複排除キーとして使用することはできません。
次の例は、選択した重複排除キーに応じた重複排除の仕組みを示しています。
次の 2 つのプロファイルについて考えてみましょう。
プロファイル A
{
"identityMap": {
"Email": [
{
"id": "johndoe_1@example.com"
},
{
"id": "johndoe_2@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_1@example.com"
},
{
"id": "johndoe_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"
}
}
重複排除を使用しない場合、書き出しファイルには次のエントリが含まれます。
personalEmail | firstName | lastName |
---|---|---|
johndoe@example.com | John | Doe |
johndoe@example.com | John | D |
Email 名前空間の重複排除を指定した場合、書き出しファイルには次のエントリが含まれます。プロファイル B はオーディエンスの資格を持つ最新のものなので、書き出されるのは 1 つだけです。
メール* | personalEmail | firstName | lastName |
---|---|---|---|
johndoe_1@example.com | johndoe@example.com | John | D |
johndoe_2@example.com | johndoe@example.com | John | D |
personal Email
属性による重複排除を仮定した場合、エクスポートファイルには次のエントリが含まれます。プロファイル B はオーディエンスの資格を持つ最新のものなので、書き出されるのは 1 つだけです。
personalEmail* | firstName | lastName |
---|---|---|
johndoe@example.com | John | D |
複合キー personalEmail + lastName
による重複排除を仮定した場合、エクスポートファイルには次のエントリが含まれます。
personalEmail* | lastName* | firstName |
---|---|---|
johndoe@example.com | D | John |
johndoe@example.com | Doe | John |
CRM ID やメールアドレスなどの ID 名前空間を重複排除キーとして選択して、すべてのプロファイルレコードが必ず一意に識別されるようにすることをお勧めします。
(データセット全体ではなく)データセット内の特定のフィールドのみに適用されたデータ使用ラベルがある場合、アクティベーション時のこれらのフィールドレベルラベルの適用は、次の条件で行われます。
例えば、フィールド person.name.firstName
に宛先のマーケティングアクションと競合する特定のデータ使用ラベルがある場合、レビュー手順でデータ使用ポリシー違反が表示されます。詳しくは、Adobe Experience Platform でのデータガバナンスを参照してください。
ベータ版のお客様は、アレイオブジェクトをExperience Platformからクラウドストレージの宛先に書き出すことができます。 詳細を表示: 配列と計算フィールドのエクスポート 機能にアクセスするには、Adobe担当者にお問い合わせください。
新しいマッピングページには次の既知の制限事項があります。
既知の制限により、現在、フィールドを選択ウィンドウを使用して、segmentMembership.status
をファイル書き出しに追加できません。 代わりに、手動で値 xdm: segmentMembership.status
をスキーマフィールドに貼り付ける必要があります(下図を参照)。
ファイルのエクスポートは、segmentMembership.status
が選択されているかどうかによって、次のように異なります。
segmentMembership.status
フィールドを選択した場合、エクスポートされたファイルには、最初の完全スナップショットではアクティブメンバーが含まれ、その後の増分エクスポートではアクティブおよび期限切れのメンバーが含まれます。segmentMembership.status
フィールドを選択しない場合、エクスポートされたファイルには、最初の完全スナップショットとその後の増分エクスポートで、アクティブメンバーのみが含まれます。以下の画像に示すように、ID 名前空間を書き出し用に選択する機能は、現在サポートされていません。 書き出し用の ID 名前空間を選択すると、レビュー手順でエラーが発生します。
ベータ版の間に書き出したファイルに ID 名前空間を追加する必要がある場合の一時的な回避策として、次のいずれかを実行できます。
カタログ内のすべてのクラウドストレージの宛先で、 マッピング step これは、 属性を選択 この節で説明する手順です。
この 属性を選択 Adobe Campaign、OracleResponsys、OracleEloqua、SalesforceMarketing Cloud電子メールマーケティングの各宛先に対して、手順が引き続き表示されます。
プロファイルベースの宛先の場合、ターゲット宛先に送信するプロファイル属性を選択する必要があります。
属性を選択ページで「新しいフィールドを追加」を選択します。
「スキーマフィールド」エントリの右側の矢印を選択します。
Adobe Analytics の フィールドを選択 ページで、宛先に送信する XDM 属性または ID 名前空間を選択してから、「 」を選択します 選択.
さらにマッピングを追加するには、手順 1~3 を繰り返します。
Adobe Experience Platform は、スキーマから推奨される一般的に使用される属性 4 つ(person.name.firstName
、person.name.lastName
、personalEmail.address
、segmentMembership.status
)を事前に選択します。
既知の制限により、現在、フィールドを選択ウィンドウを使用して、segmentMembership.status
をファイル書き出しに追加できません。 代わりに、手動で値を貼り付ける必要があります xdm: segmentMembership.status
をスキーマフィールドに追加します(下図を参照)。
ファイルの書き出しは、次の方法で、 segmentMembership.status
が選択されている場合:
segmentMembership.status
フィールドを選択した場合、エクスポートされたファイルには、最初の完全スナップショットではアクティブメンバーが含まれ、その後の増分エクスポートではアクティブおよび期限切れのメンバーが含まれます。segmentMembership.status
フィールドを選択しない場合、エクスポートされたファイルには、最初の完全スナップショットとその後の増分エクスポートで、アクティブメンバーのみが含まれます。このステップは、 カスタムアップロード オーディエンス オーディエンス選択 手順
エンリッチメント属性は、Experience Platformで カスタムアップロード. この手順では、選択した外部オーディエンスごとに、宛先に書き出す属性を選択できます。
次の手順に従って、各外部オーディエンスのエンリッチメント属性を選択します。
属性をエクスポートせずに、宛先に対する外部オーディエンスをアクティブ化する場合は、 エンリッチメント属性の除外 切り替え このオプションを選択すると、外部オーディエンスからプロファイルがエクスポートされますが、対応する属性はどれも宛先に送信されません。
選択 次へ 移動先 レビュー 手順
「レビュー」ページには、選択内容の概要が表示されます。「キャンセル」を選択してフローを分割するか、「戻る」を選択して設定を変更する、または、「完了」を選択して確定し、宛先へのデータの送信を開始します。
組織で Adobe Healthcare Shield または Adobe Privacy & Security Shield を購入した場合、適用可能な同意ポリシーを表示を選択すると、どの同意ポリシーが適用され、その結果、いくつのプロファイルがアクティベーションに含まれるかを確認することができます。お読みください 同意ポリシーの評価 を参照してください。
Adobe Analytics の レビュー 手順の後、Experience Platformは、データ使用ポリシーの違反を確認します。 ポリシーに違反した場合の例を次に示します。違反を解決するまで、オーディエンスのアクティベーションワークフローを完了することはできません。 ポリシー違反の解決方法については、 データ使用ポリシーの違反 (データガバナンスに関するドキュメントの節)を参照してください。
また、この手順では、ページで使用可能なフィルターを使用して、このワークフローの一部としてスケジュールまたはマッピングが更新されたオーディエンスのみを表示できます。 また、表示するテーブル列を切り替えることもできます。
選択が完了し、ポリシー違反が検出されなかった場合は、「 」を選択します。 完了 をクリックして選択を確定し、宛先へのデータの送信を開始します。
メールマーケティングの宛先とクラウドストレージの宛先の場合、Adobe Experience Platform は、指定されたストレージの場所に .csv
ファイルを作成します。ワークフローで設定したスケジュールに従って、ストレージの場所に新しいファイルが作成されます。デフォルトのファイル形式を以下に示しますが、次の操作を実行できます。 ファイル名のコンポーネントを編集する:
<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
が含まれています。