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.
mboxDebug é especialmente útil quando você está configurando Target em sua página para garantir que a solicitação Target seja acionada e o cookie esteja sendo definido. 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.
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 do editor (ou Aprovador)
Para obter mais informações sobre clientes Target Standard, consulte Especificar funções e permissões em Usuários. Para obter mais informações sobre clientes Target Premium, consulte Configurar permissões corporativas.
Função de administrador no nível do espaço de trabalho/perfil do produto
Os espaços de trabalho estão disponíveis somente para Target Premium clientes. Para obter mais informações, consulte Configurar permissões corporativas.
Direitos de administrador (permissão do Sysadmin) no nível do produto Adobe Target
Para recuperar o token de autorização:
Clique em Administração > Implementação.
Na seção Ferramentas do depurador, clique em Gerar novo token de autenticação.
Adicione o token gerado como um parâmetro ao seu URL para ativar uma das ferramentas de depuração avançadas.
mboxTrace permite que você receba informações de rastreamento anexadas às respostas Target. As informações de rastreamento refletem o resultado de uma chamada Target (por exemplo, uma conversão ou uma impressão) e quaisquer dados adicionais que possam ajudar a determinar por que esse resultado em particular aconteceu, como um conjunto de ramificações disponíveis entre 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 at.js, em vez de abrir uma nova janela do navegador ou exibir uma saída no console como em mbox.js, você precisará 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 mboxTrace
https://www.mysite.com/page.html?mboxTrace=window&authorization=f543abf-0111-4061-9619-d41d665c59a6
A saída mostra informações muito detalhadas sobre seu conteúdo. 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:
Uso do mboxTrace em páginas do Recomendações: Adicionar mboxTrace como um parâmetro de query em páginas com recomendações substitui o design do Recommendations na página por uma janela de detalhes mboxTrace, que exibe informações detalhadas sobre suas recomendações, incluindo:
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 de recomendações.
Para usar mboxDebug, inclua um parâmetro mboxDebug no fim do seu URL. A tabela a seguir contém informações sobre Target parâmetros de URL relacionados à resposta.
Alguns parâmetros de mboxDebug estão disponíveis com ou sem autenticação.
Parâmetros de URL | Propósito |
---|---|
mboxDebug=1 |
Depurador Adicionar este parâmetro a qualquer URL com solicitações de Público alvo definidas abre uma janela pop-up com detalhes de depuração importantes. 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 de Público alvo para mostrar a resposta da solicitação 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 tempo de resposta para cada solicitação 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. |
Certifique-se de que o fragmento do URL esteja depois dos parâmetros da string de query. Qualquer coisa depois do primeiro #
é um identificador de fragmento e faz com que os parâmetros de depuração não funcionem corretamente.
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. Autentique para o Experience Cloud e você pode usar a poderosa ferramenta MboxTrace para inspecionar suas qualificações de atividade e audiência, bem como seu perfil de 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 depurador do Adobe Experience Cloud.
O mbox.js envia um cookie chamado "em-disabled" para o visitante quando o target.js não é carregado durante a entrega. Este cookie evita que as ofertas criadas com o Visual Experience Composer sejam renderizadas no site. Os visitantes com esse cookie não veem o conteúdo do teste nem são contados nesses relatórios de atividades. Todo o conteúdo restante da oferta (por exemplo, das campanhas no Target Classic) continua sendo carregado. O cookie tem duração de 30 minutos a partir do momento da falha no carregamento.
A chamada SiteCatalyst: purchase
não pode ser usada para dados de tráfego do algoritmo de compra. Em vez disso, use a chamada orderConfirmPage
.
Atividades baseadas em formulário criadas com Target Standard/Premium podem colidir com atividades criadas na interface de usuário Target Classic com a mesma prioridade e usar a mesma solicitação Target.
O Target não é mais compatível com o IE8.
Atualize para mbox.js versão 58 ou posterior.
mbox.js versão 58 e posterior executa conteúdo não JavaScript para a solicitação global Target imediatamente após a tag HTML BODY
estar presente. O conteúdo do JavaScript nas tags <script>
para a solicitação global Target é executado depois que o evento DOMContentLoaded
é acionado. Essa ordem de delivery de conteúdo garante que o conteúdo JavaScript para a solicitação global Target seja entregue e renderizado corretamente.
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().
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 nas quais o Target está sendo executado.
Se a oferta remota ou de redirecionamento usar um URL inválido, poderá ocorrer uma falha no fornecimento.
Para ofertas de redirecionamento, a resposta Target pode conter /* invalid redirect offer URL */
Ou
Para ofertas remotas, a resposta Target pode conter /* invalid remote offer URL */
Você pode verificar a resposta Target no navegador ou usando mboxTrace. Consulte https://tools.ietf.org/html/std66 para obter mais informações sobre URLs válidos.
O at.js não aciona solicitações de Público alvo se você estiver usando um documento inválido. A at.js exige o doctype HTML 5.
Os vídeos a seguir contêm mais informações sobre os conceitos discutidos neste artigo.