Générer des identifiants d’appareil propriétaires

Les applications Adobe Experience Cloud génèrent traditionnellement des cookies pour stocker les identifiants d’appareils à l’aide de différentes technologies, notamment :

Des modifications récentes apportées au navigateur limitent la durée de ces types de cookies. Les cookies propriétaires sont plus efficaces lorsqu’ils sont définis à l’aide d’un serveur détenu par le client à l’aide d’un enregistrement DNS A/AAAA plutôt que d’un CNAME DNS. La fonctionnalité Identifiant d’appareil interne (FPID) permet aux clients implémentant Adobe Experience Platform Web SDK d’utiliser les identifiants d’appareil dans les cookies des serveurs à l’aide des enregistrements DNS A/AAAA. Ces identifiants peuvent ensuite être envoyés à Adobe et utilisés comme adresses de contrôle pour générer des identifiants Experience Cloud (ECID), qui restent l’identifiant principal dans les applications Adobe Experience Cloud.

Voici un exemple rapide de la manière dont cette fonctionnalité fonctionne :

Pour ce tutoriel, un exemple spécifique utilisant le langage de script PHP est utilisé pour montrer comment :

Vous trouverez plus d’informations sur les identifiants d’appareils propriétaires dans la documentation du produit.

Générer un UUIDv4

PHP n'a pas de bibliothèque native pour la génération d'UUID, donc ces exemples de code sont plus étendus que ce qui serait nécessaire si un autre langage de programmation était utilisé. PHP a été choisi pour cet exemple parce que c'est un langage côté serveur largement pris en charge.

Lorsque la fonction suivante est appelée, elle génère un UUID aléatoire version-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));
    }

?>

Écrire la valeur UUIDv4 dans un cookie

Le code suivant envoie une requête à la fonction ci-dessus pour générer un UUID. Il définit ensuite les indicateurs de cookie décidés par votre organisation. Si un cookie a déjà été généré, l’expiration est prolongée.

<?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);
    }

?>

Inclure la valeur du cookie dans le mappage d’identités

La dernière étape consiste à utiliser PHP pour faire écho à la valeur du cookie dans le mappage d'identité.

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

Valider la génération d’ECID

Validez la mise en œuvre en confirmant que le même ECID est généré à partir de votre identifiant d’appareil interne :

Pour plus d’informations sur cette fonctionnalité, consultez la documentation.