DocumentaçãoGuia do desenvolvedor do Marketo

Redirecionar

Last update: Mon May 05 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Tópicos:
  • Javascript

Criado para:

  • Administrador

A API de redirecionamento do RTP permite redirecionar públicos segmentados para um URL de destino.

  • 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.
  • O RTP não suporta listas de contas nomeadas de Marketing Baseado em Conta. As listas e os códigos ABM pertencem apenas às listas de contas carregadas (arquivos CSV) gerenciadas no RTP.

Uso

rtp('send' , 'redirect' , 'field_name' , [ 'values_array' , '...' , '...' ] , 'www.redirect_url.com' , true/false )

Parâmetro
Opcional/Obrigatório
Tipo
Descrição
'enviar'
Obrigatório
Sequência de caracteres
Ação do método.
'redirecionar'
Obrigatório
Sequência de caracteres
Nome do método.
field_name
Obrigatório
Sequência de caracteres
Nome do campo para corresponder. Exemplo: 'abm.name' (veja abaixo).
values_array
Obrigatório
Matriz
Lista de valores para corresponder ao campo (não diferencia maiúsculas de minúsculas).
redirect_url
Obrigatório
Sequência de caracteres
URL do Target para redirecionar visitantes que corresponderam à condição.
redirect_matched_visitors
Opcional
Booleano
Se true, os visitantes correspondentes à condição serão redirecionados. Se for falso, os visitantes sem correspondência da condição serão redirecionados. Padrão: verdadeiro.

Organização, Setor, Listas ABM, Local, ISP, Segmentos correspondentes

Condição
Hierarquia de dados
Exemplo
Segmentos correspondentes (funciona somente após o primeiro clique)
matchedSegments.name
rtp( 'send', 'redirect' , 'matchedSegments.name' , ['Fortune 1.000' , 'Enterprise'] , 'http://www.marketo.com');
Segmentos correspondentes (funciona somente após o primeiro clique)
matchedSegments.id
rtp( 'send', 'redirect' , 'matchedSegments.id' , [106 , 107 , 190] , 'http://www.marketo.com');
Listas ABM
abm.name
rtp( 'send', 'redirect' , 'abm.name' , ['top_key_accounts', 'ative_customers'] , 'http://www.marketo.com');
Listas ABM
abm.code
rtp( 'send', 'redirect' , 'abm.code' , [13 , 15] , 'http://www.marketo.com');
Organizações
org
rtp( 'send', 'redirect' , 'org', ['ebay'], 'http://www.marketo.com');
Local
location.country
rtp( 'send', 'redirect' , 'location.country' , ['United States'], 'http://www.marketo.com');
Local
location.state
rtp( 'send', 'redirect' , 'location.state', ['ca'], 'http://www.marketo.com');
Local
location.city
rtp( 'send', 'redirect' , 'location.city', ['San Mateo'], 'http://www.marketo.com');
Setores
indústrias
rtp( 'enviar', 'redirecionar' , 'indústrias' , ['Educação'], 'http://www.marketo.com');
Provedor de Internet
isp
rtp( 'send', 'redirect' , isp , ['False'], 'http://www.marketo.com');

Observações

  • Se a regra/condição de redirecionamento se basear em Firmographics (empresa, setor, localização), é possível inserir o código de redirecionamento antes do rtp('send', 'view') e do rtp('get','campaign') para reduzir a latência.
  • O redirecionamento via JavaScript é um redirecionamento no lado do navegador e depende do carregamento e da otimização do site para atingir a velocidade máxima.
  • A prática recomendada é definir o código de redirecionamento logo após a tag rtp e colocá-lo no cabeçalho.
  • Verifique se você não está executando um autoredirecionamento (há uma rede de segurança no rtp para bloquear chamadas de redirecionamento cíclicas).
<!DOCTYPE html>
<html lang="en-US">
<head>
<!-- RTP tag -->
<script type='text/javascript'>

// This tag needs to be replaced with your account tag
(function(c,h,a,f,i){c[a]=c[a]||function(){(c[a].q=c[a].q||[]).push(arguments)};
c[a].a=i;var g=h.createElement("script");g.async=true;g.type="text/javascript";
g.src=f+'?rh='+c.location.hostname+'&aid='+i;var b=h.getElementsByTagName("script")[0];b.parentNode.insertBefore(g,b);
})(window,document,"rtp","//xyz.marketo.com/rtp-api/v1/rtp.js","xyz");

// START REDIRECT EXAMPLE
//   - Using a helper redirect function
//   - Redirect based on named account
rtp('send','redirect','org', ['microsoft'],'http://www.marketo.com');

// Redirect based on named account list (ABM)
rtp('send','redirect','abm.name', {
    // Redirect visitors that match 'first_abm' list to www.marketo.com
    'http://www.marketo.com' : ['first_abm'],
    // Redirect visitors that match 'second_abm' list to blog.marketo.com
    'http://blog.marketo.com' : ['second_abm']
});
// END REDIRECT EXAMPLE
rtp('send','view');
rtp('get','campaign');
</script>
<!-- End of RTP tag -->

Como redirecionar visitantes rastreados

  1. Anexe um parâmetro ao final do URL de destino: ou seja, www.marketo.com?rtp=redirect
  2. Crie um segmento chamado - "Redirecionado pelo RTP"
  3. Use o parâmetro "Páginas específicas" para direcionar os visitantes que visualizam qualquer página com o parâmetro mostrado abaixo.

visitantes-redirecionados-de-rastreamento

Como definir mais de uma condição com URLs de destino diferentes

A chamada de redirecionamento oferece suporte a várias chamadas. Isso permite redirecionar com vários campos e criar condições complexas com URLs e valores diferentes.

Uso

rtp('send', 'redirect', field_name, url_values_map);

Parâmetro
Opcional/Obrigatório
Tipo
Descrição
'enviar'
Obrigatório
Sequência de caracteres
Ação do método.
'redirecionar'
Obrigatório
Sequência de caracteres
Nome do método.
field_name
Obrigatório
Sequência de caracteres
Nome do campo para corresponder. Exemplo: 'abm.name' (veja acima).
url_values_map
Obrigatório
Objeto
Mapear entre o URL de redirecionamento e a lista de valores. Exemplo:{'http://marketo.com' : ['first_abm', 'second_abm']}

Exemplo

rtp('send','redirect','abm.name', {
    // Redirect visitors that match 'first_abm' list to www.marketo.com
    'http://www.marketo.com' : ['first_abm'],
    // Redirect visitors that match 'second_abm' list to blog.marketo.com
    'http://blog.marketo.com' : ['second_abm']
});
rtp('send','redirect','org', {
    // Redirect visitors from 'Microsoft' to www.marketo.com/enterprise
    'http://www.marketo.com/enterprise' : ['microsoft']
});
recommendation-more-help
bb269a6d-047a-4bf7-9acd-23ad9a63dc59