Guida alla risoluzione dei problemi del servizio identità

Questo documento contiene le risposte alle domande frequenti su Adobe Experience Platform Identity Servicee una guida alla risoluzione dei problemi per individuare gli errori più comuni. Per domande e risoluzione dei problemi relativi alle Platform API in generale, consultate la guida alla risoluzione dei problemi delle API di Adobe Experience Platform.

I dati che identificano un singolo cliente sono spesso frammentati tra i vari dispositivi e sistemi utilizzati per interagire con il tuo marchio. Identity Service riunisce queste identità frammentate, facilitando la comprensione completa del comportamento dei clienti e offrendo esperienze digitali di grande impatto in tempo reale. Per ulteriori informazioni, consultate la panoramica del servizioidentità.

Domande frequenti

Di seguito è riportato un elenco di risposte alle domande frequenti su Identity Service.

Che cosa sono i dati di identità?

I dati di identità sono tutti i dati che possono essere utilizzati per identificare una singola persona. A seconda del contesto di utilizzo dei dati all'interno dell'organizzazione, i dati di identità possono includere nomi utente, indirizzi e-mail e ID dai sistemi CRM. I dati di identità non sono limitati agli utenti registrati del sito Web o del servizio, in quanto anche gli utenti anonimi possono essere identificati dal loro dispositivo o ID di cookie.

Qual è il vantaggio di etichettare i campi di dati come identità?

Etichettare alcuni campi dati come identità nei dati dei record e delle serie temporali consente di mappare le relazioni di identità all'interno della struttura naturale dei dati e di riconciliare i dati duplicati tra canali. Per ulteriori informazioni, consulta la panoramica del servizio identità.

Cosa sono le identità conosciute e anonime?

Un'identità nota si riferisce a un valore di identità che può essere utilizzato autonomamente o con altre informazioni per identificare, contattare o individuare una singola persona. Esempi di identità note possono includere indirizzi e-mail, numeri di telefono e ID CRM.

Un'identità anonima si riferisce a un valore di identità che non può essere utilizzato da sola o con altre informazioni per identificare, contattare o individuare una singola persona (ad esempio un ID di cookie).

Cos'è un grafico di identità privata?

Un grafico di identità privata è una mappa privata delle relazioni tra identità collegate e unite, visibile solo all’organizzazione.

Quando più identità sono incluse in tutti i dati acquisiti da un endpoint di streaming o inviati a un set di dati abilitato per Identity Service, tali identità sono collegate in Private Identity Graph. Identity Service sfrutta questo grafico per cogliere le identità di un determinato consumatore o entità, consentendo l'unione di identità e profilo.

Come si creano più campi di identità all'interno di uno schema XDM?

Gli schemi XDM (Experience Data Model) supportano più campi di identità. Qualsiasi campo di dati di tipo string all'interno di uno schema che implementa la classe XDM Singolo profilo o XDM ExperienceEvent può essere etichettato come campo di identità. Una volta etichettati, tutti i dati contenuti in questi campi vengono aggiunti alla mappa di identità del profilo.

Per i passaggi su come etichettare un campo XDM come campo di identità utilizzando l'interfaccia utente, vedere la sezione Identità nell'esercitazione Editor di schema. Se utilizzate l'API, consultate la sezione descrittore di identità nell'esercitazione API del Registro di sistema dello schema.

Esistono contesti in cui alcuni campi non devono essere etichettati come identità?

I campi di identità devono essere riservati ai valori univoci per ogni singolo utente. Ad esempio, prendere in considerazione un dataset per un programma di fidelizzazione dei clienti. Il campo "livello di fedeltà" (oro, argento, bronzo) non sarebbe un campo di identità utile, mentre l'ID fedeltà, un valore unico, sarebbe.

Campi come codici ZIP e indirizzi IP non devono essere etichettati come identità per singoli utenti, in quanto questi valori possono essere applicati a più persone. Questi tipi di campi devono essere etichettati solo come identità per le strategie di marketing a livello domestico.

Perché i miei campi di identità non collegano come mi aspetto?

