SHA256 Hash-stöd för setCustomerIDs
hashing-support
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 metoden setCustomerIDs
i ECID use-setcustomerids-method
Den första metoden utnyttjar metoden 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.
Metoden setCustomerIDs
accepterar flera kund-ID 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 lagras inte i en cookie som kan 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
, vilket visas nedan:
> visitor.getCustomerIDs();
< {email: {…}}
email: {id: "a6ea4cde5da5ae7cc68baae894d1d6544fca26254433b0fff7c2cb4843b4a097", authState: 1, hashType: "SHA-256"}
__proto__: Object
Om du använder metoden setCustomerIDs
anropas till dpm.demdex.net
, med frågeparametern d_cid_ic
som innehåller det hash-kodade 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
I tabellen nedan finns en beskrivning av parametern d_cid_ic
och autentiseringstillståndet.
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 som visas 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%01 0
- Autentiserad: …d_cid=123%01456%01 1
- Utloggad: …d_cid=123%01456%01 2
Lägga till en åtgärd i Adobe Experience Platform Launch add-action-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 regeldokumentationen i Adobe Launch och ser 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 metoden setCustomerIDs
som beskrivs i det första avsnittet, resulterar detta i ett anrop till Experience Cloud ID-tjänsten, med tillägget d_cid_ic
-frågeparametern.