Handleiding voor het oplossen van problemen met koppelingsregels voor identiteitsgrafieken

Wanneer u regels voor identiteitsgrafieken test en valideert, kan er een aantal problemen optreden die te maken hebben met gegevensinvoer en grafiekgedrag. Lees dit document om te leren hoe te om sommige gemeenschappelijke kwesties problemen op te lossen die u zou kunnen ontmoeten wanneer het werken met identiteitsgrafiek die regels verbindt.

Overzicht gegevensinvoer data-ingestion-flow-overview

Het volgende diagram is een vereenvoudigde weergave van hoe gegevens stromen naar Adobe Experience Platform en Toepassingen. Gebruik dit diagram als verwijzing om u te helpen een beter inzicht in de inhoud van deze pagina krijgen.

Het is van belang de volgende factoren in aanmerking te nemen:

Problemen met gegevensinvoer data-ingestion-issues

Mijn identiteiten worden niet opgenomen in de identiteitsservice my-identities-are-not-getting-ingested-into-identity-service

Er zijn verschillende redenen waarom dit zou kunnen gebeuren, waaronder, maar niet beperkt tot:

Binnen de context van identiteitsgrafiek die regels verbindt, kan een verslag van de Dienst van de Identiteit worden verworpen omdat de inkomende gebeurtenis twee of meer identiteiten met zelfde unieke namespace maar verschillende identiteitswaarde heeft. Dit scenario gebeurt gewoonlijk als gevolg van implementatiefouten.

Overweeg het volgende evenement met twee veronderstellingen:

De volgende gebeurtenis retourneert een foutbericht waarin wordt aangegeven dat inname is mislukt.

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

de stappen van het Oplossen van problemen

Om deze fout op te lossen, moet u eerst de volgende informatie verzamelen:

Daarna, gebruik de Dienst van de Vraag van Adobe Experience Platformen stel de volgende vraag in werking:

  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'

Nadat u de query hebt uitgevoerd, zoekt u de gebeurtenisrecord die u had verwacht om een grafiek te genereren en controleert u vervolgens of de identiteitswaarden in dezelfde rij verschillend zijn. Bekijk de volgende afbeelding voor een voorbeeld:

Ervaring na verificatieGebeurtenissen worden toegeschreven aan het verkeerde geverifieerde profiel

De prioriteit Namespace speelt een belangrijke rol in hoe de gebeurtenisfragmenten primaire identiteit bepalen.

Opdat voor authentiek verklaarde gebruikersgebeurtenissenaan de persoon worden gebonden namespace, moeten alle voor authentiek verklaarde gebeurtenissen de persoon namespace (CRMID) bevatten. Dit betekent dat zelfs nadat een gebruiker zich aanmeldt, de naamruimte van de persoon nog steeds aanwezig moet zijn op elke geverifieerde gebeurtenis.

U kunt de markering primary=true 'events' blijven zien wanneer u een profiel opzoekt in de profielviewer. Dit wordt echter genegeerd en wordt niet gebruikt door Profiel.

HULP's worden standaard geblokkeerd. Daarom als u de bronVerbinding van Adobe Analyticsgebruikt, moet u ervoor zorgen dat ECID aan hoger dan ECID wordt voorrang gegeven zodat de unauthenticated gebeurtenissen een primaire identiteit van ECID zullen hebben.

de stappen van het Oplossen van problemen

Mijn ervaring is dat gebeurtenisfragmenten niet in het profiel worden opgenomen my-experience-event-fragments-are-not-getting-ingested-into-profile

Er zijn verschillende redenen die ertoe bijdragen waarom uw ervaringsfragmenten niet in Profiel worden opgenomen, met inbegrip van maar niet beperkt tot:

In de context van namespace prioriteit, zal het Profiel verwerpen:

de stappen van het Oplossen van problemen

Als uw gegevens worden verzonden naar gegevens het meer, maar niet het Profiel, en u gelooft dat dit toe te schrijven aan het verzenden van twee of meer identiteiten met de hoogste namespaceprioriteit in één enkele gebeurtenis is, dan kunt u de volgende vraag in werking stellen om te bevestigen dat er twee verschillende identiteitswaarden tegen zelfde namespace worden verzonden:

  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'

U kunt ook de volgende query uitvoeren om te controleren of er geen inname naar profiel plaatsvindt vanwege de hoogste naamruimte met een lege tekenreeks:

  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'

Deze twee vragen gaan ervan uit dat:

Problemen met grafiekgedrag graph-behavior-related-issues

In deze sectie worden algemene problemen beschreven die u kunt tegenkomen met betrekking tot het gedrag van de identiteitsgrafiek.

Unauthenticated ExperienceEvents worden gekoppeld aan het verkeerde geverifieerde profiel

