DocumentaçãoGuia do desenvolvedor do Marketo

Contexto do usuário

5 de maio de 2025
  • Tópicos:

Criado para:

  • Administrador

Contexto do usuário A API do JavaScript expõe os dados no nível do usuário e do visitante em várias sessões para ativar o recurso de personalização avançada usando o comportamento e os dados históricos do usuário. A API vai além da leitura de dados e expõe variáveis personalizadas que permitem enviar dados e eventos significativos para o back-end do RTP para fins avançados de segmentação e personalização. Recursos adicionais: Triggers, Correspondência de Padrões.

  • Você deve se tornar um cliente do Web Personalization e implantar a tag RTP no site antes de usar a API de Contexto de Usuário.
  • A API de contexto de usuário é um recurso que deve ser ativado pelo Suporte da Marketo mediante solicitação. Quando a API estiver ativada, um objeto userContext no objeto global RTP será exposto.

Atributos de Contexto do Usuário

NomeTipoDescrição
customVar[1-5]Sequência de caracteresDados personalizados salvos no contexto do usuário.
viewedCampaignsIDs de campanha como sequência separada por vírgulasCampanhas visualizadas nas visitas atuais ou anteriores.
Campanhas clicadasIDs de campanha como sequência separada por vírgulasClicou por meio de campanhas em visitas atuais ou anteriores.

Definir variáveis personalizadas

Adicionar dados personalizados ao Contexto do Usuário.

Uso

rtp('set', 'customVar'[1-5], my_custom_value);

ParâmetroOpcional/ObrigatórioTipoDescrição
'definir'ObrigatórioSequência de caracteresAção do método.
customVarObrigatórioSequência de caracteresNome da variável personalizada.
my_custom_valueObrigatórioSequência de caracteresValor personalizado a ser salvo na variável personalizada no índice de 1 a 5.

Observação: as variáveis personalizadas são enviadas ao RTP somente na chamada de exibição, portanto, é recomendável definir variáveis personalizadas antes que a exibição seja chamada. Caso contrário, ele será enviado somente na próxima chamada de visualização.

Restrições de Var personalizadas

  • O comprimento da variável personalizada não pode ultrapassar 100 caracteres.
  • Os dados da campanha são limitados às últimas dez visitas, com dez campanhas por visita.

Uso

rtp('set', 'customVar', 'A');

// Set and get customVars
rtp('set', 'customVar1', 'foo');

// Read location
if (rtp.userContext.location.state == 'CA')  {
    // Do something
}

// Check if user viewed campaign id 45:
// The campaign id is exposed in the RTP UI when hovering over a campaign name.
if (rtp.userContext.viewedCampaign('45')) {
    // Do something
}
recommendation-more-help
bb269a6d-047a-4bf7-9acd-23ad9a63dc59