柔軟なバッチスケジュールによるバッチオーディエンス評価の管理

AVAILABILITY
柔軟なバッチスケジュールは現在、可用性の制限​で利用できます。 詳しくは、Adobe カスタマーケアにお問い合わせください。

バッチセグメンテーションは、プロファイルデータを一度に移動して、対応するオーディエンスを作成できる評価方法です。 以前は、こうしたバッチオーディエンスは、1日に1回実行される、単一の固定セグメンテーションジョブに依存していました。

柔軟なバッチスケジュールにより、オーディエンスを評価するタイミングを制御できます。これにより、評価のタイミングに柔軟に優先順位を付けることができるため、より多くのオーディエンスに適切に拡張できます。

スケジュールの作成 create-schedule

柔軟なバッチスケジュールを使用するには、まずオーディエンスのスケジュールを作成する必要があります。 Experience Platform UIまたはAPIを使用して、スケジュールを作成できます。

UI

Experience Platform UIを使用してスケジュールを作成するには、まずSegmentation Service ワークスペース内の​Evaluation セクションにアクセスする必要があります。

「顧客」セクション内の「オーディエンス」を選択し、続いて「評価」を選択します。

​ オーディエンスと評価ボタンがハイライト表示され、評価ページへのアクセス方法が表示されます。

評価 ページが表示され、組織内で現在利用可能なすべてのスケジュールが表示されます。 「スケジュールを作成」を選択して、スケジュールの作成を開始します。

評価ページ内で「スケジュールを作成」ボタンが強調表示されます。

スケジュールの作成 ポップオーバーが表示されます。 このポップオーバーで、スケジュールを実行する名前、ケイデンス、時刻など、スケジュールの詳細を入力できます。 必要なすべての詳細を入力したら、作成​を選択して続行します。

​ スケジュールの作成ポップオーバーが表示されます。

API

Experience Platform APIを使用してスケジュールを作成するには、/schedules エンドポイントにPOST リクエストを行う必要があります。

API 形式

code language-http
POST /schedules

リクエスト

accordion
スケジュールを作成するためのサンプルリクエスト。
code language-shell
curl -X POST https://platform.adobe.io/data/core/ups/config/schedules \
 -H 'Authorization: Bearer {ACCESS_TOKEN}' \
 -H 'Content-Type: application/json' \
 -H 'x-gw-ims-org-id: {ORG_ID}' \
 -H 'x-api-key: {API_KEY}' \
 -H 'x-sandbox-name: {SANDBOX_NAME}'
 -d '
{
    "name": "Weekly VIP refresh",
    "type": "batch_segmentation",
    "schedule": "0 0 10 * * ?",
    "properties": {
        "segments": [
            "sample-audience-1",
            "sample-audience-2"
        ]
    },
    "state": "active"
}'

スケジュールを作成するときは、名前、タイプ、スケジュール、そのスケジュールに属するオーディエンス、およびその状態を指定する必要があります。 APIを使用したスケジュールの作成について詳しくは、​ スケジュール エンドポイント ガイド ​を参照してください。

応答

accordion
スケジュールを作成する際の応答サンプル。
code language-json
{
  "id": "cd585edf-962d-420d-94ad-3be03e619ac2",
  "name": "Weekly VIP Refresh",
  "type": "batch_segmentation",
  "schedule": "0 0 10 * * ?",
  "frequency": "weekly",
  "state": "active",
  "properties": {
    "segments": ["sample-audience-1", "sample-audience-2"]
  }
}

応答が成功すると、HTTP ステータス 200が返され、新しく作成したスケジュールに関する情報が表示されます。 frequency フィールドは自動的に入力され、指定されたscheduleに基づきます。

スケジュールへのオーディエンスの割り当て assign-audience

スケジュールを作成したら、以前のスケジュールに追加のオーディエンスを割り当てることができます。 Experience Platform UIまたはAPIを使用して、オーディエンスを割り当てることができます。

UI

Experience Platform UIを使用してスケジュールにオーディエンスを割り当てるには、スケジュールの横にある 省略記号アイコン ​ を選択し、次に​ オーディエンスをスケジュール ​を選択します。

​ オーディエンスをスケジュール ボタンがハイライト表示されます。

「オーディエンスをスケジュール」ポップオーバーが表示されます。 スケジュールに追加するオーディエンスを選択し、スケジュール​を選択して、スケジュールの変更を確認します。

​ スケジュール オーディエンス ポップオーバーが表示されます。

API

Experience Platform APIを使用してオーディエンスをスケジュールに割り当てるには、/schedules/add-audiences エンドポイントにPOST リクエストを行う必要があります。

