Felsökningsguide för länkningsregler för identitetsdiagram

När du testar och validerar regler för länkning av identitetsdiagram kan du stöta på problem som rör datainmatning och diagrambeteende. Läs det här dokumentet om du vill veta mer om hur du felsöker några vanliga problem som kan uppstå när du arbetar med länkningsregler för identitetsdiagram.

Översikt över dataöverföringsflöde data-ingestion-flow-overview

Bilden nedan är en förenklad representation av hur data flödar in i Adobe Experience Platform och Program. Använd det här diagrammet som referens för att få en bättre förståelse för innehållet på den här sidan.

Det är viktigt att notera följande faktorer:

Problem med datainmatning data-ingestion-issues

Mina identiteter importeras inte till identitetstjänsten my-identities-are-not-getting-ingested-into-identity-service

Det finns olika orsaker till varför detta kan inträffa, bland annat följande:

Inom ramen för länkningsreglerna för identitetsdiagram kan en post refuseras från identitetstjänsten eftersom den inkommande händelsen har två eller flera identiteter med samma unika namnutrymme men olika identitetsvärde. Detta scenario inträffar vanligtvis på grund av implementeringsfel.

Tänk på följande händelse med två antaganden:

Följande händelse returnerar ett felmeddelande som anger att importen misslyckades.

{
  "_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"
    }
  }
}

Felsökningssteg

För att lösa det här felet måste du först samla in följande information:

Använd sedan Adobe Experience Platform Query Service och kör följande fråga:

  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'

När du har kört frågan letar du reda på den händelsepost som du förväntade dig att generera ett diagram och kontrollerar sedan att identitetsvärdena är olika på samma rad. Visa följande bild som ett exempel:

ExperienceEvents efter autentisering tilldelas fel autentiserade profil

Namnområdesprioriteten spelar en viktig roll i hur händelsefragment bestämmer den primära identiteten.

För att autentiserade användarhändelser ska kunna kopplas till personnamnområdet måste alla autentiserade händelser innehålla personnamnområdet (CRMID). Detta innebär att även efter att en användare har loggat in måste personens namnutrymme fortfarande finnas på varje autentiserad händelse.

Du kan fortsätta att se flaggan primary=true events när du söker efter en profil i profilvisningsprogrammet. Detta ignoreras dock och används inte av profilen.

AAID:n blockeras som standard. Om du använder Adobe Analytics-källkopplingen måste du därför se till att ECID prioriteras högre än ECID så att de oautentiserade händelserna får en primär ECID-identitet.

Felsökningssteg

Mina upplevelsehändelsefragment importeras inte till profilen my-experience-event-fragments-are-not-getting-ingested-into-profile

Det finns olika orsaker till varför dina händelsefragment inte kommer in i profilen, bland annat men inte begränsat till:

När det gäller namnområdesprioritet avvisar profilen:

Felsökningssteg

Om dina data skickas till en datalinje, men inte till en profil, och du tror att det beror på att två eller flera identiteter med den högsta namnområdesprioriteten i en enda händelse skickas, kan du köra följande fråga för att verifiera att två olika identitetsvärden har skickats mot samma namnutrymme:

  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'

Du kan också köra följande fråga för att kontrollera om det inte sker någon inmatning till profilen på grund av att det högsta namnutrymmet har en tom sträng:

  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'

De här två frågorna förutsätter att:

Problem relaterade till diagrambeteende graph-behavior-related-issues

I det här avsnittet beskrivs vanliga problem som du kan råka ut för när identitetsdiagrammet fungerar.

Oautentiserade ExperienceEvents kopplas till fel autentiserade profil

Identitetsoptimeringsalgoritmen respekterar de senast upprättade länkarna och tar bort de äldsta länkarna. Det är därför möjligt att när den här funktionen är aktiverad kan ECID:n omtilldelas (länkas) från en person till en annan. Följ stegen nedan för att förstå hur en identitet länkas över tid:

Felsökningssteg

Först måste du samla in följande information:

Identitetssymboler (namespaceCode) är skiftlägeskänsliga. Om du vill hämta alla identitetssymboler för en viss datauppsättning i identityMap kör du följande fråga:

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

Om du inte känner till identitetsvärdet för din cookie-identifierare och du vill söka efter ett cookie-ID som skulle ha länkats till flera personidentifierare, måste du köra följande fråga. Den här frågan förutsätter ECID som cookie-namnområde och CRMID som personnamnområde.

  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

Nu när du har identifierat cookie-värden som är länkade till flera person-ID:n kan du ta ett av resultaten och använda det i följande fråga för att få en kronologisk vy över när det cookie-värdet länkades till en annan person-ID:

  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

Identitetsoptimeringsalgoritmen fungerar inte som förväntat

Felsökningssteg

Mer information finns i dokumentationen om identitetsoptimeringsalgoritmen, samt i de typer av diagramstrukturer som stöds.

Du kan också använda diagramsimuleringsverktyget i gränssnittet för att simulera händelser och konfigurera egna inställningar för namnutrymmes- och namnområdesprioritet. Om du gör det kan du få en grundläggande förståelse för hur identitetsoptimeringsalgoritmen ska fungera.

Om simuleringsresultaten matchar dina diagrambeteendeförväntningar kan du kontrollera och se om dina identitetsinställningar matchar de inställningar som du har konfigurerat i simuleringen.

Jag ser fortfarande komprimerade diagram i sandlådan även efter att jag har konfigurerat identitetsinställningarna

