Soluções de problemas da entrega de conteúdo

Se a página não exibir o conteúdo esperado, há algumas etapas que você pode seguir para depurar a entrega de conteúdo.

  • Verifique seu código de campanha ou atividade cuidadosamente. Um erro de ortografia ou de outro tipo pode fazer com que o conteúdo esperado não seja exibido.
  • Use mboxTrace ou mboxDebug para solucionar problemas da solicitação do Target.
  • Use o Adobe Experience Cloud Debugger, uma ferramenta fácil de usar que fornece praticamente as mesmas informações que o mboxDebug para solucionar problemas da solicitação do Target.

O mboxDebug é particularmente útil quando você está configurando o Target na sua página para garantir que a solicitação do Target seja disparada e que o cookie seja configurado. No entanto, ela não entra no tipo de detalhes que são úteis durante a depuração da entrega de conteúdo. Se a sua atividade não aparecer na sua página ou se aparecer conteúdo indesejado, use mboxTrace para examinar e depurar a página atentamente.

Recuperar o token de autorização para usar com ferramentas de depuração

Como mboxTrace e mboxDebug podem expor dados de campanha e dados de perfil a terceiros, um token de autorização é necessário. O token de autorização pode ser recuperado na interface de usuário do Target. O token é válido por seis horas.

Você deve ter uma das seguintes permissões de usuário para gerar um token de autenticação:

  • Pelo menos permissão de Editor (ou Aprovador)

    Para obter mais informações para clientes do Target Standard, consulte Especificar funções e permissões em Usuários. Para obter mais informações para clientes do Target Premium, consulte Configurar permissões corporativas.

  • Função de administrador no nível de espaço de trabalho/perfil de produto

    Os espaços de trabalho estão disponíveis somente para clientes do Target Premium. Para obter mais informações, consulte Configurar permissões corporativas.

  • Direitos de administrador (permissão de Sysadmin) no nível do produto Adobe Target

Para recuperar o token de autorização:

  1. Clique em Administração > Implementação.

  2. Na seção Ferramentas de depuração, clique em Gerar novo token de autenticação.

    Gerar novo token de autenticação

  3. Adicione o token gerado como um parâmetro ao seu URL para ativar uma das ferramentas de depuração avançadas.

    Token de autorização

mboxTrace

A mboxTrace permite que você receba informações de rastreamento anexadas a respostas do Target. As informações de rastreamento refletem o resultado de uma chamada do Target (por exemplo, uma conversão ou uma impressão) e dados adicionais que podem ajudar a determinar por que esse resultado particular aconteceu, como um conjunto de ramificações disponíveis dentre as quais a seleção foi feita em uma campanha. Use essas informações para depurar a entrega de conteúdo.

Os seguintes parâmetros estão disponíveis:

Opções de mboxTrace Saída
?mboxTrace=console Imprime no log do console como objetos.
Para a at.js, em vez de abrir uma nova janela no navegador ou configurar a saída para o console como na mbox.js (descontinuada), é preciso inspecionar a solicitação de rede e procurar em Visualização (Chrome) ou Resposta (Firefox).
?mboxTrace=json Imprime no log do console como sequência de caracteres JSON literal
?mboxTrace=window Imprime em uma janela pop-up como uma sequência de caracteres JSON
?mboxTrace=disable Desativa o rastreamento do modo de sessão

Exemplo de chamada de mboxTrace

https://www.mysite.com/page.html?mboxTrace=window&authorization=f543abf-0111-4061-9619-d41d665c59a6

A saída exibe informações detalhadas sobre o conteúdo. O mboxTrace mostra detalhes sobre sua campanha ou atividade e perfil. Também fornece um instantâneo do perfil antes da execução, e um instantâneo do que foi alterado após a execução. Ela também mostra quais campanhas ou atividades foram avaliadas para cada local.

