バッチプロファイルの書き出し宛先に対してオーディエンスをアクティブ化する

概要 overview

この記事では、クラウドストレージやメールマーケティングの宛先など、バッチプロファイルファイルベースの宛先にAdobe Experience Platformでオーディエンスをアクティブ化するために必要なワークフローについて説明します。

前提条件 prerequisites

宛先に対してオーディエンスをアクティブ化するには、宛先🔗に正常に接続している必要があります。 まだ接続していない場合は、宛先カタログに移動し、サポートされている宛先を参照し、使用する宛先を設定します。

書き出しでサポートされているファイル形式 supported-file-formats-export

オーディエンスの書き出し時には、次のファイル形式がサポートされます。

CSV ファイルを書き出すと、書き出したファイルの構造化に関する柔軟性が向上することに注意してください。 CSV ファイルの​ ファイル形式の設定の詳細をご覧ください。

ファイルベースの宛先🔗への接続を作成する際に、書き出すファイル形式を選択します。

宛先の選択 select-destination

オーディエンスの選択 select-audiences

配信元に応じて、複数のタイプのオーディエンスから選択できます。

オーディエンスの書き出しのスケジュール scheduling

Adobe Experience Platformは、メールマーケティングとクラウドストレージの宛先のデータを異なるファイルタイプ ​として書き出します。 スケジュール ページでは、書き出す各オーディエンスのスケジュールとファイル名を設定できます。

新しいオーディエンス​と​ アクティブ化されたオーディエンス ​のオプションを使用して、このページの2つのビューを切り替えます。

Experience Platformは、ファイルの書き出しごとにデフォルトスケジュールを自動的に設定します。 必要に応じて、各スケジュールの横にある鉛筆アイコンを選択し、カスタムスケジュールを定義することで、デフォルトのスケジュールを変更できます。

各オーディエンスについて、2つの書き出しタイプから1つを選択します。完全ファイルの書き出しまたは増分ファイルの書き出し。

スケジュール設定ステップでハイライト表示された {modal="regular"}

複数のスケジュールを同時に編集するには、画面の左側にあるチェックボックスを使用してオーディエンスを選択し、スケジュールを編集​を選択します。 設定したスケジュールは、選択したオーディエンスのすべての書き出されたファイルに適用されます。

{modal="regular"}

完全ファイルを書き出し export-full-files

「完全ファイルを書き出し」を選択すると、選択したオーディエンスのすべてのプロファイル資格の完全なスナップショットを含むファイルの書き出しをトリガーできます。

{modal="regular"}

スケジュールされた書き出し動作について export-behavior

スケジュールされた書き出しには、オーディエンスのスナップショットデータに、スナップショットの作成と書き出し時間の間に発生するプロファイルの増分またはIDの変更が含まれます。 これは、スナップショットデータのみを使用する​ オンデマンド書き出しとは異なります。

次の表は、スケジュールされた書き出しとオンデマンド書き出しの違いを示しています。特に、データの鮮度と用途が異なります。

オーディエンスの評価後にプロファイルが更新された場合、評価時にオーディエンスメンバーシップが決定されたにもかかわらず、スケジュールされた書き出しには更新された属性値が含まれます。

例:「retailIDがnullのプロファイル」のオーディエンスは、そのフィールドが​ 後 ​評価で​ 前 ​にスケジュールされたエクスポートが更新された場合、retailIDが入力されたプロファイルを書き出すことができます。

レコメンデーション

オンデマンド書き出しについては、​ オンデマンドでのファイルの書き出しに関するドキュメントを参照してください。

増分ファイルの書き出し export-incremental-files

「増分ファイルを書き出し」を選択して、最初のファイルが選択したオーディエンスのすべてのプロファイル条件の完全なスナップショットであり、後続のファイルが前回の書き出しからの増分プロファイル条件である書き出しをトリガーします。

{modal="regular"}

ファイル名の設定 configure-file-names

ほとんどの宛先では、デフォルトのファイル名は、宛先名、オーディエンス ID、日付と時刻インジケーターで構成されます。 例えば、書き出したファイル名を編集して、異なるキャンペーンを区別したり、データの書き出し時間をファイルに追加したりできます。 一部の宛先開発者は、別のデフォルトのファイル名追加オプションを宛先に表示するように選択する場合があります。

モーダルウィンドウを開いてファイル名を編集するには、鉛筆アイコンを選択します。 ファイル名は 255 文字までに制限されています。

{modal="regular"}

ファイル名エディターで、別のコンポーネントを選択してファイル名に追加できます。

{modal="regular"}

宛先名とオーディエンス IDをファイル名から削除することはできません。 これらのオプションに加えて、次のオプションを追加できます。

複数のファイル名を同時に編集するには、画面の左側にあるチェックボックスを使用してオーディエンスを選択し、ファイル名を編集​を選択します。 設定したファイル名オプションは、選択したオーディエンスのすべての書き出されたファイルに適用されます。

「 {modal="regular"}

変更を適用​を選択して、選択を確定します。

すべてのオーディエンスの設定が完了したら、次へ​を選択して続行します。

マッピング mapping

