Documentazione Guida per sviluppatori di Marketo

Reindirizza

Ultimo aggiornamento: 5 maggio 2025

Argomenti:
SCR-160012

Creato per:

Amministratore

L’API di reindirizzamento RTP consente di reindirizzare i tipi di pubblico segmentati a un URL di destinazione.

Prima di utilizzare l'API Contesto utente, è necessario diventare un cliente di Web Personalization e disporre del tag RTP distribuito sul sito.
RTP non supporta gli elenchi di account denominati Account Based Marketing (Marketing basato su account). Gli elenchi e il codice ABM si riferiscono solo agli elenchi di account caricati (file CSV) gestiti all’interno di RTP.

Utilizzo

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

Parametro	Facoltativo/Obbligatorio	Tipo	Descrizione
'invia'	Obbligatorio	Stringa	Azione del metodo.
'reindirizza'	Obbligatorio	Stringa	Nome del metodo.
nome_campo	Obbligatorio	Stringa	Nome del campo da confrontare. Esempio: "abm.name" (vedi sotto).
matrice_valori	Obbligatorio	Array	Elenco di valori con cui confrontare il campo (senza distinzione maiuscole/minuscole).
redirect_url	Obbligatorio	Stringa	URL di destinazione per reindirizzare i visitatori che corrispondono alla condizione.
redirect_matched_visitors	Facoltativo	Booleano	Se true, i visitatori con la condizione corrispondente verranno reindirizzati. Se false, i visitatori senza corrispondenza vengono reindirizzati. Impostazione predefinita: true.

Organizzazione, settore, elenchi ABM, ubicazione, ISP, segmenti corrispondenti

Condizione	Gerarchia dei dati	Esempio
Segmenti corrispondenti (funziona solo dopo il primo clic)	matchedSegments.name	rtp( 'send', 'redirect' , 'matchedSegments.name' , ['Fortune 1,000' , 'Enterprise'] , 'http://www.marketo.com');
Segmenti corrispondenti (funziona solo dopo il primo clic)	matchedSegments.id	rtp( 'send', 'redirect' , 'matchedSegments.id' , [106 , 107 , 190] , 'http://www.marketo.com');
Elenchi ABM	abm.name	rtp( 'send', 'redirect' , 'abm.name' , ['top_key_accounts', 'active_customers'] , 'http://www.marketo.com');
Elenchi ABM	abm.code	rtp( 'send', 'redirect' , 'abm.code' , [13 , 15] , 'http://www.marketo.com');
Organismi	org	rtp( 'send', 'redirect' , 'org', ['ebay'], 'http://www.marketo.com');
Posizione	location.country	rtp( 'send', 'redirect' , 'location.country' , ['United States'], 'http://www.marketo.com');
Posizione	location.state	rtp( 'send', 'redirect' , 'location.state', ['ca'], 'http://www.marketo.com');
Posizione	location.city	rtp( 'send', 'redirect' , 'location.city', ['San Mateo'], 'http://www.marketo.com');
Settori	settori	rtp( 'send', 'redirect' , 'industrie' , ['Istruzione'], 'http://www.marketo.com');
ISP	isp	rtp( 'send', 'redirect' , isp , ['False'], 'http://www.marketo.com');

Note

Se la regola/condizione di reindirizzamento è basata su Firmographics (company, industry, location), è possibile inserire il codice di reindirizzamento prima di rtp('send', 'view') e rtp('get','campaign') per ridurre la latenza.
Il reindirizzamento tramite JavaScript è un reindirizzamento lato browser e dipende dal caricamento e dall’ottimizzazione del sito web per raggiungere la velocità massima.
La best practice prevede di impostare il codice di reindirizzamento subito dopo il tag rtp e inserirlo nell’intestazione.
Assicurati di non eseguire un reindirizzamento automatico (in rtp è presente una rete di sicurezza per bloccare le chiamate di reindirizzamento ciclico).

<!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 -->

Reindirizzare i visitatori tracciati

Aggiungi un parametro alla fine dell’URL di destinazione: ad esempio www.marketo.com?rtp=redirect
Creare un segmento denominato - "Reindirizzato da RTP"
Utilizza il parametro "Pagine specifiche" per indirizzare i visitatori che visualizzano qualsiasi pagina con il parametro mostrato di seguito.

visitatori reindirizzati al tracciamento

Come definire più di una condizione con URL di destinazione diversi

La chiamata di reindirizzamento supporta più chiamate. Questo consente di reindirizzare con più campi e creare condizioni complesse con URL e valori diversi.

Utilizzo

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

Parametro

Facoltativo/Obbligatorio

Tipo

Descrizione

'invia'

Obbligatorio

Stringa

Azione del metodo.

'reindirizza'

Obbligatorio

Stringa

Nome del metodo.

nome_campo

Obbligatorio

Stringa

Nome del campo da confrontare. Esempio: "abm.name" (vedi sopra).

url_values_map

Obbligatorio

Oggetto

Mappa tra l’URL di reindirizzamento e l’elenco di valori. Esempio:{'http://marketo.com' : ['first_abm', 'second_abm']}

Esempio

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