Apparaat-id's van de eerste fabrikant genereren

Adobe Experience Cloud-toepassingen hebben van oudsher cookies gegenereerd om apparaatid's op te slaan met behulp van verschillende technologieën, zoals:

Recente browserwijzigingen beperken de duur van dit type cookies. De koekjes van de eerste partij zijn het meest efficiënt wanneer zij gebruikend een klant-bezeten server gebruikend DNS A/AAAA-verslag in tegenstelling tot DNS CNAME worden geplaatst. Met de FPID-functionaliteit (First-party device ID) kunnen klanten die Adobe Experience Platform Web SDK implementeren, apparaat-id's gebruiken in cookies van servers die DNS A/AAAA-records gebruiken. Deze id's kunnen vervolgens naar de Adobe worden verzonden en worden gebruikt als zaden om Experience Cloud-id's (ECID's) te genereren, wat de primaire id blijft in Adobe Experience Cloud-toepassingen.

Hier volgt een kort voorbeeld van de werking van de functionaliteit:

In deze zelfstudie wordt een specifiek voorbeeld met PHP-scripttaal gebruikt om te tonen hoe:

Aanvullende documentatie met betrekking tot apparaat-id's van de eerste fabrikant vindt u in de productdocumentatie.

Een UUIDv4 genereren

PHP heeft geen native bibliotheek voor het genereren van UUID, dus deze codevoorbeelden zijn uitgebreider dan wat waarschijnlijk vereist zou zijn als een andere programmeertaal werd gebruikt. PHP werd gekozen voor dit voorbeeld omdat het een breed ondersteunde server-side taal is.

Wanneer de volgende functie wordt aangeroepen, genereert deze een willekeurige UUID-versie 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));
    }

?>

UUIDv4-waarde naar een cookie schrijven

De volgende code vraagt de bovenstaande functie om een UUID te genereren. Vervolgens worden de cookie-vlaggen ingesteld die door uw organisatie worden bepaald. Als er al een cookie is gegenereerd, wordt de vervaldatum verlengd.

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

?>

De cookie-waarde opnemen in het identiteitsoverzicht

De laatste stap is om PHP te gebruiken om de koekjeswaarde aan de Kaart van de Identiteit te echo.

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

ECID-generatie valideren

Valideer de implementatie door te bevestigen dat dezelfde ECID wordt gegenereerd op basis van uw apparaat-id van de eerste partij:

Voor meer informatie over deze eigenschap, zie de documentatie.