Generación de ID de dispositivos de origen

Las aplicaciones de Adobe Experience Cloud han generado tradicionalmente cookies para almacenar los ID de dispositivo mediante diferentes tecnologías, entre las que se incluyen:

1. Cookies de terceros
2. Cookies de origen configuradas por un servidor de Adobe mediante la configuración CNAME de un nombre de dominio
3. Cookies de origen configuradas por JavaScript

Los cambios recientes en el explorador restringen la duración de estos tipos de cookies. Las cookies de origen son más efectivas cuando se establecen mediante un servidor propiedad del cliente que utiliza un registro A/AAAA DNS, en lugar de un CNAME DNS. La funcionalidad de ID de dispositivo de origen (FPID) permite a los clientes que implementan el SDK web de Adobe Experience Platform utilizar ID de dispositivo en cookies de servidores que utilizan registros A/AAAA de DNS. Estos ID se pueden enviar al Adobe de y se pueden usar como semillas para generar ID de Experience Cloud (ECID), que sigue siendo el identificador principal en las aplicaciones de Adobe Experience Cloud.

A continuación se muestra un ejemplo rápido de cómo funciona la funcionalidad:

1. Un explorador del usuario final solicita una página web del servidor web o CDN de un cliente.
2. El cliente genera un ID de dispositivo (FPID) en su servidor web o CDN (el servidor web debe estar vinculado al registro A/AAAA de DNS del nombre de dominio).
3. El cliente establece una cookie de origen para almacenar el FPID en el explorador del usuario final.
4. La implementación del SDK web de Adobe Experience Platform del cliente realiza una solicitud a Platform Edge Network, incluido el FPID en el mapa de identidad.
5. Experience Platform Edge Network recibe el FPID y lo utiliza para generar un ID de Experience Cloud (ECID).
6. La respuesta del SDK web de Platform devuelve el ECID al explorador del usuario final.
7. Si la variable idMigrationEnabled=true, Platform Web SDK utiliza JavaScript para almacenar el ECID como AMCV_ en el explorador del usuario final.
8. En el caso de que la variable AMCV_ Cuando la cookie caduca, el proceso se repite. Siempre que esté disponible el mismo ID de dispositivo de origen, se añade un nuevo AMCV_ La cookie se crea con el mismo valor de ECID que antes.

Para este tutorial, se utiliza un ejemplo específico utilizando el lenguaje de script PHP para mostrar cómo:

• Generación de un UUIDv4
• Escribir el valor de UUIDv4 en una cookie
• Incluir el valor de la cookie en el mapa de identidad
• Validar la generación de ECID

Puede encontrar más documentación relacionada con los ID de dispositivos de origen en la documentación del producto.

Generación de un UUIDv4

PHP no tiene una biblioteca nativa para la generación de UUID, por lo que estos ejemplos de código son más extensos de lo que probablemente se requeriría si se utilizara otro lenguaje de programación. Se eligió PHP para este ejemplo porque es un lenguaje ampliamente compatible del lado del servidor.

Cuando se llama a la siguiente función, genera un UUID aleatorio versión 4:

<?php

    function guidv4($data)
    {
        $data = $data ?? random_bytes(16);

        $data[6] = chr(ord($data[6]) & 0x0f | 0x40); // set version to 0100
        $data[8] = chr(ord($data[8]) & 0x3f | 0x80); // set bits 6-7 to 10

        return vsprintf('%s%s-%s-%s-%s-%s%s%s', str_split(bin2hex($data), 4));
    }

?>

Escribir el valor de UUIDv4 en una cookie

El siguiente código realiza una solicitud a la función anterior para generar un UUID. A continuación, establece los indicadores de cookies que ha decidido su organización. Si ya se ha generado una cookie, se amplía la caducidad.

<?php

    if(!isset($_COOKIE['FPID'])) {
        $cookie_value = guidv4(openssl_random_pseudo_bytes(16));
        $arr_cookie_options = array (
        'expires' => time() + 60*60*24*30*13,
        'path' => '/',
        'domain' => 'mysiteurl.com',
        'secure' => true,
        'httponly' => true,
        'samesite' => 'lax'
        );
        setcookie($cookie_name, $cookie_value, $arr_cookie_options);
        $_COOKIE[$cookie_name] = $cookie_value;
    }
    else {
        $cookie_value = $_COOKIE[$cookie_name];
        $arr_cookie_options = array (
        'expires' => time() + 60*60*24*30*13,
        'path' => '/',
        'domain' => 'mysiteurl.com',
        'secure' => true,
        'httponly' => true,
        'samesite' => 'lax'
        );
        setcookie($cookie_name, $cookie_value, $arr_cookie_options);
    }

?>

Incluir el valor de la cookie en el mapa de identidad

El paso final es usar PHP para repetir el valor de la cookie en el mapa de identidad.

{
    "identityMap": {
        "FPID": [
                    {
                        "id": "<? echo $_COOKIE[$cookie_name] ?>",
                        "authenticatedState": "ambiguous",
                        "primary": true
                    }
                ]
        }
}

Validar generación de ECID

Valide la implementación confirmando que se genera el mismo ECID a partir del ID del dispositivo de origen:

1. Genere una cookie FPID.
2. Envíe una solicitud a Platform Edge Network mediante el SDK web de Platform.
3. Una cookie con el formato AMCV_<IMSORGID@AdobeOrg> se genera. Esta cookie contiene el ECID.
4. Tome nota del valor de la cookie que se genera y, a continuación, elimine todas las cookies del sitio, excepto la FPID cookie.
5. Envíe otra solicitud a Platform Edge Network.
6. Confirme el valor en la variable AMCV_<IMSORGID@AdobeOrg> La cookie es la misma ECID como en el AMCV_ cookie que se ha eliminado. Si el valor de la cookie es el mismo para un FPID determinado, el proceso de inicialización del ECID se realizó correctamente.

Para obtener más información acerca de esta función, consulte la documentación.