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

重要

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

概要

この記事では、クラウドストレージやメールマーケティングの宛先など、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 ストレージなど)で同じです。

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

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

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

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

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

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

重要

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

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

プロファイル属性の選択

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

  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 の節を参照してください。

重複排除キー

重複排除キーは、ユーザーがプロファイルの重複排除する 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 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 が含まれています。

このページ