Het algoritme van de identiteitsoptimalisering zal de onlangs gevestigde verbindingen respecteren en de oudste verbindingenverwijderen. Daarom is het mogelijk dat, zodra deze functie is ingeschakeld, ECID's opnieuw van de ene persoon naar de andere worden toegewezen (opnieuw gekoppeld). Volg onderstaande stappen om te begrijpen hoe een identiteit in de loop der tijd gekoppeld wordt:

de stappen van het Oplossen van problemen

Eerst moet u de volgende informatie verzamelen:

Identiteitssymbolen (namespaceCode) zijn hoofdlettergevoelig. Om alle identiteitssymbolen voor een bepaalde dataset in identityMap terug te winnen, stel de volgende vraag in werking:

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

Als u de identiteitswaarde van uw cookie-id niet kent en u wilt zoeken naar een cookie-id die aan meerdere personen-id's zou zijn gekoppeld, moet u de volgende query uitvoeren. Bij deze query wordt ECID gebruikt als de cookie-naamruimte en CRMID als de naamruimte voor de persoon.

  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 u de cookiewaarden hebt geïdentificeerd verbonden aan veelvoudige persoon IDs, neem één van de resultaten en gebruik het in de volgende vraag om een chronologische mening van te krijgen wanneer die koekjeswaarde met een verschillende persoon herkenningsteken werd verbonden:

  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

Het algoritme voor identiteitsoptimalisatie werkt niet zoals verwacht

de stappen van het Oplossen van problemen

Verwijs naar de documentatie op algoritme van de identiteitsoptimalisering, evenals de types van grafiekstructuren die worden gesteund.

U kunt het hulpmiddel van de grafieksimulatie in UIook gebruiken om gebeurtenissen te simuleren en uw eigen unieke namespace en namespace prioritaire montages te vormen. Dit kan u helpen een basislijninzicht te geven in hoe het algoritme voor identiteitsoptimalisatie zich zou moeten gedragen.

Als uw simulatieresultaten uw verwachtingen van het grafiekgedrag aanpassen, dan kunt u controleren en zien als uw identiteitsmontagesde montages aanpast die u in uw simulatie hebt gevormd.

Ik zie samengevouwen grafieken in mijn zandbak zelfs na het vormen van identiteitsmontages

De grafieken van de identiteit zullen aan uw gevormde unieke namespace en namespace prioriteit naleven nadat de montages zijn bewaard. Om het even welke "doen ineenstorten"grafieken die bestaan alvorens u sparen uw nieuwe montages niet zal worden beïnvloed, tot de nieuwe gegevens worden opgenomen dusdanig dat de doen ineenstorten grafiek wordt bijgewerkt. De primaire identiteit van gebeurtenisfragmenten op het Profiel van de Klant in real time zal niet worden bijgewerkt zelfs na namespace prioritaire veranderingen.

de stappen van het Oplossen van problemen

U kunt de kijker van de identiteitsgrafiekgebruiken om te controleren of uw grafiek vóór of na uw montages werd opgenomen. Controleer de laatst bijgewerkte tijdstempel onder Link properties om te zien wanneer Identity Service de grafiek heeft opgenomen. Als de tijdstempel zich vóór de configuratie bevindt, geeft dat aan dat de grafiek is samengevouwen voordat de functie is ingeschakeld.

Ik wil weten hoeveel 'samengevouwen' grafieken er in mijn sandbox staan

Gebruik het identiteitsdashboard voor inzicht in de staat van uw identiteitsgrafiek, zoals het aantal identiteiten en grafieken. Verwijs naar metrisch, "Aantal van de Grafiek met veelvoudige namespaces"voor een telling van grafieken die zijn doen ineenstorten - dit zijn grafieken die twee of meer identiteiten met zelfde namespace bevatten. Ervan uitgaande dat de sandbox geen gegevens heeft en dat u een naamruimte (bijvoorbeeld CRMID) hebt geconfigureerd om uniek te zijn, wordt verwacht dat er geen grafieken met twee of meer CRMID's moeten zijn. In het onderstaande voorbeeld zijn er twee grafieken die twee of meer e-mailadressen bevatten.

U kunt een gedetailleerde uitsplitsing in de de uitvoerdataset van de profielmomentopnamein gegevensmeer vinden door de hieronder vraag in werking te stellen:

  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

U kunt de volgende vraag in de de uitvoerdataset van de profielmomentopname gebruiken om steekproefidentiteiten van "doen ineenstorten"grafieken te verkrijgen.

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

Veelgestelde vragen faq

Deze sectie schetst een lijst van antwoorden op vaak gestelde vragen over de verbindingsregels van de identiteitsgrafiek.

Algoritme voor identiteitsoptimalisatie identity-optimization-algorithm

Lees deze sectie voor antwoorden op vaak gestelde vragen over het algoritme van de identiteitsoptimalisering.

