柔軟なオーディエンス評価ガイド

AVAILABILITY
柔軟なオーディエンスの評価は、Microsoft Azureで実行中のExperience Platformのインスタンスで​ のみ ​利用できます。 サポートされているExperience Platform インフラストラクチャについて詳しくは、Experience Platform マルチクラウドの概要を参照してください。
さらに、柔軟なオーディエンス評価は、のみ​でReal-Time CDP B2C EditionおよびAdobe Journey Optimizerで使用できます。

柔軟なオーディエンス評価により、バッチ方式のセグメンテーションジョブをオンデマンドで実行できます。 柔軟なオーディエンス評価により、高度なキャンペーンの立ち上げやジャストインタイムのコミュニケーションなど、時間に制限のあるアクティビティを実行できます。

ガードレール guardrails

柔軟なオーディエンス評価を実行する場合は、次の条件を考慮してください。

  • 柔軟なオーディエンス評価は、サンドボックスごとに1日あたり​ 2回 ​のみ使用できます。 この制限は、午前0時(UTC)にリセットされます。
  • 実稼動 サンドボックスごとに、年間50回の柔軟なオーディエンス評価を実行する​ 最大 ​があります。
    • 1年とは、柔軟なオーディエンス評価を行うために、Experience Platform契約の日付から1年と定義されます。 例えば、5月18日に契約を開始した場合、柔軟なオーディエンス評価の実行数は5月18日ごとにリセットされます。
  • 開発 サンドボックスごとに、年間​ 最大 ​件の柔軟なオーディエンス評価が100回実行されます。
    • 1年とは、柔軟なオーディエンス評価を行うために、Experience Platform契約の日付から1年と定義されます。 例えば、5月18日に契約を開始した場合、柔軟なオーディエンス評価の実行数は5月18日ごとにリセットされます。
  • すべてのオーディエンス は、「セグメント化サービス」のオリジンを持っている必要があります。
  • すべてのオーディエンス は、バッチセグメント化を使用して評価する必要があります
  • すべてのオーディエンス は、ピープルベースのオーディエンスである必要があります
  • 柔軟なオーディエンス評価の実行ごとに選択できるオーディエンスは、最大20個までです。
NOTE
年に1回、柔軟なオーディエンス評価を追加購入できます。 詳しくは、Adobe カスタマーケアにお問い合わせください。

アクセス access

柔軟なオーディエンス評価を使用するには、次の権限が必要です。

  • ​Profile Management​」セクションの「」に対するセグメントの評価。

役割ベースのアクセス制御について詳しくは、​ アクセス制御の概要を参照してください。

柔軟なオーディエンス評価の実行

Experience Platform APIまたはUIを使用して、柔軟なオーディエンス評価を実行できます。

Experience Platform API

Experience Platform API内で柔軟にオーディエンスの評価を実行するには、評価するすべてのセグメント定義(オーディエンス)のIDを含むセグメントジョブを作成する必要があります。

note
NOTE
セグメント ジョブ API呼び出しごとに追加できるセグメント定義IDは、20個のうち​ 最大 ​個までです。

/segment/jobs エンドポイントにPOST リクエストを行い、リクエスト本文にセグメント定義のIDを含めることで、新しいセグメントジョブを作成できます。

accordion
新しいセグメントジョブを作成するためのサンプルリクエスト
code language-shell
curl -X POST https://platform.adobe.io/data/core/ups/segment/jobs \
 -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 '[
    {
        "segmentId": "7863c010-e092-41c8-ae5e-9e533186752e"
    },
    {
        "segmentId": "07d39471-05d1-4083-a310-d96978fd7c85"
    }
 ]'
table 0-row-2 1-row-2
プロパティ 説明
segmentId 評価するセグメント定義のID。 これらのセグメント定義は、様々な結合ポリシーに属することができます。

応答が成功すると、HTTP ステータス 200が、新しく作成したセグメントジョブに関する情報と共に返されます。