Algumas das informações incluem segmentos correspondentes ou não e IDs de direcionamento:

  • SegmentId: as IDs dos segmentos, da biblioteca de segmentos reutilizáveis ou anônimas criadas para a campanha em particular.
  • TargetId: as IDs dos direcionamentos, da biblioteca de expressões de destino ou de direcionamentos anônimos para qualquer segmento da campanha.
  • Unmatched: a solicitação não estava qualificada nessa chamada para esses segmentos ou direcionamentos.
  • Matched: a solicitação estava qualificada para os segmentos ou direcionamentos especificado.

Uso da mboxTrace nas páginas de recomendações: a adição da mboxTrace como um parâmetro de consulta em páginas com recomendações substitui o design do Recommendations na página por uma janela de detalhes da mboxTrace, que exibe informações detalhadas sobre suas recomendações, incluindo:

  • Recomendações retornadas em relação às recomendações solicitadas
  • A chave usada e se está gerando recomendações
  • Recomendações geradas por critérios em relação a recomendações de backup
  • Configurações de critérios
  • Exclusões e inclusões aplicadas
  • Regras de coleção

Não é necessário incluir =console, =json ou =window no parâmetro de consulta. Quando terminar com os detalhes do mboxTrace, adicione =disable e pressione Enter para retornar ao modo normal de exibição.

mboxTrace não altera o funcionamento e a aparência normais do site. Os visitantes verão o design normal do Recommendations.

mboxDebug

Para usar mboxDebug, inclua um parâmetro mboxDebug no fim do seu URL. A tabela a seguir contém informações sobre parâmetros de URL relacionados à resposta do Target.

OBSERVAÇÃO

Alguns parâmetros de mboxDebug estão disponíveis com ou sem autenticação.

Parâmetros de URL Propósito
mboxDebug=1 Depurador
A adição desse parâmetro a qualquer URL com solicitações do Target definidas abre uma janela pop-up com detalhes de depuração valiosos. Informações sobre cookies, PCid e valores de ID de sessão aparecem escritos e todos os URLs de são visíveis. Clique em um URL de solicitação do Target para mostrar a resposta à solicitação do Target. Mais detalhes estão disponíveis em mbox_debug.pdf.
mboxDebug=x-cookie Modificar o cookie
mboxDisable=1 Desabilitar mboxes na página
mboxDebug=x-profile Ver perfis definidos.
mboxDebug=x-time Mostrar o tempo de resposta para cada solicitação do Target.
mboxOverride.browserIp=<Insert IP address> Testar geolocalização
Teste a geolocalização com este parâmetro de URL. Insira um endereço IP como o valor para este atributo e o geolocalização do Test&Target avalia o endereço IP para compará-lo com qualquer geolocalização e segmentação configurados em uma campanha.
OBSERVAÇÃO

Verifique se o fragmento do URL está após os parâmetros da sequência de consulta. Qualquer item depois do primeiro # é um identificador de fragmento e faz com que os parâmetros de depuração não funcionem corretamente.

Adobe Experience Cloud Debugger

Com o depurador da Adobe Experience Cloud é mais rápido e fácil entender a implementação do Target. Você pode visualizar rapidamente a configuração da biblioteca, examinar as solicitações para garantir que os parâmetros personalizados estão sendo passados corretamente, ativar o logon no console e desativar todas as solicitações do Target. Faça a autenticação na Experience Cloud e use a ferramenta MboxTrace avançada para inspecionar as qualificações de atividade e público-alvo, bem como o perfil do visitante.

Para obter mais informações, consulte os vídeos de treinamento abaixo:

Para obter informações mais detalhadas, consulte Depurar at.js usando o Adobe Experience Cloud Debugger.

Os melhores vendedores não aparecem no Recommendations

A chamada SiteCatalyst: purchase não pode ser usada para dados de tráfego de algoritmo de compra. Em vez disso, use a chamada orderConfirmPage.

Verificar prioridade da atividade

As atividades com base em formulários criadas com o Target Standard/Premium podem entrar em conflito com atividades criadas na interface do Target Classic que têm a mesma prioridade e usam a mesma solicitação do Target.

O código personalizado não produz os resultados esperados no Internet Explorer 8.

O Target não é mais compatível com o IE8.

O cookie do Target não é definido

