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:

API OD

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.

Nova integração do Adobe I/O

Clique em Fazer upload de arquivos.

Nova integração do Adobe I/O

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

Nova integração do Adobe I/O

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

Nova integração do Adobe I/O

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.

API OD

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!

API OD

14.5.1.2 Listar disposições

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

API OD

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.

API OD

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.

API OD

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.

API OD

14.5.1.4 Lista de ofertas personalizadas

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

API OD

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

API OD

14.5.1.5 Lista de ofertas de fallback

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

API OD

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.

API OD

14.5.1.6 Listar coleções

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

API OD

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

API OD

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.

API OD

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.

API OD

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

API OD

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

API OD

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:

API OD

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.

WebSDK

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.

WebSDK

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.

WebSDK

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:

Configuração do Launch

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

Configuração do Launch

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.

Configuração do Launch

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

Configuração do Launch

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

Configuração do Launch

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.

Configuração do Launch

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

Configuração do Launch

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

Configuração do Launch

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

Configuração do Launch

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.

Configuração do Launch

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

Configuração do Launch

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!

Configuração do Launch

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

Configuração do Launch

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.

Configuração do Launch

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

Nesta página