Kund-ID:n och autentiseringstillstånd

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

Tillsammans med besökar-ID:t för Experience Cloud kan du koppla ytterligare kund-ID:n och en autentiseringsstatus till varje besökare.

Autentiseringstillstånd

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.

VIKTIGT

setCustomerIDs (synkronisering av kund-ID) krävs av kundattribut och centrala tjänster. Synkronisering av kund-ID:n är en valfri identifieringsmetod för Analytics. Target kräver Visitor.AuthState.AUTHENTICATED för att kundattribut ska fungera. Se bastjänster - Så här aktiverar du dina lösningar till exempel.

Från och med Experience Cloud Identity Service v1.5+, setCustomerIDs innehåller det valfria AuthState -objekt. AuthState identifierar besökare utifrån deras autentiseringsstatus (t.ex. inloggad, utloggad). Du anger autentiseringstillståndet med ett statusvärde i tabellen. Autentiseringsstatus returneras som ett heltal.

Autentiseringsstatus Statusheltal Användarstatus

Visitor.AuthState.UNKNOWN

0

Okänd eller aldrig autentiserad.

Okänd används som standard när AuthState används inte med ett besökar-ID eller anges inte uttryckligen på varje sida eller i appsammanhang.

Visitor.AuthState.AUTHENTICATED

1

Autentiserad för en viss instans, sida eller app.

Obs! För att fungera som det ska, kundattribut för Mål kräver den här statusen.

Visitor.AuthState.LOGGED_OUT

2

Utloggad.

Använd ärenden för autentiseringstillstånd

Du kan tilldela autentiseringstillstånd till dina användare, beroende på vilka åtgärder de utför på dina webbegenskaper och om de är autentiserade. Se några exempel i tabellen nedan:

Autentiseringsstatus Användningsfall

Visitor.AuthState.UNKNOWN

Det här läget kan användas för scenarier som:

  • Läsa ett e-postmeddelande (den här åtgärden innebär troligtvis att läsaren är den avsedda mottagaren, men e-postmeddelandet kan också ha vidarebefordrats).
  • Klicka igenom från ett e-postmeddelande till en landningssida.

Visitor.AuthState.AUTHENTICATED

Användaren autentiseras för närvarande med en aktiv session på din webbplats eller i din app.

Visitor.AuthState.LOGGED_OUT

Användaren autentiserades men loggades aktivt ut. Användaren avsåg att koppla från det autentiserade tillståndet. Användaren vill inte längre behandlas som autentiserad.

Ange kund-ID och autentiserade tillstånd

Kund-ID:n kan innehålla kombinationer av ID:n och autentiserade tillstånd som visas i följande exempel.

VIKTIGT
  • ID:n är skiftlägeskänsliga.
  • Använd bara okodade värden för dina ID:n.
  • Kund-ID:n och autentiseringstillstånd lagras inte i cookien för besökar-ID. De måste anges för varje sida eller programkontext.
  • Du bör inte inkludera någon personligt identifierbar information (PII) i kund-ID:n. Om du använder PII för att identifiera en besökare (till exempel en e-postadress) rekommenderar vi att du lagrar en hashad eller krypterad version av informationen i stället. ECID-biblioteket har stöd för att hash-koda användaridentifierare. Se SHA256 Hash-stöd för setCustomerIDs.
// Single ID with a single authentication state
visitor.setCustomerIDs({
    "userid":{
        "id":"67312378756723456",
        "authState":Visitor.AuthState.AUTHENTICATED
    }
});

/*
Multiple IDs with only the first ID explicitly assigned an authentication state.
The second ID is not explicitly assigned an authentication state and is implicitly
assigned Visitor.AuthState.Unknown by default.
*/
visitor.setCustomerIDs({
    "userid":{
        "id":"67312378756723456",
        "authState":Visitor.AuthState.AUTHENTICATED
    },
    "dpuuid":"550e8400-e29b-41d4-a716-446655440000"
});

// Multiple IDs with identical authentication states
visitor.setCustomerIDs({
    "userid":{
        "id":"67312378756723456",
        "authState":Visitor.AuthState.AUTHENTICATED
    },
    "dpuuid":{
        "id":"550e8400-e29b-41d4-a716-446655440000",
        "authState":Visitor.AuthState.AUTHENTICATED
    }
});

// Multiple IDs with different authentication states
visitor.setCustomerIDs({
    "userid":{
        "id":"67312378756723456",
        "authState":Visitor.AuthState.AUTHENTICATED
    },
    "dpuuid":{
        "id":"550e8400-e29b-41d4-a716-446655440000",
        "authState":Visitor.AuthState.LOGGED_OUT
    }
});

Returnera kund-ID:n och autentiserade tillstånd

Använd getCustomerIDs för att returnera kund-ID:n och relaterade autentiserade tillstånd. Den här metoden returnerar en besökares autentiserade tillstånd som ett heltal.

Syntax

getCustomerIDs returnerar data med följande syntax.

{
    [customerIDType1]:{
        "id":[customerID1],
        "authState":[authState1]
    },
    [customerIDType2]:{
        "id":[customerID2],
        "authState":[authState2]
    }
    ...
}

Exempel

Returnerade kund-ID:n och autentiseringsstatusdata ska se ut ungefär som i följande exempel.

Object customerIDs = visitor.getCustomerIDs();

// No setCustomerIDs call on this instance
{}

// setCustomerIDs call on this instance with {"userid":{"id":"67312378756723456"}}
{
    "userid":{
        "id":"67312378756723456",
        "authState":0
    }
}

// setCustomerIDs call on this instance with {"userid":{"id":"67312378756723456","authState":Visitor.AuthState.AUTHENTICATED}}
{
    "userid":{
        "id":"67312378756723456",
        "authState":1
    }
}

// setCustomerIDs call on this instance with {"userid":{"authState":Visitor.AuthState.LOGGED_OUT}}
{
    "userid":{
        "authState":2
    }
}

// setCustomerIDs call on this instance with {"userid":{"authState":Visitor.AuthState.LOGGED_OUT},"dpuuid":{"id":"550e8400-e29b-41d4-a716-446655440000"}}
{
    "userid":{
        "authState":2
    },
    "dpuuid":{
        "id":"550e8400-e29b-41d4-a716-446655440000",
        "authState":0
    }
 }

SDK-stöd

The Experience Cloud ID-tjänsten stöder kund-ID:n och autentiseringstillstånd i Android- och iOS SDK-koden. Se följande kodbibliotek:

Meddelande till Analytics- och Audience Manager-kunder

Om du skickar deklarerade ID:n till Audience Manager, userid -objektet måste matcha den integrationskod som är associerad med en datakälla. Mer information finns i Visitor ID Service i Konfigurera kod för kopplingsregler dokumentation.

På denna sida