Handleiding voor het oplossen van problemen met identiteitsservice

Dit document geeft antwoorden op veelgestelde vragen over Adobe Experience Platform Identity Serviceen een gids voor probleemoplossing voor algemene fouten. Voor vragen en problemen met betrekking tot Platform API's in het algemeen, zie de Handleiding voor problemen met de Adobe Experience Platform API.

Gegevens die één enkele klant identificeren, worden vaak gefragmenteerd over de verschillende apparaten en systemen die zij gebruiken om met uw merk in contact te komen. Identity Service verzamelt deze gefragmenteerde identiteiten, zodat u een volledig inzicht in het gedrag van de klant krijgt zodat u in real-time een ongekende digitale ervaring kunt opdoen. Zie de klasse Overzicht van identiteitsservice.

Veelgestelde vragen

Hieronder volgt een lijst met antwoorden op veelgestelde vragen over Identity Service.

Wat zijn identiteitsgegevens?

Identiteitsgegevens zijn alle gegevens die kunnen worden gebruikt om een individuele persoon te identificeren. Afhankelijk van de context van hoe de gegevens binnen uw organisatie worden gebruikt, kunnen de identiteitsgegevens gebruikersnamen, e-mailadressen, en identiteitskaart van de systemen van CRM omvatten. Identiteitsgegevens zijn niet beperkt tot geregistreerde gebruikers van uw website of service, omdat anonieme gebruikers ook kunnen worden geïdentificeerd door hun apparaat of cookie-id.

Wat is het nut van het etiketteren van gegevensvelden als identiteiten?

Door bepaalde gegevensvelden als identiteiten te labelen in uw record- en tijdreeksgegevens kunt u identiteitsrelaties toewijzen binnen de natuurlijke structuur van uw gegevens en dubbele gegevenskanalen met elkaar in overeenstemming brengen. Zie de Overzicht van identiteitsservice voor meer informatie .

Wat zijn bekende en anonieme identiteiten?

Een bekende identiteit verwijst naar een identiteitswaarde die zelfstandig of met andere informatie kan worden gebruikt om een individuele persoon te identificeren, te contacteren of te bepalen. Voorbeelden van bekende identiteiten zijn bijvoorbeeld e-mailadressen, telefoonnummers en CRM-id's.

Een anonieme identiteit verwijst naar een identiteitswaarde die niet zelfstandig of met andere informatie kan worden gebruikt om een individuele persoon (zoals een koekjesidentiteitskaart) te identificeren, te contacteren of te bepalen.

Wat is een persoonlijke identiteitsgrafiek?

Een persoonlijke identiteitsgrafiek is een persoonlijke kaart van relaties tussen verbonden en verbonden identiteiten, die alleen zichtbaar is voor uw organisatie.

Wanneer meer dan één identiteit inbegrepen in om het even welke gegevens die van een het stromen eindpunt worden opgenomen of naar een dataset worden verzonden die voor wordt toegelaten Identity Service, zijn deze identiteiten gekoppeld in de persoonlijke identiteitsgrafiek. Identity Service gebruikt deze grafiek om een bepaalde consument of entiteit aan de genre identiteiten te binden, waardoor identiteitsstitching en het samenvoegen van profielen mogelijk worden.

Hoe creeer ik veelvoudige identiteitsgebieden binnen een XDM schema?

Experience Data Model (XDM) schema's ondersteunen meerdere identiteitsvelden. Elk gegevensveld van het type string binnen een schema dat de klasse XDM Individual Profile of XDM ExperienceEvent uitvoert kan als identiteitsgebied worden geëtiketteerd. Als deze velden zijn gelabeld, worden alle gegevens in deze velden toegevoegd aan het identiteitsoverzicht van het profiel.

Voor stappen over hoe te om een gebied XDM als identiteitsgebied te etiketteren gebruikend het gebruikersinterface, zie Identiteitsgedeelte in de zelfstudie Schema-editor. Als u de API gebruikt, zie Sectie Identiteitsbeschrijving in de Schema Registry API zelfstudie.

