Felsökningsguide för identitetstjänst

Det här dokumentet innehåller svar på vanliga frågor om Adobe Experience Platform Identity Servicesamt en felsökningsguide för vanliga fel. För frågor och felsökning gällande Platform API:er i allmänhet finns i Felsökningsguide för Adobe Experience Platform API.

Data som identifierar en enskild kund fragmenteras ofta över olika enheter och system som de använder för att interagera med ert varumärke. Identity Service samlar ihop dessa fragmenterade identiteter och ger en fullständig förståelse för kundbeteenden så att ni kan leverera slagkraftiga digitala upplevelser i realtid. Mer information finns i Översikt över identitetstjänsten.

Vanliga frågor och svar

Här följer en lista med svar på vanliga frågor om Identity Service.

Vad är identitetsdata?

Identitetsuppgifter är alla data som kan användas för att identifiera en enskild person. Beroende på hur data används inom organisationen kan identitetsdata innehålla användarnamn, e-postadresser och ID:n från CRM-system. Identitetsdata är inte begränsade till registrerade användare av din webbplats eller tjänst, eftersom anonyma användare också kan identifieras med deras enhets- eller cookie-ID.

Vad är fördelen med att märka datafält som identiteter?

Genom att sätta etiketter på vissa datafält som identiteter i data för post- och tidsserier kan du mappa identitetsrelationer inom den naturliga datastrukturen och stämma av duplicerade data i olika kanaler. Se Översikt över identitetstjänsten för mer information.

Vad är kända och anonyma identiteter?

En känd identitet avser ett identitetsvärde som kan användas fristående eller tillsammans med annan information för att identifiera, kontakta eller hitta en enskild person. Exempel på kända identiteter kan vara e-postadresser, telefonnummer och CRM-ID.

En anonym identitet refererar till ett identitetsvärde som inte kan användas fristående eller tillsammans med annan information för att identifiera, kontakta eller hitta en enskild person (till exempel ett cookie-ID).

Vad är ett privat identitetsdiagram?

Ett privat identitetsdiagram är en privat karta över relationer mellan sammanfogade och länkade identiteter, som bara är synlig för din organisation.

När fler än en identitet ingår i data som har importerats från en direktuppspelningsslutpunkt eller skickats till en datauppsättning som är aktiverad för Identity Serviceär dessa identiteter länkade i det privata identitetsdiagrammet. Identity Service använder det här diagrammet för att skapa magra identiteter för en viss konsument eller enhet, vilket möjliggör identitetssammanfogning och profilsammanslagning.

Hur skapar jag flera identitetsfält i ett XDM-schema?

Experience Data Model (XDM) scheman stöder flera identitetsfält. Alla datafält av typen string i ett schema som implementerar den enskilda XDM-profilen eller XDM ExperienceEvent-klassen kan märkas som ett identitetsfält. När de har etiketterats läggs alla data i dessa fält till i profilens identitetskarta.

Anvisningar om hur du etiketterar ett XDM-fält som ett identitetsfält med användargränssnittet finns i Identitetssektion i schemaredigeraren. Om du använder API:t kan du läsa Identitetsbeskrivningsavsnitt i API-självstudiekursen för schemaregistret.

Finns det kontexter där vissa fält inte ska märkas som identiteter?

Identitetsfält ska reserveras för värden som är unika för varje individ. Ta till exempel en datauppsättning för ett kundlojalitetsprogram. Fältet "lojalitetsnivå" (guld, silver, brons) skulle inte vara ett användbart identitetsfält, medan det skulle vara ett unikt ID.

Fält som ZIP-koder och IP-adresser ska inte märkas som identiteter för enskilda, eftersom dessa värden kan gälla för mer än en enskild person. Dessa typer av fält bör endast märkas som identiteter för marknadsföringsstrategier på hushållsnivå.

Varför länkar inte mina identitetsfält på det sätt jag förväntar mig?

Använda /cluster/members slutpunkt i Identitetstjänstens API kan du visa associerade identiteter för ett eller flera identitetsfält. Om svaret inte returnerar de länkade identiteter som du förväntar dig ska du se till att du anger rätt identitetsinformation i dina XDM-data. Se avsnittet om tillhandahålla XDM-data till identitetstjänsten i Översikt över identitetstjänsten om du vill ha mer information.

Vad är ett identitetsnamnutrymme?

Ett ID-namnutrymme ger kontext för hur identitetsfält relaterar till en kunds identitet. Identitetsfält under namnutrymmet"E-post" ska till exempel överensstämma med ett standardformat för e-post (namn)@emailprovider.com) Fälten som använder namnutrymmet "Phone" bör överensstämma med ett standardtelefonnummer (till exempel 987-555-1234 i Nordamerika).

