DocumentaçãoExperience PlatformGuia do Serviço de segmentação

Guia flexível de avaliação do público-alvo

Last update: Fri Mar 13 2026 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Tópicos:

Criado para:

  • Desenvolvedor
  • Usuário
AVAILABILITY
A avaliação de público flexível está somente disponível em instâncias do Experience Platform em execução em Microsoft Azure. Para saber mais sobre a infraestrutura do Experience Platform compatível, consulte a visão geral da nuvem múltipla do Experience Platform.
Além disso, a avaliação flexível de público-alvo está somente disponível para uso com o Real-Time CDP B2C Edition.

A avaliação flexível do público-alvo permite executar um trabalho de segmentação em lote sob demanda. Com a avaliação flexível do público-alvo, você pode executar lançamentos de campanhas ad-hoc, comunicações just-in-time ou outras atividades sensíveis ao tempo.

Medidas de proteção guardrails

When you run flexible audience evaluation, please keep the following conditions in mind:

  • You can only use flexible audience evaluation twice per day per sandbox. This limit resets at midnight (UTC).
  • You have a maximum of 50 flexible audience evaluation runs per year per production sandbox.
    • Um ano é definido como um ano a partir da data do contrato do Experience Platform para avaliação flexível do público-alvo. Por exemplo, se o contrato começou em 18 de maio, o número de execuções flexíveis de avaliação de público-alvo será redefinido a cada 18 de maio.
  • Você tem um máximo de 100 execuções de avaliação de público flexível por ano por sandbox de desenvolvimento.
    • Um ano é definido como um ano a partir da data do contrato do Experience Platform para avaliação flexível do público-alvo. Por exemplo, se o contrato começou em 18 de maio, o número de execuções flexíveis de avaliação de público-alvo será redefinido a cada 18 de maio.
  • Todos os públicos-alvo devem ter uma origem de "Serviço de segmentação".
  • All the audiences must be evaluated using batch segmentation.
  • Todos os públicos-alvo devem ser baseados em pessoas.
  • Você pode selecionar no máximo 20 públicos-alvo por execução de avaliação de público-alvo flexível.
NOTE
Você pode adquirir execuções adicionais de avaliação de público-alvo flexível por ano. Para obter mais informações, entre em contato com o Atendimento ao cliente da Adobe.

Acesso access

Para usar a avaliação flexível do público-alvo, você deve ter a seguinte permissão:

  • Evaluate Segment to an Audience na seção Profile Management.

Para obter mais informações sobre o controle de acesso baseado em função, leia a visão geral do controle de acesso.

Execução de avaliação de público-alvo flexível

Você pode executar a avaliação flexível do público usando as APIs do Experience Platform ou a interface do usuário.

APIs do Experience Platform

Para executar uma avaliação flexível do público-alvo nas APIs do Experience Platform, será necessário criar um trabalho de segmento que contenha as IDs de todas as definições de segmento (públicos-alvo) que você deseja avaliar.

note note
NOTE
Você só pode adicionar um máximo de 20 IDs de definição de segmento por chamada de API de trabalho de segmento.

You can create a new segment job by making a POST request to the /segment/jobs endpoint and including the IDs of the segment definitions in the request body.

accordion
A sample request for creating a new segment job
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
Propriedade Descrição
segmentId The ID of the segment definition that you want to evaluate. Essas definições de segmento podem pertencer a diferentes políticas de mesclagem.

Uma resposta bem-sucedida retorna o status HTTP 200 com informações sobre o trabalho de segmento recém-criado.

accordion
Um exemplo de resposta ao criar um novo trabalho de segmento.
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
}

Depois de criar o trabalho de segmento, você pode verificar seu status fazendo uma solicitação GET para o ponto de extremidade /segment/jobs, fornecendo a ID do trabalho de segmento recém-criado no caminho da solicitação.

accordion
Exemplo de solicitação para recuperar um trabalho de segmento
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}'

Uma resposta bem-sucedida retorna o status HTTP 200 com informações detalhadas sobre o trabalho de segmento especificado.

accordion
Uma resposta de amostra para recuperar um trabalho de segmento.
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
}
INTERFACE DO USUÁRIO DO Experience Platform

Para executar a avaliação de público-alvo flexível na interface do Experience Platform, selecione Audiences na seção Customers.