Zijn er contexten waarin sommige gebieden niet als identiteiten zouden moeten worden geëtiketteerd?

Identiteitsvelden moeten worden gereserveerd voor waarden die uniek zijn voor elk individu. Bijvoorbeeld, overweeg een dataset voor een programma van de klantenloyaliteit. Het veld "loyaliteitsniveau" (goud, zilver, brons) zou geen nuttig identiteitsveld zijn, terwijl de loyaliteitsidentiteitskaart-unieke waarde-zou zijn.

Velden zoals ZIP-codes en IP-adressen mogen niet worden gelabeld als identiteiten voor personen, omdat deze waarden op meerdere personen van toepassing kunnen zijn. Deze soorten velden mogen alleen worden geëtiketteerd als identiteiten voor marketingstrategieën op huishoudelijk niveau.

Waarom zijn mijn identiteitsvelden niet aan elkaar gekoppeld zoals ik verwacht?

Met de /cluster/members eindpunt in de identiteitsservice-API kunt u de bijbehorende identiteiten voor een of meer identiteitsvelden weergeven. Als de reactie niet de verbonden identiteiten terugkeert u verwacht, zorg ervoor dat u de aangewezen identiteitsinformatie in uw XDM gegevens verstrekt. Zie de sectie over XDM-gegevens leveren aan Identity Service in het overzicht Identiteitsservice voor meer informatie.

Wat is naamruimte voor identiteit?

Een identiteitsnaamruimte geeft context voor hoe identiteitsvelden betrekking hebben op de identiteit van een klant. Identiteitsvelden onder de naamruimte E-mail moeten bijvoorbeeld een standaard e-mailindeling hebben (naam)@emailprovider.com) terwijl velden die de naamruimte Telefoon gebruiken, moeten voldoen aan een standaardtelefoonnummer (zoals 987-555-1234 in Noord-Amerika).

Naamruimten onderscheiden vergelijkbare identiteitswaarden tussen verschillende CRM-systemen. Neem bijvoorbeeld een profiel dat een numerieke identificatie bevat die is gekoppeld aan het beloningsprogramma van uw bedrijf. Een naamruimte van "Loyalty" zou deze waarde scheiden van een vergelijkbare numerieke id voor uw eCommerce-systeem dat ook in hetzelfde profiel wordt weergegeven.

Zie de Overzicht van naamruimte in identiteit voor meer informatie .

Hoe associeer ik een identiteit met een identiteitsnamespace?

Identiteitsvelden moeten worden gekoppeld aan een bestaande naamruimte voor identiteiten wanneer deze worden gemaakt. Nieuwe naamruimten moeten gemaakt met de API voordat u ze aan identiteitsvelden koppelt.

Voor stapsgewijze instructies voor het definiëren van een naamruimte bij het maken van een identiteitsdescriptor met de API, raadpleegt u de sectie over een descriptor maken in de de ontwikkelaarsgids van het Registratie van het Schema. Voor het markeren van een schemagebied als identiteit in UI, volg de stappen in Zelfstudie Schema-editor.

Wat zijn de standaardnaamruimten van Experience Platform? standard-namespaces

Standaardnaamruimten zijn naamruimten die beschikbaar zijn voor alle organisaties. Zie de Overzicht van naamruimten voor een volledige lijst met beschikbare standaardnaamruimten.

Waar kan ik de lijst van identiteitsnamespaces beschikbaar voor mijn organisatie vinden?

Met de Identity Service API, kunt u alle beschikbare naamruimten voor uw organisatie weergeven door een GET-aanvraag in te dienen bij de /idnamespace/identities eindpunt. Zie de sectie over lijst met beschikbare naamruimten in het overzicht van de Identiteitsservice-API voor meer informatie.

Hoe maak ik een aangepaste naamruimte voor mijn organisatie?

