Ver a Prévia de Campanhas por API do App Personalization

Ver a prévia de variações e campanhas

1. Selecione a prévia que deseja ver.

• Para ver a prévia de uma variação: ao criar ou editar a variação, clique em Preview in app (ver prévia no app). Você pode ver a prévia das variações mesmo que elas não tenham sido salvas. 
  
• Para ver a prévia de uma campanha: passe o mouse sobre a campanha por API da qual você deseja ver a prévia, então clique no ícone Preview (prévia). 
  

A caixa de diálogo de prévia é exibida.

2. Configure e veja a prévia: 

1. No campo Preview on (ver prévia em), insira o link profundo para o seu app, onde você deseja injetar o código da variação. Observe que, toda vez que o link é editado, um novo QR code é criado.
2. Leia o QR com qualquer dispositivo que tenha uma câmera e o seu app instalado. O QR code direcionará você ao local em seu app, juntamente com o token de prévia da campanha, e a variação será exibida. 

Opcionalmente:

1. Envie um e-mail com o URL de prévia a outros revisores. 
2. Clique em Copy URL (copiar URL) para salvá-lo ou visualizá-lo sem o QR code.

Observações:

• Quando você vê a prévia de uma campanha, todas as condições de direcionamento são consideradas antes de ela ser veiculada.
• As prévias de variações representam uma captura instantânea do código da variação no momento da geração dos links de prévia.
• Os links permanecem ativos por 45 dias.  

Ativar o modo de prévia

Para ver a prévia das campanhas por API, seu aplicativo deve solicitar o modo de prévia. Essa é uma alteração única que seu desenvolvedor faz. Depois, ver a prévia de variações e campanhas não exige mais nenhum esforço de desenvolvimento.

Quando você clica em Preview para uma campanha ou variação no console do Experience OS, o website é aberto com o parâmetro de URL dyApiPreview=[token]. Por exemplo: 
http://acme.com/dyApiPreview=5f30be92-dbd3-4053-904b-f83cd885574b

Como desenvolvedor, adicione a lógica: se o parâmetro de URL dyApiPreview existir no URL atual, inclua o token de prévia na solicitação de API no preview.ids[].

{ 
"user": {"dyid": "1679843083476146043", 
“dyid_server”: "1679843083476146043" }, 
"session":{"dy": "a2719b4d6c4709128bf5f57a3bf3"}, 
"selector": { 
  "names": ["PDP Top Banner", "PDP Recs"],
  “preview”: {
  “ids”: [“PREVIEW TOKEN”] // É aqui que você injeta o token de prévia a partir do parâmetro de URL
  }
  },
"context": { 
  "page": { "type":"HOMEPAGE", "location":"https://shop.biz/", "locale":"en_US" 
  }, 
  "device": { "userAgent":"Mozilla/5.0 (X11; Linux x86_64) Chrome/56.0.29", "ip":"54.100.200.255"} 
}, 
} 

{
"cookies": [ 
  {"name": "_dyid_server", "value": "16798430146043", "maxAge": "63072000"},
      {"name": "_dyjsession", "value": "a2719b4d6c470383f1bf3", "maxAge": "63072000"}
  ],
  "choices": [
  "id": 5,
  "name": "Homepage Banner Main",
  "type": "DECISION",
  "decisionId": "aGVsbG8K",
  "isPreview": true,
  "variations": [
  {
  "id": 52,
  "payload": {
... 
"type": "CUSTOM_JSON",
"data": {
  "key1": "value1",
  "key2": "value2"
}

{
  "user": { "id": "yaexono4ohphania" },
  "session": { "custom": "iquahngaishe2koh" },
  "selector": { 
     "names": ["PDP Top Banner", "PDP Recs"],
     “preview”: {
        "ids": [“PREVIEW TOKEN”] // É aqui que você injeta o token de prévia a partir do parâmetro de URL
     }
   },
   "context": { 
     // O contexto habitual...
   }
}

{
  "choices": [
  {
  "id": 551993,
  "name": "HP Top Banner",
  "type": "DECISION",
  "variations": [
  {
  "id": 25863143,
  "payload": {
  "type": "CUSTOM_JSON",
  "data": {
  "image": "http://lorempixel.com/400/200/",
  "title": "Stay Sharp",
  "subtitle": "Set the tone of elegance",
  "cta": "Buy Now",
  "link": ""
  }
  }
  }
  ],
  "decisionId": "l7QtNTg5MTkwODkyNDA4MTM1NDM3Oc4AEHLBpzk5MzA1ODQBkJHOAYqj56UzNjQzOQ=="
  }
  ],
  "isPreviewMode": true
}}

Observações

• O escopo do token de prévia é para a solicitação inteira. Ou seja, ele “habilitará” todos os rascunhos de experiências nas campanhas. Se você quiser ver a prévia de rascunhos de uma única campanha, separe as solicitações.
• Os tokens de prévia expiram após 2 semanas.
• Um novo token de prévia é gerado toda vez que Preview é clicado.
• Ao solicitar o modo de prévia para várias campanhas, você receberá a melhor opção (com base no direcionamento correspondido) de todas campanhas em execução e em rascunho.
• Se você enviar um token de prévia inválido, receberá um aviso: Request contains invalid previewId (a solicitação contém previewId inválido).
• Se você enviar uma solicitação sem token de prévia (ou seja, uma chamada de produção em execução), somente experiências de status ativo serão consideradas. Campanhas que incluem somente experiências em rascunho ou pausadas retornarão opções vazias.
• Você pode incluir vários tokens de prévia em uma única chamada separando os tokens por vírgula. Isso é útil se você quiser ver a prévia de diversas variações de diferentes campanhas ao mesmo tempo. Se você incluir diversos tokens, os tokens para ver a prévia de uma variação têm precedência sobre tokens para ver a prévia de uma campanha.
• Observe a diferença entre tokens de prévia a nível de campanha e tokens a nível de variação: Um token de prévia a nível de campanha retorna o parâmetro “isPreviewMode”: true no final da resposta, que faz com que todas as campanhas retornadas sejam visualizadas no modo de prévia.
  Um token de prévia a nível de variação retorna o parâmetro “isPreview”: true dentro do parâmetro “choices” de cada variação separadamente, se o token corresponder a uma variação.