SHA256 Hash-stöd för setCustomerIDs

Senaste uppdatering: 2023-04-27
  • Skapat för:
  • Developer
    User
    Admin
    Leader

Experience Cloud ID-tjänsten (ECID) stöder SHA-256-algoritmen som gör att du kan skicka in kund-ID:n eller e-postadresser och skicka ut hash-kodade ID:n. Detta är en valfri JavaScript-metod för att skicka hash-kodade identifierare till Experience Cloud. Du kan fortsätta att använda dina egna metoder för hashning innan du skickar kund-ID:n.
Det finns två sätt att implementera hash-stöd med setCustomerID, vilket beskrivs i avsnitten nedan:

Använd setCustomerIDs metod i ECID

Den första metoden använder setCustomerIDs (customerIDs<object>, hashType<string>).

ECID-biblioteket utför datavypnormalisering på kund-ID:n innan hash inträffar. Den här processen trimmar de tomma områdena för användar-ID:n i båda ändar och konverterar alla tecken till gemener. Exempel: " ecid@adobe.com " blir "ecid@adobe.com"

Nedan visas ett kodexempel på hur du anger ett enda kund-ID (den e-postadress som nämns ovan) med SHA-256-hash.

// Set single customerID with SHA-256 hashing
visitor.setCustomerIDs({email: {id: "ecid@adobe.com", authState: 1}}, "SHA-256");

Tillsammans med besökar-ID:t för Experience Cloud kan du koppla ytterligare kund-ID:n, autentiseringsstatus och hash-typ (SHA-256) till varje besökare. Om du inte anger någon hash-typ betraktas den som ingen hash.

The setCustomerIDs metoden godkänner flera kund-ID:n för samma besökare. Detta hjälper er att identifiera eller rikta in er på en enskild användare på olika enheter. Du kan till exempel överföra dessa ID:n som kundattribut till Experience Cloud och få tillgång till dessa data via olika lösningar.

Kund-ID, autentiserade tillstånd och hash-typ är inte lagras i en cookie som ska användas senare. I stället ska Kund-ID, autentiserade tillstånd och hash-typ lagras i en instansvariabel som ska hämtas med getCustomerIDs, enligt nedan:

> visitor.getCustomerIDs();
< {email: {…}}
    email: {id: "a6ea4cde5da5ae7cc68baae894d1d6544fca26254433b0fff7c2cb4843b4a097", authState: 1, hashType: "SHA-256"}
    __proto__: Object

Använda setCustomerIDs -metoden leder till ett anrop till Experience Cloud ID-tjänsten, till dpm.demdex.net, med tillägget d_cid_ic frågeparameter, som innehåller det hashkodade kund-ID:t. Ett exempelanrop kan se ut som det nedan. Radbrytningar lades till för tydlighet.

http://dpm.demdex.net/id?d_visid_ver=4.4.0&d_fieldgroup=AAM&d_rtbd=json&d_ver=2&
d_orgid=12A3F3F459CE0AD80A495CBE%40AdobeOrg&d_nsid=0&d_mid=12349850857640731290890207735189050123&
d_blob=6G1ynYcLPuiQxYZrsz_pkqfLG9yMXBpb2zX5dvJdYQJzPXImdj0y&
d_cid_ic=email%a6ea4cde5da5ae7cc68baae894d1d6544fca26254433b0fff7c2cb4843b4a097%011&
ts=1563299964843

Se tabellen nedan för en beskrivning av d_cid_ic parameter och autentiseringstillstånd.

Parameter Beskrivning
d_cid_ic Skickar integreringskoden, det unika användar-ID:t (DPUID) och ett autentiserat tillstånds-ID till ID-tjänsten. Separera integreringskoden och DPUID med kontrolltecknet som inte skrivs ut, %01:
Exempel: d_cid_ic=Integration_code%01DPUID%01Authentication_state
Autentiseringstillstånd
Detta är ett valfritt ID i parametern d_cid_ic. Uttryckt som ett heltal identifierar det användare utifrån deras autentiseringsstatus enligt nedan:
  • 0 (Okänd eller aldrig autentiserad)
  • 1 (autentiserad för den här instansen/sidan/appkontexten)
  • 2 (utloggad)

Exempel:
  • Okänd: …d_cid=123%01456%010
  • Autentiserad: …d_cid=123%01456%011
  • Utloggad: …d_cid=123%01456%012

Lägg till en åtgärd i Adobe Experience Platform Launch

Experience Platform Launch är nästa generation av tagghanteringsfunktioner från Adobe. Läs mer om Platform launch i Starta produktdokumentation.

Om du vill lägga till en åtgärd i Launch läser du regeldokumentation i Adobe Launch och se skärmbilden nedan:


När du har bekräftat din konfiguration kapslar Launch in data i ett objekt, som nedan:

{
    integration_code: {
        id: "value",
        authState: auth_state,
        hashType: "hash_algorithm"
    }
}

Här följer ett kodexempel:

// Set single customer ID with hash type
setCustomerIDs(Ingeration code: {
    id: "string_value",
    authState: auth_state,
    hashType: "hash_algorithm"
});

På samma sätt som setCustomerIDs som beskrivs i första avsnittet, leder detta till ett anrop till Experience Cloud ID-tjänsten, med tillägg av d_cid_ic frågeparameter.

På denna sida