accordion
新しいセグメントジョブを作成する際の応答のサンプル。
code language-json
{
    "id": "b31aed3d-b3b1-4613-98c6-7d3846e8d48f",
    "imsOrgId": "{ORG_ID}",
    "sandbox": {
        "sandboxId": "28e74200-e3de-11e9-8f5d-7f27416c5f0d",
        "sandboxName": "prod",
        "type": "production",
        "default": true
    },
    "profileInstanceId": "ups",
    "source": "api",
    "status": "PROCESSING",
    "batchId": "678f53bc-e21d-4c47-a7ec-5ad0064f8e4c",
    "computeJobId": 8811,
    "computeGatewayJobId": "9ea97b25-a0f5-410e-ae87-b2d85e58f399",
    "segments": [
        {
            "segmentId": "7863c010-e092-41c8-ae5e-9e533186752e",
            "segment": {
                "id": "7863c010-e092-41c8-ae5e-9e533186752e",
                "expression": {
                    "type": "PQL",
                    "format": "pql/json",
                    "value": "workAddress.country = \"US\""
                },
                "mergePolicyId": "25c548a0-ca7f-4dcd-81d5-997642f178b9",
                "mergePolicy": {
                    "id": "25c548a0-ca7f-4dcd-81d5-997642f178b9",
                    "version": 1
                }
            }
        },
        {
            "segmentId": "07d39471-05d1-4083-a310-d96978fd7c85",
            "segment": {
                "id": "07d39471-05d1-4083-a310-d96978fd7c85",
                "expression": {
                    "type": "PQL",
                    "format": "pql/json",
                    "value": "workAddress.country = \"US\""
                },
                "mergePolicyId": "25c548a0-ca7f-4dcd-81d5-997642f178b9",
                "mergePolicy": {
                    "id": "25c548a0-ca7f-4dcd-81d5-997642f178b9",
                    "version": 1
                }
            }
        }
    ],
    "metrics": {
        "totalTime": {
            "startTimeInMs": 1573203617195,
            "endTimeInMs": 1573204395655,
            "totalTimeInMs": 778460
        },
        "profileSegmentationTime": {
            "startTimeInMs": 1573204266727,
            "endTimeInMs": 1573204395655,
            "totalTimeInMs": 128928
        },
        "segmentedProfileCounter":{
            "7863c010-e092-41c8-ae5e-9e533186752e":1033
        },
        "segmentedProfileByNamespaceCounter":{
            "7863c010-e092-41c8-ae5e-9e533186752e":{
                "tenantiduserobjid":1033,
                "campaign_profile_mscom_mkt_prod2":1033
            }
        },
        "segmentedProfileByStatusCounter":{
            "7863c010-e092-41c8-ae5e-9e533186752e":{
                "exited":144646,
                "realized":2056
            }
        },
        "totalProfiles":13146432,
        "totalProfilesByMergePolicy":{
            "25c548a0-ca7f-4dcd-81d5-997642f178b9":13146432
        }
    },
    "requestId": "4e538382-dbd8-449e-988a-4ac639ebe72b-1573203600264",
    "schema": {
        "name": "_xdm.context.profile"
    },
    "properties": {
        "scheduleId": "4e538382-dbd8-449e-988a-4ac639ebe72b",
        "runId": "e6c1308d-0d4b-4246-b2eb-43697b50a149"
    },
    "_links": {
        "cancel": {
            "href": "/segment/jobs/b31aed3d-b3b1-4613-98c6-7d3846e8d48f",
            "method": "DELETE"
        },
        "checkStatus": {
            "href": "/segment/jobs/b31aed3d-b3b1-4613-98c6-7d3846e8d48f",
            "method": "GET"
        }
    },
    "updateTime": 1573204395000,
    "creationTime": 1573203600535,
    "updateEpoch": 1573204395
}

セグメントジョブを作成した後、新しく作成したセグメントジョブのIDをリクエストパスに指定して、/segment/jobs エンドポイントにGET リクエストを行うことで、そのステータスを確認できます。

