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

概要 overview

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

前提条件 prerequisites

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

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

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

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

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

宛先の選択 select-destination

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

宛先に対してアクティブ化するオーディエンスを選択するには、オーディエンス名の左側にあるチェックボックスを使用し、次へ​を選択します。

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

アクティブ化する1つまたは複数のオーディエンスを選択する際に表示される

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

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

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

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

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

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

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

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

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

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

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

レコメンデーション

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

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

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

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

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

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

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

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

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

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

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

マッピング mapping

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

必須の属性 mandatory-attributes

必須属性は、選択した属性がすべてのプロファイルレコードに含まれるようにする、ユーザーが有効にしたチェックボックスです。 例：書き出されるすべてのプロファイルには、メールアドレスが含まれます。

Experience Platform が特定の属性を含むプロファイルのみを書き出すよう、属性を必須としてマークすることができます。 その結果、追加のフィルタリング形式として使用できます。 属性を必須としてマークする必要は​ありません。

必須属性を選択しない場合、属性に関係なく、すべての対象プロファイルを書き出します。

属性の 1 つをスキーマの一意の ID にすることをお勧めします。 必須属性について詳しくは、メールマーケティングの宛先ドキュメントの ID の節を参照してください。

重複排除キー deduplication-keys

重複排除キーは、プロファイルの重複排除の方法を決定するユーザー定義のプライマリキーです。 同じ個人に複数のレコードが存在する場合、重複排除によって最新のレコードのみが書き出されます。

重複排除キーを使用すると、同一プロファイルの複数のレコードが 1 つの書き出しファイルに含まれる可能性がなくなります。

Experience Platform で重複排除キーを使用する方法は 3 つあります。

重複排除の例 deduplication-example

次の例は、選択した重複排除キーに応じた重複排除の仕組みを示しています。

次の 2 つのプロファイルについて考えてみましょう。

プロファイル A

{
  "identityMap": {
    "Email": [
      {
        "id": "johndoe@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@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は、オーディエンスに適格な最新のプロファイルなので、書き出されるのはプロファイル Bのみです。

重複排除のユースケース 3：単一のプロファイル属性に基づく重複排除 deduplication-use-case-3

personal Email 属性による重複排除を仮定した場合、エクスポートファイルには次のエントリが含まれます。 プロファイル Bは、オーディエンスに適格な最新のプロファイルなので、書き出されるのはプロファイル Bのみです。

重複排除のユースケース 4：2 つのプロファイル属性に基づく重複排除 deduplication-use-case-4

複合キー personalEmail + lastName による重複排除を仮定した場合、エクスポートファイルには次のエントリが含まれます。

CRM ID やメールアドレスなどの ID 名前空間を重複排除キーとして選択して、すべてのプロファイルレコードが必ず一意に識別されるようにすることをお勧めします。

同じタイムスタンプを持つプロファイルの重複排除の動作 deduplication-same-timestamp

プロファイルをファイルベースの宛先に書き出す場合、重複排除によって、複数のプロファイルが同じ重複排除キーと同じ参照タイムスタンプを共有する場合に、1つのプロファイルのみが書き出されます。 このタイムスタンプは、プロファイルのオーディエンスメンバーシップまたはID グラフが最後に更新された時点を表します。 プロファイルの更新およびエクスポート方法について詳しくは、​ プロファイルのエクスポート動作 ドキュメントを参照してください。

重要な考慮事項 key-considerations

重複排除キーがEmail列である次のデータを考えてみましょう。

重複排除の後、エクスポートファイルには次のものが含まれます。

説明: test1@test.comでは、両方のプロファイルが同じ重複排除キーとタイムスタンプを共有しています。 アルゴリズムは、first_nameとlast_name列の値を辞書的に並べ替えます。 名前は同じなので、タイはlast_name列を使用して解決されます。この列の前には「Doe」が表示されます。

信頼性の向上：この更新された重複排除プロセスにより、同じ座標を持つ連続した実行が常に同じ結果を生成し、一貫性が向上します。

計算フィールドを使用してデータ変換を実行する calculated-fields

計算フィールド ​ コントロールを使用して、ファイルベースの宛先に書き出されたデータに対して様々なデータ変換を実行できます。

既知の制限事項 known-limitations

新しい​マッピング ページには、次の既知の制限があります。

マッピングワークフローでオーディエンスメンバーシップ属性を選択できません audience-membership-attribute-mapping

既知の制限により、現在、フィールドを選択 ウィンドウを使用してsegmentMembership.seg_namespace.seg_id.statusをファイル書き出しに追加することはできません。 代わりに、手動で値 xdm: segmentMembership.seg_namespace.seg_id.status をスキーマフィールドに貼り付ける必要があります（下図を参照）。

ファイルのエクスポートは、segmentMembership.seg_namespace.seg_id.status が選択されているかどうかによって、次のように異なります。

ファイルベースの宛先に対する​ プロファイル書き出し動作の詳細をご確認ください。

ID 名前空間は現在、書き出し用に選択できません identity-namespaces-export-limitation

以下の画像に示すように、ID 名前空間を書き出し用に選択する機能は、現在サポートされていません。 書き出し用にID名前空間を選択すると、レビュー​手順でエラーが発生します。

ベータ版の間に書き出したファイルに ID 名前空間を追加する必要がある場合の一時的な回避策として、次のいずれかを実行できます。

プロファイル属性の選択 select-attributes

プロファイルベースの宛先の場合、ターゲット宛先に送信するプロファイル属性を選択する必要があります。

IMPORTANT

既知の制限により、現在、フィールドを選択 ウィンドウを使用してsegmentMembership.seg_namespace.seg_id.statusをファイル書き出しに追加することはできません。 代わりに、以下に示すように、値xdm: segmentMembership.seg_namespace.seg_id.statusをスキーマフィールドに手動で貼り付ける必要があります。

ファイルの書き出しは、segmentMembership.seg_namespace.seg_id.statusが選択されているかどうかに応じて、次のように異なります。

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

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

エンリッチメント属性の選択ステップを示す

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

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

エンリッチメント属性を除外トグルを示す

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

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

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

。

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

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

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

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

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

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

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

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

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

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

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

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

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

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

レビュー review

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

レビュー手順に

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

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

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

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

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

また、この手順では、ページで使用可能なフィルターを使用して、このワークフローの一部としてスケジュールまたはマッピングが更新されたオーディエンスのみを表示できます。 表示するテーブル列を切り替えることもできます。

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

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