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 section_BED130298E794D1FA229DB7C3358BA54
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 Editor permissão (ou Approver)
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 Administration > Implementation.
-
Na seção Ferramentas de Depuração, clique em Generate New Authentication Token.
-
Adicione o token gerado como um parâmetro ao seu URL para ativar uma das ferramentas de depuração avançadas.
mboxTrace section_256FCF7C14BB435BA2C68049EF0BA99E
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:
?mboxTrace=console
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
?mboxTrace=window
?mboxTrace=disable
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 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.
mboxDebug=1
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
mboxOverride.browserIp=<Insert IP address>
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.
#
é um identificador de fragmento e faz com que os parâmetros de depuração não funcionem corretamente.Adobe Experience Cloud Debugger section_A2798ED3A431409690A4BE08A1BFCF17
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 section_3920C857270A406C80BE6CBAC8221ECD
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 section_3D0DD07240F0465BAF655D0804100AED
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. section_FAC3651F19144D12A37A3E4F14C06945
O Target não é mais compatível com o IE8.
O cookie do Target não é definido section_77AFEB541C0B495EB67E29A4475DF960
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. section_9E1DABEB75AB431FB9F09887E6DD07D3
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. section_7D09043B687F43B39DAEDF17D00375AC
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. query-strings
O Activity URL 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 em Configure gear icon > selecione Page Delivery > e especifique a URL desejada no campo Activity URL.
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:
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:
Opção 3: Em vez de direcionar o URL completo, aproveite uma parte específica do URL.
Nesse cenário, a URL é https://shopping.mycart.com?type=Summers%20Offers
e regras de modelo adicionais especificam um Query com type > is (case sensitive) > type=Summers%20Offers, separadas por um operador OU:
Evitar aspas duplas no valor do atributo de perfil Target não está funcionando como o esperado. escape
Quando você envia valores contendo aspas duplas em um atributo de perfil Target, você deve usar o escape duplo como mostrado abaixo.
adobe.target.trackEvent({
"mbox": "data-collection",
"params": {
"profile.tagLine": "Escape \\\"Double Quotes\\\" like this."
}
});
Vídeos de treinamento
Os vídeos a seguir contêm mais informações sobre os conceitos discutidos neste artigo.