Namnutrymmen skiljer på liknande identitetsvärden mellan olika CRM-system. Ta till exempel en profil som innehåller ett numeriskt lojalitets-ID som är kopplat till ditt företags belöningsprogram. Ett namnutrymme med "Loyalty" skulle separera det här värdet från ett liknande numeriskt ID för e-handelssystemet som också visas i samma profil.

Se Översikt över namnutrymmet identity för mer information.

Hur associerar jag en identitet med ett identitetsnamnutrymme?

Identitetsfält måste kopplas till ett befintligt ID-namnutrymme när de skapas. Alla nya namnutrymmen måste vara som skapats med API innan de kopplas till identitetsfält.

Stegvisa instruktioner för hur du definierar ett namnutrymme när du skapar en identitetsbeskrivning med API:t finns i avsnittet om skapa en beskrivning i Utvecklarhandbok för schemaregister. Följ stegen i dialogrutan för att markera ett schemafält som en identitet i användargränssnittet Schemaredigeraren, genomgång.

Vilka är de vanliga ID-namnutrymmena från Experience Platform? standard-namespaces

Standardnamnutrymmen för identiteter är namnutrymmen som är tillgängliga för alla organisationer. Se Översikt över namnutrymmen för identiteter för en fullständig lista över tillgängliga standardnamnutrymmen.

Var hittar jag en lista över de identitetsnamnutrymmen som är tillgängliga för min organisation?

Använda Identitetstjänstens APIkan du visa alla tillgängliga ID-namnutrymmen för din organisation genom att göra en GET-förfrågan till /idnamespace/identities slutpunkt. Se avsnittet om visa tillgängliga namnutrymmen i API:t för identitetstjänsten om du vill ha mer information.

Hur skapar jag ett anpassat namnutrymme för min organisation?

Använda Identitetstjänstens APIkan du skapa ett anpassat ID-namnutrymme för din organisation genom att göra en POST-förfrågan till /idnamespace/identities slutpunkt. Se avsnittet om skapa ett anpassat namnutrymme i API:t för identitetstjänsten om du vill ha mer information.

Vad är sammansatta identiteter och XID:n?

Identiteter refereras i API-anrop antingen av deras sammansatta identitet eller XID. En sammansatt identitet är en representation av en identitet som innehåller ett ID-värde och ett namnutrymme. Ett XID är en identifierare med ett enda värde som representerar samma konstruktion som en sammansatt identitet (ett ID och ett namnutrymme), och tilldelas automatiskt till nya identiteter när de bevaras av identitetstjänsten. Se API-översikt för identitetstjänst för mer information.

Hur hanterar Identity Service personligt identifierbar information (PII)?

Identitetstjänsten har standardnamnutrymmen som stöder inmatning av hash-kodade identitetsvärden för telefonnummer och e-post. Du ansvarar dock för att värden hash-kodas. Om du vill veta mer om hur du hash-kodar data som hämtas till Platform kan du läsa Data Prep guide för mappningsfunktioner.

Är det något du bör tänka på när du hash-kodar PII-baserade identiteter?

Om du skickar hash-kodade PII-värden till identitetstjänsten måste du använda samma krypteringsmetod i alla datauppsättningar. Detta garanterar att samma identitetsvärde för alla datauppsättningar genererar samma hash-kodade värden och kan matchas och länkas korrekt i identitetsdiagrammet.

Varför kan jag inte komma åt identitetsdiagramsidan eller API:erna?

Din plattformsadministratör måste tillhandahålla dig med view-identity-graph behörighet för att du ska kunna visa identitetsdiagramdata. Utan den här behörigheten får du ett meddelande om nekad behörighet på identitetsdiagramvisningsprogramsidan och när du anropar plattforms-API:er. Se åtkomstkontroll - översikt för mer information om behörigheter.

Felsökning

Följande avsnitt innehåller felsökningsförslag för specifika felkoder och oväntade beteenden som du kan stöta på när du arbetar med Identity Service API.

Identity Service felmeddelanden

Här följer en lista över felmeddelanden som du kan stöta på när du använder Identity Service API.

Obligatorisk frågeparameter saknas

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

Det här felet visas när en obligatorisk frågeparameter inte inkluderades i sökvägen till begäran. The detail i felmeddelandet innehåller namnet på den parameter som saknas. Variationer i det här felmeddelandet inkluderar:

Kontrollera att du tar med den angivna parametern i sökvägen för begäran innan du försöker igen.

Tidsstämpeln bör vara inom de senaste 180 dagarna

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

Identity Service tar bort data som är äldre än 180 dagar. Det här felmeddelandet visas när du försöker komma åt data som är äldre än det här.

Det finns en gräns på 1 000 XID i ett enda samtal

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

Det här felmeddelandet visas när du försöker hämta identitetsinformation för mer än det maximala antalet XID tillåts i ett enda API-anrop. Minska antalet XID i din begäran till under den gräns som visas för att lösa problemet.