Utilizzando l' /cluster/members endpoint nell'API del servizio identità, potete visualizzare le identità associate per uno o più campi di identità. Se la risposta non restituisce le identità collegate attese, assicurarsi di fornire le informazioni di identità appropriate nei dati XDM. Per ulteriori informazioni, vedere la sezione relativa alla fornitura di dati XDM al servizio identità nella panoramica del servizio identità.

Che cos'è uno spazio nomi identità?

Uno spazio dei nomi di identità fornisce un contesto in cui i campi di identità si riferiscono all'identità di un cliente. Ad esempio, i campi di identità nello spazio dei nomi "E-mail" devono essere conformi a un formato e-mail standard (nome@emailprovider.com), mentre i campi che utilizzano lo spazio dei nomi "Phone" devono essere conformi a un numero di telefono standard (ad esempio 987-555-1234 in Nord America).

Gli spazi dei nomi distinguono valori di identità simili tra i diversi sistemi CRM. Ad esempio, prendete in considerazione un profilo che contiene un ID fedeltà numerico associato al programma di premi della società. Uno spazio dei nomi di "Fedeltà" separerebbe questo valore da un ID numerico simile per il sistema eCommerce che appare anche nello stesso profilo.

Per ulteriori informazioni, vedere la panoramica dello spazio dei nomi identità.

Come si collega un'identità a uno spazio nomi identità?

I campi identità devono essere associati a uno spazio nomi identità esistente al momento della creazione. Eventuali nuovi spazi dei nomi devono essere creati mediante l'API prima di associarli ai campi di identità.

Per istruzioni dettagliate sulla definizione di uno spazio nomi durante la creazione di un descrittore di identità tramite l'API, vedere la sezione sulla creazione di un descrittore nella guida per gli sviluppatori del Registro di sistema dello schema. Per contrassegnare un campo di schema come identità nell'interfaccia utente, seguire i passaggi dell'esercitazione Editor dischema.

Quali sono gli spazi dei nomi di identità standard forniti dal Experience Platform ?

I seguenti spazi dei nomi standard sono forniti per l'uso da parte di tutte le organizzazioni all'interno Experience Platform:

Nome visualizzato ID Codice Descrizione
CORE 0 CORE nome legacy: " Adobe AudienceManager"
ECID 4 ECID alias: "Adobe Marketing Cloud ID", "Adobe Experience Cloud ID", "Adobe Experience Platform ID"
E-mail 6 E-mail
E-mail (SHA256, minuscola) 11 E-mail Spazio dei nomi standard per le e-mail con hash precedente. I valori forniti in questo spazio nomi vengono convertiti in lettere minuscole prima di eseguire l'hash con SHA-256.
Telefono 7 Telefono
Windows AID 8 WAID
AdCloud 411 AdCloud alias: Ad Cloud
Adobe Target 9 TNTID ID destinazione
Google Ad ID 20914 GAID GAID
Apple IDFA 20915 IDFA ID per inserzionisti

Dove è possibile trovare l'elenco di spazi dei nomi identità disponibili per la mia organizzazione?

Utilizzando l'API Servizioidentità potete elencare tutti gli spazi dei nomi identità disponibili per la vostra organizzazione effettuando una richiesta di GET all' /idnamespace/identities endpoint. Per ulteriori informazioni, consulta la sezione sull’ elenco degli spazi dei nomi disponibili nella panoramica API del servizio identità.

Come si crea uno spazio nomi personalizzato per la propria organizzazione?

Utilizzando l'API Servizioidentità potete creare uno spazio nomi identità personalizzato per la vostra organizzazione effettuando una richiesta di POST all' /idnamespace/identities endpoint. Per ulteriori informazioni, consulta la sezione sulla creazione di uno spazio dei nomi personalizzato nella panoramica API del servizio identità.

Cosa sono le identità composite e gli XID?

Alle identità viene fatto riferimento nelle chiamate API tramite la loro identità composita o XID. Un'identità composita è una rappresentazione di un'identità che contiene un valore ID e uno spazio dei nomi. Un XID è un identificatore a valore singolo che rappresenta lo stesso costrutto di un'identità composita (un ID e uno spazio dei nomi) e viene assegnato automaticamente alle nuove identità se persistente da Servizio identità. Per ulteriori informazioni, consulta la panoramica API del servizio identità.