Met de Identity Service APIkunt u een aangepaste naamruimte voor uw organisatie maken door een POST aan te vragen bij de /idnamespace/identities eindpunt. Zie de sectie over een aangepaste naamruimte maken in het overzicht van de Identiteitsservice-API voor meer informatie.

Wat zijn samengestelde identiteiten en XIDs?

In API-aanroepen wordt naar identiteiten verwezen door hun samengestelde identiteit of XID. Een samengestelde identiteit is een representatie van een identiteit die een id-waarde en een naamruimte bevat. Een XID is een single-value herkenningsteken die het zelfde concept zoals een samengestelde identiteit (identiteitskaart en een namespace) vertegenwoordigt, en automatisch toegewezen aan nieuwe identiteiten wanneer voortgeduurd door de Dienst van de Identiteit. Zie de Overzicht van de Identity Service API voor meer informatie .

Hoe verwerkt de Identiteitsdienst persoonlijk identificeerbare informatie (PII)?

De Dienst van de identiteit heeft standaardnamespaces om het opnemen van gehakte identiteitswaarden voor telefoonaantallen en e-mails te steunen. U bent echter verantwoordelijk voor de hash van waarden. Voor meer informatie over het hashen van gegevens die in Platform worden opgenomen, zie Data Prep handleiding voor toewijzingsfuncties.

Zijn er overwegingen bij het hakken van op PII-Gebaseerde identiteiten?

Als u gehakte PII waarden naar de Dienst van de Identiteit verzendt, moet u de zelfde encryptiemethode over uw datasets gebruiken. Dit zorgt ervoor dat de zelfde identiteitswaarde over datasets de zelfde hashed waarden produceert en behoorlijk kan worden aangepast en in de identiteitsgrafiek worden verbonden.

Waarom heb ik geen toegang tot de pagina of API's van de identiteitsgrafiek?

Uw beheerder van het Platform moet u voorzien van view-identity-graph toestemming om identiteitsgrafiekgegevens weer te geven. Zonder deze toestemming, zult u een toestemmingsontkend bericht op de pagina van de kijker van de identiteitsgrafiek en wanneer het roepen van Platform APIs ontvangen. Zie de toegangsbeheer voor meer informatie over machtigingen.

Problemen oplossen

In de volgende sectie vindt u suggesties voor het oplossen van problemen voor specifieke foutcodes en voor onverwacht gedrag dat u kunt tegenkomen tijdens het werken met de Identity Service API.

Identity Service foutberichten

Hieronder volgt een lijst met foutberichten die u kunt tegenkomen bij het gebruik van de Identity Service API.

Vereiste queryparameter ontbreekt

{
    "title": "InvalidInput",
    "status": 400,
    "detail": "Missing required query parameter - namespace"
}

Deze fout wordt weergegeven wanneer een vereiste queryparameter niet is opgenomen in het aanvraagpad. De detail in het foutbericht wordt de naam van de ontbrekende parameter vermeld. Variaties in dit foutbericht zijn:

Controleer of u de opgegeven parameter correct in het aanvraagpad opneemt voordat u het opnieuw probeert.

De tijdstempel moet in de afgelopen 180 dagen staan

{
    "title": "InvalidInput",
    "status": 400,
    "detail": "Timestamp should be within last 180 days"
}

Identity Service zuivert gegevens ouder dan 180 dagen. Dit foutbericht wordt weergegeven wanneer u probeert toegang te krijgen tot gegevens die ouder zijn dan deze pagina.

Er is een grens van 1000 XIDs in één enkele vraag

{
    "title": "InvalidInput",
    "status": 400,
    "detail": "There is a limit of 1000 XIDs in a single call"
}

Dit foutbericht wordt weergegeven wanneer u probeert identiteitsgegevens op te halen voor meer dan het maximale aantal XIDs toegestaan in één API-aanroep. Verlaag het aantal XID's in uw verzoek tot onder de weergegeven limiet om dit probleem op te lossen.

