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

概要

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

前提条件

宛先に対してデータをアクティブ化するには、次の条件を満たしている必要があります。 宛先に接続されている. まだおこなっていない場合は、 宛先カタログ、サポートされている宛先を参照し、使用する宛先を設定します。

宛先を選択

  1. に移動します。 接続/宛先​をクリックし、 カタログ タブをクリックします。

    「宛先カタログ」タブ

  2. 選択 セグメントのアクティブ化 を選択します。

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

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

    宛先を選択

  4. 次のセクションに移動: セグメントを選択.

セグメントを選択

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

セグメントを選択

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

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

重要

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

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

を選択します。 スケジュールを作成 ボタンをクリックします。

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

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

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

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

  1. 以下を使用: 頻度 書き出し頻度を選択するセレクター:

    • 1 回:1 回のオンデマンドフルファイル書き出しをスケジュールします。
    • 毎日:指定した時刻に、毎日 1 回、ファイルの完全なエクスポートをスケジュールします。
  2. 以下を使用: 時間 時刻を選択するセレクター ( ) UTC 形式を指定します。

    重要

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

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

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

    重要

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

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

増分ファイルの書き出し

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

重要

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

増分ファイルの書き出し

  1. 以下を使用: 頻度 書き出し頻度を選択するセレクター:

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

    重要

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

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

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

    重要

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

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

ファイル名の設定

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

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

ファイル名を設定

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

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

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

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

選択 変更を適用 をクリックして選択を確定します。

重要

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

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

プロファイル属性を選択

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

  1. 属性を選択 ページ、選択 新しいフィールドを追加.

    新しいマッピングを追加

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

    ソースフィールドを選択

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

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

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

メモ

Adobe Experience Platformは、スキーマの 4 つの推奨される、一般的に使用される属性を事前に選択します。 person.name.firstName, person.name.lastName, personalEmail.address, segmentMembership.status.

ファイルの書き出しは、 segmentMembership.status が選択されている場合:

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

推奨属性

必須の属性

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

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

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

属性の 1 つを 一意の ID スキーマから。 必須属性について詳しくは、 電子メールマーケティングの宛先 ドキュメント。

重複排除キー

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

重複排除キーを使用すると、同じプロファイルの複数のレコードが 1 つのエクスポートファイルに含まれる可能性がなくなります。

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

  • 単一の ID 名前空間をとして使用 重複排除キー
  • 単一のプロファイル属性を XDM as a のプロファイル 重複排除キー
  • 1 つの XDM 複合キーとしてのプロファイル
重要

単一の 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 はセグメントに適合する最新のものなので、書き出されるのは 1 つだけです。

メール* 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 はセグメントに適合する最新のものなので、書き出されるのは 1 つだけです。

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は、などの ID 名前空間を選択することをお勧めします CRM 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.firstname, person.lastname, person.gender, person.birthyear、および personalEmail.address.

このページ