Casos de uso DIL y ejemplos de código

Última actualización: 2023-08-02
ADVERTENCIA

A partir de julio de 2023, el Adobe ha interrumpido el desarrollo del Data Integration Library (DIL) y el DIL extensión.

Los clientes existentes pueden seguir utilizando su DIL implementación. Sin embargo, el Adobe no se desarrollará DIL más allá de este punto. Se recomienda a los clientes que evalúen SDK web de Experience Platform para su estrategia de recopilación de datos a largo plazo.

Los clientes que deseen implementar nuevas integraciones de recopilación de datos a partir de julio de 2023 deben utilizar SDK web de Experience Platform en su lugar.

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

Envío de elementos de datos al Audience Manager con el DIL

Cree una variable de objeto que envíe información sobre elementos de página a Audience Manager. Esto resulta útil para la recopilación de datos generales o como alternativa a la recopilación de datos con variables de Analytics.

Descripción

El siguiente código muestra cómo recopilar datos de página y enviarlos al Audience Manager con DIL. En estos ejemplos se utiliza una variable para guardar elementos de datos en una lista plana o una matriz. Recuerde, pasar variables como pares clave-valor. Además, tenga en cuenta lo siguiente c_ prefijo antes de la clave en el par clave-valor. Esta prefijo obligatorio identifica la información como datos definidos por el usuario. En el primer ejemplo, debe anexar manualmente c_ a la clave. En el segundo ejemplo, DIL lo hace automáticamente.

Mantener Coherentes Las Propiedades Del Valor

Recuerde mantener las mismas propiedades de valor 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, pasar color:blue y color:red establece el valor devuelto en rojo (sobrescribe el azul).

Ejemplo 1: Enviar datos como pares clave-valor

Este ejemplo básico envía datos de color y precio al Audience Manager en forma de pares clave-valor. Su código puede tener un aspecto similar al siguiente:


var sample_dil = DIL.create({partner:"partner name"});
sample_dil.api.signals({
   c_color:"blue",
   c_price:"900"
});
sample_dil.api.submit();

Ejemplo 2: Enviar datos en un objeto

En este ejemplo avanzado se muestra cómo enviar datos en un objeto al Audience Manager. Al trabajar con este método, DIL permite pasar un objeto como parámetro de función a signals() método. DIL Su código puede tener un aspecto similar al siguiente:


var my_object = {
   color : "blue",
   price : "900"
};

var sample_dil = DIL.create({ partner : "partner name" });
//Load the object and append "c_" to all keys in the key-value pairs and send data to AudienceManager.
sample_dil.api.signals(my_object,"c_").submit();

Ejemplo 3: Enviar datos de página en una matriz

En este caso, la variable my_object utiliza una matriz para contener 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 tipo de producto y a un modelo. Su código puede tener un aspecto similar al siguiente:


var my_objects = [{
   color : "blue",
   price : "900"
}, {
   type : "acura",
   model : "tl"
}];

var sample_dil = DIL.create({ partner : "partner name" });

for (var i = 0; i < my_objects.length; i++)
//Load the object and append "c_" to all the keys in the key-value pairs.
{
    sample_dil.api.signals(my_objects[i], "c_");
}
sample_dil.api.submit();

Capturar URL de referencia

Capturar y enviar una URL de referencia al Audience Manager.

NOTA

Este método solo funciona cuando los usuarios se desplazan entre páginas con protocolos similares (HTTP o HTTPS). Por ejemplo, el explorador conserva una dirección URL de referencia cuando se navega de un sitio seguro a otro sitio seguro. Los navegadores no conservan la dirección URL de referencia cuando se desplaza entre sitios seguros y no seguros. Este comportamiento es normal y no se puede evitar con DIL.

Ejemplo de código

Su código puede tener un aspecto similar al siguiente:


var adobe_dil = DIL.create({ partner : "partner name" });
adobe_dil.api.signals({ 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 al Audience Manager.

IMPORTANTE

En esta sección se describe la funcionalidad heredada, que no es compatible con las últimas versiones de DIL.

Motores de búsqueda admitidos

De forma predeterminada, DIL.getSearchReferrer reconoce las búsquedas de 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 ha buscado el término "home" desde Google Canadá ( www.google.ca). Este código le ayudará a capturar esos términos de búsqueda y a enviarlos a Audience Manager.

Código básico

Código básico para obtener el referente de búsqueda (de google.com, por 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 ha buscado el término "home" desde Google Canadá ( www.google.ca). Observe cómo el código prefija el valor requerido c_ parámetro del motor de búsqueda ( c_se) y término de búsqueda ( c_st). c_ es un prefijo obligatorio que las identifica como variables definidas por el cliente para el Audience Manager.


var adobe_dil = DIL.create({partner:"partner name"});
var search_referrer = DIL.tools.getSearchReferrer();

if (search_referrer && search_referrer.valid) {
  adobe_dil.api.signals({
    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 ha buscado el término "home" desde dogpile.com. Porque Dogpile no es compatible 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. Su código puede tener un aspecto similar al siguiente:


var adobe_dil = DIL.create({partner:"partner name"});
var search_referrer = DIL.tools.getSearchReferrer(document.referrer, {
    hostPattern:/dogpile\./,
    queryParam:"q"
});

if (search_referrer && search_referrer.valid) {
  adobe_dil.api.signals({
    c_se : se.name,
    c_st : se.keywords
  }).submit();
}

Asignar valores de clave a otras claves

Asocie el valor de un par clave-valor a otra clave.

Descripción

En un par clave-valor, la variable c_ El prefijo anexado a la clave identifica la señal como datos definidos por el cliente. Los datos definidos por el cliente se utilizan para la segmentación en el sitio específico que pasó datos en una llamada de evento. Sin embargo, a veces desea que esta información esté disponible en todas las propiedades de la cuenta de Audience Manager. Para ello, asigne el valor en una c_ par clave-valor con una clave a nivel de plataforma. Una clave de nivel de plataforma lleva el prefijo d_ y hace que la señal esté disponible para la segmentación en todas las propiedades de la cuenta.

Por ejemplo, puede recopilar datos de código postal de un sitio concreto pero querer segmentarlos para que incluyan todas las propiedades del Audience Manager. Para que el código postal esté disponible en el nivel de plataforma, puede asignar la clave de código postal definida por el cliente (por ejemplo, c_zip) a una clave definida por la plataforma como se muestra a continuación.

Ejemplo de código

Su código puede 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 un DIL con una etiqueta GTM.

Este procedimiento supone que tiene un Google Tag Manager cuenta, algún conocimiento práctico de ese producto y su Audience Manager dil.js archivo.

Para enviar tráfico a dil.js archivo en GTM:

  1. Cree un nuevo contenedor o abra uno existente.

  2. Agregue una etiqueta nueva al contenedor.

  3. Abra la etiqueta para editarla y:

    • Asigne un nombre a la etiqueta
    • Seleccionar Custom HTML Tag desde el Tag Type lista desplegable.
    • En el campo HTML, coloque la variable DIL código (biblioteca + código personalizado) en etiquetas de script <script>DIL code</script>.
    • Haga clic Save.
  4. Publique el contenedor.

  5. Genere el código de la etiqueta contenedora y colóquelo en su inventario.

En esta página