In che modo Identity Service gestisce le informazioni personali (PII)?

Il servizio identità crea un hash di crittografia univoca dei dati PII prima dei valori persistenti. I dati di identità negli spazi dei nomi "Phone" e "Email" vengono automaticamente crittografati con SHA-256, con i valori "Email" automaticamente convertiti in lettere minuscole prima dell'hashing.

Devo crittografare tutti i dati PII prima di inviarli alla piattaforma?

Non è necessario crittografare manualmente i dati PII prima di assimilarli nella piattaforma. Applicando l'etichetta di utilizzo dei I1 dati a tutti i campi di dati applicabili, Platform converte automaticamente questi campi in valori ID con hash al momento dell'assimilazione.

Per i passaggi relativi all'applicazione e alla gestione delle etichette di utilizzo dei dati, vedere l'esercitazione sulle etichette di usodei dati.

Ci sono delle considerazioni quando si hashing delle identità basate su PII?

Se si inviano valori PII con hash al servizio identità, è necessario utilizzare lo stesso metodo di crittografia per tutti i set di dati. In questo modo lo stesso valore di identità nei set di dati genera gli stessi valori con hash e può essere confrontato e collegato correttamente nel grafico dell'identità.

Risoluzione dei problemi

La sezione seguente contiene suggerimenti per la risoluzione dei problemi relativi a codici di errore specifici e a comportamenti imprevisti che potrebbero verificarsi durante l'utilizzo dell' Identity Service API.

Identity Service messaggi di errore

Di seguito è riportato un elenco di messaggi di errore che potrebbero verificarsi durante l'utilizzo dell' Identity Service API.

Parametro di query obbligatorio mancante

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

Questo errore viene visualizzato quando un parametro di query richiesto non è stato incluso nel percorso della richiesta. Il nome detail del messaggio di errore fornisce il nome del parametro mancante. Le varianti di questo messaggio di errore includono:

  • Parametro query obbligatorio mancante - nsId
  • Parametro query richiesto mancante - id
  • Parametro query richiesto mancante - xid o (nsid,id)
  • Parametro query obbligatorio mancante - targetNs
  • Parametro query obbligatorio mancante - xids o compositeXids

Prima di riprovare, verificate di aver incluso correttamente il parametro indicato nel percorso della richiesta.

La marca temporale deve essere compresa negli ultimi 180 giorni

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

Identity Service elimina i dati di età superiore a 180 giorni. Questo messaggio di errore viene visualizzato quando si tenta di accedere a dati più vecchi di questo.

Esiste un limite di 1000 XIDs in una singola chiamata

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

Questo messaggio di errore viene visualizzato quando tentate di recuperare informazioni di identità per un numero superiore al massimo di XID consentiti in una singola chiamata API. Ridurre il numero di XID nella richiesta al di sotto del limite visualizzato per risolvere il problema.

Esiste un limite per 1000 compositeXids in una singola chiamata

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

Questo messaggio di errore viene visualizzato quando tentate di recuperare informazioni di identità per più del numero massimo di identità composite consentito in una singola chiamata API. Riducete il numero di identità composite nella richiesta al di sotto del limite visualizzato per risolvere il problema.

Il tipo di grafico specificato non è valido

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

Questo messaggio di errore viene visualizzato quando a un parametro di graph-type query viene assegnato un valore non valido nel percorso della richiesta. Consultate la sezione sui grafici di identità nella Identity Service panoramica per scoprire quali tipi di grafico sono supportati.

Il token di servizio non dispone di un ambito valido

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

Questo messaggio di errore viene visualizzato quando non è stato eseguito il provisioning dell'organizzazione IMS con le autorizzazioni appropriate per Identity Service. Per risolvere il problema, contattate l’amministratore di sistema.

Token del servizio gateway non valido

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

In caso di errore, il token di accesso non è valido. I token di accesso scadono ogni 24 ore e devono essere rigenerati per continuare a utilizzare Platform le API. Per istruzioni sulla generazione di nuovi token di accesso, consulta l’esercitazione sull’autenticazione.

