Controle a avaliação do público-alvo em lote com Agendamentos flexíveis em lote

A segmentação em lote é um método de avaliação que permite mover os dados do perfil de uma só vez para criar um público-alvo correspondente. Anteriormente, esses públicos-alvo em lote dependiam de um único trabalho de segmentação fixo, executado uma vez por dia.

Com Agendamentos flexíveis em lote, você controla quando seus públicos-alvo são avaliados, oferecendo mais flexibilidade para priorizar seus tempos de avaliação para que você possa dimensionar melhor para volumes maiores de público-alvo.

Criar um agendamento create-schedule

Para usar Agendamentos flexíveis de lotes, primeiro será necessário criar um agendamento para os públicos-alvo. Você pode criar um agendamento usando a interface do usuário ou a API do Experience Platform.

POST /schedules

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"
}'

{
  "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"]
  }
}

Atribuir públicos-alvo a um agendamento assign-audience

Depois de criar um agendamento, você pode atribuir públicos adicionais ao agendamento anterior. Você pode atribuir públicos-alvo usando a interface ou a API do Experience Platform.

POST /schedules/add-audiences

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"
        ]
      }'

{
    "added": ["sample-audience-3", "sample-audience-4"],
    "existing": [],
    "invalid": [],
    "segmentCount": {
        "previous": 2,
        "current": 4,
        "diff": 2
    }
}

Como alternativa, você pode atribuir um agendamento a um público-alvo durante a criação do público-alvo. No Audience Builder, depois de salvar o público-alvo, vá para a seção Agendamento na seção de propriedades do público-alvo e selecione o .

O popover Agendamentos de público-alvo é exibido. Nesse popover, é possível atribuir a quais cronogramas o público-alvo deve pertencer.

Exibir a programação de um público view-audience-schedule

Você pode ver a quais cronogramas um público pertence usando a interface do usuário ou a API do Experience Platform.

POST /schedules/audience-map

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"
        ]
      }'

{
  "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"
    }
  }
}

Remover públicos-alvo de uma programação remove-audience

Se quiser remover públicos-alvo de um agendamento já criado, use a interface do usuário do Experience Platform ou a API.

POST /schedules/remove-audiences

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"
    ]
 }
 '

{
    "removed": ["sample-audience-1"],
    "existing": [],
    "invalid": [],
    "segmentCount": {
        "previous"
    }
}

Executar um agendamento manualmente run-manually

Em vez de aguardar a execução do agendamento, você pode acionar manualmente um agendamento existente para execução usando a interface do usuário ou a API do Experience Platform.

POST /schedules/trigger

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"
    }'

Ativar ou desativar um agendamento

Você pode ativar ou desativar um agendamento usando a interface ou a API do Experience Platform.

PATCH /schedules/{SCHEDULE_ID}

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"
        }
      ]'

Próximas etapas

Depois de ler este guia, agora você sabe como usar Agendamentos flexíveis de lotes usando a API ou a interface do usuário do Experience Platform. Para obter mais informações sobre a interface de Cronogramas de lote flexíveis, leia a visão geral sobre a interface do serviço de segmentação. Para obter mais informações sobre a API de agendamentos, leia o manual de ponto de extremidade de agendamentos. Para saber como o Agendamento flexível em lote funciona com sua capacidade e créditos, leia a visão geral de uso e capacidades de licença.

Vídeo video

O vídeo a seguir mostra como usar agendas em lote flexíveis, descrevendo como criar agendas personalizadas, monitorar trabalhos de segmentação e gerenciar créditos na guia Avaliação.

Apêndice appendix

O apêndice a seguir lista como as dependências entre programações funcionam e as perguntas mais frequentes sobre programações de lote flexíveis.

Dependências entre agendamentos cross-schedule-dependencies

Se um público-alvo se referir a outro público-alvo como uma dependência, essa dependência poderá colocar esse público-alvo em um agendamento ao qual não pertence.

Considere os quatro públicos-alvo e os dois agendamentos a seguir:

Programação A: Público-alvo 1, Público-alvo 4
Programação B: Público-alvo 2, Público-alvo 3

O Público-alvo 1 se refere ao Público-alvo 2 por meio de uma dependência, portanto, o Público-alvo 1 precisa da associação avaliada do Público-alvo 2 para calcular sua própria associação.

Quando o Agendamento A é executado, o Público-alvo 1 e o Público-alvo 4 são avaliados, conforme esperado. No entanto, o Público-alvo 2 também é executado, pois é uma dependência do Público-alvo 1.

Quando a Programação B é executada, o Público-alvo 2 e o Público-alvo 3 são avaliados, conforme esperado. Nesse cenário, o Público-alvo 1 não é avaliado, pois o Público-alvo 2 não depende do Público-alvo 1.

Como resultado, isso significa que os públicos-alvo que são dependentes de outros públicos-alvo (como o Público-alvo 2 no cenário acima) maio são avaliados mais de uma vez por dia - uma vez como parte de sua própria avaliação agendada e outra como parte da programação do público-alvo que depende do outro público-alvo.

Perguntas frequentes faq

Preciso fazer algo para continuar usando a avaliação diária que tenho atualmente?

Um público-alvo pode ser atribuído a mais de um agendamento personalizado?

Os públicos de streaming ou de borda podem usar agendamentos personalizados?

Posso atribuir uma composição de público-alvo a um agendamento personalizado?

Quantas programações posso executar?

Preciso de Agendamentos de Lotes Flexíveis para ter mais de 4.000 públicos em lotes?

Criar um agendamento personalizado custa algo?

Como posso ver se meu cronograma foi executado?

Resposta

Você pode ver se seu cronograma foi executado na visualização de monitoramento do trabalho de segmentação. Selecione Monitoramento seguido por Painel, Públicos-alvo e Trabalho de segmentação. Aqui, selecione o ao lado da hora em que o agendamento foi executado para ver a lista de públicos avaliados pelo agendamento.