Er is een grens voor 1000 compoundXids in één enkele vraag

{
    "title": "InvalidInput",
    "status": 400,
    "detail": "There is a limit for 1000 compositeXids in a single call"
}

Dit foutbericht wordt weergegeven wanneer u probeert identiteitsgegevens op te halen voor meer dan het maximale aantal samengestelde identiteiten toegestaan in één API-aanroep. Verlaag het aantal samengestelde identiteiten in uw verzoek tot onder de weergegeven limiet om dit probleem op te lossen.

Het opgegeven grafiektype is ongeldig

{
    "title": "InvalidInput",
    "status": 400,
    "detail": "The graph-type abc specified is invalid. Please provide a valid graph-type"
}

Dit foutbericht wordt weergegeven wanneer een graph-type De vraagparameter wordt gegeven een ongeldige waarde in de verzoekweg. Zie de sectie over identiteitsgrafieken in de Identity Service overzicht om te leren welke grafiektypes worden gesteund.

Servicetoken heeft geen geldig bereik

{
    "title": "UnauthorizedAccess",
    "status": 401,
    "detail": "Service token does not have valid scope. Either acp.core.identity or acp.foundation is required"
}

Dit foutbericht wordt weergegeven wanneer uw organisatie niet beschikt over de juiste machtigingen voor Identity Service. Neem contact op met de systeembeheerder om dit probleem op te lossen.

Het de dienstteken van de gateway is niet geldig

{
    "title": "UnauthorizedAccess",
    "status": 401,
    "detail": "Gateway service token is not valid"
}

In het geval van deze fout, is uw toegangstoken ongeldig. De tokens van de toegang verlopen om de 24 uur en moeten opnieuw worden geproduceerd om verder te blijven gebruiken Platform API's. Zie de verificatiezelfstudie voor instructies over het produceren van nieuwe toegangstokens.

Token voor machtigingsservice is niet geldig

{
    "title": "UnauthorizedAccess",
    "status": 401,
    "detail": "Authorization service token is not valid"
}

In het geval van deze fout, is uw toegangstoken ongeldig. De tokens van de toegang verlopen om de 24 uur en moeten opnieuw worden geproduceerd om verder te blijven gebruiken Platform API's. Zie de verificatiezelfstudie voor instructies over het produceren van nieuwe toegangstokens.

Gebruikerstoken heeft geen geldige productcontext

{
    "title": "UnauthorizedAccess",
    "status": 401,
    "detail": "User token does not have valid product context"
}

Dit foutbericht wordt weergegeven wanneer uw toegangstoken niet is gegenereerd op basis van een Experience Platform integratie. Zie de verificatiezelfstudie voor instructies over het genereren van nieuwe toegangstokens voor een Experience Platform integratie.

Interne fout bij ophalen van native XID uit identiteit- en naamruimtecode

{
    "title": "UnauthorizedAccess",
    "status": 401,
    "detail": "Invalid IMS Token/IMS Org | Internal error - when tried to get native XID from identity and namespace code"
}

Wanneer Identity Service Blijft een identiteit, identiteitskaart van de identiteit en bijbehorende namespace ID worden toegewezen een uniek herkenningsteken genoemd XID. Dit bericht wordt weergegeven wanneer een fout optreedt tijdens het zoeken naar de XID voor een bepaalde ID-waarde en -naamruimte.

De IMS-organisatie is niet voorzien voor Identity Service gebruiken

{
    "title": "AccountNotProvisioned",
    "status": 403,
    "detail": "The IMS Org. {IMS_ORG_NAME} is not provisioned for Identity Service usage"
}

Dit foutbericht wordt weergegeven wanneer uw organisatie niet beschikt over de juiste machtigingen voor Identity Service. Neem contact op met de systeembeheerder om dit probleem op te lossen.

Interne serverfout

