Felsöka live-aktiviteter troubleshoot-mobile-live
Med liveaktiviteter i Adobe Journey Optimizer kan du få dynamiska uppdateringar i realtid på iOS låsskärmar och Dynamic Islands. De kan bara aktiveras och hanteras via API-utlösta kampanjer.
Använd ärendetyper:
- Enhet: Individuellt riktade, transaktionella (API-utlösta transaktionskampanjer)
- Sändning: Målgruppsanpassad, massleverans (API-utlösta marknadsföringskampanjer)
En vanlig utmaning med Live Activity är när API-anropet för att utlösa eller uppdatera en Live Activity returnerar ett lyckat svar (200 OK), men Live Activity inte visas eller uppdateras på användarens enhet. Den här frånkopplingen mellan API-bekräftelse och det faktiska enhetsbeteendet kan ske vid flera punkter i leveransflödet. Den här guiden ger en systematisk felsökningsmetod för att identifiera var leveransen misslyckas, där varje steg från API-förfrågningsvalidering till enhetsrendering undersöks.
Förutsättningar
Innan du felsöker bör du kontrollera att du har:
-
accordion Konfigurera en Assurance-session Konfigurera en Assurance-session för att hämta SDK-händelser och inspektera leveransflödet. Assurance ger synlighet i
- Edge Network förfrågningar och svar
- Profilkvalificeringshändelser
- Push-tokenregistrering
- Livscykelhändelser för aktiv aktivitet
Lär dig hur du konfigurerar Assurance i Adobe Experience Platform Assurance-dokumentationen.
Obs! För iOS Live Activity kontrollerar du att appen körs på en fysisk iOS-enhet (iOS 16.1 eller senare) eller en Xcode-simulator (iOS 16.1 eller senare).
-
accordion Samla in API-utlöst kampanjinformation Navigera till API Triggered Campaign i Journey Optimizer och hämta:
- Kampanjnamn
- Kampanj-ID hittades i URL:en eller kampanjegenskaperna
- Kampanjversion, om tillämpligt
- Surface configuration, iOS app surface used for Live Activity
-
accordion Samla in API-begärandeinformation Spara följande när du gör ett API-anrop för att aktivera den aktiva aktiviteten:
- Nyttolast för API-begäran, inklusive profilidentifierare och liveaktivitetsdata
- API-svar inklusive statuskod, meddelande-ID, begäran-ID
- Tidsstämpel för när API anropades
- Slutpunkt används, t.ex.
/campaign/{CAMPAIGN_ID}/execute
-
accordion Identifiera testprofilen Hämta följande från din API-begäran:
- Profilnamnrymd, t.ex. ECID, e-post, kund-ID
- Profil-ID som används i API-anropet
Se till att du kan slå upp den här profilen i Adobe Experience Platform. Lär dig hur du söker efter en profil i Experience Platform-dokumentationen.
-
accordion Enhet- och appinformation Samla följande från din testenhet:
- Enhetsmodell, t.ex. iPhone 14 Pro
- iOS
- Programpaketidentifierare
- APN:s push-token
- Nätverksanslutningsstatus vid testning
Vanliga scenarier
Profil- eller push-tokenproblem profile-issue
[Gäller både enhetsanvändning och sändningsanvändning]{class="badge positive"}
API:t returnerar HTTP 200, men den aktiva aktiviteten visas inte. Vanliga orsaker:
- Profilen finns inte i Adobe Experience Platform.
- Push-token för aktiv aktivitet har inte synkroniserats med profilen.
- push-information för aktiv aktivitet synkroniseras men innehåller felaktig konfiguration, t.ex. fel
appIdellerattributeType.
Obs! Exempel på sändningsanvändning: Om vissa profiler i din publik saknar token kommer endast de profilerna inte att kunna ta emot den aktiva aktiviteten. Ta prov på flera profiler från er målgrupp för att diagnostisera tokenproblem. Detta gäller endast fjärrstarthändelser, inte uppdaterings- eller sluthändelser.
Förkontroller
-
Krav för iOS-program:
- iOS 16.1+
NSSupportsLiveActivitiesinställd påYESiInfo.plistActivityAttributeshar implementerats korrekt.
-
SDK-integrering för mobiler:
- Adobe Experience Platform Mobile SDK (messaging SDK 5.11.0+)
Messaging.registerLiveActivitiesimplementerades och anropades med push-token för Live-aktivitet.
Felsökningssteg
-
accordion Verifiera att profilen finns i Adobe Experience Platform - I Journey Optimizer går du till Kund
>Profiler. - Sök med namnutrymme och identitetsvärde från API-begäran.
- Om profilen inte hittas finns den inte eller så är intag inte slutfört. Skapa profilen eller vänta på intag innan Live-aktiviteten aktiveras.
- Om en profil hittas fortsätter du till steg 2 nedan för att kontrollera om push-token är synkroniserad.
- I Journey Optimizer går du till Kund
-
accordion Kontrollera om push-token för aktiv aktivitet har synkroniserats Du kan använda Assurance för att verifiera tokenregistrering:
- I Assurance filtrerar eller söker du efter händelser från listan Händelser
eventType = "liveActivity.pushToStart". - Markera Händelsen och kontrollera nyttolasten.
- Kontrollera att värden för token, appId och attributeType finns.
- Bekräfta om händelsen har skickats.
Du kan även checka in Adobe Experience Platform-profilen.
- Gå till fliken Händelser från din profil i Adobe Experience Platform.
- Sök efter
liveActivity.pushToStarthändelser. - Kontrollera den jämna tidsstämpeln och nyttolasten.
Om inga händelser hittas kommer din mobilapp inte att anropa
Messaging.registerLiveActivitykorrekt. Du måste åtgärda integreringen med SDK. - I Assurance filtrerar eller söker du efter händelser från listan Händelser
-
accordion Validera tokeninformation i profil -
Gå till fliken Attribut från din profil.
-
Sök efter
liveActivityPushNotificationDetails. -
Verifiera tokenkonfigurationen:
code language-json { "liveActivityPushNotificationDetails": [ { "appId": "com.example.myapp", "token": "abc123def456...", "platform": "apns", "denylisted": false, "attributeType": "OrderTrackingAttributes", "identity": {} } ] }
Verifiera varje fält:
table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 Fält Krav Vanligt problem appIdMåste exakt matcha iOS bundle-ID Felmatchning mellan dev/prod bundle-ID:n attributeTypeMåste exakt matcha Swift ActivityAttributes-strukturnamnet (skiftlägeskänsligt)Typo eller felaktigt strukturnamn platformMåste vara "apns"eller"apnsSandbox"Fel plattformsvärde denylistedMåste vara falseToken markerad som ogiltig eller användaren avböjde tokenGiltig APN:s push-token Token har gått ut eller appen har installerats om Om något fält är felaktigt: Uppdatera mobilappen, registrera om med
Messaging.registerLiveActivities, vänta 5-10 minuter och kontrollera igen.Om
liveActivityPushNotificationDetailssaknas: Token har inte synkroniserats än. Vänta 5-10 minuter efter att händelsenliveActivity.pushToStarthar visats i Assurance. -
Kampanjkonfiguration och nyttolastproblem payload-issues
[Gäller både enhetsanvändning och sändningsanvändning]{class="badge positive"}
Profilen finns med giltiga tokens, men Live Activity (Aktivitet) visas inte. Detta kan orsakas av:
- Fel konfiguration av yta eller kanal.
- Felaktig API-nyttolaststruktur.
content-stateochattributesmatchar inte implementeringen av iOSActivityAttributes.- Inaktuell
timestamp(kritisk för uppdatering/slut).
Obs! Kampanjen måste vara API-utlöst marknadsföring (inte Transactional). Nyttolasten använder audience i stället för den enskilda profile. I det här avsnittet finns information om den sändningsspecifika nyttolaststrukturen och i Adobe Developer-dokumentationen för fullständiga API-specifikationer.
Förkontroller
- Campaign är API-utlöst Transactional (Unitary) eller API-utlöst Marketing (broadcast) och alternativet High Throttput måste inte vara aktiverat eftersom det är inkompatibelt med Live Activity.
- Kontrollera att profilen finns och att tokens synkroniseras korrekt med scenariot ovan.
Felsökningssteg
-
accordion Verifiera konfiguration av kampanjyta - Öppna din kampanj i Journey Optimizer och gå till Åtgärder -menyn.
- Kontrollera din Live-aktivitetskonfiguration. Ytan måste konfigureras för iOS-appen med en källidentifierare som matchar
appIdi din profilsliveActivityPushNotificationDetails. Om din profil till exempel har"appId": "com.example.myapp"måste ytan ha samma app som mål. - Kontrollera att aktivitetstypen i kampanjkonfigurationen matchar exakt
attributeTypei din profilsliveActivityPushNotificationDetails. Om din profil till exempel har"attributeType": "FoodDeliveryLiveActivityAttributes"måste kampanjen ange samma aktivitetstyp.
-
accordion Validera API-nyttolaststruktur Kontrollera att nyttolasten följer rätt struktur när kampanjen körs via API.
Unitär nyttolast:
code language-json { "campaignId": "your-campaign-id", "recipients": [{ "type": "aep", "userId": "user@example.com", "namespace": "email", "context": { "requestPayload": { "aps": { "content-available": 1, "timestamp": 1756984054, "event": "start", "attributes-type": "FoodDeliveryLiveActivityAttributes", "content-state": { ... }, "attributes": { ... } } } } }] }Vanliga nyttolastproblem:
table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 6-row-3 Fält Krav Vanligt problem attributes-typeMåste matcha kampanjaktivitetstyp och profil attributeTypeFelmatchning eller stavfel campaignIdMåste matcha aktiverat kampanj-ID Fel eller saknat kampanj-ID content-availableMåste vara 1Saknat eller felaktigt värde eventMåste vara "start","update"eller"end"Ogiltig händelsetyp timestampMåste alltid vara den aktuella/senaste Unix-epoken i sekunder Använda gammal/cachelagrad tidsstämpel userId/namespaceMåste matcha en befintlig profil i AEP Profilidentifieraren matchar inte Kritisk: Använd alltid den senaste tidsstämpeln
- Fältet
timestampmåste alltid vara den aktuella Unix-epoken (i sekunder) när varje API-anrop görs. - Detta gäller alla händelsetyper:
start,updateoch särskiltend. - Påverkan på uppdateringar/slutbegäranden: Om en gammal eller gammal tidsstämpel används misslyckas uppdaterings- och slutbegäranden eller ignoreras av enheten.
- Återanvänd INTE tidsstämplar från tidigare begäranden eller använd cachelagrade värden.
- Generera en ny tidsstämpel för varje API-anrop.
Valfria fält (alla händelsetyper):
requestId: Unik identifierare för spårning (rekommenderas).alert: Objekt medtitleochbodyför meddelanden (användbart för att dra uppmärksamheten till uppdateringar).
Om
dismissal-date:- Valfritt fält som innehåller Unix epok-tid (sekunder).
- Endast relevant när
event: "end". - Anger när den aktiva aktiviteten automatiskt ska tas bort från enheten.
- Om den inte anges vid en sluthändelse förblir Live Activity synlig tills användaren stänger den.
- Måste vara en framtida tidsstämpel (senare än
timestamp).
- Fältet
-
accordion Justera nyttolast med iOS-implementering Kontrollera att API-nyttolasten matchar implementeringen av iOS-appen
ActivityAttributes. Adobe SDKLiveActivityAttributes-protokollet utökar iOSActivityAttributesoch kräver enliveActivityData-egenskap.Verifiera mappningen:
-
ActivityAttributesmåste implementera AdobeLiveActivityAttributes-protokollet. Exempel:code language-swift struct FoodDeliveryLiveActivityAttributes: LiveActivityAttributes { public struct ContentState: Codable, Hashable { var orderStatus: String var estimatedDeliveryTime: String } // Adobe SDK requirement var liveActivityData: LiveActivityData // Your custom attributes var restaurantName: String }Obs! Fältet
liveActivityDataär obligatoriskt för Adobe SDK och måste inkluderas i alla implementeringar. -
API-nyttolasten måste spegla iOS-strukturen:
code language-json { "aps": { "event": "start", "timestamp": 1756984054, "attributes-type": "FoodDeliveryLiveActivityAttributes", "content-state": { "orderStatus": "Preparing", "estimatedDeliveryTime": "20 mins" }, "attributes": { "liveActivityData": { "liveActivityID": "order-12345" }, "restaurantName": "Pizza Palace" } } }
Checklista för validering:
-
Inkludera alla
ContentState-fält icontent-state(krävs för alla händelsetyper). -
Inkludera alla
LiveActivityAttributes-fält iattributes(endast starthändelser), inklusive:liveActivityData(obligatoriskt; innehåller vanligenliveActivityIDeller liknande identifierare)- Alla anpassade fält från din struktur
-
Matcha fältnamn exakt (skiftlägeskänsliga).
-
Matcha datatyper (String, Int, Bool, kapslade objekt).
-
Bevara den kapslade objektstrukturen.
Vanliga misstag:
table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 6-row-3 7-row-3 Problem Effekt Korrigera liveActivityDatasaknas i attributAktiviteten kommer inte att starta Inkludera alltid objektet liveActivityDatai starthändelsenObligatoriskt fält saknas i starthändelsen Aktiviteten kommer inte att starta Lägg till alla fält från iOS-struktur Fel fältnamn (typo/case) Fältet ignorerades eller parsningsfel Matcha iOS-fältnamn exakt Fel datatyp Tolkningsfel Matcha iOS-datatyper Saknat kapslat objekt Ofullständiga data Inkludera alla kapslade strukturer Inkluderar attributesi uppdatering/slutOnödigt, men ignoreras vanligtvis Inkludera bara attributesi starthändelsenInaktuell tidsstämpel vid uppdatering/slut Uppdatering/slut ignoreras av enheten Generera alltid en ny tidsstämpel Mer exempel finns på Skapa Live-aktivitetssidan.
-
-
accordion Testa med Assurance Verifiera API-körning och nyttolast med Assurance:
-
Öppna din Assurance-session.
-
Kör API-anropet för att utlösa Live Activity.
-
I händelselistan söker du efter:
- Kampanjkörningshändelser.
- Leveranshändelser för live-aktivitet.
- Felhändelser för validering av nyttolast.
-
Granska händelsenyttolaster för att verifiera:
- Nyttolasten har bearbetats korrekt.
- Inga valideringsfel inträffade.
- Live Activity skickades till APN:er.
-
Leveransfel och felanalys
[Gäller både enhetsanvändning och sändningsanvändning]{class="badge positive"}
I det här scenariot har alla tidigare kontroller passerat:
- Det finns en profil med giltiga push-tokens för Live-aktivitet
- Kampanjen är korrekt konfigurerad med korrekt nyttolast
- Uppdateringstoken synkroniseras (endast för update/end-händelser, enhetsanvändning)
Men den aktiva aktiviteten visas, uppdateras eller avslutas fortfarande inte som förväntat. Problemet kan vara på Adobe leveranssystemnivå eller hos leverantören av push-meddelandetjänster (APN).
Obs! Rapporter visar mätvärden för alla målgruppsmedlemmar. Vissa profiler kan lyckas medan andra misslyckas.
Förkontroller
-
Tidigare scenarier har validerats:
- Profilen finns med rätt
liveActivityPushNotificationDetails - Kampanjytan och aktivitetstypen är korrekta
- API-nyttolasten är giltig med aktuell tidsstämpel
- Uppdateringstoken synkroniseras (för update/end-händelser)
- Profilen finns med rätt
-
API-anrop har bekräftats:
- API-anropet returnerade HTTP 200 (lyckades)
- Kampanj-ID och mottagarinformation är korrekta
Felsökningssteg
-
accordion Kontrollera kampanjrapporter -
Navigera till din Live Activity Campaign.
-
Klicka på knappen Rapporter.
-
Välj Visa hela tidsrapporten.
-
Granska följande avsnitt:
-
Kontrollera Sending Statistics-måtten för att förstå leveransframgången:
table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 Mått Vad det betyder Vad du ska leta efter Målinriktad Antal profiler som är kvalificerade för målgruppen Ska inkludera din testprofil Skickar Totalt antal push-meddelanden har gjorts Ska matcha dina API-anrop Levererat Levereras till enheter Jämför med Skicka för att se hur framgångsrik du är Skicka fel Push-meddelanden som inte kunde skickas Höga tal Skicka undantag Profiler exkluderade av Adobe Journey Optimizer Kontrollera om din profil har uteslutits -
Om Skicka fel > 0, kontrollera tabellen Felorsaker för att se specifika felkoder och meddelanden:
table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 Allmänt fel Betydelse Upplösning Ogiltig token Push-token är ogiltig eller har gått ut Registrera om live-aktivitetstoken från enheten Token hittades inte Ingen giltig token har associerats med profilen Verifiera att liveActivityPushNotificationDetailsfinnsAPN avvisade Tjänsten Apple Push Notification avvisade push Kontrollera APN-certifikat, paket-ID, miljö Nätverkstimeout Det går inte att nå APN:er Ett tillfälligt problem. Försök med API-anropet igen -
Om Skicka undantag > 0 kontrollerar du tabellen Undantagna orsaker:
table 0-row-3 1-row-3 2-row-3 3-row-3 Gemensamt undantag Betydelse Upplösning Profilen har valts ut Användaren har valt bort meddelanden Kontrollera profilens medgivandestatus Token blocklist Token markerad som ogiltig Registrera om token eller kontrollera status för blockeringslista Profilen är inte giltig Profilen uppfyller inte kampanjvillkoren Granska regler för kampanjmålgrupper
-
Läs mer på rapportsidan för Live-aktivitetskampanjen.
-
-
accordion Kontrollera meddelandefeedbackhändelser i profilen -
Navigera till Kund > Profiler i Journey Optimizer.
-
Sök efter och öppna profilen.
-
Välj fliken Händelser.
-
Filtrera eller sök efter händelser med
eventType = "message.feedback". -
Sök efter feedbackhändelser som matchar typen
liveActivityIDocheventför din Live Activity. -
Granska följande nyckelfält:
table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 Fält Möjliga värden Vad det betyder feedbackStatussent,error,denylistLeveransresultat från tjänsteleverantör serviceProviderapns/apnsSandboxBör vara APN för iOS Live Activity errorCodeNumerisk kod eller nullAPN:er-specifik felkod om misslyckades errorMessageFelbeskrivning eller nullFelmeddelande som kan läsas av människor -
Om
feedbackStatus: "error":- Kontrollera
errorCodeocherrorMessageför specifika APN-fel - Vanliga APN-fel inkluderar utgånen token, ogiltigt certifikat, fel paket-ID
- Kontrollera
-
Om ingen feedback-händelse hittades:
- Ett försök till push-meddelande har kanske inte gjorts
- Kontrollera om profilen har uteslutits i kampanjrapporter enligt steg 1 ovan.
-
-
accordion Verifiera direktaktivitetsleverans till APN:er i Assurance -
Öppna din Assurance-session. Den måste vara aktiv under API-anropet.
-
Kör API-anropet (starta, uppdatera eller avsluta).
-
I händelselistan söker du efter leveranshändelser för Live-aktivitet.
-
Sök efter händelser relaterade till APN:s push-leverans.
-
Kontrollera om det finns följande indikatorer:
- Push-begäran till APN:er: Bekräftar att Adobe har skickat push-åtgärden till Apple servrar
- APN-svar: Visar om APN:er accepterade eller avvisade push-meddelanden
- Leveransstatus: Indikation om slutförd eller fel
-
Om problem hittas, se följande vanliga APN:s leveransproblem:
table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 Problem Symptom i Assurance Upplösning APN-certifikatet har upphört att gälla Autentiseringsfel Förnya och överföra nya APN-certifikat Fel miljö (dev vs prod) Felmatchningsfel för token Säkerställ att certifikatet matchar appens byggtyp Fel i paket-ID Ogiltig källidentifierare Verifiera att ID för certifikatpaket matchar app Token har upphört InvalidToken-fel från APN:er Registrera om live-aktivitetstoken Hastighetsbegränsning För många förfrågningar Minska API-anropsfrekvens
-
-
accordion Fortsätt till ytterligare diagnostiska kontroller -
Kontrollera Live Activity Lifecycle-statistik i Campaign Report.
Granska avsnittet Live activity lifecycle i kampanjrapporten:
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 Mått Vad du ska kontrollera Fjärrstart Ska antalet API-utlösta starter visas Uppdateringar Ska visa antal uppdateringshändelser Slutar Ska visa antalet sluthändelser Antal summor Generell volym för live-aktivitetshändelse Om dessa värden är noll eller inte matchar dina API-anrop finns det ett leveransproblem mellan Adobe och APN.
-
Om leveransen är klar men enheten inte visar den aktiva aktiviteten:
- Kontrollera om det finns några aktivitetsfel i iOS enhetsloggar.
- Kontrollera att programmet är i förgrunden eller i bakgrunden (inte avslutat).
- Bekräfta att enheten är ansluten till nätverket.
- Testa på flera enheter för att slippa enhetsspecifika problem.
- Kontrollera att iOS är version 16.1 eller senare.
-
-
accordion Eskalering till Adobe Support Om du har slutfört alla steg och problemet inte är löst kontaktar du Adobe kundtjänst med:
Obligatorisk information:
-
Kampanj-ID och namn
-
Namnutrymme för profil och ID
liveActivityIDfrån API-nyttolast
-
Tidsstämplar för API-anrop
-
Skärmbilder av:
- Kampanjrapporter (skicka statistik, felorsaker, orsaker som inte tagits med)
- Profilhändelser (
liveActivity.updateToken,message.feedback) - Assurance session med leveranshändelser
-
fullständig nyttolast för API-begäran
-
Information om APN-certifikat (utgångsdatum, miljö, paket-ID)
-
Enhetliga scenarier
Uppdateringstoken för aktiv aktivitet har inte synkroniserats token-not-synced
Direktaktiviteten har startats på enheten, men efterföljande update eller end API-anrop (som returnerar HTTP 200) kan inte uppdatera eller stänga den aktiva aktiviteten. Detta inträffar när token för uppdatering av Live Activity inte synkroniseras korrekt till Adobe.
Förstå uppdateringstokens
När en Live Activity startas på en enhet genererar iOS en unik uppdateringstoken för den specifika Live Activity-instansen. Denna token krävs för:
- Skicka uppdateringar till den aktiva aktiviteten
- Fjärravsluta den aktiva aktiviteten
Varje instans av Live Activity har en egen unik uppdateringstoken. Adobe behöver denna token för att kunna leverera update- och end-händelser.
Förväntat beteende
För att update- och end-händelser ska fungera måste följande inträffa:
- Aktiviteten har startats på enheten.
- Enheten genererar en uppdateringstoken för den aktuella Live Activity-instansen.
- Mobile SDK hämtar och skickar uppdateringstoken till Adobe.
- Uppdateringstoken synkroniseras och lagras i Adobe.
- Efterföljande API-anrop för uppdatering/slut använder denna token för leverans.
Förkontroller:
- Användarbehörighet: Första gången en Live-aktivitet startas på en enhet visas en systemfråga i iOS: "Tillåt att [appnamn] tillhandahåller uppdateringar för Live-aktivitet?" Användaren måste trycka på Tillåt för att uppdateringstoken ska genereras och synkroniseras. Om användaren trycker på"Tillåt inte" skapas inga uppdateringstokens och uppdatering/slut-begäranden misslyckas. Det här är en engångserbjudande per program.
- Profil- och kampanjvalidering: Fullständig scenario 1 och scenario 2 kontrollerar att profil, token och kampanjkonfiguration är korrekta.
Felsökningssteg
-
accordion Verifiera synkronisering av uppdateringstoken i Assurance -
Öppna din Assurance-session.
-
Kontrollera att sessionen var aktiv när den aktiva aktiviteten startades på enheten.
-
Filtrera eller sök efter händelser med
eventType = "liveActivity.updateToken". -
Markera händelsen och inspektera nyttolasten:
- Kontrollera att fältet
tokeninnehåller en giltig uppdateringstokensträng. - Kontrollera att
liveActivityIDmatchar din Live Activity-instans. - Bekräfta att
activityTypematchar dinattributes-type.
- Kontrollera att fältet
-
Om händelsen inte hittas:
- Uppdateringstoken genererades eller hämtades inte av SDK.
- Kontrollera om användaren har beviljat Live Activity-behörigheter.
- Kontrollera att Live Activity faktiskt har startats på enheten.
- Bekräfta att mobilen SDK är ordentligt integrerad för att hämta uppdateringstokens.
-
Om en händelse hittas fortsätter du till steg 2.
-
-
accordion Verifiera uppdateringstoken i profilhändelser -
Navigera till Kund > Profiler i Journey Optimizer.
-
Sök efter och öppna profilen.
-
Välj fliken Händelser.
-
Sök efter
liveActivity.updateTokenhändelser. -
Kontrollera händelseinformationen:
- Kontrollera att tidsstämpeln är aktuell (matchar när Live Activity startas).
- Bekräfta att
tokenochliveActivityIDfinns. - Kontrollera att
activityTypeär korrekt.
-
Om händelsen inte hittas i profilen:
- Uppdateringstokenhändelsen kanske inte har importerats till profilen än.
- Vänta 5-10 minuter och kontrollera igen.
- Om det fortfarande saknas efter 15 minuter kan det bero på ett problem med att ta emot händelser.
-
Om en händelse hittas har uppdateringstoken synkroniserats. Du kan fortsätta till steg 3.
-
-
accordion Kontrollera liveaktivitetens leveranshändelser i Assurance -
Kör ett uppdaterings- eller avslutnings-API-anrop i din Assurance-session.
-
I händelselistan söker du efter leveranshändelser för live-aktivitet (APN:er push-händelser).
-
Sök efter händelser som indikerar:
- Push-meddelande har skickats till APN:er.
- Svar från APN:er (lyckades eller fel).
- Leveransbekräftelse.
-
Om det finns en APN-leveranshändelse: push-meddelandet skickades. Om enheten fortfarande inte uppdateras kan problemet bero på enheten (appen hanterar inte push, nätverksproblem osv.).
-
Om en APN:s leveranshändelse saknas: Uppdateringstoken kanske inte lagras korrekt eller är associerad med profilen i Adobe.
-
Om det finns felhändelser: Sök i felinformationen efter specifika felorsaker (ogiltig token, APNs avvisade etc.).
-
Sändningsspecifika scenarier
Sändningskampanjkonfiguration och nyttolastproblem broadcast-config
I det här avsnittet beskrivs felsökningsscenarier som är specifika för direktsändning av aktiviteter, som kräver andra felsökningsstrategier än enastående kampanjer.
När profiler har giltiga variabler men Live Activity inte visas, uppdateras eller fungerar som väntat för målgruppsmedlemmar beror problemet vanligtvis på något av följande:
- Kampanjen har inte konfigurerats som API-utlöst marknadsföring.
- API-nyttolasten använder en felaktig sändningsstruktur (
audienceellerinput-push-channelsaknas). - Fälten
content-stateochattributesmatchar inte implementeringen av iOSActivityAttributes. input-push-channelskapades inte korrekt på Apple Developer Portal.
Det här felsökningsscenariot gäller för alla live-aktivitetshändelser i utsändningskampanjer: start, update och end.
Förkontroller:
-
Kampanjtyp:
- Verifiera att kampanjen har skapats som API-utlöst marknadsföring (krävs för utsändning/målgruppsbaserade kampanjer).
- Bekräfta att en målgrupp har definierats i kampanjkonfigurationen.
-
Profil- och tokenvalidering: Prova flera profiler från målgruppen för att verifiera att de har giltig
liveActivityPushNotificationDetails. Följ Scenario 1 om du vill ha detaljerade valideringssteg.
Felsökningssteg
-
accordion Verifiera konfiguration av kampanjmålgrupp -
Öppna din API-utlösta marknadsföringskampanj i Journey Optimizer.
-
Navigera till avsnittet Målgrupp och verifiera:
- En målgrupp väljs ut för kampanjen.
- Målgrupps-ID:t matchar det som används i API-nyttolasten.
- Publiken innehåller de förväntade profilerna.
-
Navigera till avsnittet Åtgärder.
-
Kontrollera Live-aktivitetskonfigurationen:
- Konfigurationen måste anges för iOS-programmet med rätt källidentifierare.
- Aktivitetstypen måste matcha
attributes-typei API-nyttolasten. Om nyttolasten till exempel innehåller"attributes-type": "AirplaneTrackingAttributes"måste kampanjen ange samma aktivitetstyp.
-
-
accordion Validera nyttolaststrukturen för broadcast API Nyttolaststrukturen för utsändning skiljer sig från enhetskampanjer. Kontrollera att nyttolasten följer rätt sändningsformat.
Obligatoriska fält för sändning:
code language-json { "campaignId": "878a11d4-b519-47bd-8313-fecfee19857b", "audience": { "id": "8c3dbdea-2957-401f-acf0-3966fba1601e" }, "context": { "requestPayload": { "aps": { "input-push-channel": "FEt0NgvLEfEAAOqA6AXdIQ==", "content-available": 1, "timestamp": 1771829292, "event": "update", "attributes-type": "AirplaneTrackingAttributes", "content-state": { ... }, "attributes": { ... } } } } }Vanliga nyttolastproblem:
table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 6-row-3 7-row-3 Fält Krav Vanligt problem campaignIdMåste matcha det aktiverade ID:t för marknadsföringskampanj Fel kampanj-ID eller transaktionskampanj audience.idMåste matcha en befintlig målgrupp i AEP Fel målgrupps-ID eller målgrupp finns inte input-push-channelKrävs för sändning - Unik identifierare för den här sändningsinstansen Saknas eller matchar inte channelIDiliveActivityDatatimestampMåste alltid vara den aktuella/senaste Unix-epoken i sekunder Använda gammal/cachelagrad tidsstämpel eventMåste vara "start","update"eller"end"Ogiltig händelsetyp attributes-typeMåste matcha kampanjaktivitetstyp Felmatchning eller stavfel content-availableMåste vara 1Saknat eller felaktigt värde Kritiska sändningsspecifika fält:
-
input-push-channel:- Krävs för alla livesändningsaktiviteter.
- Fungerar som en unik identifierare för den här specifika sändningsinstansen.
- Alla profiler i målgruppen får liveaktiviteter som är länkade till den här kanalen.
- Måste matcha
channelIDiliveActivityData.channelID(se steg 3). - Måste skapas för
appIDpå Apple Developer Portal av klienten. - Endast kanaler som har skapats för den specifika
appIDkan användas för att sända direktaktivitet i den appen.
-
audience.id:- Måste referera till ett giltigt målgruppssegment som skapats i Adobe Experience Platform.
- Alla profiler i den här målgruppen är avsedda för aktiviteten Live.
- Publiken måste aktiveras och innehålla profiler med giltig
liveActivityPushNotificationDetails.
Använd alltid den senaste tidsstämpeln:
- Fältet
timestampmåste alltid vara den aktuella Unix-epoktiden (i sekunder) för varje API-anrop. - Detta krav gäller alla händelsetyper:
start,updateochend. - Kritisk för uppdateringar/slut: Om inaktuella tidsstämplar används misslyckas begäranden om uppdatering och slut.
- Generera en ny tidsstämpel för varje broadcast API-anrop.
Valfria fält:
dismissal-date: Unix-epok-tid för automatisk avstängning (endast relevant förend-händelser)alert: Objekt medtitleochbodyför avisering
Fullständiga API-specifikationer finns i API-dokumentationen för Adobe Journey Optimizer Messaging.
-
-
accordion Justera innehållsläge, attribut och input-push-channel med iOS-implementering Kontrollera att nyttolastfälten matchar iOS-appens
ActivityAttributes-implementering och attinput-push-channelmatcharchannelIDiliveActivityData.- Granska din definition av iOS ActivityAttributes.
Din anpassade
ActivityAttributes-struktur måste implementera AdobeLiveActivityAttributes-protokoll:code language-swift struct AirplaneTrackingAttributes: LiveActivityAttributes { public struct ContentState: Codable, Hashable { var journeyProgress: Int } // Adobe SDK requirement var liveActivityData: LiveActivityData // Your custom attributes var arrivalAirport: String var departureAirport: String var arrivalTerminal: String }- Mappa iOS-fält för att sända API-nyttolast.
Inkludera både
attributesochcontent-stateför alla händelser:code language-json { "aps": { "input-push-channel": "FEt0NgvLEfEAAOqA6AXdIQ==", "event": "start", "timestamp": 1771829292, "attributes-type": "AirplaneTrackingAttributes", "content-state": { "journeyProgress": 0 }, "attributes": { "arrivalAirport": "DEL", "departureAirport": "MUM", "arrivalTerminal": "T1", "liveActivityData": { "channelID": "FEt0NgvLEfEAAOqA6AXdIQ==" } } } }Kritisk:
input-push-channelmåste matchachannelID- Värdet
input-push-channeli roten avapsmåste exakt matcha värdetchannelIDiliveActivityData. - I exemplet ovan är båda värdena
"FEt0NgvLEfEAAOqA6AXdIQ==". - Denna matchning länkar sändningsinstansen till liveaktivitetsdata.
- En felmatchning orsakar leveransfel.
Nyckelvalideringspunkter:
- Inkludera alla
ContentState-fält icontent-stateför alla händelsetyper. - Inkludera alla anpassade
LiveActivityAttributes-fält iattributesendast för starthändelser. - För starthändelser måste
liveActivityData.channelIDmatchainput-push-channel. - Fältnamnen är skiftlägeskänsliga och måste matcha exakt.
- Datatyperna måste matcha (String, Int, Bool, kapslade objekt osv.).
- Använd samma
input-push-channelsom den ursprungliga starthändelsen för update/end-händelser.
Vanliga misstag:
table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 6-row-3 7-row-3 Problem Effekt Korrigera input-push-channelsaknasSändningen fungerar inte Lägg till ett unikt kanal-ID för varje sändning input-push-channelmatchar intechannelIDAktiviteten kommer inte att starta Kontrollera att båda värdena är identiska Annat input-push-channelför uppdatering/slutUppdatering/slut når inte de aktiva aktiviteterna Använd samma channel-id under hela livscykeln liveActivityData.channelIDsaknasLive Activity kommer inte att länka till broadcast Inkludera channelIDi attribut för starthändelseObligatoriskt fält saknas i starthändelsen Aktiviteten kommer inte att starta Lägg till alla fält från iOS-struktur Fel fältnamn (typo/case) Fältet ignorerades eller parsningsfel Matcha iOS-fältnamn exakt Inaktuell tidsstämpel vid uppdatering/slut Uppdatering/slut ignoreras av enheter Generera alltid en ny tidsstämpel -
accordion Testa med Assurance Verifiera API-körning och nyttolast med Assurance:
-
Öppna din Assurance-session på en testenhet som ingår i publiken.
-
Kör broadcast API-anropet.
-
I händelselistan söker du efter:
- Kampanjkörningshändelser.
- Leveranshändelser för live-aktivitet.
- Felhändelser som indikerar fel vid validering av nyttolast.
-
Kontrollera händelsens nyttolaster för att bekräfta:
- Nyttolasten bearbetades korrekt.
input-push-channelfinns.- Inga valideringsfel inträffade.
- Aktiva aktiviteter skickades till APN:er för målgruppsmedlemmar.
-
Profilen finns inte i målgruppen eller i ögonblicksbilden av den gamla målgruppen
I det här scenariot är kampanjen och nyttolasten korrekt konfigurerade, men specifika profiler tar inte emot den aktiva aktiviteten. Detta inträffar vanligtvis när:
- Profilen är inte medlem i den målgrupp som är länkad till kampanjen.
- Publiken är en grupppublik och innehåller en föråldrad ögonblicksbild av profildata.
- Profilens Live Activity-token lades till nyligen men har ännu inte visats i målgruppsögonblicksbilden.
Detta felsökningsscenario gäller specifikt för utsändningar av kampanjer med målgruppsbaserad målinriktning.
Förstå målgruppsutvärdering
Adobe Experience Platform använder olika metoder för målgruppsutvärdering som avgör när profiluppdateringarna återspeglas i publiken:
Förkontroller:
-
Kampanj- och nyttolastvalidering:
- Slutför kontrollerna i det här scenariot för att säkerställa att kampanjen och nyttolasten är korrekta.
- Kontrollera att
audience.idi API-nyttolasten matchar kampanjkonfigurationen.
-
Profilen finns: Bekräfta att profilen finns i AEP med giltig
liveActivityPushNotificationDetails.
Felsökningssteg
-
accordion Verifiera att profilen finns i målgruppen Bekräfta först om den profil som ska ta emot den aktiva aktiviteten faktiskt är en del av målgruppen.
-
Navigera till Publiker i Adobe Experience Platform.
-
Sök efter och öppna målgruppen med hjälp av
audience.idfrån din kampanj. -
Klicka på Bläddra eller Exempelprofiler för att visa målgruppsmedlemmar.
-
Sök efter din testprofil med namnutrymmet och identitetsvärdet.
-
Om profilen inte hittas i målgruppen:
- Profilen uppfyller inte målgruppskriterierna eller segmentreglerna.
- Granska målgruppsdefinitionen för att förstå kraven för medlemskap.
- Uppdatera profildata eller målgruppsdefinition så att den inkluderar profilen.
- Vänta tills publikutvärderingen är klar (se steg 2).
-
Om en profil hittas i målgruppen: Gå till steg 2 för att kontrollera dataaktualitet.
-
-
accordion Kontrollera utvärderingstyp och schema för målgruppen Identifiera om publiken använder utvärdering av batch- eller direktuppspelning, eftersom detta avgör datans aktualitet.
-
På sidan Målgruppsinformation ska du kontrollera Utvärderingsmetoden:
- Batch: Utvärderades en gång om dagen enligt ett schema.
- Direktuppspelning: Utvärderades i realtid när profiluppdateringar inträffar.
- Edge: Utvärderades vid edge-platser i realtid.
Följ felsökningsstegen som baseras på utvärderingsmetoden:
Om målgruppen använder batchutvärdering:
-
Förstå begränsningar för gruppmålgrupper:
- Batchmålgrupper utvärderas en gång per dag (vanligen över natten).
- Målgruppsbilden kan vara upp till 24 timmar gammal.
- Om en profil nyligen har registrerat liveaktivitetstoken är det inte säkert att dessa tokens finns i den aktuella ögonblicksbilden.
- Uppdateringar av profiler återspeglas inte förrän nästa grupputvärdering.
-
Kontrollera när senaste utvärdering utfördes:
- I målgruppsinformationen letar du efter tidsstämpeln Senaste utvärdering.
- Om profilens
liveActivityPushNotificationDetailsuppdaterades efter den här tidsstämpeln har målgruppen inaktuella data.
-
Lös inaktuella data:
-
Alternativ 1: Vänta på schemalagd batchutvärdering
- Nästa grupputvärdering innehåller uppdaterade profildata.
- Detta sker automatiskt en gång om dagen.
- Bäst för scenarier som inte är brådskande.
-
Alternativ 2: Utlös målgruppsutvärdering på begäran
- Navigera till Publiker i AEP.
- Välj målgrupp.
- Klicka på Utvärdera nu eller Aktivera vid behov.
- Vänta tills utvärderingen är klar (detta kan ta flera minuter till timmar beroende på målgruppens storlek).
- Kontrollera att profilen nu har uppdaterat data i målgruppsögonblicksbilden.
- Försök igen med broadcast API-anropet.
-
Om målgruppen använder utvärdering av direktuppspelning:
-
Förstå målgruppsbeteendet för direktuppspelning:
- Direktuppspelande målgrupper utvärderas i realtid när profiluppdateringar sker.
- Nya profiler: Kvalificera kort efter att de har skapats om de uppfyller segmentvillkoren.
- Uppdaterade profiler: Kvalificera eller diskvalificera kort efter att de har uppdaterats.
- Befintliga oförändrade profiler: utvärderas inte igen om inte en uppdatering görs.
-
Identifiera problemet:
- Om en profil redan finns och uppfyller segmentvillkoren, men ingen uppdatering görs för den profilen, kanske den inte läggs till för en nyligen skapad målgrupp.
- Profilen måste få en uppdatering (alla attributändringar) för att utlösa en ny utvärdering.
-
Lös problemet:
-
För nya profiler: De kvalificerar sig automatiskt om villkoren uppfylls. Ingen åtgärd krävs.
-
För befintliga profiler utan senaste uppdateringar:
- Gör en mindre uppdatering av profilen (t.ex. uppdatera ett tidsstämpelfält).
- Detta utlöser utvärdering av direktuppspelning och lägger till profilen för publiken.
- Alternativ: Använd en gruppmålgrupp eller en målgrupp för befintliga profiler.
-
-