プロファイルの一括書き出し先に対するオーディエンスデータのアクティブ化

概要

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

前提条件

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

宛先の選択

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

    「宛先カタログ」タブ

  2. 次の図に示すように、セグメントをアクティブ化する宛先に対応するカードで「セグメントをアクティブ化」を選択します。

    「セグメントをアクティブ化」ボタン

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

    宛先の選択

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

セグメントの選択

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

セグメントの選択

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

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

重要

Adobe Experience Platform は、エクスポートファイルを 1 ファイルあたり 500 万レコード(行)に自動的に分割します。各行は、1 つのプロファイルを表します。

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

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

「スケジュールを作成」ボタン

完全なファイルの書き出し

完全なファイルをエクスポート」を選択して、選択したセグメントのすべてのプロファイル認定の完全なスナップショットを含むファイルのエクスポートをトリガーします。

完全なファイルの書き出し

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

    • 1 回:1 回のオンデマンドフルファイルエクスポートをスケジュールします。
    • 毎日:指定した時刻に、1 日に 1 回フルファイルエクスポートをスケジュールします。
  2. 時刻 セレクターを使用して、エクスポートを実行する時刻を UTC 形式で選択します。

    重要

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

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

  3. 日付 セレクターを使用して、エクスポートを実行する日または間隔を選択します。

    ヒント

    日別のエクスポートの場合は、開始日と終了日を、ダウンストリームプラットフォームのキャンペーン期間に合わせて設定します。

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

増分ファイルの書き出し

増分ファイルを書き出し」を選択して書き出しをトリガーします。最初のファイルは、選択したセグメントのすべてのプロファイル認定の完全なスナップショットで、後続のファイルは、前回の書き出し以降の増分プロファイル認定です。

重要

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

増分ファイルの書き出し

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

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

    重要

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

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

  3. 日付 セレクターを使用して、エクスポートを実行する日または間隔を選択します。

    ヒント

    開始日と終了日を、ダウンストリームプラットフォームのキャンペーン期間に合わせて設定します。

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

ファイル名の設定

デフォルトのファイル名は、宛先名、セグメント ID、日時インジケーターで構成されます。 例えば、エクスポートしたファイル名を編集して、異なるキャンペーンを区別したり、データのエクスポート時間をファイルに追加したりできます。

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

ファイル名の設定

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

ファイル名のオプションの編集

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

  • セグメント名:ファイル名にセグメント名を追加できます。
  • 日時:形式を追加する MMDDYYYY_HHMMSS か、ファイルが生成された時刻の 10 桁のタイムスタンプを Unix に追加するかを選択します。各増分エクスポートで生成される動的ファイル名をファイルに設定する場合は、次のオプションのいずれかを選択します。
  • カスタムテキスト:ファイル名にカスタムテキストを追加します。

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

重要

日付と時刻 コンポーネントを選択しない場合、ファイル名は静的になり、新しく書き出されたファイルによって、保存場所にある以前のファイルが書き出しごとに上書きされます。 ストレージの場所から電子メールマーケティングプラットフォームに繰り返しインポートジョブを実行する場合は、このオプションをお勧めします。

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

プロファイル属性の選択

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

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

    新しいマッピングの追加

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

    ソースフィールドの選択

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

    ソースフィールドページを選択

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

メモ

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

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

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

推奨属性

必須属性

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

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

必須属性を選択しない場合、属性に関係なく、すべての認定済みプロファイルがエクスポートされます。

属性の 1 つは、スキーマの 一意の識別子 にすることをお勧めします。 必須属性について詳しくは、 電子メールマーケティングの宛先 ドキュメントの 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 はセグメントに適合する最新のものなので、書き出されるのはプロファイル 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 はセグメントに適合する最新のものなので、書き出されるのはプロファイル 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

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

メモ

データセット内の特定のフィールド(データセット全体ではなく)にデータ使用ラベルが適用されている場合、アクティブ化時にこれらのフィールドレベルのラベルが適用されるのは、次の条件下です。

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

例えば、フィールド person.name.firstName に、宛先のマーケティングアクションと競合する特定のデータ使用ラベルがある場合、レビュー手順でデータ使用ポリシー違反が表示されます。 詳しくは、「Adobe 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.birthyearpersonalEmail.address が含まれます。

このページ