3.5 Criar um segmento - API

Neste exercício, você usará o Postman e o Adobe I/O para criar um segmento e armazenar os resultados desse segmento como um conjunto de dados, usando as APIs do Adobe Experience Platform.

História

No Perfil do cliente em tempo real, todos os dados do perfil são mostrados junto aos dados do evento e às associações de segmento existentes. Os dados mostrados podem vir de qualquer lugar, de aplicativos Adobe e soluções externas. Essa é a exibição mais poderosa no Adobe Experience Platform, o sistema de experiência de registro.

Exercício 3.5.1 - Criar um segmento por meio da API da plataforma

Vá para Postman.

Localize a coleção: _Adobe Experience Platform Enablement. Nesta coleção, você verá uma pasta 2. Segmentação. Usaremos essas solicitações neste exercício.

Segmentação

O que faremos em seguida é seguir todas as etapas necessárias para criar um segmento por meio da API. Vamos criar um segmento simples: "ldap - Todos os clientes femininos".

Etapa 1 - Criar uma definição de segmento

Clique na solicitação chamada Etapa 1 - Perfil: Crie Uma Definição De Segmento.

Segmentação

Vá para a seção Body desta solicitação.

Segmentação

No Body desta solicitação, você verá o seguinte:

Segmentação

O idioma usado para essa solicitação é chamado de Idioma da Consulta de Perfil ou PQL.

Você pode encontrar mais informações e documentação sobre PQL aqui.

Atenção: atualize a variável name na solicitação abaixo, substituindo ldap por seu ldap específico.

{
    "name" : "ldap - API - All Female Customer",
    "expression" : {"type":"PQL", "format":"pql/json", "value":"{\"nodeType\":\"fnApply\",\"fnName\":\"in\",\"params\":[{\"nodeType\":\"fieldLookup\",\"fieldName\":\"gender\",\"object\":{\"nodeType\":\"fieldLookup\",\"fieldName\":\"person\",\"object\":{\"nodeType\":\"literal\",\"literalType\":\"XDMObject\",\"value\":\"profile\"}}},{\"literalType\":\"List\",\"nodeType\":\"literal\",\"value\":[\"female\"]}]}"},
    "createdBy": "ldap",
    "schema" : { "name" : "_xdm.context.profile"},
    "ttlInDays" : 90
}

Depois de adicionar seu ldap específico, o Corpo deve ser semelhante a isto:

{
    "name" : "vangeluw - API - All Female Customer",
    "expression" : {"type":"PQL", "format":"pql/json", "value":"{\"nodeType\":\"fnApply\",\"fnName\":\"in\",\"params\":[{\"nodeType\":\"fieldLookup\",\"fieldName\":\"gender\",\"object\":{\"nodeType\":\"fieldLookup\",\"fieldName\":\"person\",\"object\":{\"nodeType\":\"literal\",\"literalType\":\"XDMObject\",\"value\":\"profile\"}}},{\"literalType\":\"List\",\"nodeType\":\"literal\",\"value\":[\"female\"]}]}"},
    "createdBy": "vangeluw",
    "schema" : { "name" : "_xdm.context.profile"},
    "ttlInDays" : 90
}

Você também deve verificar os campos Header - da sua solicitação. Vá para Headers. Você verá isso:

Postman

Chave Valor
x-sandbox-name --aepSandboxId--
OBSERVAÇÃO

Você precisa especificar o nome da sandbox do Adobe Experience Platform que está usando. Seu x-sandbox-name deve ser --aepSandboxId--.

Agora, clique no botão azul Send para criar o segmento e visualizar os resultados disso.

Segmentação

Após esta etapa, você pode visualizar sua definição de segmento na interface do usuário da plataforma. Para verificar isso, faça logon no Adobe Experience Platform e vá para Segments.

Segmentação

Etapa 2 - Criar um POST de segmento

No exercício anterior, você criou um segmento streaming. Um segmento de transmissão avalia continuamente as qualificações em tempo real. O que você está fazendo aqui é criar um segmento batch. O segmento em lote fornece uma pré-visualização de como o segmento pode parecer em termos de qualificações, mas isso não significa que o segmento realmente foi executado. Atualmente, ninguém se qualifica para este segmento. Para que as pessoas se qualifiquem, o segmento de lote precisa ser executado, que é exatamente o que faremos aqui.

Agora vamos POST de um trabalho de segmento.

Vá para Postman.

Segmentação

Na coleção Postman, clique na solicitação chamada Step 2 - POST Segment Job para abri-la.

Segmentação

Você também deve verificar os campos Header - da sua solicitação. Vá para Headers. Você verá isso:

Postman

Chave Valor
x-sandbox-name --aepSandboxId--
OBSERVAÇÃO

Você precisa especificar o nome da sandbox do Adobe Experience Platform que está usando. Seu x-sandbox-name deve ser --aepSandboxId--.

Clique no botão azul Enviar.

Você deve ver um resultado semelhante:

Segmentação

Esse trabalho de segmento agora está em execução, e isso pode levar algum tempo. Na Etapa 3, você poderá verificar o status deste trabalho.

Etapa 3 - Status do trabalho do segmento do GET

Vá para Postman.

Segmentação

Na coleção Postman, clique na solicitação chamada Etapa 3 - Status do trabalho do segmento do GET.

Segmentação

Você também deve verificar os campos Header - da sua solicitação. Vá para Headers. Você verá isso:

Postman

Chave Valor
x-sandbox-name --aepSandboxId--
OBSERVAÇÃO

Você precisa especificar o nome da sandbox do Adobe Experience Platform que está usando. Seu x-sandbox-name deve ser --aepSandboxId--.

Clique no botão azul Enviar.

Você deve ver um resultado semelhante:

Segmentação

Neste exemplo, o status da tarefa é definido como QUEUED.

Repita essa solicitação clicando no botão azul Send a cada dois minutos até que status seja definido como SUCCEEDED.

Segmentação

Depois que o status for SUCCEEDED, o trabalho do segmento foi executado e os clientes agora estão qualificados para o segmento.

Parabéns, você concluiu com sucesso o exercício Segmentação . Agora vamos ver como o Perfil do cliente em tempo real pode ser ativado em toda a empresa.

Próxima etapa: 3.6 Consulte o Perfil do cliente em tempo real em ação no Call Center

Voltar ao Módulo 3

Voltar para todos os módulos

Nesta página