14.5 Teste sua decisão usando a API

14.5.1 Trabalhar com a API do Offer Decisioning usando o Postman

Baixe esta Coleção Postman para Offer Decisioning no seu desktop e descompacte-a. Você terá isso:

Agora você tem este arquivo na área de trabalho:

• _Módulo 14 - Decisioning Service.postman_collection.json

Em Exercise 3.3.3 - Autenticação do Postman para o Adobe I/O você instalou o Postman. Você precisará usar o Postman novamente para este exercício.

Abra o Postman. Clique em Importar.

Clique em Fazer upload de arquivos.

Selecione o arquivo _Module 14 - Decisioning Service.postman_collection.json e clique em Open.

Você terá essa coleção disponível no Postman.

Agora você tem tudo o que precisa no Postman para começar a interagir com o Adobe Experience Platform por meio das APIs.

14.5.1.1 Contêineres de lista

Clique em para abrir a solicitação GET - Listar contêineres.

Em Params, você verá o seguinte:

• propriedade: _instance.parentName==aepenablementfy21

Nesse parâmetro, aepenablementfy21 é o nome da sandbox que é usada no Adobe Experience Platform. A sandbox que você deve usar é --aepSandboxId--. Substitua o texto aepenablementfy21 por --aepSandboxId--.

Depois de substituir o nome da sandbox, clique em Send.

Esta é a resposta, que mostra o contêiner de oferta para a sandbox que você especificou. Copie o container instanceId conforme indicado abaixo e anote-o em um arquivo de texto em seu computador. Você precisará usar esse container instanceId para o próximo exercício!

14.5.1.2 Listar disposições

Clique em para abrir a solicitação GET - Listar disposições. Clique em Enviar.

Agora você está vendo todas as disposições disponíveis no contêiner de oferta. As disposições que você está vendo foram definidas na interface do usuário do Adobe Experience Platform, como você pode ver em Exercício 14.1.3.

14.5.1.3 Lista de regras de decisão

Clique em para abrir a solicitação GET - Listar regras de decisão. Clique em Enviar.

Na resposta, você verá as Regras de decisão definidas na interface do usuário do Adobe Experience Platform, como você pode ver em Exercício 14.1.4.

14.5.1.4 Lista de ofertas personalizadas

Clique em para abrir a solicitação GET - Listar ofertas personalizadas. Clique em Enviar.

Na resposta, você verá as Ofertas personalizadas definidas na interface do usuário do Adobe Experience Platform em Exercício 14.2.1.

14.5.1.5 Lista de ofertas de fallback

Clique em para abrir a solicitação GET - Listar ofertas de fallback. Clique em Enviar.

Na resposta, você verá a Oferta de fallback que você definiu na interface do usuário do Adobe Experience Platform em Exercício 14.2.2.

14.5.1.6 Listar coleções

Clique em para abrir a solicitação GET - Listar Coleções.

Na resposta, você verá a Coleção definida na interface do usuário do Adobe Experience Platform em Exercise 14.2.3.

14.5.1.7 Obter ofertas detalhadas para o perfil do cliente

Clique para abrir a solicitação POST - Obter ofertas detalhadas para o Perfil do cliente. Essa solicitação é semelhante à anterior, mas retorna detalhes como URLs de imagem, texto etc.

Para esta solicitação, assim como para o exercício anterior que tem requisitos semelhantes, você precisa fornecer os valores para xdm:placementId e xdm:activityId para recuperar os detalhes da oferta específica para um cliente.

O campo xdm:activityId já está preenchido como o resultado de uma solicitação anterior enviada, depois disso você armazenou a chave OFFER_ACTIVITY_ID em seu ambiente Postman.

O campo xdm:placementId precisa ser preenchido. Você pode recuperar isso na interface do usuário do Adobe Experience Platform, conforme indicado abaixo. No exemplo abaixo, você pode ver o placementId da disposição Web - Image.

Vá para Body e insira o endereço de email do cliente para o qual deseja solicitar uma oferta. Clique em Enviar.

Por fim, você verá o resultado de que tipo de oferta personalizada e quais ativos precisam ser exibidos para esse cliente.

14.5.2 Use a API do Offer Decisioning para mostrar ofertas no Xray

No exercício anterior, você usava a API para recuperar informações do Adobe Experience Platform e do Offer Decisioning. Vamos agora ver um exemplo prático.

Você já viu o painel do Xray no site antes. O painel Xray está usando as APIs do Adobe Experience Platform para recuperar informações em cada carga útil. Agora vamos adicionar a resposta da API do Offer Decisioning no Xray.

Para tornar isso possível, você precisará de três valores:

• ID do contêiner do offer decisioning
• ID de posicionamento do offer decisioning
• ID de decisão do offer decisioning

Onde você pode encontrar esses valores?

14.5.2.1 ID do contêiner do Offer decisioning

O instanceId do contêiner foi retornado pela primeira chamada de API enviada como parte deste exercício. Role de volta para ver a etapa Listar contêineres. Siga as instruções para coletar a instanceId do contêiner.

