プロファイル書き出しのバッチ宛先に対するオーディエンスデータの有効化

重要

データをアクティブ化するには、宛先の管理宛先のアクティブ化プロファイルの表示​および​セグメントの表示に対するアクセス制御権限が必要です。詳しくは、アクセス制御の概要または製品管理者に問い合わせて、必要な権限を取得してください。

改善されたファイル書き出し機能ベータプログラムに参加している一部のお客様には、新しい マッピング アクティベーションワークフローの一部として、 新しいベータクラウドストレージの宛先. また、 既知の制限事項 をリリースの一部として追加しました。

概要

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

前提条件

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

宛先を選択

  1. 接続/宛先​に移動し、「カタログ」タブを選択します。

    宛先カタログタブへのアクセス方法をハイライトした画像

  2. 以下に示す画像のように、セグメントをアクティベートする宛先に対応するカードで「セグメントのアクティベート」を選択します。

    「セグメントをアクティブ化」ボタンをハイライトした画像

  3. セグメントをアクティベートするために使用する宛先接続を選択し、「次へ」を選択します。

    セグメントをアクティブ化する 1 つまたは複数の宛先の選択方法をハイライトした画像

  4. 次のセクションの「セグメントを選択」に移動します。

セグメントを選択

セグメント名の左側にあるチェックボックスを使用して、宛先に対してアクティベートするセグメントを選択し、「次へ」を選択します。

アクティブ化する 1 つまたは複数のセグメントの選択方法をハイライトした画像

セグメントの書き出しをスケジュールする

Adobe Experience Platform は、メールマーケティングおよびクラウドストレージの宛先のデータを CSV ファイルの形式で書き出します。スケジュール​ページでは、書き出す各セグメントのスケジュールとファイル名を設定できます。スケジュールの設定は必須ですが、ファイル名の設定はオプションです。

重要

Adobe Experience Platform は、書き出しファイルを1 ファイルあたり 500 万件のレコード(行)で自動的に分割します。各行は 1 つのプロファイルを表します。

filename.csvfilename_2.csvfilename_3.csv のように、分割ファイル名には、ファイルが大きな書き出しの一部であることを示す数字が付加されます。

宛先に送信するセグメントに対応する​スケジュールを作成​ボタンを選択します。

「スケジュールを作成」ボタンをハイライトした画像

完全ファイルを書き出し

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

