Guida alla risoluzione dei problemi per le regole di collegamento del grafo identità

Durante il test e la convalida delle regole di collegamento del grafico delle identità, potresti riscontrare alcuni problemi relativi all’acquisizione dei dati e al comportamento del grafico. Leggi questo documento per scoprire come risolvere alcuni problemi comuni che potrebbero verificarsi quando utilizzi le regole di collegamento del grafico delle identità.

Panoramica sul flusso di acquisizione dei dati data-ingestion-flow-overview

Il diagramma seguente è una rappresentazione semplificata del modo in cui i dati fluiscono in Adobe Experience Platform e Applications. Utilizza questo diagramma come riferimento per comprendere meglio i contenuti di questa pagina.

È importante notare i seguenti fattori:

Problemi di acquisizione dei dati data-ingestion-issues

Le mie identità non vengono acquisite in Identity Service my-identities-are-not-getting-ingested-into-identity-service

Questo può accadere per vari motivi, tra cui, ma non solo:

Nel contesto delle regole di collegamento del grafo delle identità, un record può essere rifiutato da Identity Service perché l’evento in ingresso ha due o più identità con lo stesso spazio dei nomi univoco ma un valore di identità diverso. Questo scenario si verifica in genere a causa di errori di implementazione.

Considera il seguente evento con due presupposti:

L’evento seguente restituisce un messaggio di errore che indica che l’acquisizione non è riuscita.

{
  "_id": "random_string",
  "eventType": "web browsing event",
  "identityMap": {
    "ECID": [
      {
        "id": "11111111111111111111111111111111111111",
        "primary": false
      }
    ],
    "CRMID": [
      {
        "id": "Alice",
        "primary": true
      }
    ]
  },
  "CRMID": "Bob",
  "timestamp": "2024-08-17T15:22:51+00:00",
  "web": {
    "webPageDetails": {
      "URL": "https://www.adobe.com/acrobat.html",
      "name": "Adobe Acrobat"
    }
  }
}

Risoluzione dei problemi

Per risolvere l'errore, è necessario innanzitutto raccogliere le informazioni seguenti:

Quindi, utilizzare Adobe Experience Platform Query Service ed eseguire la seguente query:

  SELECT key, col.id as identityValue, timestamp, _id, identityMap, *
  FROM (SELECT key, explode(value), *
  FROM (SELECT explode(identityMap), *
  FROM dataset_name)) WHERE col.id = 'identity_value'

Dopo aver eseguito la query, individua il record dell’evento che si prevedeva di generare un grafico, quindi verifica che i valori di identità siano diversi nella stessa riga. Per un esempio, visualizza l’immagine seguente:

Gli ExperienceEvents di post-autenticazione sono stati attribuiti al profilo autenticato errato

La priorità dello spazio dei nomi svolge un ruolo importante nel modo in cui i frammenti di evento determinano l’identità primaria.

Affinché eventi utente autenticati siano associati allo spazio dei nomi della persona, tutti gli eventi autenticati devono contenere lo spazio dei nomi della persona (CRMID). Ciò significa che anche dopo che un utente effettua l’accesso, lo spazio dei nomi della persona deve essere ancora presente in ogni evento autenticato.

Puoi continuare a visualizzare il flag 'eventi' di primary=true durante la ricerca di un profilo nel visualizzatore di profili. Tuttavia, questo viene ignorato e non verrà utilizzato dal profilo.

AAID sono bloccati per impostazione predefinita. Pertanto, se utilizzi il connettore di origine Adobe Analytics, assicurati che l'ECID abbia una priorità più alta rispetto all'ECID in modo che gli eventi non autenticati abbiano un'identità primaria di ECID.

Risoluzione dei problemi

I miei frammenti di evento esperienza non vengono acquisiti nel profilo my-experience-event-fragments-are-not-getting-ingested-into-profile

Esistono diversi motivi che contribuiscono al motivo per cui i frammenti di evento esperienza non vengono acquisiti in Profilo, tra cui:

Nel contesto della priorità dello spazio dei nomi, il profilo rifiuterà:

Risoluzione dei problemi

Se i dati vengono inviati al data lake, ma non al profilo, e ritieni che ciò sia dovuto all’invio di due o più identità con la priorità più elevata dello spazio dei nomi in un singolo evento, puoi eseguire la seguente query per verificare che siano presenti due valori di identità diversi inviati sullo stesso spazio dei nomi:

  SELECT identityMap, key, col.id as identityValue, _testimsorg.identification.core.email, _id, timestamp
  FROM (SELECT key, explode(value), *
  FROM (SELECT explode(identityMap), *
  FROM dataset_name)) WHERE col.id != _testimsorg.identification.core.email and key = 'Email'

Puoi anche eseguire la seguente query per verificare se l’acquisizione nel profilo non avviene a causa di uno spazio dei nomi più alto con una stringa vuota:

  SELECT identityMap, key, col.id as identityValue, _testimsorg.identification.core.email, _id, timestamp
  FROM (SELECT key, explode(value), *
  FROM (SELECT explode(identityMap), *
  FROM dataset_name)) WHERE (col.id = '' or _testimsorg.identification.core.email = '') and key = 'Email'

Queste due query presuppongono che:

Problemi relativi al comportamento del grafico graph-behavior-related-issues

Questa sezione illustra i problemi comuni che potresti incontrare sul funzionamento del grafo delle identità.

ExperienceEvents non autenticati vengono collegati al profilo autenticato errato

L'algoritmo di ottimizzazione delle identità rispetterà i collegamenti stabiliti più di recente e rimuoverà i collegamenti meno recenti. Pertanto, una volta abilitata questa funzione, gli ECID potrebbero essere riassegnati (ricollegati) da una persona all’altra. Per comprendere la cronologia del modo in cui un’identità viene collegata nel tempo, segui i passaggi seguenti:

Risoluzione dei problemi

Innanzitutto, devi raccogliere le seguenti informazioni:

I simboli di identità (namespaceCode) fanno distinzione tra maiuscole e minuscole. Per recuperare tutti i simboli di identità per un dato set di dati in identityMap, esegui la seguente query:

SELECT distinct explode(*)FROM (SELECT map_keys(identityMap) FROM dataset_name)

Se non conosci il valore di identità dell’identificatore del cookie e desideri cercare un ID cookie che sarebbe stato collegato a più identificatori di persona, devi eseguire la seguente query. Questa query assume ECID come spazio dei nomi dei cookie e CRMID come spazio dei nomi della persona.

  SELECT identityMap['ECID'][0]['id'], count(distinct identityMap['CRMID'][0]['id']) as crmidCount FROM dataset_name GROUP BY identityMap['ECID'][0]['id'] ORDER BY crmidCount desc

  SELECT identityMap['ECID'][0]['id'], count(distinct personID) as crmidCount FROM dataset_name group by identityMap['ECID'][0]['id'] ORDER BY crmidCount desc

Ora che hai identificato i valori dei cookie collegati a più ID persona, estrane uno dai risultati e utilizzalo nella seguente query per ottenere una visualizzazione cronologica di quando il valore del cookie è stato collegato a un identificatore persona diverso:

  SELECT identityMap['CRMID'][0]['id'] as personEntity, *
  FROM dataset_name
  WHERE identitymap['ECID'][0].id ='identity_value'
  ORDER BY timestamp desc

SELECT _experience.analytics.customDimensions.eVars.eVar10 as personEntity, *
FROM dataset_name
WHERE identitymap['ECID'][0].id ='identity_value'
ORDER BY timestamp desc

L'algoritmo di ottimizzazione delle identità non funziona come previsto

Risoluzione dei problemi

Consulta la documentazione sull'algoritmo di ottimizzazione delle identità e i tipi di strutture di grafo supportati.

