Show Menu
TEMAS×

Casos de uso DIL y ejemplos de código

Muestras de código y descripciones para casos de uso DIL específicos.

Envío de elementos de datos a Audience Manager con DIL

Cree una variable de objeto que envíe información sobre los elementos de página a Audience Manager. Esto resulta útil para la recopilación general de datos o como alternativa para recopilar datos con variables de Analytics.
Descripción
El siguiente código muestra cómo recopilar datos de página y enviarlos a Audience Manager con DIL. Estos ejemplos utilizan una variable para contener elementos de datos en una lista plana o una matriz. Recuerde, pase variables como pares Pares de clave-valor explicados clave-valor. Además, observe el c_ prefijo antes de la clave en el par clave-valor. Este prefijo Requisitos de prefijo para variables clave requerido identifica la información como datos definidos por el usuario. En el primer ejemplo, debe anexar manualmente c_ la clave. En el segundo ejemplo, DIL lo hace automáticamente.
Mantener consistentes las propiedades del valor
Recuerde mantener las propiedades de valor igual al pasar datos. Por ejemplo, si tiene dos claves idénticas con valores diferentes, el valor del último par clave-valor tiene prioridad sobre los objetos de valor anteriores. Por ejemplo, al pasar color:blue y color:red establecer el valor devuelto en rojo (sobrescribe el azul).
Ejemplo 1: Enviar datos como pares de clave-valor
Este ejemplo básico envía datos de color y precio a Audience Manager en forma de pares clave-valor. El código podría tener un aspecto similar al siguiente:
var sample_dil = DIL.create({partner:"

partner name

"}); 
sample_dil.api.signal({ c_color:"blue", c_price:"900" }); 
sample_dil.api.submit();


Ejemplo 2: Envío de datos a un objeto
Este ejemplo avanzado muestra cómo enviar datos en un objeto a Audience Manager. Al trabajar con este método, DIL le permite pasar un objeto como parámetro de función al signals() método. DIL El código podría tener un aspecto similar al siguiente:
var my_object = { color : "blue", price : "900" }; 
 
var sample_dil = DIL.create({ partner: "

partner name

" }); 
//Cargue el objeto y anexe "c_" a todas las claves de los pares clave-valor y envíe datos a AudienceManager. 
sample_dil.api.signal(my_object,"c_").submit();


Ejemplo 3: Envío de datos de página en una matriz
En este caso, la variable my_object utiliza una matriz para almacenar datos. Este ejemplo se basa en la información pasada por el método recomendado anteriormente, pero agrega una capa adicional para dar cabida a un modelo y tipo de producto. El código podría tener un aspecto similar al siguiente:
var my_Objects = [{ color : "blue", price : "900" }, { type : "acura", modelo : "tl" }]; 
 
var sample_dil = DIL.create({ partner: "

partner name

" }); 
 
for (var i = 0; i < my_object.length; i++) //Cargue el objeto y anexe "c_" a todas las claves de los pares clave-valor.  
{ sample_dil.api.signal(my_object[i], "c_"); 
} sample_dil.api.submit();


Capturar URL de referencia

Capture y envíe una dirección URL de referencia a Audience Manager.
Este método solo funciona cuando los usuarios se mueven entre páginas con protocolos similares (HTTP vs HTTPS). Por ejemplo, el explorador retiene una dirección URL de referencia cuando navega de un sitio seguro a otro. Los navegadores no retienen la dirección URL de referencia cuando se mueven entre sitios seguros y no seguros. Este comportamiento es una funcionalidad normal del explorador y no se puede evitar DIL.
Ejemplo de código
El código podría tener un aspecto similar al siguiente:
var adobe_dil = DIL.create({ partner: "

partner name

" }); 
adobe_dil.api.signal({ d_referer : document.referrer }).submit();


Capturar tipos de motores de búsqueda y términos de búsqueda de palabras clave

Envíe información sobre el tipo de motor de búsqueda y las búsquedas de palabras clave a Audience Manager.
En esta sección se describe la funcionalidad heredada, que no se admite en las últimas versiones de DIL.
Motores de búsqueda admitidos
De manera predeterminada, DIL.getSearchReferrer reconoce las búsquedas desde estos motores de búsqueda (incluidas las variaciones internacionales):
  • AOL
  • Ask
  • Bing
  • Google
  • Yahoo!
Descripción
El siguiente código muestra cómo obtener el referente de búsqueda para cualquiera de los motores de búsqueda admitidos. En este caso, supongamos que un usuario buscó el término "hogares" desde Google Canadá ( www.google.ca ). Este código le ayudará a capturar esos términos de búsqueda y enviarlos a Audience Manager.
Código básico
El código básico para obtener el referente de búsqueda (por google.com ejemplo) tiene este aspecto:
var search_referrer = DIL.tools.getSearchReferrer();

Ejemplo de código de motor de búsqueda enumerado
En este caso, supongamos que un usuario buscó el término "hogares" desde Google Canadá ( www.google.ca ). Observe cómo el código prefiere el parámetro requerido c_ al motor de búsqueda ( c_se ) y al término de búsqueda ( c_st ). c_ es un prefijo Requisitos de prefijo para variables clave requerido que identifica estas variables como variables definidas por el cliente en Audience Manager.
var adobe_dil = DIL.create({partner:"nombre

del

socio"}); 
var search_referrer = DIL.tools.getSearchReferrer(); 
 
if (search_referrer && search_referrer.valid) { adobe_dil.api.signal({ c_se : se.name, c_st : se.keywords }).submit(); 
}

Ejemplo de código de motor de búsqueda no enumerado
En este caso, supongamos que un usuario buscó el término "hogares" desde dogpile.com . Debido a que no Dogpile se admite de forma predeterminada, puede configurar DIL para que reconozca este motor de búsqueda y devuelva los términos de búsqueda a Audience Manager. El código podría tener un aspecto similar al siguiente:
var adobe_dil = DIL.create({partner:"nombre

del

socio"}); 
var search_referrer = DIL.tools.getSearchReferrer(document.referrer, { hostPattern:/dogpile\./, queryParam:"q" }); 
 
if (search_referrer && search_referrer.valid) { adobe_dil.api.signal({ c_se : se.name, c_st : se.keywords }).submit(); 
}

Asignar valores clave a otras claves

Asocie el valor de un par clave-valor a otra clave.
Descripción
En un par clave-valor, el c_ prefijo anexado a la clave identifica la señal como datos definidos por el cliente. Los datos definidos por el cliente se utilizan para segmentar en el sitio específico que pasó los datos en una llamada de evento. Sin embargo, a veces desea que esta información esté disponible en todas las propiedades de su cuenta de Audience Manager. Para ello, asigne el valor de un par c_ clave-valor a una clave de nivel de plataforma. Se añade un prefijo a una clave de nivel de plataforma d_ y la señal está disponible para la segmentación en todas las propiedades de la cuenta.
Por ejemplo, recopila datos de código postal de un sitio en particular, pero desea segmentarlos en todas sus propiedades de Audience Manager. Para que el código postal esté disponible a nivel de plataforma, puede asignar la clave de código postal definida por el cliente (p. ej. c_zip ) a una clave definida por la plataforma como se muestra a continuación.
Ejemplo de código
El código podría tener un aspecto similar al siguiente:
var adobe_dil = DIL.create({ 
    partner : "adobe", 
    mappings : { 
        c_zip : 'd_zip', 
        d_key2 : 'h_dil_key2' 
    } 
}); 
adobe_dil.api.signals({c_zip : '10010'}).submit(); 
// Request will look like /event?c_zip=10010&d_zip=10010

DIL de tráfico en Google Tag Manager (GTM)

Configure y proporcione DIL con una etiqueta GTM.
Este procedimiento supone que tiene una Google Tag Manager cuenta, algún conocimiento práctico de ese producto y el archivo de Audience Manager dil.js .
Para el tráfico del dil.js archivo en GTM:
  1. Cree un nuevo contenedor o abra un contenedor existente.
  2. Agregue una nueva etiqueta al contenedor.
  3. Abra la etiqueta para editarla y:
    • Asigne un nombre a la etiqueta.
    • Select Custom HTML Tag from the Tag Type drop-down list.
    • En el campo HTML, coloque el DIL código (biblioteca + el código personalizado) dentro de las etiquetas de script <script>DIL code</script> .
    • Haga clic en Save .
  4. Publique el contenedor.
  5. Genere el código de etiqueta de contenedor y colóquelo en el inventario.