Felsöka inkommande åtgärder under resor troubleshooting-inbound-actions
Inkommande åtgärder, som upplevelser i appen, på webben och i kodbaserade upplevelser, är viktiga komponenter i Journey Optimizer eftersom de möjliggör personaliserat engagemang med användare under deras resa. Oväntade beteenden kan dock inträffa, t.ex. att inkommande innehåll saknas eller att en profil fortsätter att levereras efter att den har avslutats.
Den här guiden innehåller en stegvis process för att felsöka problem som rör inkommande åtgärder under en resa, så att du kan identifiera och lösa dem oberoende av varandra innan du når ut till supporten.
Förutsättningar prerequisites
Innan du kan starta felsökningen bör du kontrollera följande:
-
Konfigurera en Assurance-session. Läs mer i Adobe Experience Platform Assurance-dokumentationen.
-
Navigera till resan som innehåller den inkommande åtgärden för att hämta resenamnet och versions-ID:t.
note NOTE Resursversions-ID finns i URL:en efter "resa/" (till exempel: 86232fb1-2932-4036-8198-55dfec606fd7).
-
Klicka på den inkommande åtgärden för att visa information om den. Hämta etiketten och ID för den inkommande åtgärden.
-
Hämta profilens namnutrymme och ID för att identifiera problem med profilen som påträffas. Beroende på din konfiguration kan namnutrymmet vara till exempel ECID, e-post eller kund-ID. Lär dig hur du söker efter en profil i Experience Platform-dokumentationen.
Scenario 1: Användaren har inte fått det inkommande innehållet scenario-1
I det här scenariot har en profil påbörjat den inkommande åtgärden under resan, men även efter 30 minuter visas inte motsvarande inkommande innehåll i enheten/klienten vid konfigurationsstartssteget.
Förkontroller pre-checks
-
Inkommande data för resa har aktiverats för profilinmatning
Den inkommande åtgärden använder datamängden Inbound för inkommande trafik för profiluppdateringarna under körningen. Kontrollera att datauppsättningen är aktiverad för profiler i den aktuella sandlådan. Läs mer om datauppsättningar
-
‘joai’-identitet har definierats i plattformsidentiteter
Den inkommande åtgärden använder namnutrymmet joai i profilen
segmentMembershipför att aktivera profilen för det inkommande steget. Kontrollera att den har definierats i Plattformsidentiteter för sandlådan. Läs mer om Experience Platform identitetstjänst
Felsökningssteg debugging-steps
Tabellen nedan visar den sekvens av felsökningssteg som du kan följa:
Steg 1: Kontrollera om enheten/klienten tar emot innehållet från edge-nätverket step-1
Börja med att kontrollera om enheten/klienten hämtar det förväntade innehållet.
-
Gå till Assurance-sessionen och välj avsnittet In-App Messaging i den vänstra panelen.
-
Klicka på listrutan Messages på fliken Messages on Device.
{width="80%"}
-
Leta efter ett meddelande med resenamnet följt av “- In-app message”. Om det finns något betyder det att meddelandet i appen finns på enheten/klienten och problemet kan vara relaterat till utlösaren i appen.
-
Om meddelandet inte hittas togs meddelandet inte emot av enheten/klienten.
Step 2: check if the edge network is returning the content step-2
This step is to make sure the Edge Network is returning the expected inbound content to be rendered on the device/client.
When a profile enters an inbound action in a journey, it is automatically qualified into a special audience segment (in the joai namespace) corresponding to the inbound journey action.
When a client makes a request to the Edge Network for a given profile and surface, the profile qualifies to receive content for the inbound journey actions targeting that surface - only if the profile is currently a member of the corresponding joai segment.
To debug the Edge Network behavior, follow the steps below.
-
Open the Edge Delivery view in the Assurance session. This view provides information about the execution of the inbound action on the Edge Network server. Learn more in the Experience Platform documentation.
-
Verify if the Edge activity corresponding to the inbound action is listed in the Qualified Activities or Unqualified Activities sections.
- If in the Qualified Activities section, the profile qualified for the inbound journey action, and the content should be returned.
- If in the Unqualified Activities section, the profile did not qualify for the inbound journey action. See the exclusion reasons for more details.
- If in neither section, either there was a problem with publishing the inbound journey action to the Edge Network, or the requested surface URI did not match the channel configuration settings for the inbound action.
note NOTE To find your Edge activity in the Assurance session, look for the activity where the audienceNamespace is joai and the audienceSegmentId is <JourneyVersionID>_<JourneyActionID> (for example: 86232fb1-2932-4036-8198-55dfec606fd7_708f718d-8503-4427-ad8d-8e28979b554c). {width="70%"}
-
If your activity is in the Unqualified Activities section and the exclusion reason is ‘Segment is not active’, it means the Edge Network delivery server does not think the profile is part of the relevant joai audience segment.
You can double check whether the joai segment is present in the Edge Network delivery server’s view of the profile by opening the segmentsMap element of the Profile section and looking for the presence of the joai segment ID.
-
If the Edge Network delivery server does not view the profile as being in the relevant joai segment, go to the next step.
Step 3: check if the ‘joai’ audience membership has propagated to the edge network step-3
This step is to verify that the Edge profile was correctly updated when the profile entered the inbound journey action and the profile was qualified into the corresponding joai segment.
När en profil är kvalificerad i ett joai-segment uppdateras profilen först på hubben och sedan projiceras segmentmedlemskapet för Edge-profilen för användning av Edge Network leveransserver.
Följ stegen nedan för att kontrollera om joai-segmentet finns i Edge-profilens segmentMembership -attribut.
-
Navigera till menyn Customer > Profiles i den vänstra navigeringsrutan i Journey Optimizer och bläddra till profilen med namnutrymme och ID. Läs mer om Kundprofiler i realtid
-
Välj fliken Attributes och välj vyn Edge.
-
Klicka på View JSON för att öppna JSON-vyn för profilen.
{width="80%"}
-
Gå till attributet
segmentMembershipoch kontrollera om segment-ID <JourneyVersionID>_<JourneyActionID> finns i namnutrymmet joai och om det är i statusen realized . {width="90%"}
-
Om det finns ett joai-segment som motsvarar åtgärden för inkommande resa spreds det korrekt till Edge-profilen.
-
Om den inte visas i vyn för Edge Network-leveransservern kan det bero på ett problem med hur leveransservern läser in Edge-profilen.
-
-
Om segment-ID:t joai inte finns eller är i läget exited betyder det att det inte har spridits till Edge (än).
Vänta 15 till 30 minuter tills
segmentMembership-värdena sprids från hubben till Edge. Gå till nästa steg om du fortfarande inte är närvarande.
Steg 4: kontrollera om “joai”-målgruppsmedlemskapet finns i profilen på navet step-4
Det här steget är att verifiera att hubbprofilen uppdaterades korrekt när profilen angavs i åtgärden för inkommande resa och profilen kvalificerades i motsvarande joai-segment.
Följ stegen nedan för att kontrollera om joai-segmentet finns i navprofilens segmentMembership -attribut.
-
Navigera till menyn Customer > Profiles i den vänstra navigeringsrutan i Journey Optimizer och bläddra till profilen med namnutrymme och ID. Läs mer om Kundprofiler i realtid
-
Välj fliken Attributes och välj vyn Hub.
-
Klicka på View JSON för att öppna JSON-vyn för profilen.
-
Gå till attributet segmentMembership och kontrollera om segment-ID <JourneyVersionID>_<JourneyActionID> finns i namnutrymmet joai och om det är i statusen realized .
-
Om det finns något, kapslades det joai-segment som motsvarar åtgärden för inkommande resa korrekt i hubbprofilen.
-
Om den inte hittas i Edge-profilen efter minst 30 minuter kan det bero på ett problem med Edge projektionssystem.
-
-
Om segment-ID:t joai inte finns eller är i läget exited betyder det att profilen inte (ännu) kvalificerades korrekt i det speciella joai -målgruppssegmentet när den registreras i motsvarande inkommande reseåtgärd.
Vänta 15 till 30 minuter tills
segmentMembership-värdena har importerats till profilen på hubben. Gå till nästa steg om du fortfarande inte är närvarande.
Steg 5: Om klienten/enheten fortfarande inte får det förväntade innehållet step-5
Om du har gått igenom alla steg ovan och inte ser det förväntade beteendet efter att ha väntat i 30 till 60 minuter på att segmentmedlemskapet ska sprida sig till Edge Network kontaktar du Adobe kundtjänst eller din Adobe-representant.
Inkludera så mycket information du kan från felsökningsstegen, till exempel:
- det steg där du ser det oväntade beteendet,
- ID för reseversion.
- ID för reseåtgärd.
- hela Assurance trace,
- JSON-vyn av Edge-profilen,
- JSON-vyn av navprofilen,
- osv.
Scenario 2: Användaren tar fortfarande emot inkommande innehåll scenario-2
Det här scenariot är omvänt för scenario 1: profilen har avslutat resan, men användaren tar fortfarande emot det inkommande innehållet.
Men när en profil avslutar en resa bör den inte längre kvalificera sig för målgruppssegmenten joai som motsvarar de inkommande åtgärderna under resan.
Gå igenom samma felsökningssteg som för Scenario 1 för att kontrollera om hubbprofilen, Edge-profilen och Edge Network leveransserver korrekt återspeglar segmentmedlemskapsstatusen för det relevanta joai-segmentet och om klienten inte längre tar emot det inkommande innehållet.