Puoi anche utilizzare lo strumento di simulazione del grafico nell'interfaccia utente per simulare eventi e configurare le impostazioni univoche dello spazio dei nomi e della priorità dello spazio dei nomi. Questo può aiutarti a capire come dovrebbe comportarsi l’algoritmo di ottimizzazione delle identità.

Se i risultati della simulazione corrispondono alle aspettative di comportamento del grafico, puoi verificare se le impostazioni identità corrispondono alle impostazioni configurate nella simulazione.

Continuo a vedere grafici compressi nella sandbox anche dopo aver configurato le impostazioni di identità

I grafi di identità rispetteranno lo spazio dei nomi univoco configurato e la priorità dello spazio dei nomi dopo il salvataggio delle impostazioni. Eventuali grafici "compressi" esistenti prima del salvataggio delle nuove impostazioni non saranno interessati, finché non verranno acquisiti nuovi dati in modo tale che il grafico compresso venga aggiornato. L’identità primaria dei frammenti di evento in Real-Time Customer Profile non verrà aggiornata nemmeno dopo le modifiche di priorità dello spazio dei nomi.

Risoluzione dei problemi

Puoi usare visualizzatore grafo identità per verificare se il grafo è stato acquisito prima o dopo le impostazioni. Esamina l'ultimo timestamp aggiornato in Proprietà collegamento per vedere quando Identity Service ha acquisito il grafico. Se la marca temporale è precedente alla configurazione, ciò suggerisce che il grafico "compresso" è stato creato prima di abilitare la funzione.

Voglio sapere quanti grafici "compressi" esistono nella mia sandbox

Utilizza il dashboard delle identità per ottenere informazioni sullo stato del grafico delle identità, ad esempio il conteggio di identità e grafici. Per un conteggio dei grafici compressi, consulta la metrica "Conteggio dei grafici con più spazi dei nomi": si tratta di grafici che contengono due o più identità con lo stesso spazio dei nomi. Supponendo che la sandbox non disponga di dati e che uno spazio dei nomi (ad esempio, CRMID) sia stato configurato come univoco, l’aspettativa è che non ci siano grafici con due o più CRMID. Nell’esempio seguente, sono presenti due grafici che contengono due o più indirizzi e-mail.

Puoi trovare un raggruppamento dettagliato nel set di dati di esportazione snapshot del profilo nel data lake eseguendo la query seguente:

  SELECT key, identityCountInGraph, count(identityCountInGraph) as graphCount
  FROM (SELECT key, cardinality(value) as identityCountInGraph
  FROM (SELECT explode(identityMap)
  FROM dataset_name
  WHERE cardinality(identityMap) > 1)) /* by definition, graphs have 2 or more identities */
  WHERE key not in ('ecid', 'aaid', 'idfa', 'gaid') /* filter out common device/cookie namespaces */
  GROUP BY 1, 2
  ORDER BY 1, 2 asc

Puoi utilizzare la seguente query nel set di dati di esportazione dello snapshot del profilo per ottenere identità di esempio da grafici "compressi".

  SELECT identityMap
  FROM dataset_name
  WHERE cardinality(identityMap['CRMID'])>1 /* any graphs with 2+ CRMID. Change CRMID namespace if needed */

Domande frequenti faq

Questa sezione illustra un elenco di risposte alle domande più frequenti sulle regole di collegamento del grafico delle identità.

Algoritmo di ottimizzazione identità identity-optimization-algorithm

Leggi questa sezione per le risposte alle domande frequenti sull'algoritmo di ottimizzazione delle identità.

Ho un CRMID per ciascuna delle mie unità aziendali (CRMID B2C, CRMID B2B), ma non ho uno spazio dei nomi univoco tra tutti i miei profili. Cosa succede se contrassegno B2C CRMID e B2B CRMID come univoci e abilito le impostazioni di identità?