API 形式

code language-http
POST /schedules/add-audiences

リクエスト

accordion
スケジュールにオーディエンスを追加するためのサンプルリクエスト。
code language-shell
curl -X POST https://platform.adobe.io/data/core/ups/config/schedules/add-audiences \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'Content-Type: application/json' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -d '{
        "id": "cd585edf-962d-420d-94ad-3be03e619ac2",
        "segments": [
            "sample-audience-3",
            "sample-audience-4"
        ]
      }'

スケジュールにオーディエンスを追加する場合は、スケジュール IDと、スケジュールに追加するオーディエンスのIDを指定する必要があります。 スケジュールへのオーディエンスの追加について詳しくは、​ スケジュールエンドポイントガイド ​を参照してください。

応答

accordion
スケジュールにオーディエンスを追加する際の応答の成功。
code language-json
{
    "added": ["sample-audience-3", "sample-audience-4"],
    "existing": [],
    "invalid": [],
    "segmentCount": {
        "previous": 2,
        "current": 4,
        "diff": 2
    }
}

応答が成功すると、スケジュールに追加されたオーディエンスに関する情報を含むHTTP ステータス 200が返されます。

または、オーディエンス作成中にオーディエンスにスケジュールを割り当てることもできます。 オーディエンスビルダー内で、オーディエンスを保存した後、「オーディエンスプロパティ」セクションの​スケジュール セクションに移動し、 ​ カレンダーアイコン ​ を選択します。

オーディエンススケジュール ポップオーバーが表示されます。 このポップオーバーで、オーディエンスが属すべきスケジュールを割り当てることができます。

​ スケジュールの割り当てポップオーバーが表示され、オーディエンスがどのスケジュールに属しているかが表示されます。

オーディエンスのスケジュールを表示する view-audience-schedule

Experience Platform UIまたはAPIを使用して、オーディエンスがどのスケジュールに属しているかを確認できます。

UI
note
NOTE
Audience Builder​を使用して作成されたオーディエンスのスケジュールのみを表示できます。

Experience Platform UIを使用してオーディエンスが属するスケジュールを表示するには、​ オーディエンスポータル ​に移動し、オーディエンスを選択してから​ オーディエンスを編集 ​します。

オーディエンスビルダー内で、 ​ カレンダーアイコン ​ を選択します。 オーディエンスプロパティ セクションの​スケジュール セクション内に、オーディエンススケジュール ポップオーバーが表示されます。 このポップオーバーには、オーディエンスが属するスケジュールが表示され、オーディエンスが属するスケジュールを追加または削除できます。

​ スケジュールの割り当てポップオーバーが表示され、オーディエンスがどのスケジュールに属しているかが表示されます。

API

Experience Platform APIを使用してオーディエンスが属するスケジュールを表示するには、/schedules/audience-map エンドポイントにPOST リクエストを行います。

API 形式

code language-http
POST /schedules/audience-map

リクエスト

accordion
リストされたオーディエンスがどのスケジュールに属しているかを確認するためのサンプルリクエスト。
code language-shell
curl -X POST https://platform.adobe.io/data/core/ups/config/schedules/audience-map \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'Content-Type: application/json' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -d '{
        "segments": [
            "sample-audience-1",
            "sample-audience-2"
        ]
      }'

このエンドポイントを使用するには、スケジュールを表示するオーディエンスのIDを指定する必要があります。 オーディエンスが属するスケジュールの表示について詳しくは、​ スケジュールエンドポイントガイド ​を参照してください。

応答

accordion
オーディエンスのスケジュールを取得する際の応答が成功しました。
code language-json
{
  "audienceMap": {
    "sample-audience-1": ["cd585edf-962d-420d-94ad-3be03e619ac2"],
    "sample-audience-2": []
  },
  "schedules": {
    "cd585edf-962d-420d-94ad-3be03e619ac2": {
      "name": "Weekly VIP Refresh",
      "schedule": "0 0 10 * * ?",
      "frequency": "weekly"
    }
  }
}

応答が成功すると、HTTP ステータス 200が返され、リクエストされたオーディエンスが属するスケジュールに関する詳細情報が表示されます。

スケジュールからのオーディエンスの削除 remove-audience

作成済みのスケジュールからオーディエンスを削除する場合は、Experience Platform UIまたはAPIを使用できます。

UI

Experience Platform UIを使用してスケジュールからオーディエンスを削除するには、スケジュールの横にある 詳細アイコン ​ を選択し、次に​ オーディエンスをスケジュール ​を選択します。