O botão Públicos-alvo na seção Clientes é destacado. O Portal de Público-Alvo para perfis de clientes é exibido.

O Portal de público-alvo é exibido, mostrando uma lista de todos os públicos-alvo de pessoas da organização. No Portal de público-alvo, você pode escolher os públicos que deseja avaliar e selecionar Evaluate audience.

The audiences that you want to use flexible audience evaluation on are selected.

O popover Evaluate audiences on demand é exibido, exibindo a lista de públicos-alvo que serão avaliados com o trabalho do segmento sob demanda. If an audience is ineligible to be evaluated on demand, it will automatically be removed from the evaluation job. Confirme se os públicos-alvo listados são aqueles que você deseja avaliar.

The audiences that can be evaluated using flexible audience evaluation are displayed.

Depois de confirmar que os públicos-alvo corretos estão listados, você pode continuar com a solicitação e a avaliação do público-alvo flexível será iniciada. You can view the status of this audience evaluation in the evaluation job monitoring view.

note note
NOTE
O status do trabalho do segmento pode ser relatado como no estado "Em fila" no painel de monitoramento. Você pode visualizar o status mais atualizado do trabalho do segmento fazendo uma solicitação GET para o ponto de extremidade /segment/jobs, fornecendo a ID do trabalho do segmento no caminho da solicitação. Mais informações sobre como usar esse endpoint podem ser encontradas na guia API.
If you run flexible audience evaluation and want the evaluation to activate the audience to a destination, you need to ensure the frequency is set to After segment evaluation. Executar a avaliação flexível do público-alvo em públicos que já estão definidos para serem ativados após a avaliação do segmento, ativará os públicos-alvo assim que o trabalho de avaliação flexível do público-alvo for concluído, independentemente de quaisquer trabalhos de ativação diários anteriores.

Vídeo video

The following video demonstrates how to access and use flexible audience evaluation in Experience Platform.

https://video.tv.adobe.com/v/3453645?captions=por_br&

Perguntas frequentes faq

A seção a seguir lista as perguntas frequentes relacionadas à avaliação flexível do público-alvo.

Em quanto tempo posso ativar um público-alvo usando a avaliação flexível de públicos-alvo?

Resposta
Você pode ativar um público-alvo usando a avaliação de público-alvo flexível imediatamente após sua criação.

Quanto tempo leva a avaliação flexível do público-alvo?

Resposta
Um trabalho de avaliação de público-alvo flexível pode levar até quatro horas para ser concluído.

Posso executar o agendamento com avaliação de público-alvo flexível?

Resposta
Não, o agendamento não está disponível para uso com a avaliação flexível de público.

Do I need to run an additional export job when using flexible audience evaluation?

Resposta
No, the export job is automatically run after the corresponding segment job is completed.

Quais serviços posso usar na avaliação de públicos-alvo com uma avaliação de público-alvo flexível?

Resposta
Você pode usar públicos-alvo em todos os serviços downstream, incluindo destinos e jornadas do Adobe Journey Optimizer.

Quando os limites flexíveis de avaliação de público-alvo são redefinidos?

Resposta
The daily limit is reset at midnight (UTC). O limite anual é redefinido na data de aniversário do contrato.

Which types of audiences are supported with flexible audience evaluation?

Resposta
Somente os públicos-alvo com a origem do Serviço de segmentação são compatíveis com a avaliação flexível do público-alvo. Outros públicos, como composições, upload personalizado ou Data Distiller, não são compatíveis com a avaliação flexível do público.

Quais execuções contribuem para minha contagem de execuções de avaliação de público flexível?

Resposta
Execuções de avaliação de público flexíveis que foram criadas usando a API ou a interface do usuário contam para o limite máximo. No entanto, a execução diária do trabalho de segmentação em lotes que é executado à noite não contribui para esse limite.

Preciso avaliar todos os públicos-alvo dependentes ao avaliar o público-alvo principal com uma avaliação de público-alvo flexível?

Resposta
Não. A avaliação flexível do público-alvo avaliará automaticamente todos os públicos-alvo dependentes. Por exemplo, se o Público-alvo A depender do Público-alvo B, você só precisará avaliar o Público-alvo B. Uma avaliação flexível do público-alvo avaliará automaticamente o Público-alvo A e depois o Público-alvo B.
recommendation-more-help
770bc05d-534a-48a7-9f07-017ec1e14871