「完全なファイルを書き出し」切り替えを選択した UI の画像。

  1. 頻度」セレクターを使用して、書き出しの頻度を選択します。

    • 1 回:オンデマンドによる 1 回限りの完全ファイルの書き出しをスケジュールします。
    • 毎日:指定した時刻に、毎日 1 回、完全ファイルの書き出しをスケジュールします。
  2. 以下を使用: 時間 書き出しをセグメント評価の直後に実行するか、スケジュールに沿って、指定した時間に実行するかを切り替えます。 選択時に、 予定 オプションを選択すると、セレクターを使用して時刻 ( UTC 形式を指定します。

    メモ

    この セグメント評価後 以下に説明するオプションは、現在、一部のベータ版のお客様のみが利用できます。

    以下を使用: セグメント評価後 毎日の Platform バッチセグメント化ジョブが完了した直後にアクティベーションジョブを実行するオプション。 これにより、アクティベーションジョブが実行されると、最新のプロファイルが確実に宛先に書き出されます。

    バッチ保存先のアクティベーションフローの「セグメント評価後」オプションをハイライトした画像です。
    以下を使用: 予定 オプションを使用して、特定の時間にアクティベーションジョブを実行することができます。 これにより、Experience Platformプロファイルデータは毎日同時に書き出されますが、アクティベーションジョブが開始される前にバッチセグメントジョブが完了しているかどうかに応じて、書き出すプロファイルが最新ではない場合があります。

    バッチ保存先のアクティベーションフローの「スケジュール済み」オプションをハイライトし、時間セレクターを表示する画像です。

    重要

    内部の Experience Platform 処理の設定方法により、最初の増分ファイルまたは完全ファイルの書き出しにすべてのバックフィルデータが含まれない場合があります。

    完全ファイルと増分ファイルの両方で最新の完全なバックフィルデータの書き出しを確実に行うには、Adobe では、次の日の午後12時(GMT)以降に初回のファイル書き出し時間を設定することをお勧めします。この制限は、今後のリリースで対処される予定です。

  3. 日付」セレクターを使用して、書き出しを実行する日または間隔を選択します。日常の書き出しでのベストプラクティスは、開始日と終了日を、ダウンストリームプラットフォームのキャンペーンの期間に合わせて設定することです。

    重要

    書き出し間隔を選択する場合、その間隔の最終日は書き出しに含まれません。例えば、1月4日から 11日までの間隔を選択した場合、最後のファイルエクスポートは 1月10日に実行されます。

  4. 作成」を選択して、スケジュールを保存します。

増分ファイルの書き出し

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

重要

最初にエクスポートされた増分ファイルには、セグメントの対象となるすべてのプロファイルが含まれ、バックフィルとして機能します。

「増分ファイルを書き出し」切り替えを選択した UI の画像。

  1. 頻度​セレクターを使用して、エクスポートする頻度を選択します。

    • 毎日:増分ファイルのエクスポートを、毎日 1 回指定した時刻にスケジュールします。
    • 毎時:増分ファイルのエクスポートを、3 時間、6 時間、8 時間、または 12 時間ごとにスケジュールします。
  2. 時間​セレクターを使用して、エクスポートを実行する時刻を UTC 形式で指定します。

    重要

    内部の Experience Platform 処理の設定方法により、最初の増分ファイルまたは完全ファイルの書き出しにすべてのバックフィルデータが含まれない場合があります。

    完全ファイルと増分ファイルの両方で最新の完全なバックフィルデータの書き出しを確実に行うには、Adobe では、次の日の午後12時(GMT)以降に初回のファイル書き出し時間を設定することをお勧めします。この制限は、今後のリリースで対処される予定です。

  3. 日付​セレクターを使用して、エクスポートを実行する間隔を選択します。ベストプラクティスは、開始日と終了日を、ダウンストリームプラットフォームのキャンペーンの期間に合わせて設定することです。

    重要

    間隔の最終日はエクスポートに含まれません。例えば、1月4日から 11日までの間隔を選択した場合、最後のファイルエクスポートは 1月10日に実行されます。

  4. 作成」を選択して、スケジュールを保存します。

ファイル名の設定

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

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

メモ

次の画像は、のファイル名を編集する方法を示しています Amazon S3 の宛先の場合、プロセスはすべてのバッチ宛先 (SFTP、 Azure Blob Storageまたは Google Cloud Storage) をクリックします。

ファイル名の設定に使用される鉛筆アイコンをハイライトする画像。

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

使用可能なすべてのファイル名オプションを示す画像。

宛先名とセグメント ID をファイル名から削除することはできません。これらに加えて、次を追加できます。

ファイル名オプション 説明
セグメント名 書き出されたセグメントの名前。
日時 追加する項目を選択 MMDDYYYY_HHMMSS 形式または Unix の 10 桁のタイムスタンプ。 増分エクスポートのたびにファイル名を動的に生成したい場合は、次のオプションのいずれかを選択します。
カスタムテキスト ファイル名に追加するカスタムテキスト。
宛先 ID セグメントのエクスポートに使用する宛先データフローの ID。
注意:このファイル名追加オプションは、改善されたファイルエクスポート機能ベータプログラムに参加しているベータ版のお客様のみが利用できます。 ベータ版プログラムにアクセスする場合は、Adobe担当者またはカスタマーケアにお問い合わせください。
宛先名 セグメントのエクスポートに使用する宛先データフローの名前。
注意:このファイル名追加オプションは、改善されたファイルエクスポート機能ベータプログラムに参加しているベータ版のお客様のみが利用できます。 ベータ版プログラムにアクセスする場合は、Adobe担当者またはカスタマーケアにお問い合わせください。
組織名 組織内のExperience Platform名。
注意:このファイル名追加オプションは、改善されたファイルエクスポート機能ベータプログラムに参加しているベータ版のお客様のみが利用できます。 ベータ版プログラムにアクセスする場合は、Adobe担当者またはカスタマーケアにお問い合わせください。
サンドボックス名 セグメントの書き出しに使用するサンドボックスの ID。
注意:このファイル名追加オプションは、改善されたファイルエクスポート機能ベータプログラムに参加しているベータ版のお客様のみが利用できます。 ベータ版プログラムにアクセスする場合は、Adobe担当者またはカスタマーケアにお問い合わせください。

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

重要

日時​コンポーネントを選択しない場合、ファイル名は固定され、新しくエクスポートされたファイルは、エクスポートのたびに保存場所にある以前のファイルを上書きします。ストレージの場所からメールマーケティングプラットフォームへのインポートジョブを繰り返し実行する場合は、このオプションをお勧めします。

すべてのセグメントの設定が完了したら「次へ 」を選択して続行します。

プロファイル属性の選択

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

  1. 属性を選択​ページで「新しいフィールドを追加」を選択します。

    「新しいフィールドを追加」ボタンをハイライトした画像。

  2. スキーマフィールド」エントリの右側の矢印を選択します。

    ソースフィールドの選択方法をハイライトした画像。

  3. フィールドを選択​ページで、宛先に送信する XDM 属性を選択してから「選択」を選択します。

    ソースフィールドとして使用可能な様々なフィールドを示す画像。

  4. さらにマッピングを追加するには、手順 1 ~ 3 を繰り返します。

メモ

Adobe Experience Platform は、スキーマから推奨される一般的に使用される属性 4 つ(person.name.firstNameperson.name.lastNamepersonalEmail.addresssegmentMembership.status)を事前に選択します。

重要

既知の制限により、現在、 フィールドを選択 追加するウィンドウ segmentMembership.status をファイルエクスポートに追加します。 代わりに、手動で値を貼り付ける必要があります xdm: segmentMembership.status をスキーマフィールドに追加します(下図を参照)。

アクティベーションワークフローのマッピング手順でセグメントメンバーシップの回避策を示す画面記録。

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

  • segmentMembership.status フィールドを選択した場合、エクスポートされたファイルには、最初の完全スナップショットでは​アクティブ​メンバーが含まれ、その後の増分エクスポートでは​アクティブ​および​期限切れ​のメンバーが含まれます。
  • segmentMembership.status フィールドを選択しない場合、エクスポートされたファイルには、最初の完全スナップショットとその後の増分エクスポートで、アクティブ​メンバーのみが含まれます。

セグメントアクティベーションワークフローのマッピング手順で事前入力された推奨属性を示す画像。

必須の属性

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

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

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

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

重複排除キー

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

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

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

  • 重複排除キーとして、単一の ID 名前空間を使用する
  • 重複排除キーとして、XDM プロファイルから単一のプロファイル属性を使用する
  • 複合キーとして、XDM プロファイルから 2 つのプロファイル属性の組み合わせを使用する
重要

単一の ID 名前空間を宛先に書き出すことができ、名前空間は自動的に重複排除キーとして設定されます。複数の名前空間を宛先に送信することはサポートされていません。

ID 名前空間とプロファイル属性の組み合わせを重複排除キーとして使用することはできません。

重複排除の例

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

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

プロファイル A

{
  "identityMap": {
    "Email": [
      {
        "id": "johndoe_1@example.com"
      },
      {
        "id": "johndoe_2@example.com"
      }
    ]
  },
  "segmentMembership": {
    "ups": {
      "fa5c4622-6847-4199-8dd4-8b7c7c7ed1d6": {
        "status": "existing",
        "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": "existing",
        "lastQualificationTime": "2021-04-10 11:33:28"
      }
    }
  },
  "person": {
    "name": {
      "lastName": "D",
      "firstName": "John"
    }
  },
  "personalEmail": {
    "address": "johndoe@example.com"
  }
}

重複排除の使用例 1:重複排除なし

重複排除を使用しない場合、書き出しファイルには次のエントリが含まれます。

personalEmail firstName lastName
johndoe@example.com John Doe
johndoe@example.com John D

重複排除の使用例 2:ID 名前空間に基づく重複排除

Email 名前空間の重複排除を指定した場合、書き出しファイルには次のエントリが含まれます。プロファイル B はセグメントに適合する最新のプロファイルなので、唯一書き出されます。

メール* personalEmail firstName lastName
johndoe_1@example.com johndoe@example.com John D
johndoe_2@example.com johndoe@example.com John D

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

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

personalEmail* firstName lastName
johndoe@example.com John D

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

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

personalEmail* lastName* firstName
johndoe@example.com D John
johndoe@example.com Doe John

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

メモ

(データセット全体ではなく)データセット内の特定のフィールドのみに適用されたデータ使用ラベルがある場合、アクティベーション時のこれらのフィールドレベルラベルの適用は、次の条件で行われます。

  • これらのフィールドは、セグメント定義で使用されます。
  • フィールドは、ターゲット先の予測属性として設定されます。

例えば、フィールド person.name.firstName に宛先のマーケティングアクションと競合する特定のデータ使用ラベルがある場合、レビュー手順でデータ使用ポリシー違反が表示されます。詳しくは、Adobe Experience Platform でのデータガバナンスを参照してください。

(ベータ版)マッピング

重要

ベータ版のお客様は、 マッピング 次に代わる手順 プロファイル属性を選択 上記の手順を参照してください。 この新しい マッピング 手順では、必要なカスタム名に対して、書き出されたファイルのヘッダーを編集できます。

機能とドキュメントは変更される場合があります。 このベータ版プログラムにアクセスする場合は、Adobe担当者またはカスタマーケアにお問い合わせください。

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

  1. マッピング ページ、選択 新しいフィールドを追加.

    マッピングワークフローで強調表示されている新しいフィールドコントロールを追加します。

  2. 右側の矢印を選択します。 ソースフィールド エントリ。

    マッピングワークフローでハイライト表示されているソースフィールドコントロールを選択します。

  3. ソースフィールドを選択 ページで、書き出し先のファイルに含めるプロファイル属性と ID を選択し、「 」を選択します 選択.

    ヒント

    次の画像に示すように、検索フィールドを使用して、選択を絞り込むことができます。

    宛先に書き出すことができるプロファイル属性を示すモーダルウィンドウ。

  4. エクスポート用に選択したフィールドがマッピングビューに表示されます。 必要に応じて、書き出したファイルのヘッダーの名前を編集できます。 それには、「ターゲット」フィールドで「 」アイコンを選択します。

    宛先に書き出すことができるプロファイル属性を示すモーダルウィンドウ。

  5. ターゲットフィールドを選択 ページで、書き出したファイルのヘッダーの名前を入力し、 選択.

    ヘッダーの入力済みのわかりやすい名前を示すモーダルウィンドウ。

  6. エクスポート用に選択したフィールドがマッピングビューに表示され、編集したヘッダーがエクスポートされたファイルに表示されます。

    宛先に書き出すことができるプロファイル属性を示すモーダルウィンドウ。

  7. (オプション)エクスポートされたフィールドを選択して、 必須キー または 重複排除キー.

    宛先に書き出すことができるプロファイル属性を示すモーダルウィンドウ。

  8. 書き出すフィールドをさらに追加するには、上記の手順を繰り返します。

既知の制限事項

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

マッピングワークフローでは、セグメントメンバーシップ属性を選択できません

既知の制限により、現在、 フィールドを選択 追加するウィンドウ segmentMembership.status をファイルエクスポートに追加します。 代わりに、手動で値を貼り付ける必要があります xdm: segmentMembership.status をスキーマフィールドに追加します(下図を参照)。

アクティベーションワークフローのマッピング手順でセグメントメンバーシップの回避策を示す画面記録。

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

  • segmentMembership.status フィールドを選択した場合、エクスポートされたファイルには、最初の完全スナップショットでは​アクティブ​メンバーが含まれ、その後の増分エクスポートでは​アクティブ​および​期限切れ​のメンバーが含まれます。
  • segmentMembership.status フィールドを選択しない場合、エクスポートされたファイルには、最初の完全スナップショットとその後の増分エクスポートで、アクティブ​メンバーのみが含まれます。

ID 名前空間は、現在、エクスポート用に選択できません

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

ID エクスポートを示すサポートされていないマッピング

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

  • エクスポートに ID 名前空間を含めるデータフローに、従来のクラウドストレージの宛先を使用します
  • ID を属性としてExperience Platformにアップロードし、クラウドストレージの宛先に書き出します。

レビュー

確認」ページには、選択の概要が表示されます。「キャンセル」を選択してフローを分割するか、「戻る」を選択して設定を変更する、または、「完了」を選択して確定し、宛先へのデータの送信を開始します。

重要

このステップでは、Adobe 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.firstnameperson.lastnameperson.genderperson.birthyear および personalEmail.address が含まれています。

このページ