Questo scenario non è supportato. Pertanto, è possibile che i grafici si riducano nei casi in cui un utente utilizza il proprio CRMID B2C per accedere e un altro utente utilizza il proprio CRMID B2B per accedere. Per ulteriori informazioni, consulta la sezione sul requisito dello spazio dei nomi per singola persona nella pagina di implementazione.

L’algoritmo di ottimizzazione delle identità corregge i grafici compressi esistenti?

I grafici compressi esistenti saranno interessati dall’algoritmo del grafico ("fissi") solo se vengono aggiornati dopo il salvataggio delle nuove impostazioni.

Se due persone effettuano l'accesso e la disconnessione utilizzando lo stesso dispositivo, cosa succede agli eventi? Tutti gli eventi verranno trasferiti all’ultimo utente autenticato?

Per ulteriori informazioni, leggere la guida in determinazione dell'identità primaria per gli eventi esperienza.

Che impatto avrà sui percorsi in Adobe Journey Optimizer il trasferimento dell’ECID da una persona a un’altra?

Il CRMID dell’ultimo utente autenticato verrà collegato all’ECID (dispositivo condiviso). Gli ECID possono essere riassegnati da una persona all’altra in base al comportamento dell’utente. L’impatto dipenderà da come verrà costruito il percorso, pertanto è importante che i clienti testino il percorso in un ambiente sandbox di sviluppo per convalidarne il comportamento.

I punti chiave da evidenziare sono i seguenti:

Priorità dello spazio dei nomi

Leggi questa sezione per le risposte alle domande frequenti sulla priorità dello spazio dei nomi.

Ho abilitato le impostazioni di identità. Cosa succede alle mie impostazioni se voglio aggiungere uno spazio dei nomi personalizzato dopo che le impostazioni sono state abilitate?

Esistono due "bucket" di spazi dei nomi: spazi dei nomi delle persone e spazi dei nomi dispositivo/cookie. Il nuovo spazio dei nomi personalizzato creato avrà la priorità più bassa in ogni "bucket", in modo che questo nuovo spazio dei nomi personalizzato non influisca sull’acquisizione dei dati esistenti.

Se Real-Time Customer Profile non utilizza più il flag "primary" in identityMap, è ancora necessario inviare questo valore?

Sì, il flag "primary" su identityMap viene utilizzato da altri servizi. Per ulteriori informazioni, leggere la guida sulle implicazioni della priorità dello spazio dei nomi su altri servizi Experience Platform.

La priorità dello spazio dei nomi si applica ai set di dati dei record Profilo in Real-Time Customer Profile?

No. La priorità dello spazio dei nomi si applica solo ai set di dati Experience Event che utilizzano la classe XDM ExperienceEvent.

Come funziona questa funzione insieme ai guardrail del grafo delle identità di 50 identità per grafo? La priorità dello spazio dei nomi influisce su questo guardrail definito dal sistema?

L’algoritmo di ottimizzazione dell’identità verrà applicato per primo per garantire la rappresentazione dell’entità della persona. In seguito, se il grafo tenta di superare il guardrail del grafo delle identità (50 identità per grafo), verrà applicata questa logica. La priorità dello spazio dei nomi non influisce sulla logica di eliminazione del guardrail identità/grafico 50.

Test

Leggi questa sezione per le risposte alle domande frequenti sulle funzionalità di test e debug nelle regole di collegamento del grafico delle identità.

Quali sono alcuni degli scenari che dovrei testare in un ambiente sandbox di sviluppo?

In generale, il test su una sandbox di sviluppo dovrebbe simulare i casi d’uso che intendi eseguire sulla sandbox di produzione. Per alcune aree chiave da convalidare durante l’esecuzione di test completi, consulta la tabella seguente:

Come posso verificare che questa funzione funzioni come previsto?

Utilizza lo strumento di simulazione del grafico 🔗 per verificare che la funzione funzioni a un singolo livello di grafico.

Per convalidare la funzionalità a livello di sandbox, fai riferimento alla sezione Conteggio dei grafici con più spazi dei nomi nel dashboard delle identità.