Klant-id's en verificatiestatus customer-ids-and-authentication-states

Naast de bezoeker-id van het Experience Cloud kunt u aanvullende klant-id's en een verificatiestatus aan elke bezoeker koppelen.

Verificatiestatus section-68ad4065dfaa437d9070832d6e2bf85c

De methode setCustomerIDs accepteert meerdere klant-id's voor dezelfde bezoeker. Hierdoor kunt u een individuele gebruiker op verschillende apparaten herkennen of als doelgebruiker instellen. Bijvoorbeeld, kunt u deze IDs als klantenattributenaan Experience Cloud uploaden en tot dit gegeven over de verschillende oplossingen toegang hebben.

Vanaf Experience Cloud Identity Service v1.5+ bevat setCustomerIDs het optionele AuthState -object. AuthState identificeert bezoekers op basis van hun verificatiestatus (bijvoorbeeld aangemeld, afgemeld). U stelt de verificatiestatus in met een statuswaarde in de tabel. De verificatiestatus wordt geretourneerd als een geheel getal.

Gevallen gebruiken voor verificatiestatussen section-fe9560cc490943b29dac2c4fb6efd72c

U kunt verificatiestatussen toewijzen aan uw gebruikers, afhankelijk van de handelingen die zij uitvoeren op uw wegeigenschappen en of zij zijn geverifieerd. Zie enkele voorbeelden in de onderstaande tabel:

Klant-id's en geverifieerde statussen instellen section-ec4b367d16ad4ac1a1baca9b01f4ee98

Klant-id's kunnen combinaties van id's en geverifieerde statussen bevatten, zoals in de volgende voorbeelden wordt getoond.

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

Klanten-id's en geverifieerde statussen retourneren section-71a610546188478fa9a3185a01d6e83b

Gebruik getCustomerIDs om klant-id's en verwante geverifieerde statussen te retourneren. Deze methode retourneert de geverifieerde status van een bezoeker als een geheel getal.

Syntaxis

getCustomerIDs retourneert gegevens met de volgende syntaxis.

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

Voorbeelden

Geretourneerde klant IDs en de gegevens van de authentificatiestatus zouden gelijkaardig aan de volgende voorbeelden moeten kijken.

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-ondersteuning section-861c6b3b1ba645dda133dccb22ec7bb0

De Experience Cloud ID-service ondersteunt de klant-id's en verificatiestatus in onze Android- en iOS SDK-code. Zie de volgende codebibliotheken:

Bericht voor klanten van Analytics en van de Audience Manager section-3a8e9d51e71c4c6e865184b81ed9d99b

Als u gedeclareerde id's doorgeeft aan Audience Manager , moet het userid -object overeenkomen met de integratiecode die is gekoppeld aan een gegevensbron. Voor meer informatie, zie de Visitor ID Service sectie in vormt de documentatie van de Code van de Regels van de Fusie.