​ オーディエンスをスケジュール ボタンがハイライト表示されます。

「オーディエンスをスケジュール」ポップオーバーが表示されます。 スケジュールから削除するオーディエンスを選択し、スケジュール​を選択して、スケジュールの変更を確認します。

​ スケジュール オーディエンス ポップオーバーが表示されます。

API

スケジュールからオーディエンスを削除するには、/schedules/remove-audiences エンドポイントにPOST リクエストを行う必要があります。

API 形式

code language-http
POST /schedules/remove-audiences

リクエスト

accordion
スケジュールからオーディエンスを削除するサンプルリクエスト
code language-shell
curl -X POST https://platform.adobe.io/data/core/ups/config/schedules/remove-audiences/
 -H 'Authorization: Bearer {ACCESS_TOKEN}' \
 -H 'x-gw-ims-org-id: {ORG_ID}' \
 -H 'x-api-key: {API_KEY}' \
 -H 'x-sandbox-name: {SANDBOX_NAME}'
 -d '
 {
    "id": "cd585edf-962d-420d-94ad-3be03e619ac2",
    "segments": [
        "sample-audience-1"
    ]
 }
 '

スケジュールからオーディエンスを削除する場合は、スケジュール IDと、スケジュールから削除するオーディエンスのIDを指定する必要があります。 スケジュールへのオーディエンスの削除について詳しくは、​ スケジュールエンドポイントガイド ​を参照してください。

応答

accordion
スケジュールからオーディエンスを削除する際の応答の成功。
code language-json
{
    "removed": ["sample-audience-1"],
    "existing": [],
    "invalid": [],
    "segmentCount": {
        "previous"
    }
}

スケジュールを手動で実行 run-manually

スケジュールの実行を待つ代わりに、Experience Platform UIまたはAPIを使用して、既存のスケジュールを手動でトリガーして実行できます。

UI

Experience Platform UIでスケジュールを手動で実行するには、評価 ページで評価するスケジュールの横にある 詳細アイコン ​ を選択し、続いて​ スケジュールの実行 ​を選択します。

​ スケジュールの実行ボタンがハイライト表示されます。

確認ポップアップが表示されます。 開始​を選択して、スケジュール実行をすぐに開始します。

実行スケジュール ポップオーバーが表示されます。

API

Experience Platform APIでスケジュールを手動で実行するには、/schedules/trigger エンドポイントにPOST リクエストを行う必要があります。

API 形式

code language-http
POST /schedules/trigger

リクエスト

accordion
スケジュールの評価をトリガーするサンプルリクエスト。
code language-shell
curl -X POST https://platform.adobe.io/data/core/ups/config/schedules/trigger \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'Content-Type: application/json' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -d '{
    "id": "cd585edf-962d-420d-94ad-3be03e619ac2"
    }'

スケジュールの評価をトリガーする場合は、評価するスケジュールのIDを指定する必要があります。 一度に1つのスケジュールを評価できるのは​のみです。 スケジュール評価のトリガーについて詳しくは、​ スケジュールエンドポイントガイド ​を参照してください。

応答

応答が成功すると、コンテンツなしでHTTP ステータス 200が返されます。

スケジュールを有効または無効にする

Experience Platform UIまたはAPIを使用して、スケジュールを有効または無効にできます。

UI

Experience Platform UIを使用してスケジュールを有効または無効にするには、スケジュールの横にある 詳細アイコン ​ を選択します。 現在無効になっているスケジュールを有効にする場合は、「有効にする」を選択します。 現在有効になっているスケジュールを無効にする場合は、無効​を選択します。

​ スケジュールを無効にするボタンが強調表示されます。

API

Experience Platform APIを使用してスケジュールを有効または無効にするには、更新するスケジュールのIDを指定して、/schedules エンドポイントに対してPATCH リクエストを行う必要があります。

API 形式

code language-http
PATCH /schedules/{SCHEDULE_ID}

リクエスト

accordion
スケジュールを更新するためのサンプルリクエスト
code language-shell
curl -X PATCH https://platform.adobe.io/data/core/ups/config/schedules/cd585edf-962d-420d-94ad-3be03e619ac2 \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'Content-Type: application/json' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -d '[
        {
            "op": "replace",
            "path": "/state",
            "value": "inactive"
        }
      ]'

スケジュールを更新する場合は、スケジュールの操作、パス、値を指定する必要があります。 無効なスケジュールを有効にする場合は、valueをactiveに設定する必要があります。 有効なスケジュールを無効にする場合は、valueをinactiveに設定する必要があります。 スケジュールの更新について詳しくは、​ スケジュールエンドポイントガイド ​を参照してください。

