Manuale dell'API di Rich Media

Come utilizzare URL di uscita dinamica

Obiettivo

Utilizza un URL di uscita di un'origine dati esterna (come Fogli Google, un feed XML o Google Merchant Center) anziché inserirlo in Studio, Campaign Manager 360 o Google Ad Manager. 

Soluzione

Il metodo Enabler.exitOverride(id, url) dell'SDK HTML5 di Studio sostituisce qualsiasi URL di uscita inserito in Studio, Campaign Manager 360 o Ad Manager.

Esempi

Imposta una variabile stringa, exitURL, in cui memorizzare l'URL di destinazione della creatività. L'URL può essere trasmesso in modo dinamico tramite XML, derivato da un feed dinamico o hardcoded.

Utilizzare un URL di uscita da un feed dinamico in Google Web Designer

  1. Nel riquadro Dinamici, fai clic su + per aggiungere le associazioni dinamiche.
  2. Nella scheda Associazioni della finestra di dialogo Proprietà dinamiche, fai clic su Aggiungi associazione.
  3. Per l'elemento, seleziona l'ID dell'area tocco.
  4. Per l'attributo dell'elemento, seleziona Exit override URL (URL di uscita di sostituzione).
  5. Per l'oggetto schema dei dati, seleziona l'oggetto dal feed che rappresenta l'URL dinamico (ad esempio Product.0.url).

Uscite dinamiche in Studio

Utilizzare un URL di uscita di un feed dinamico in JavaScript

// Replace the dynamicContent value below with your own dynamic element value.
var exitURL = dynamicContent.Feed_1[0].ExitURL.Url;

function exitClickHandler() {
  Enabler.exitOverride("exit name goes here", exitURL);
}

exitButton.addEventListener('click', exitClickHandler, false);

Utilizzare un URL di uscita hardcoded in JavaScript

Utilizza un URL di uscita hardcoded solo quando sai che l'URL non dovrà essere modificato in seguito. Se devi modificarlo, devi aggiornare il codice della creatività e inviare nuovamente la creatività per la gestione del traffico. 

// productId è un valore calcolato in un altro punto del codice e
// non viene mostrato in questo esempio.
var exitURL = "http://www.yoursite.com?product=" + productId;

function exitClickHandler() {
  Enabler.exitOverride("exit name goes here", exitURL);
}

exitButton.addEventListener('click', exitClickHandler, false);

 

Aggiungere valori o parametri agli URL di uscita dinamica

Utilizza un altro metodo per aggiungere il monitoraggio di terze parti agli URL di uscita dinamica nel codice JavaScript della creatività per recuperare i parametri impostati in Campaign Manager 360. Il metodo Enabler.getParameter ti consente di ricavare il valore del suffisso della pagina di destinazione (memorizzato nella macro exit_suffix) e di aggiungerlo agli URL di uscita del feed dinamico associato.

Passaggio 1: aggiungi il codice alla creatività

Usando una delle opzioni che seguono, aggiungi il codice alla creatività per abbinare l'URL di uscita dinamica al suffisso di Campaign Manager 360.

Abbinare l'URL di uscita dinamica e il suffisso in Google Web Designer

  1. Fai clic sull'area tocco su cui vuoi applicare l'uscita dinamica e il suffisso.
  2. Aggiungi un nuovo evento (fai clic sul pulsante "+" nel riquadro Eventi).
  3. Seleziona Area tocco > Tocco/clic nel passaggio Evento.
  4. Nel passaggio Azione, seleziona Personalizzata > Aggiungi azione personalizzata Add custom action
  5. Aggiungi un nome funzione, quindi incolla il seguente codice personalizzato nell'area di testo. Sostituisci l'URL di uscita di esempio con il tuo URL di uscita.
  6. Fai clic su OK.
// Sostituisci il valore dynamicContent qui sotto con il valore del tuo elemento dinamico.
var exitURL = dynamicContent.Feed_1[0].ExitURL.Url;
var urlSuffix = Enabler.getParameter('exit_suffix'); 
var symbol = (exitURL.indexOf('?') > -1) ? '&': '?'; 
if (urlSuffix) { 
  while (urlSuffix.charAt(0) == '?' || urlSuffix.charAt(0) == '&') { 
    urlSuffix = urlSuffix.substring(1); 
  } 
  if (urlSuffix.indexOf('?') > -1) { 
    urlSuffix = urlSuffix.replace(/\?/g, '&'); 
  } 
} 
exitURL = exitURL + symbol + urlSuffix;

