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.
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.
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:
Clique em Administração > Implementação.
Na seção Ferramentas de depuração, 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.
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:
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:
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.
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.
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. |
mboxDisable=1 |
Desabilitar mboxes na página |
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. |
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.
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.
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
.
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 Target não é mais compatível com o IE8.
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 onde o Target estiver 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 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.
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.
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.
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:
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:
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:
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:
Quando você envia valores contendo aspas duplas em um Target atributo de perfil, você deve fazer o escape duas vezes como mostrado abaixo.
adobe.target.trackEvent({
"mbox": "data-collection",
"params": {
"profile.tagLine": "Escape \\\"Double Quotes\\\" like this."
}
});
Os vídeos a seguir contêm mais informações sobre os conceitos discutidos neste artigo.