Identitetsdiagram följer din konfigurerade unika namnområdes- och namnområdesprioritet när inställningarna har sparats. Komprimerade diagram som finns före som du sparar dina nya inställningar påverkas inte förrän nya data har infogats så att det komprimerade diagrammet uppdateras. Den primära identiteten för händelsefragment i kundprofilen i realtid uppdateras inte ens när namnområdesprioriteten har ändrats.

Felsökningssteg

Du kan använda identitetsdiagramvisningsprogrammet för att kontrollera om diagrammet har importerats före eller efter dina inställningar. Undersök den senaste uppdaterade tidsstämpeln under Link properties för att se när identitetstjänsten importerade diagrammet. Om tidsstämpeln är före konfigurationen tyder det på att det"komprimerade" diagrammet skapades innan funktionen aktiverades.

Jag vill veta hur många komprimerade diagram som finns i min sandlåda

Använd identitetspanelen för att få insikter om identitetsgrafens tillstånd, till exempel antalet identiteter och diagram. I måttet "Antal diagram med flera namnutrymmen" finns ett antal komprimerade diagram - det här är diagram som innehåller två eller flera identiteter med samma namnutrymme. Om du utgår ifrån att sandlådan inte har några data och har konfigurerat ett namnutrymme (t.ex. CRMID) som unikt, är det förväntat att det ska finnas nolldiagram med två eller flera CRMID:n. I exemplet nedan finns det två diagram som innehåller två eller flera e-postadresser.

Du kan hitta en detaljerad beskrivning i datamängden för export av ögonblicksbilder i datasjön genom att köra frågan nedan:

  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

Du kan använda följande fråga i datauppsättningen för export av ögonblicksbilder för att hämta exempel på identiteter från komprimerade diagram.

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

Vanliga frågor och svar faq

I det här avsnittet finns en lista med svar på vanliga frågor om länkningsregler för identitetsdiagram.

Identitetsoptimeringsalgoritm identity-optimization-algorithm

I det här avsnittet finns svar på vanliga frågor om algoritmen för identitetsoptimering.

Jag har ett CRMID för varje affärsenhet (B2C CRMID, B2B CRMID), men jag har inget unikt namnutrymme för alla mina profiler. Vad händer om jag markerar B2C CRMID och B2B CRMID som unika och aktiverar mina identitetsinställningar?

Scenariot stöds inte. Därför kan du se att diagram komprimeras om en användare använder sitt B2C CRMID för att logga in och en annan användare använder sitt B2B CRMID för att logga in. Mer information finns i avsnittet Krav på namnutrymme för en person på implementeringssidan.

Åtgärdar identitetsoptimeringsalgoritmen befintliga komprimerade diagram?

Befintliga komprimerade diagram påverkas ("fast") endast av diagramalgoritmen om dessa diagram uppdateras när du har sparat de nya inställningarna.

Vad händer med händelserna om två personer loggar in och ut med samma enhet? Överför alla händelser till den senast autentiserade användaren?

Mer information finns i guiden fastställa den primära identiteten för upplevelsehändelser.

Hur kommer resor i Adobe Journey Optimizer att påverkas när ECID överförs från en person till en annan?

CRMID för den senaste autentiserade användaren kommer att länkas till ECID (delad enhet). ECID kan omtilldelas från en person till en annan baserat på användarbeteende. Effekten beror på hur resan är uppbyggd, så det är viktigt att kunderna testar resan i en sandlådemiljö för att validera beteendet.

De viktigaste punkterna som ska markeras är följande:

Namnområdesprioritet

I det här avsnittet finns svar på vanliga frågor om namnområdesprioritet.

Jag har aktiverat mina identitetsinställningar. Vad händer med mina inställningar om jag vill lägga till ett anpassat namnutrymme efter att inställningarna har aktiverats?

Det finns två 'bucket' med namnutrymmen: namnutrymmen för personer och namnutrymmen för enheter/cookies. Det nya anpassade namnutrymmet har den lägsta prioriteten i varje 'bucket' så att det nya anpassade namnutrymmet inte påverkar befintlig datainmatning.

Om kundprofilen i realtid inte längre använder flaggan"primär" på identityMap, måste det här värdet ändå skickas?

Ja, den primära flaggan för identityMap används av andra tjänster. Mer information finns i guiden om konsekvenserna av namnområdesprioritet för andra Experience Platform-tjänster.

Gäller namnområdesprioriteten profilpostdatauppsättningar i kundprofilen i realtid?

Nej. Namnområdesprioriteten gäller bara Experience Event-datauppsättningar som använder klassen XDM ExperienceEvent.

Hur fungerar den här funktionen tillsammans med identitetsgrafens skyddsytor med 50 identiteter per diagram? Påverkar namnområdesprioriteten den systemdefinierade skyddsprofilen?

Identitetsoptimeringsalgoritmen används först för att säkerställa personentitetsrepresentationen. Om diagrammet därefter försöker överskrida identitetdiagrammet(50 identiteter per diagram) används den här logiken. Namnområdesprioriteten påverkar inte borttagningslogiken för det 50 identitets-/diagramskyddsutkastet.

Testning

I det här avsnittet finns svar på vanliga frågor om testnings- och felsökningsfunktioner i länkningsregler för identitetsdiagram.

Vilka scenarier bör jag testa i en utvecklingssandlådemiljö?

Generellt sett bör testning i en utvecklingssandlåda efterlikna de användningsfall som du tänker köra i din produktionssandlåda. I följande tabell finns några viktiga områden att validera vid utförlig testning:

Hur verifierar jag att den här funktionen fungerar som väntat?

Använd diagramsimuleringsverktyget för att verifiera att funktionen fungerar på en enskild diagramnivå.

Om du vill validera funktionen på sandlådenivå ska du läsa avsnittet Graph count with multiple namespaces på identitetspanelen.