Enabler.exitOverride('exit', exitURL);

Custom code to add a dynamic exit suffix
Abbinare l'URL di uscita dinamica e il suffisso utilizzando JavaScript in un editor HTML qualsiasi

Se utilizzi un editor HTML diverso da Google Web Designer, usa un metodo JavaScript come quello descritto di seguito per recuperare il suffisso di uscita da Campaign Manager 360. Prima di chiamare questa funzione, devi caricare e inizializzare l'Enabler.

function addSuffix(url, dcmParameter) { 
  var urlSuffix = Enabler.getParameter(dcmParameter); 
  var _url = ''; 

  if (url) { 
    var symbol = (url.indexOf('?') > -1) ? '&': '?'; 
    if(urlSuffix) { 
      while (urlSuffix.charAt(0) == '?' || urlSuffix.charAt(0) == '&') { 
        urlSuffix = urlSuffix.substring(1); 
      } 
      if (urlSuffix.indexOf('?') > -1) { 
        urlSuffix = urlSuffix.replace(/\?/g, '&'); 
      } 
    } 
    _url = url + symbol + urlSuffix; 
  } 
  return _url; 
} 

// Esempio di come useresti questa funzione
exitUrl = addSuffix(exitUrl, 'exit_suffix'); 

Passaggio 2: aggiungi i parametri URL in Campaign Manager 360

Dopo aver aggiunto la creatività a Campaign Manager 360, inserisci i parametri di ricerca che verranno accodati all'URL di uscita aggiungendo un suffisso della pagina di destinazione.

Scegli dove aggiungere il suffisso in base alla posizione in cui dovrebbe essere applicato:

  • Tutte le pagine di destinazione in tutte le campagne: aggiungi il suffisso nelle proprietà dell'inserzionista.
  • Tutte le pagine di destinazione in una campagna: aggiungi il suffisso nelle proprietà della campagna.
  • Tutte le creatività assegnate a un annuncio: aggiungi il suffisso nelle proprietà dell'annuncio.

Imposta il suffisso al massimo livello per applicarlo al maggior numero di creatività possibile. Puoi sostituire il suffisso impostandolo a un livello inferiore e più specifico. Ad esempio, se imposti un suffisso nelle proprietà dell'inserzionista, qualsiasi suffisso impostato nelle proprietà della campagna o dell'annuncio sostituirà il suffisso a livello di inserzionista.

Aggiungere un suffisso della pagina di destinazione

  1. Apri le proprietà dell'annuncio, della campagna o dell'inserzionista e fai clic su Suffisso URL della pagina di destinazione
  2. Inserisci l'intero suffisso nella casella di testo. I suffissi possono includere più parametri di ricerca, ma non devono superare i 128 caratteri. Se il suffisso viene ereditato, puoi modificarlo nell'elemento principale o disattivare Eredita suffisso URL. Quando l'ereditarietà è attiva, viene utilizzato il suffisso dell'elemento principale. Un suffisso ereditato per una campagna proviene dalle impostazioni dell'inserzionista. Un suffisso ereditato in un annuncio proviene dalle impostazioni della campagna.
  3. Campaign Manager 360 identifica tutte le coppie chiave-valore presenti nel suffisso e ti consente di modificarle sotto il campo come parametri di ricerca. Puoi scegliere macro o inserire stringhe personalizzate. Per rimuovere una coppia chiave-valore, fai clic sull'icona di rimozione .

Example of landing page URL suffix settings

Impostazioni del suffisso dell'URL pagina di destinazione ed editor delle coppie chiave-valore in Campaign Manager 360.

Leggi ulteriori informazioni sui suffissi delle pagine di destinazione nel Centro assistenza Campaign Manager 360

È stato utile?

Come possiamo migliorare l'articolo?

Hai bisogno di ulteriore assistenza?

Prova i passaggi successivi indicati di seguito:

Ricerca
Cancella ricerca
Chiudi ricerca
Menu principale
14676601625630620903
true
Cerca nel Centro assistenza
true
true
true
true
true
74220
false
false