accordion
セグメントジョブを取得するリクエストのサンプル
code language-shell
curl -X GET https://platform.adobe.io/data/core/ups/segment/jobs/b31aed3d-b3b1-4613-98c6-7d3846e8d48f \
 -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}'

正常な応答は、HTTP ステータス 200 と、指定したセグメントジョブに関する詳細情報を返します。

accordion
セグメントジョブを取得するための応答のサンプル。
code language-json
{
    "id": "b31aed3d-b3b1-4613-98c6-7d3846e8d48f",
    "imsOrgId": "{ORG_ID}",
    "sandbox": {
        "sandboxId": "28e74200-e3de-11e9-8f5d-7f27416c5f0d",
        "sandboxName": "prod",
        "type": "production",
        "default": true
    },
    "profileInstanceId": "ups",
    "source": "api",
    "status": "SUCCEEDED",
    "batchId": "678f53bc-e21d-4c47-a7ec-5ad0064f8e4c",
    "computeJobId": 8811,
    "computeGatewayJobId": "9ea97b25-a0f5-410e-ae87-b2d85e58f399",
    "segments": [
        {
            "segmentId": "7863c010-e092-41c8-ae5e-9e533186752e",
            "segment": {
                "id": "7863c010-e092-41c8-ae5e-9e533186752e",
                "expression": {
                    "type": "PQL",
                    "format": "pql/text",
                    "value": "workAddress.country = \"US\""
                },
                "mergePolicyId": "25c548a0-ca7f-4dcd-81d5-997642f178b9",
                "mergePolicy": {
                    "id": "25c548a0-ca7f-4dcd-81d5-997642f178b9",
                    "version": 1
                }
            }
        },
        {
            "segmentId": "07d39471-05d1-4083-a310-d96978fd7c85",
            "segment": {
                "id": "07d39471-05d1-4083-a310-d96978fd7c85",
                "expression": {
                    "type": "PQL",
                    "format": "pql/json",
                    "value": "workAddress.country = \"US\""
                },
                "mergePolicyId": "25c548a0-ca7f-4dcd-81d5-997642f178b9",
                "mergePolicy": {
                    "id": "25c548a0-ca7f-4dcd-81d5-997642f178b9",
                    "version": 1
                }
            }
        }
    ],
    "metrics": {
        "totalTime": {
            "startTimeInMs": 1579304313411
        },
        "profileSegmentationTime": {}
    },
    "requestId": "4e538382-dbd8-449e-988a-4ac639ebe72b-1573203600264",
    "schema": {
        "name": "_xdm.context.profile"
    },
    "_links": {
        "cancel": {
            "href": "/segment/jobs/d3b4a50d-dfea-43eb-9fca-557ea53771fd",
            "method": "DELETE"
        },
        "checkStatus": {
            "href": "/segment/jobs/d3b4a50d-dfea-43eb-9fca-557ea53771fd",
            "method": "GET"
        }
    },
    "updateTime": 1579304339000,
    "creationTime": 1579304260897,
    "updateEpoch": 1579304339
}
Experience Platform UI

Experience Platform UI内で柔軟なオーディエンス評価を実行するには、顧客 セクションの​ オーディエンス ​を選択します。

顧客セクション内の「オーディエンス」ボタンがハイライト表示されます。 顧客プロファイルのオーディエンスポータルが表示されます。

オーディエンスポータルが表示され、組織のすべての人物オーディエンスのリストが表示されます。 オーディエンスポータルで、評価するオーディエンスを選択し、オーディエンスを評価​を選択できます。

柔軟なオーディエンス評価を使用するオーディエンスが選択されています。

オンデマンドでオーディエンスを評価する ポップオーバーが表示され、オンデマンドセグメントジョブで評価されるオーディエンスのリストが表示されます。 オーディエンスがオンデマンドで評価する資格がない場合、評価ジョブから自動的に削除されます。 リストされたオーディエンスが、評価するオーディエンスであることを確認します。