Ik heb een CRMID voor elk van mijn zaken verenigt (B2C CRMID, B2B CRMID), maar ik heb geen unieke namespace over al mijn profielen. Wat zal gebeuren als ik B2C CRMID en B2B CRMID als uniek merk, en mijn identiteitsmontages toelaat?

Dit scenario wordt niet ondersteund. Daarom kunt u grafieken zien ineenstorten in gevallen waar een gebruiker hun B2C CRMID aan login gebruikt, en een andere gebruiker hun B2B CRMID aan login gebruikt. Voor meer informatie, lees de sectie over enige persoon namespace vereistein de implementatiepagina.

Worden bestaande samengevouwen grafieken door algoritme voor identiteitsoptimalisatie gecorrigeerd?

Bestaande samengevouwen grafieken worden alleen door het grafiekalgoritme beïnvloed ('fixed') als deze grafieken worden bijgewerkt nadat u de nieuwe instellingen hebt opgeslagen.

Als twee personen zich aanmelden en uitloggen met hetzelfde apparaat, wat gebeurt er dan met de gebeurtenissen? Zullen alle gebeurtenissen over naar de laatste voor authentiek verklaarde gebruiker overgaan?

Voor meer informatie, lees de gids bij bepalend de primaire identiteit voor ervaringsgebeurtenissen.

Hoe zullen de verplaatsingen in Adobe Journey Optimizer worden beïnvloed wanneer de ECID van de ene persoon naar de andere overgaat?

De CRMID van de laatst geverifieerde gebruiker wordt gekoppeld aan de ECID (gedeelde apparaat). ECID's kunnen op basis van gebruikersgedrag opnieuw van de ene persoon naar de andere worden toegewezen. De impact zal afhangen van hoe de reis wordt gebouwd, zodat is het belangrijk dat de klanten de reis in een omgeving van de ontwikkelingszandbak uittesten om het gedrag te bevestigen.

De belangrijkste punten om te benadrukken zijn als volgt:

Prioriteit naamruimte

Lees deze sectie voor antwoorden op vaak gestelde vragen over namespace prioriteit.

Ik heb mijn identiteitsinstellingen ingeschakeld. Wat gebeurt er met mijn instellingen als ik een aangepaste naamruimte wil toevoegen nadat de instellingen zijn ingeschakeld?

Er zijn twee 'emmers' van naamruimten: naamruimten van personen en naamruimten van apparaat/cookie. De nieuwe aangepaste naamruimte krijgt de laagste prioriteit in elk 'emmertje', zodat deze nieuwe aangepaste naamruimte geen invloed heeft op bestaande gegevensinvoer.

Als het Profiel van de Klant in real time niet meer de "primaire"vlag op identityMap gebruikt, moet deze waarde nog worden verzonden?

Ja, de "primaire"vlag op identityMap wordt gebruikt door andere diensten. Voor meer informatie, lees de gids op de implicaties van namespaceprioriteit op andere diensten van het Experience Platform.

Zal naamruimteprioriteit van toepassing zijn op de gegevenssets van het profielrecord in Real-Time Klantprofiel?

Nee. De prioriteit Namespace zal slechts op de datasets van de Gebeurtenis van de Ervaring van toepassing zijn gebruikend de Klasse XDM ExperienceEvent.

Hoe werkt deze functie in overeenstemming met de identiteitsgrafiekinstructies van 50 identiteiten per grafiek? Heeft naamruimteprioriteit invloed op deze door het systeem gedefinieerde hulplijn?

Het algoritme voor identiteitsoptimalisatie wordt eerst toegepast om te zorgen dat de persoon die entiteit vertegenwoordigt wordt vertegenwoordigd. Nadien, als de grafiek probeert om de graadmeter van de identiteitsgrafiek(50 identiteiten per grafiek) te overschrijden, dan zal deze logica worden toegepast. De prioriteit Namespace beïnvloedt niet de schrappingslogica van de 50 identiteit/grafiekbegeleiding.

Testen

Lees deze sectie voor antwoorden op vaak gestelde vragen over het testen van en het zuiveren eigenschappen in identiteitsgrafiek die regels verbinden.

Wat zijn enkele scenario's die ik zou moeten testen in een omgeving van de ontwikkelingszandbak?

In het algemeen geldt dat het testen op een ontwikkelingssandbox de gebruiksgevallen moet nabootsen die u wilt uitvoeren in de productiesandbox. Raadpleeg de volgende tabel voor een aantal belangrijke onderdelen die u wilt valideren wanneer u uitgebreide tests uitvoert:

Hoe kan ik controleren of deze functie naar behoren functioneert?

Gebruik het hulpmiddel van de grafieksimulatieom te bevestigen dat de eigenschap op een individueel grafiekniveau werkt.

Als u de functie wilt valideren op sandboxniveau, raadpleegt u de sectie Graph count with multiple namespaces in het identiteitsdashboard.