Token del servizio di autorizzazione non valido

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

In caso di errore, il token di accesso non è valido. I token di accesso scadono ogni 24 ore e devono essere rigenerati per continuare a utilizzare Platform le API. Per istruzioni sulla generazione di nuovi token di accesso, consulta l’esercitazione sull’autenticazione.

Il token utente non dispone di contesto prodotto valido

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

Questo messaggio di errore viene visualizzato quando il token di accesso non è stato generato da un' Experience Platform integrazione. Per istruzioni su come generare nuovi token di accesso per un’ integrazione, consultate l’esercitazione sull’ Experience Platform autenticazione.

Errore interno durante il recupero di XID nativo dal codice identità e spazio dei nomi

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

Quando Identity Service persiste un'identità, all'ID dell'identità e all'ID dello spazio nomi associato viene assegnato un identificatore univoco denominato XID. Questo messaggio viene visualizzato quando si verifica un errore durante il processo di ricerca dell'XID per un determinato valore ID e spazio dei nomi.

Organizzazione IMS non fornita per Identity Service l'utilizzo

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

Questo messaggio di errore viene visualizzato quando non è stato eseguito il provisioning dell'organizzazione IMS con le autorizzazioni appropriate per Identity Service. Per risolvere il problema, contattate l’amministratore di sistema.

Errore interno del server

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

Questo errore viene visualizzato quando si verifica un'eccezione imprevista nell'esecuzione di una chiamata di Platform servizio. La procedura consigliata consiste nel programmare le chiamate automatizzate in modo che ritentino le richieste alcune volte a un intervallo di tempo al momento della ricezione dell'errore. Se il problema persiste, contattare l'amministratore di sistema.

Codici di errore di inserimento batch

Identity Service acquisisce i dati di identità dai dati di record e serie temporali caricati Platform utilizzando l'inserimento batch. Poiché l’assimilazione batch è un processo asincrono, è necessario visualizzare i dettagli di un batch per visualizzare gli errori. Gli errori si accumulano man mano che il batch avanza fino al completamento del batch.

Di seguito è riportato un elenco di messaggi di errore correlati ai Identity Service quali potresti trovarti quando utilizzi l'API diinserimento dati.

Schema XDM sconosciuto

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

Identity Service utilizza solo le identità per i dati di record o serie temporali conformi rispettivamente alle Profile classi o alle ExperienceEvent classi. Se si tenta di acquisire dati per Identity Service le quali non è conforme a una delle due classi, l'errore viene generato.

0 identità valide nelle prime 100 righe del batch elaborato

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

Questo errore viene visualizzato quando le prime 100 righe di un batch non presentavano identità. Questo errore non indica in modo conclusivo che non sono state trovate identità nei record successivi.

Record ignorati poiché avevano solo 1 identità per record XDM

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

Identity Service collega solo le identità quando i singoli record presentano due o più valori di identità. Questo messaggio di errore si verifica una volta per ciascun batch acquisito e visualizza il numero di record in cui è stata trovata una sola identità e non sono state apportate modifiche al grafico dell'identità.

Il codice dello spazio dei nomi non è registrato per questa organizzazione IMS

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

Questo errore viene visualizzato quando un record acquisito presenta un'identità il cui spazio nomi associato non esiste o non è accessibile dall'organizzazione IMS.

L'assimilazione batch come organizzazione IMS non è stata fornita per il grafico dell'identità privata

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

Durante l'assimilazione dei dati batch, questo messaggio di errore viene visualizzato quando l'organizzazione IMS non dispone delle autorizzazioni necessarie per Identity Service. Per risolvere il problema, contattate l’amministratore di sistema.

Errore interno

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

Questo errore viene visualizzato quando si verifica un'eccezione imprevista durante l'assimilazione di un batch. La procedura consigliata consiste nel programmare le chiamate automatizzate in modo che ritentino le richieste alcune volte a un intervallo di tempo al momento della ricezione dell'errore. Se il problema persiste, contattare l'amministratore di sistema.

In questa pagina