Se o seu site tiver um subdomínio, como us.domain.com, mas você precisar que o cookie do esteja definido em domain.com (em vez de us.domain.com), você deve substituir a configuração cookieDomain. Para obter mais informações, consulte targetGlobalSettings().

O conteúdo do Target cintila ou não é exibido caso um elemento também faça parte da personalização do Adobe Experience Manager.

Se um elemento DOM fizer parte da segmentação de personalização do Adobe Experience Manager (AEM) e de uma atividade do Target, o conteúdo do Target poderá cintilar ou não ser exibido.

Para resolver isso, você pode desativar a personalização do AEM nas páginas onde o Target estiver sendo executado.

Falha no fornecimento de ofertas remotas e de redirecionamento devido a um URL inválido.

Se a oferta remota ou de redirecionamento usar um URL inválido, poderá ocorrer uma falha no fornecimento.

Para ofertas de redirecionamento, a resposta do Target pode conter /* invalid redirect offer URL */

Ou

Para ofertas remotas, a resposta do Target pode conter /* invalid remote offer URL */

Você pode verificar a resposta do Target no navegador ou usando a mboxTrace. Consulte https://tools.ietf.org/html/std66 para obter mais informações sobre URLs válidos.

TargetAs solicitações do não estão sendo disparadas em meu site.

A at.js não disparará solicitações do Target se você estiver usando um tipo de documento inválido. A at.js exige o doctype HTML 5.

Certifique-se de que as atividades do Target tratam corretamente os URLs com parâmetros de sequência de consulta.

O URL da atividade determina a página que qualifica os visitantes para a atividade e renderiza as experiências da atividade para os usuários. Quando solicitado durante a criação da atividade, digitar o URL completo nem sempre garante que o conteúdo será entregue na página do site, especialmente com URLs que contenham parâmetros de sequência de consulta.

Por padrão, o Visual Experience Composer (VEC) abre a página especificada nas suas configurações do Visual Experience Composer. Você também pode especificar uma página diferente durante a criação da atividade.

Para exibir uma página diferente após a abertura do VEC, clique no ícone de Configuração > selecione Entrega da página > e especifique o URL desejado no campo URL da atividade.

Definir a interface das configurações de Entrega de página

Mas e se o URL contiver parâmetros de sequência de consulta? Ele funcionará e mostrará o conteúdo personalizado? Nesse cenário, independentemente do público-alvo, é possível incluir regras de modelo, além do URL básico para definir os parâmetros de consulta.

As seguintes opções podem ser usadas para incluir regras de modelo adicionais:

Opção 1: Replique o URL e mantenha-o na regra de modelo com a opção “contém”.

Essa opção garante que esse URL se qualifica para a atividade. Mas saiba que há casos de exceção anexados a ela que podem influenciar seus dados de relatório com registros adicionais para URLs que contêm o URL de base.

Nesse cenário, o URL é https://shopping.mycart.com?type=Summers%20Offers e regras de modelo adicionais “contêm” o mesmo URL, separado por um operador OU:

Replicar o URL nas regras de modelo

Opção 2: Restrinja a condição “contém” do URL somente com a sequência de consulta.

O caso de exceção discutido na opção anterior é aplicado nesta opção, mas aqui a configuração condicional é limitada somente à sequência de consulta.

Nesse cenário, o URL é https://shopping.mycart.com?type=Summers%20Offers e as regras de modelo adicionais “contêm” somente a sequência de consulta, separadas por um operador OU:

A regra de modelo contém somente a sequência de consulta

Opção 3: Em vez de direcionar o URL completo, aproveite uma parte específica do URL.

Nesse cenário, o URL é https://shopping.mycart.com?type=Summers%20Offers e regras de modelo adicionais especificam uma Consulta com type > é (diferencia maiúsculas de minúsculas) > type=Summers%20Offers, separadas por um operador OU:

Regra de modelo aproveitando uma parte específica do URL

Vídeos de treinamento

Os vídeos a seguir contêm mais informações sobre os conceitos discutidos neste artigo.

Adicionar a extensão Selo do tutorial

Depuração básica do Adobe Target Selo do tutorial

Mbox Trace Selo do tutorial

Nesta página