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

概要 overview

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

前提条件 prerequisites

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

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

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

CSV ファイルの書き出しでは、書き出したファイルの構造をより柔軟に指定できます。 詳しくは、CSV ファイルのファイル形式設定を参照してください。

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

宛先の選択 select-destination

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

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

接触チャネルに応じて、複数のタイプのオーディエンスから選択できます。

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

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

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

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

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

増分ファイルの書き出し

「増分ファイルのエクスポート」を選択して、エクスポートをトリガーにします。最初のファイルは、選択したオーディエンスに対するすべてのプロファイル資格の完全なスナップショットであり、それ以降のファイルは、前回のエクスポート以降の増分プロファイル資格です。

。

ファイル名の設定

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

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

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

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

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

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

マッピング mapping

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

必須の属性 mandatory-attributes

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

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

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

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

重複排除キー deduplication-keys

重複排除キーは、ユーザーがプロファイルの重複排除する ID を決定する、ユーザー定義のプライマリキーです。

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

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

重複排除の例 deduplication-example

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

次の 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"
  }
}

重複排除の使用例 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 名前空間を重複排除キーとして選択して、すべてのプロファイルレコードが必ず一意に識別されるようにすることをお勧めします。

[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 が選択されているかどうかによって、次のように異なります。

詳しくは、 ファイルベースの宛先のプロファイル書き出し動作を参照してください。

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

以下の画像に示すように、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に カスタムアップロード として取り込まれた、カスタムアップロードされたオーディエンスに対応します。 この手順では、選択した外部オーディエンスごとに、宛先に書き出す属性を選択できます。

各外部オーディエンスのエンリッチメント属性を選択するには、次の手順に従います。

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

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

レビュー 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 が含まれています。