O formato do instanceId do contêiner tem esta aparência: 02068be3-17ae-3ca6-bed6-0daf0084c5a1 e fez parte da saída da solicitação Listar Contêineres:

14.5.2.2 ID de posicionamento do Offer decisioning

A ID de posicionamento da oferta identifica o local e o tipo de ativo que é necessário. Por exemplo, a imagem principal na página inicial do site Luma corresponde ao Offer Placement ID para Web - Image.

Para localizar a ID de posicionamento da oferta para Web - Imagem, vá para https://platform.adobe.com.

Em seguida, vá para Components e, em seguida, para Posicionamentos. Clique na disposição Web - Image para ver seus detalhes.

Como você pode ver na imagem acima, neste exemplo, o Offer Placement ID é xcore:offer-placement:129048460001fd30. Anote o Offer Placement ID para seu posicionamento para Web - Image, pois ele será necessário no próximo exercício.

14.5.2.3 ID da decisão do Offer decisioning

A ID de decisão identifica qual combinação de ofertas personalizadas e ofertas de fallback você gostaria de usar. No exercício anterior, você criou sua própria Decisão e a nomeou ldap - Luma Decision.

Para encontrar a ID de decisão para sua ldap - Luma Decision, vá para https://platform.adobe.com.

Em seguida, vá para Offers, vá para Decisões e clique para selecionar sua Decisão, que é chamada de ldap - Luma Decision.

Como você pode ver na imagem acima, neste exemplo, a ID de decisão é xcore:offer-activity:1290525f4441fd6e. Anote a ID de decisão para sua Decisão ldap - Luma Decision, pois ela será necessária no próximo exercício.

14.5.2.4 Atualizar o ID de configuração de ativação

Antes de testar sua demonstração completa, será necessário atualizar as configurações da ID de configuração e atualizar os campos para ID do contêiner do Offer decisioning, ID de posicionamento do Offer decisioning e ID de decisão do Offer decisioning na página Atualizar ID de configuração do site de demonstração.

Vá para https://public.aepdemo.net/admin_configuration_update.html.

Você verá isso:

Insira a ID de configuração e clique em Carregar configuração. Você verá seus valores de ID de configuração sendo carregados.

Role para baixo até ver os campos ID do contêiner do Offer decisioning, ID do posicionamento do Offer decisioning e ID da decisão do Offer decisioning.

Agora é necessário inserir os valores para esses três campos. Você coletou esses valores há alguns minutos na etapa anterior.

Em seguida, na página Atualizar ID de configuração , role para baixo e clique em Atualizar ID de configuração.

Após essa alteração, a resposta da API do Offer Decisioning será mostrada no Xray!

14.5.2 Teste de matriz

14.5.2.1 Carregar site e marca

Abra uma nova janela do navegador incognitivo e limpe e vá para https://public.aepdemo.net.

Você verá isso.

Insira a ID de configuração e clique em Carregar configuração. Sua configuração é carregada.

Role para baixo e clique em Salvar configuração.

Em seguida, você será redirecionado para a página inicial do Administrador. Vá para Selecionar LDAP. Selecione o LDAP e clique em Save.

Em seguida, você será redirecionado para a página inicial do Administrador. Vá para Selecione a Marca e selecione a marca Luma, clique em Salvar.

Em seguida, você será redirecionado para a página inicial do Administrador. Clique no logotipo Luma.

14.5.2.2 O cliente navega no site

Você verá a página do Luma. Você deve ver imediatamente a alteração da imagem principal e deve ver a Oferta de fallback que foi definida como parte de sua Decisão, exatamente como no exercício anterior. Além disso, ao abrir o painel do Xray e observar o painel do Offer Decisioning, você verá também a oferta aplicável sendo exibida lá.

É importante entender a diferença:

• a imagem principal no site está sendo entregue pelo SDK da Web, graças à integração entre o SDK da Web, o Edge e o Offer Decisioning
• o painel Xray e a oferta mostrada no Xray são viabilizados com o consumo das APIs do Offer Decisioning

Isso significa que há duas maneiras de obter a oferta no contexto em que ela é necessária, o que oferece muita flexibilidade!

Vá para a página Login/Register. Preencha os campos e clique em CREATE ACCOUNT para criar sua conta.

Como parte da configuração das Ofertas personalizadas, você definiu ofertas para clientes do sexo masculino ou feminino. Com base na seleção de gênero realizada na página Login/Register, você verá outra oferta na página inicial do Luma. Desta vez, não é mais uma Oferta de fallback, mas uma Oferta personalizada. Agora você pode ver novamente a mesma oferta na imagem herói e no Xray.

Neste exemplo, a seleção de gênero é masculina. Para clientes do sexo masculino, a oferta de maior prioridade é a oferta para a Zeppelin Yoga Pant.

Graças à integração entre o SDK da Web e o Adobe Experience Platform, as ofertas podem ser entregues de uma maneira agradável e fácil, com uma quantidade limitada de configuração.

Você concluiu este exercício.

Próxima etapa: 14.6 Teste sua decisão usando Journey Orchestration

Voltar ao Módulo 14

Voltar para todos os módulos