この手順では、ターゲットの宛先に書き出すファイルに追加する、プロファイル属性を選択する必要があります。 書き出すプロファイル属性と ID を選択するには：

必須の属性、重複排除キー、計算フィールド、およびマッピングステップの既知の制限について詳しくは、​ バッチ宛先マッピングリファレンス ​を参照してください。

エンリッチメント属性を選択 select-enrichment-attributes

エンリッチメント属性は、カスタムアップロード​としてExperience Platformに取り込まれたカスタムアップロード済みオーディエンスに対応します。 この手順では、選択した外部オーディエンスごとに、宛先に書き出す属性を選択できます。

TIP

属性をエクスポートせずに宛先に対して外部オーディエンスをアクティブ化する場合は、エンリッチメント属性を除外​切り替えを有効にします。 このオプションは、プロファイルを外部オーディエンスから書き出しますが、対応する属性はすべて宛先に送信されません。

エンリッチメント属性を除外トグルを示す {modal="regular"}

エンリッチメント属性の選択ステップを示す {modal="regular"}

以下の手順に従って、各外部オーディエンスのエンリッチメント属性を選択します。

「次へ」を選択して、​ レビュー ステップに移動します。

[Beta]{class="badge informative"} エンリッチメント属性から配列とオブジェクトを書き出す export-arrays-enrichment-attributes

JSONまたはParquet出力と配列、マップ、およびオブジェクトの書き出し​​切り替えが有効になっているを使用して、オーディエンスをクラウドストレージの宛先に書き出す場合、配列全体またはオブジェクトの配列から選択したフィールドを含む複雑なデータ構造をエンリッチメント属性として書き出すことができます。

{modal="regular"}。

エンリッチメント属性ステップには、次の2列マッピングインターフェイスが表示されます。

この機能は、次のすべての条件を満たす場合にのみ使用できます。

配列全体の書き出し export-entire-array

ソースフィールド選択画面から配列属性の名前を選択します。 ソースフィールドには配列パスが入力され、ターゲットフィールドには配列名が自動的に入力されます。 書き出された出力では、配列内のすべてのオブジェクトとすべてのプロパティが保持されます。

{modal="regular"}

オブジェクトの配列から1つのフィールドをエクスポートする export-single-array-field

オブジェクトの配列内にネストされたプロパティを選択すると、Source フィールド​は、to_objectを使用してtransformArray計算された式を自動的に入力し、配列内のすべてのオブジェクトからそのプロパティを抽出します。

例えば、someArray[*].amountを選択すると、ソースフィールドに次の情報が入力されます。

transformArray(someArray, x -> to_object("amount", x.amount))

ターゲットフィールドには、リーフノード名（amount）が自動入力されます。 ターゲットフィールドの名前を変更することもできます。

{modal="regular"}

オブジェクトの配列から複数のフィールドをエクスポートする export-multiple-array-fields

同じオブジェクトの配列から複数のプロパティを書き出すには、次の2つの手順に従います。

例えば、amountとdateの両方をsomeArrayから書き出すには、まずsomeArray[*].amountを選択し、次のように式を編集します。

transformArray(someArray, x -> to_object("amount", x.amount, "date", x.date))

指定したフィールドのみが、書き出された配列内の各オブジェクトに含まれます。 さらに、必要に応じて、書き出したファイルの最上位の配列名を変更することもできます。

{modal="regular"}

レビュー review

レビュー ページで、選択内容の概要を確認できます。 キャンセル​を選択してフローを分割し、戻る​を選択して設定を変更するか、完了​を選択して選択内容を確認し、宛先へのデータ送信を開始します。

レビュー手順に {modal="regular"}

同意ポリシーの評価 consent-policy-evaluation

組織で Adobe Healthcare Shield または Adobe Privacy & Security Shield を購入した場合、適用可能な同意ポリシーを表示​を選択すると、どの同意ポリシーが適用され、その結果、いくつのプロファイルがアクティベーションに含まれるかを確認することができます。 詳しくは、同意ポリシーの評価を参照してください。

データ使用ポリシーチェック data-usage-policy-checks

Review​手順では、Experience Platformもデータ使用ポリシー違反をチェックします。 ポリシーに違反した場合の例を次に示します。 オーディエンスのアクティベーション ワークフローを完了するには、違反を解決する必要があります。 ポリシー違反を解決する方法について詳しくは、「データガバナンスのドキュメント」セクションの​ データ使用ポリシー違反を参照してください。

{modal="regular"}

オーディエンスを絞り込む filter-audiences

「新しいオーディエンス」と「アクティブ化されたオーディエンス」トグルを使用して、このアクティベーションフローで追加したオーディエンスと、以前のフローで宛先に対して既にアクティブ化したオーディエンスを切り替えます。

表に表示する列を選択するには、「表をカスタマイズ」アイコンを選択します。 テーブルをカスタマイズ ダイアログで、表示する列を選択またはクリアしてから、適用​を選択します。

{modal="regular"}

選択に満足しており、ポリシー違反が検出されていない場合は、終了​を選択して選択を確定し、宛先へのデータ送信を開始します。

オーディエンスのアクティブ化の検証 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 が含まれています。