Handleiding voor het oplossen van problemen met identiteitsservice

Dit document bevat antwoorden op veelgestelde vragen over Adobe Experience Platform Identity Service en een gids voor probleemoplossing voor algemene fouten. Voor vragen en het oplossen van problemen betreffende Platform APIs in het algemeen, zie de het oplossen van problemengids van 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 verenigt deze gefragmenteerde identiteiten en maakt het voor de klant gemakkelijker om volledig inzicht te krijgen in het gedrag van de klant, zodat u in real-time een indrukwekkende digitale ervaring kunt opdoen. Voor meer informatie, zie het overzicht van de Dienst van de Identiteit.

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 het overzicht van de Dienst van de Identiteitvoor 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 CRMID'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 Identity Service wordt toegelaten, worden die identiteiten verbonden in de Privé Grafiek van de Identiteit. Identity Service gebruikt deze grafiek om een bepaalde consument of entiteit aan genre identiteiten te binden, die identiteitsstitching en profiel het samenvoegen toestaan.

Hoe creeer ik veelvoudige identiteitsgebieden binnen een XDM schema?

Model van de Gegevens van de Ervaring (XDM)schema's steunen veelvoudige identiteitsgebieden. Elk gegevensveld van het type string binnen een schema dat de klasse XDM Individual Profile of XDM ExperienceEvent implementeert, kan worden gelabeld als een identiteitsveld. Als deze velden zijn gelabeld, worden alle gegevens in deze velden toegevoegd aan het identiteitsoverzicht van het profiel.

Voor stappen op hoe te om een gebied XDM als identiteitsgebied te etiketteren gebruikend het gebruikersinterface, zie de sectie van de Identiteitin het leerprogramma van de Redacteur van het Schema. Als u API gebruikt, zie de sectie van de Omschrijving van de Identiteitin het leerprogramma van de Registratie API van het Schema.

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?

Gebruikend het /cluster/members eindpuntin de Dienst API van de Identiteit, kunt u de bijbehorende identiteiten voor één of meerdere identiteitsgebieden bekijken. 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 op verstrekkend XDM gegevens aan de Dienst van de Identiteitin het overzicht van de Dienst van de Identiteit 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 het overzicht van identiteitskaart namespacevoor meer informatie.

Hoe associeer ik een identiteit met een identiteitsnamespace?

Identiteitsvelden moeten worden gekoppeld aan een bestaande naamruimte voor identiteiten wanneer deze worden gemaakt. Om het even welke nieuwe namespaces moeten worden gecreeerd gebruikend APIalvorens hen met identiteitsgebieden te associëren.

Voor geleidelijke instructies voor het bepalen van namespace wanneer het creëren van een identiteitsbeschrijver die API gebruikt, gelieve de sectie op te zien creërend een beschrijverin de de ontwikkelaarsgids van de Registratie van het Schema. Voor het merken van een schemagebied als identiteit in UI, volg de stappen in het leerprogramma van de Redacteur van het Schema.

Wat zijn de standaardnaamruimten van Experience Platform? standard-namespaces

Standaardnaamruimten zijn naamruimten die beschikbaar zijn voor alle organisaties. Zie het namespaces overzicht van de Identiteitvoor een volledige lijst van beschikbare standaardnamespaces.

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

Gebruikend de Dienst API van de Identiteit, kunt u van alle beschikbare identiteitsnamespaces voor uw organisatie een lijst maken door een verzoek van de GET tot het /idnamespace/identities eindpunt te richten. Zie de sectie op lijst beschikbare namespacesin het API overzicht van de Dienst van de Identiteit voor meer informatie.

Hoe maak ik een aangepaste naamruimte voor mijn organisatie?

Gebruikend de Dienst API van de Identiteit, kunt u een douaneidentiteit tot stand brengen namespace voor uw organisatie door een verzoek van de POST aan het /idnamespace/identities eindpunt te maken. Zie de sectie op creërend een douane namespacein het overzicht van de Dienst API van de Identiteit 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 het overzicht van de Dienst API van de Identiteitvoor 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. Meer leren over het hakken van gegevens die in Platform worden opgenomen, zie de Data Prep gids van de kaartfuncties.

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?

De beheerder van het Platform moet u de view-identity-graph toestemming verstrekken om de gegevens van de identiteitsgrafiek te bekijken. 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 het toegangsbeheeroverzichtvoor meer informatie over toestemmingen.

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 API van Identity Service .

Identity Service foutberichten

Hieronder volgt een lijst met foutberichten die kunnen optreden wanneer u de API Identity Service gebruikt.

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. In detail van het foutbericht wordt de naam van de ontbrekende parameter weergegeven. 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 foutenbericht toont wanneer u probeert om identiteitsinformatie voor meer dan het maximumaantal XIDsterug te winnen toegelaten in één enkele API vraag. 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 foutenbericht toont wanneer u probeert om identiteitsinformatie voor meer dan het maximumaantal samengestelde identiteitenterug te winnen toegelaten in één enkele API vraag. 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 parameter graph-type query een ongeldige waarde heeft in het aanvraagpad. Zie de sectie op identiteitsgrafiekenin het Identity Service overzicht om te leren welke grafiek-types 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. Toegangstokens verlopen elke 24 uur en moeten opnieuw worden gegenereerd om door te gaan met het gebruik van Platform API's. Zie het authentificatieleerprogrammavoor instructies bij 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. Toegangstokens verlopen elke 24 uur en moeten opnieuw worden gegenereerd om door te gaan met het gebruik van Platform API's. Zie het authentificatieleerprogrammavoor instructies bij 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 door een Experience Platform -integratie. Zie het authentificatieleerprogrammavoor instructies bij het produceren 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 een identiteit voortduurt, worden de identiteitskaart van de identiteit en bijbehorende namespace identiteitskaart 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 ingericht voor Identity Service gebruik

{
    "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 de uitvoering van een serviceaanroep Platform . 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 op uit record- en tijdreeksgegevens die naar Platform zijn geüpload met 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.

Het volgende is een lijst van foutenmeldingen met betrekking tot Identity Service u kunt ontmoeten wanneer het gebruiken van Ingestie API van de Partij.

Onbekend XDM-schema

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

Identity Service gebruikt alleen identiteiten voor record- of tijdreeksgegevens die respectievelijk voldoen aan de klassen Profile of ExperienceEvent . Deze fout treedt op wanneer wordt geprobeerd gegevens in te voeren voor Identity Service die zich niet aan een van beide klassen houdt.

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 koppelt alleen identiteiten 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.