柔軟なオーディエンス評価を使用して評価できるオーディエンスが表示されます。

正しいオーディエンスがリストされていることを確認したら、リクエストを続行し、柔軟なオーディエンス評価を開始します。 このオーディエンス評価のステータスは、評価ジョブ監視ビューで確認できます。

note
NOTE
セグメントジョブのステータスは、監視ダッシュボード内の「キュー済み」状態としてレポートされる場合があります。 /segment/jobs エンドポイントにGET リクエストを実行し、リクエストパスにセグメントジョブのIDを指定することで、セグメントジョブの最新のステータスを表示できます。 このエンドポイントの使用について詳しくは、「API」タブを参照してください。
柔軟なオーディエンス評価を実行し、評価でオーディエンスを宛先にアクティベートする場合は、頻度が​ セグメント評価の後 ​に設定されていることを確認する必要があります。 セグメント評価🔗の後にアクティブ化するように既に設定されているオーディエンスに対して柔軟なオーディエンス評価を実行すると、以前の日常的なアクティブ化ジョブに関係なく、柔軟なオーディエンス評価ジョブが終了するとすぐにオーディエンスがアクティブ化されます。

ビデオ video

次のビデオでは、Experience Platformで柔軟なオーディエンス評価にアクセスして使用する方法を示します。

よくある質問 faq

次の節では、柔軟なオーディエンス評価に関するよくある質問を示します。

柔軟なオーディエンス評価を使用して、どの程度すばやくオーディエンスをアクティベートできますか?

回答
作成直後に柔軟なオーディエンス評価を使用して、オーディエンスをアクティベートできます。

柔軟なオーディエンス評価にはどのくらいの時間がかかりますか?

回答
柔軟なオーディエンス評価ジョブは、完了までに最大4時間かかる場合があります。

柔軟なオーディエンス評価でスケジュールを実行できますか?

回答
いいえ。柔軟なオーディエンス評価では、スケジュールを使用できません。

柔軟なオーディエンス評価を使用する場合、追加の書き出しジョブを実行する必要がありますか?

回答
いいえ。書き出しジョブは、対応するセグメントジョブが完了すると自動的に実行されます。

柔軟なオーディエンス評価で評価されるサービスにはどのようなものがありますか?

回答
配信先やAdobe Journey Optimizerのジャーニーを含む、あらゆるダウンストリームサービスでオーディエンスを使用できます。

柔軟なオーディエンス評価制限はいつリセットされますか?

回答
1日の制限は、午前0時(UTC)にリセットされます。 年間制限は、契約の契約応当日にリセットされます。

柔軟なオーディエンス評価でサポートされているオーディエンスの種類?

回答
柔軟なオーディエンス評価がサポートされるのは、セグメント化サービスのオリジンを持つオーディエンスのみです。 コンポジション、カスタムアップロード、Data Distillerなどの他のオーディエンスは、柔軟なオーディエンス評価ではサポートされていません。

柔軟なオーディエンス評価の実行カウントに貢献する要因は何ですか?

回答
APIまたはUIを使用して作成された柔軟なオーディエンス評価の実行は、最大数に達するまでカウントされます。 ただし、夜間に実行される毎日のバッチセグメント化ジョブ実行は、この制限に貢献する​ not ​です。

柔軟なオーディエンス評価でメインオーディエンスを評価する際に、すべての依存オーディエンスを評価する必要がありますか?

回答
いいえ。 柔軟なオーディエンス評価では、すべての依存オーディエンスが自動的に評価されます。 例えば、オーディエンス Aがオーディエンス Bに依存している場合は、オーディエンス Bを評価するだけで済みます。柔軟なオーディエンス評価では、オーディエンス Aを自動的に評価し、オーディエンス Bを自動的に評価します。
recommendation-more-help
experience-platform-help-segmentation