Det finns en gräns för 1000 compositeXids i ett enskilt anrop

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

Det här felmeddelandet visas när du försöker hämta identitetsinformation för mer än det maximala antalet sammansatta identiteter tillåts i ett enda API-anrop. Minska antalet sammansatta identiteter i din begäran till under den gräns som visas för att lösa problemet.

Den angivna diagramtypen är ogiltig

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

Det här felmeddelandet visas när en graph-type frågeparametern har fått ett ogiltigt värde i begärandesökvägen. Se avsnittet om identitetsdiagram i Identity Service översikt för att lära dig vilka diagramtyper som stöds.

Tjänsttoken har inte ett giltigt scope

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

Det här felmeddelandet visas när din organisation inte har tilldelats rätt behörigheter för Identity Service. Kontakta systemadministratören för att lösa problemet.

Gatewaytjänstens token är inte giltig

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

Om det här felet inträffar är din åtkomsttoken ogiltig. Åtkomsttoken upphör att gälla var 24:e timme och måste genereras om för att du ska kunna fortsätta använda Platform API. Se självstudiekurs om autentisering för instruktioner om hur du genererar nya åtkomsttoken.

Autentiseringstjänsttoken är inte giltig

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

Om det här felet inträffar är din åtkomsttoken ogiltig. Åtkomsttoken upphör att gälla var 24:e timme och måste genereras om för att du ska kunna fortsätta använda Platform API. Se självstudiekurs om autentisering för instruktioner om hur du genererar nya åtkomsttoken.

Användartoken har inte en giltig produktkontext

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

Det här felmeddelandet visas när din åtkomsttoken inte har genererats från en Experience Platform integrering. Se självstudiekurs om autentisering för instruktioner om hur du genererar nya åtkomsttoken för en Experience Platform integrering.

Internt fel vid hämtning av ursprungligt XID från identitets- och namnutrymmeskod

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

När Identity Service består av en identitet. Identitetens ID och tillhörande namnområdes-ID tilldelas en unik identifierare som kallas XID. Det här meddelandet visas när ett fel inträffar under sökningen efter XID för ett givet ID-värde och namnutrymme.

IMS-organisationen har inte etablerats för Identity Service användning

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

Det här felmeddelandet visas när din organisation inte har tilldelats rätt behörigheter för Identity Service. Kontakta systemadministratören för att lösa problemet.

Internt serverfel

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

Det här felet visas när ett oväntat undantag inträffar vid körning av ett Platform servicebesök. Det bästa sättet är att programmera dina automatiska anrop så att de kan försöka igen några gånger med ett tidsintervall när det här felet tas emot. Kontakta systemadministratören om problemet kvarstår.

Felkoder för batchinmatning

Identity Service importerar identitetsdata från post- och tidsseriedata som överförs till Platform med gruppinmatning. Eftersom gruppinmatning är en asynkron process måste du visa information för en grupp för att kunna se fel. Fel ackumuleras allt eftersom batchen fortskrider tills batchen är klar.

Här följer en lista med felmeddelanden som rör Identity Service du kan stöta på när du använder API för gruppinmatning.

Okänt XDM-schema

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

Identity Service bara använder identiteter för post- eller tidsseriedata som uppfyller Profile eller ExperienceEvent respektive. Försöker importera data för Identity Service som inte följer någon av klasserna utlöser det här felet.

Det fanns 0 giltiga identiteter i de första 100 raderna i den bearbetade gruppen

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

Det här felet visas när de första 100 raderna i en batch inte visade några identiteter. Detta fel innebär dock inte att inga identiteter hittades i efterföljande poster.

Poster hoppades över eftersom de bara hade en identitet per XDM-post

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

Identity Service bara länkar identiteter när enskilda poster har två eller flera identitetsvärden. Det här felmeddelandet visas en gång för varje inkapslad sats och visar antalet poster där endast en identitet kunde hittas och som inte resulterade i någon ändring av identitetsdiagrammet.

Namnområdeskoden har inte registrerats för denna IMS-organisation

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

Det här felet visas när en inkapslad post visar en identitet vars associerade namnutrymme inte finns eller inte är tillgängligt för din organisation.

Hoppar över batchinmatning eftersom IMS-organisation inte har etablerats för privat identitetsdiagram

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

Vid inmatning av batchdata visas det här felmeddelandet när din organisation inte har tilldelats rätt behörigheter för Identity Service. Kontakta systemadministratören för att lösa problemet.

Internt fel

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

Det här felet visas när ett oväntat undantag inträffar under en gruppinmatning. Det bästa sättet är att programmera dina automatiska anrop så att de kan försöka igen några gånger med ett tidsintervall när det här felet tas emot. Kontakta systemadministratören om problemet kvarstår.