応答

応答が成功すると、コンテンツなしでHTTP ステータス 204が返されます。

次の手順

このガイドでは、Experience Platform APIまたはUIを使用して、柔軟なバッチスケジュールを使用する方法を説明しました。 柔軟なバッチスケジュール UIについて詳しくは、​ セグメント化サービス UIの概要を参照してください。 スケジュール APIについて詳しくは、​ スケジュール エンドポイント ガイド ​を参照してください。 柔軟なバッチスケジュールがキャパシティとクレジットでどのように機能するかについては、​ ライセンスの使用状況とキャパシティの概要を参照してください。

ビデオ video

次のビデオでは、評価 タブ内で柔軟なバッチスケジュールを使用する方法、カスタムスケジュールの作成、セグメント化ジョブの監視、クレジットの管理方法を説明します。

付録 appendix

次の付録では、クロススケジュール依存関係の仕組みと、柔軟なバッチスケジュールに関するよくある質問を示します。

クロススケジュールの依存関係 cross-schedule-dependencies

あるオーディエンスが別のオーディエンスを依存関係として参照している場合、その依存関係により、そのオーディエンスを属していないスケジュールに取り込むことができます。

次の4つのオーディエンスと2つのスケジュールについて検討します。

スケジュール A: オーディエンス 1、オーディエンス 4
スケジュール B:オーディエンス 2、オーディエンス 3

オーディエンス 1は、依存関係を介してオーディエンス 2を参照するので、オーディエンス 1 には、オーディエンス 2の評価メンバーシップが必要です。独自のメンバーシップを計算してください。

スケジュール Aが実行されると、Audience 1とAudience 4は期待どおりに評価されます。 ただし、Audience 2はAudience 1の依存関係であるため、Audience 2 も​実行されます。

スケジュール Bが実行されると、オーディエンス 2とオーディエンス 3は期待どおりに評価されます。 このシナリオでは、Audience 2はAudience 1に依存しないため、Audience 1は​ not ​評価されます。

その結果、他のオーディエンスの依存関係にあるオーディエンス(上記のシナリオのオーディエンス 2など)であるオーディエンス may​は、1日に1回以上、スケジュールされた評価の一部として1回、他のオーディエンスに依存するオーディエンスのスケジュールの一部として1回以上評価されます。

よくある質問 faq

現在使用している日次の評価を引き続き使用するには、何か操作する必要がありますか?

回答
いいえ。 システムスケジュールは自動的に実行され続けます。 カスタムスケジュールを作成しない限り、何も変更されません。

オーディエンスを複数のカスタムスケジュールに割り当てることはできますか?

回答
はい。 1つのオーディエンスを複数のカスタムスケジュールに割り当てることができます。

ストリーミングオーディエンスまたはエッジオーディエンスはカスタムスケジュールを使用できますか?

回答
いいえ。 ストリーミングオーディエンスとエッジオーディエンスは、常にシステムスケジュールで評価されます。

カスタムスケジュールにオーディエンス構成を割り当てることはできますか?

回答
いいえ。 オーディエンスの構成は、システムスケジュールの一部として自動的に評価されます。 これには、コンポジションの一部である内部オーディエンスが含まれます。

実行できるスケジュールの数は?

回答
1日に最大4つのスケジュールを実行できます。 この​ には、システム スケジュールが ​含まれています。

4,000人を超えるバッチオーディエンスを作成するには、柔軟なバッチスケジュールが必要ですか?

回答
はい。 10,000人のバッチオーディエンスを抱えるには、柔軟なバッチスケジュールが必要です。

カスタムスケジュールの作成には費用がかかりますか?

回答
Experience Platformには、1週間のカスタムスケジュール(52回のスケジュール実行)が含まれています。 さらに、システムのスケジュールは常に無料です。 追加のカスタムスケジュールを作成する場合、追加のスケジュールされた実行はクレジットを消費します。 詳しくは、​ ライセンスの使用状況と容量の概要を参照してください。

スケジュールが実行されたかどうかを確認するにはどうすればよいですか?

回答
スケジュールがセグメント化ジョブ監視ビュー内で実行されたかどうかを確認できます。 監視​を選択し、ダッシュボード、オーディエンス、セグメント化ジョブ​を選択します。 ここから、スケジュールが実行された時間の横にある ​ フィルターアイコン ​ を選択すると、スケジュールで評価されたオーディエンスのリストが表示されます。
recommendation-more-help
experience-platform-help-segmentation