灵活的受众评估指南

AVAILABILITY
灵活的受众评估是​仅限,在Microsoft Azure上运行的Experience Platform实例上可用。 要了解有关支持的Experience Platform基础架构的更多信息,请参阅Experience Platform multi-cloud概述
Additionally, flexible audience evaluation is only available for use with Real-Time CDP B2C Edition.

Flexible audience evaluation lets you run a batch segmentation job on demand. With flexible audience evaluation, you can run ad-hoc campaign launches, just-in-time communications, or other time-sensitive activities.

护栏 guardrails

在运行灵活的受众评估时,请牢记以下条件:

  • 每个沙盒每天只能使用灵活的受众评估​两次。 此限制在午夜(UTC)重置。
  • 每​ 生产 ​沙盒每年最多可运行​个50次灵活的受众评估
    • 一年定义为从Experience Platform合同之日起的一年,以便灵活评估受众。 例如,如果您的合同从5月18日开始,则您的灵活受众评估运行数将每5月18日重置一次。
  • 您每​ 开发 ​沙盒每年最多有​ ​运行100次灵活受众评估。
    • 年份的定义为从Experience Platform合同签订之日起的一年,以便进行灵活的受众评估。 例如,如果您从5月18日开始合同,则您的灵活受众评估运行次数将每隔5月18日重置一次。
  • 所有受众​ 都必须 ​具有“分段服务”的来源。
  • 必须使用批处理分段评估所有受众​
  • 所有受众​ 必须 ​是基于人员的受众。
  • You can only select a maximum of 20 audiences per flexible audience evaluation run.
NOTE
You can purchase additional flexible audience evaluation runs per year. For more information, contact Adobe Customer Care.

访问 access

要使用灵活的受众评估,您必须具有以下权限:

  • Evaluate Segment to an Audience​部分下的​Profile Management

For more information on role-based access control, please read the access control overview.

Running flexible audience evaluation

You can run flexible audience evaluation by using either the Experience Platform APIs or UI.

Experience Platform APIs

To run flexible audience evaluation within the Experience Platform APIs, you'll need to create a segment job that contains the IDs of all the segment definitions (audiences) you want to evaluate.

note note
NOTE
You can only add a maximum of 20 segment definition IDs per segment job API call.

您可以通过向/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
}

创建区段作业后,您可以通过向/segment/jobs端点发出GET请求来检查其状态,在请求路径中提供新创建的区段作业的ID。

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
A sample response for retrieving a segment job.
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中运行灵活的受众评估,请在​ Audiences ​部分中选择​Customers

“客户”部分中的“受众”按钮高亮显示。 将显示客户配置文件的受众门户。

此时将显示“受众门户”,其中包含组织内所有人员受众的列表。 在Audience Portal中,您可以选择要评估的受众并选择​Evaluate audience

已选择您要对其使用灵活受众评估的受众。

此时将显示​ Evaluate audiences on demand ​弹出框,其中显示了将使用按需区段作业评估的受众列表。 如果受众不符合按需评估的条件,则它将被自动从评估作业中删除。 确认列出的受众就是您要评估的受众。

显示可以使用灵活受众评估进行评估的受众。

确认列出的受众正确后,您可以继续处理请求,并开始进行灵活的受众评估。 您可以在评估作业监视视图中查看此受众评估的状态。

note note
NOTE
区段作业的状态可能会在监控仪表板中报告为“已排队”状态。 您可以查看区段作业的最新状态,方法是向/segment/jobs端点发出GET请求,并在请求路径中提供区段作业的ID。 在“API”选项卡中可找到有关使用此端点的更多信息。
如果您运行灵活的受众评估,并希望评估将受众激活到目标,则需要确保将频率设置为​After segment evaluation。 对已设置为在区段评估激活的受众运行灵活的受众评估,将在灵活的受众评估作业完成后立即激活受众,而不考虑任何之前的每日激活作业。

视频 video

以下视频演示了如何在Experience Platform中访问和使用灵活的受众评估。

常见问题 faq

The following section lists frequently asked questions related to flexible audience evaluation.

How soon can I activate an audience using flexible audience evaluation?

回答
您可以在创建受众后立即使用灵活的受众评估激活受众。

How long does flexible audience evaluation take?

回答
A flexible audience evaluation job can take up to four hours to complete.

Can I run scheduling with flexible audience evaluation?

回答
No, scheduling is not available to use with flexible audience evaluation.

使用灵活的受众评估时,是否需要运行额外的导出作业?

回答
不会,导出作业将在相应的区段作业完成后自动运行。

我可以使用哪些服务通过灵活的受众评估来评估受众?

回答
您可以在所有下游服务(包括目标和Adobe Journey Optimizer历程)中使用受众。

何时重置灵活的受众评估限制?

回答
每日限制在午夜(UTC)重置。 年度限制将在合同的周年日期重置。

灵活的受众评估支持哪些类型的受众?

回答
Only audiences with the origin of Segmentation Service are supported for flexible audience evaluation. Other audiences, such as compositions, custom upload, or Data Distiller, are not supported for flexible audience evaluation.

哪些运行有助于我的灵活受众评估运行计数?

回答
使用API或UI创建的灵活受众评估运行接近最大限制。 但是,夜间运行的每日批处理分段作业不会​ 导致 ​超出此限制。

Do I need to evaluate all dependent audiences when evaluating the main audience with flexible audience evaluation?

回答
否。Flexible audience evaluation will automatically evaluate all dependent audiences. For example, if Audience A depends on Audience B, you only need to evaluate Audience B. Flexible audience evaluation will automatically evaluate Audience A and then Audience B.
recommendation-more-help
770bc05d-534a-48a7-9f07-017ec1e14871