{
    "title": "InternalError",
    "status": 500,
    "detail": "Internal Server Error. There was a problem processing your request"
}

Deze fout wordt weergegeven wanneer er een onverwachte uitzondering optreedt bij het uitvoeren van een Platform serviceoproep. De beste praktijken moeten uw geautomatiseerde vraag programmeren om hun verzoeken een paar keer bij een bepaald interval opnieuw te proberen wanneer het ontvangen van deze fout. Neem contact op met de systeembeheerder als het probleem zich blijft voordoen.

Code voor de fout met de inname in de batch

Identity Service neemt identiteitsgegevens van verslag en tijdreeksgegevens op die worden geupload aan Platform gebruik van Batch-inname. Aangezien batch-opname een asynchroon proces is, moet u de details van een batch bekijken om fouten weer te geven. Fouten zullen zich ophopen aangezien de partij vordert tot de partij volledig is.

Hieronder volgt een lijst met foutberichten die betrekking hebben op Identity Service u kunt ontmoeten wanneer het gebruiken van Batchverwerking-API.

Onbekend XDM-schema

{
    "title": "InvalidInput",
    "status": 400,
    "detail": "Unknown XDM schema"
}

Identity Service alleen identiteiten verbruikt voor record- of tijdreeksgegevens die voldoen aan de Profile of ExperienceEvent , respectievelijk. Gegevens invoeren voor Identity Service die zich niet aan een van beide klassen houdt, zal deze fout teweegbrengen.

Er waren 0 geldige identiteiten in de eerste 100 rijen van de verwerkte partij

{
    "title": "InvalidInput",
    "status": 400,
    "detail": "There were 0 valid identities in the first 100 rows of the processed batch"
}

Deze fout wordt weergegeven wanneer de eerste 100 rijen van een batch geen id's bevatten. Deze fout geeft echter niet overtuigend aan dat er geen identiteiten zijn gevonden in volgende records.

Overgeslagen records omdat ze slechts 1 identiteit per XDM-record hadden

{
    "title": "InvalidInput",
    "status": 400,
    "detail": "Skipped {NUMBER_OF_RECORDS} records as they had only 1 identity per XDM record"
}

Identity Service Hiermee worden alleen id's gekoppeld wanneer één record twee of meer identiteitswaarden bevat. Dit foutbericht treedt één keer op voor elke opgenomen batch en geeft het aantal records weer waarin slechts één identiteit kan worden gevonden en waarbij de identiteitsgrafiek niet is gewijzigd.

Naamruimtecode is niet geregistreerd voor deze IMS-organisatie

{
    "title": "InvalidInput",
    "status": 400,
    "detail": "Namespace Code {ERRONEOUS_CODE} is not registered for this IMS Org"
}

Deze fout wordt weergegeven wanneer een opgenomen record een identiteit voorstelt waarvan de bijbehorende naamruimte niet bestaat of niet toegankelijk is voor uw organisatie.

Het overslaan van batch-opname als IMS Org is niet voorzien voor Private Identity Graph

{
    "title": "AccountNotProvisioned",
    "status": 403,
    "detail": "Skipping batch ingestion as IMS Org is not provisioned for Private Identity Graph"
}

Bij het invoeren van batchgegevens wordt dit foutbericht weergegeven wanneer uw organisatie niet beschikt over de juiste machtigingen voor Identity Service. Neem contact op met de systeembeheerder om dit probleem op te lossen.

Interne fout

{
    "title": "InternalError",
    "status": 500,
    "detail": "Internal Error. There was a problem during the ingestion"
}

Deze fout wordt weergegeven wanneer tijdens een batchopname een onverwachte uitzondering optreedt. De beste praktijken moeten uw geautomatiseerde vraag programmeren om hun verzoeken een paar keer bij een bepaald interval opnieuw te proberen wanneer het ontvangen van deze fout. Neem contact op met de systeembeheerder als het probleem zich blijft voordoen.