Fehlerbehebung bei Live-Aktivitäten troubleshoot-mobile-live

Richten Sie eine Assurance- ein, um SDK-Ereignisse zu erfassen und die Bereitstellungs-Pipeline zu überprüfen. Assurance bietet Einblicke in:

• Edge Network-Anfragen und -Antworten
• Profilqualifikationsereignisse
• Push-Token-Registrierung
• Live-Aktivitäts-Lebenszyklus-Ereignisse

Wie Sie Assurance einrichten, erfahren Sie in der Dokumentation zu Adobe Experience Platform Assurance.

Hinweis: Stellen Sie für iOS Live-Aktivitäten sicher, dass Ihre App auf einem physischen iOS-Gerät (iOS 16.1 oder höher) oder Xcode-Simulator (iOS 16.1 oder höher) ausgeführt wird.

Navigieren Sie zu Ihrer API-ausgelösten Kampagne in Journey Optimizer und rufen Sie Folgendes ab:

• Kampagnenname
• In der URL oder den Kampagneneigenschaften gefundene Kampagnen-ID
• Campaign-Version, falls zutreffend
• Oberflächenkonfiguration, für die Live-Aktivität verwendete iOS-App-Oberfläche

Wenn Sie den API-Aufruf an den Trigger für die Live-Aktivität ausführen, speichern Sie:

• Payload der API-Anfrage, einschließlich Profilkennungen und Live-Aktivitätsdaten
• API-Antwort einschließlich Status-Code, Nachrichten-ID, Anfrage-ID
• Zeitstempel, der angibt, wann die API aufgerufen wurde
• Verwendeter Endpunkt, z. B. /campaign/{CAMPAIGN_ID}/execute

Aus Ihrer API-Anfrage können Sie Folgendes abrufen:

• Profil-Namespace, z. B. ECID, E-Mail, Kunden-ID
• Im API-Aufruf verwendete Profil-ID

Stellen Sie sicher, dass Sie dieses Profil in Adobe Experience Platform nachschlagen können. Erfahren Sie in ​ Dokumentation zu Experience Platform, wie Sie ein Profil ​.

Erfassen Sie Folgendes auf Ihrem Testgerät:

• Gerätemodell, z. B. iPhone 14 Pro
• iOS-Version
• App-Bundle-Kennung
• Push-Token für APNs
• Status der Netzwerkverbindung zum Zeitpunkt der Tests

1. Navigieren Sie in Journey Optimizer zu Kunde > Profile.
2. Suchen Sie mithilfe des Namespace und des Identitätswerts aus der API-Anfrage.
3. Wenn das Profil nicht gefunden wird, existiert das Profil nicht oder die Aufnahme wurde nicht abgeschlossen. Erstellen Sie das Profil oder warten Sie auf die Aufnahme, bevor Sie die Live-Aktivität auslösen.
4. Wenn ein Profil gefunden wird, fahren Sie mit Schritt 2 unten fort, um zu überprüfen, ob das Push-Token synchronisiert ist.

Sie können Assurance verwenden, um die Token-Registrierung zu überprüfen:

1. Filtern Sie in Assurance über die Ereignisse-Liste oder suchen Sie eventType = "liveActivity.pushToStart" nach Ereignissen.
2. Wählen Sie Ereignis aus und überprüfen Sie die Payload.
3. Überprüfen Sie, ob die Werte für Token, appId und attributeType vorhanden sind.
4. Bestätigen, ob das Ereignis erfolgreich gesendet wurde.

Sie können auch das Adobe Experience Platform-Profil einchecken.

1. Rufen Sie in Adobe Experience Platform über Ihr Profil die Registerkarte Ereignisse auf.
2. Nach liveActivity.pushToStart Ereignissen suchen.
3. Überprüfen Sie den Zeitstempel und die Payload des Ereignisses.

Wenn keine Ereignisse gefunden werden, ruft Ihre Mobile App Messaging.registerLiveActivity nicht korrekt auf. Sie müssen die SDK-Integration korrigieren.

1. Rufen Sie von Profil aus die Registerkarte Attribute auf.

2. Suchen Sie liveActivityPushNotificationDetails.

3. Überprüfen Sie die Token-Konfiguration:

   code language-json
   { "liveActivityPushNotificationDetails": [ { "appId": "com.example.myapp", "token": "abc123def456...", "platform": "apns", "denylisted": false, "attributeType": "OrderTrackingAttributes", "identity": {} } ] }

Validieren jedes Felds:

Wenn ein Feld falsch ist: Aktualisieren Sie die Mobile App, registrieren Sie sich erneut mit Messaging.registerLiveActivities, warten Sie 5-10 Minuten und überprüfen Sie dann erneut.

Wenn liveActivityPushNotificationDetails fehlt: Token wurde noch nicht synchronisiert. Warten Sie 5-10 Minuten, nachdem Sie das liveActivity.pushToStart Ereignis in Assurance gesehen haben.

1. Öffnen Sie in Journey Optimizer Ihre Kampagne und navigieren Sie zum Menü Aktionen .
2. Überprüfen Sie Ihre Konfiguration der Live-Aktivität. Die Oberfläche muss für die iOS-App mit einer Bundle-Kennung konfiguriert werden, die mit der appId in der liveActivityPushNotificationDetails Ihres Profils übereinstimmt. Wenn Ihr Profil beispielsweise über "appId": "com.example.myapp" verfügt, muss die Oberfläche dieselbe App ansprechen.
3. Vergewissern Sie sich dass der Aktivitätstyp“ in Ihrer Kampagnenkonfiguration genau mit dem attributeType in der liveActivityPushNotificationDetails Ihres Profils übereinstimmt. Wenn Ihr Profil beispielsweise über "attributeType": "FoodDeliveryLiveActivityAttributes" verfügt, muss die Kampagne denselben Aktivitätstyp angeben.

Stellen Sie beim Ausführen der Kampagne über die API sicher, dass die Payload der richtigen Struktur entspricht.

Unitäre Payload:

{
   "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": { ... }
         }
      }
      }
   }]
}

Häufige Payload-Probleme:

Kritisch: Verwenden Sie immer den neuesten Zeitstempel

• Das timestamp Feld muss immer zum Zeitpunkt jeden API-Aufrufs die aktuelle Unix-Epochenzeit) in Sekunden) sein.
• Dies gilt für alle Ereignistypen: start, update und insbesondereend.
• Auswirkungen auf Updates/: Die Verwendung eines veralteten oder alten Zeitstempels führt dazu, dass Update- und End-Anfragen fehlschlagen oder vom Gerät ignoriert werden.
• Verwenden KEINE Zeitstempel aus früheren Anfragen wieder oder verwenden Sie zwischengespeicherte Werte.
• Generieren Sie für jeden API-Aufruf einen neuen Zeitstempel.

Optionale Felder (alle Ereignistypen):

• requestId: Eindeutige Kennung für das Tracking (empfohlen).
• alert: Objekt mit title und body für Benachrichtigungen (nützlich, um auf Aktualisierungen hinzuweisen).

Über dismissal-date:

• Optionales Feld mit Unix-Epochenzeit (Sekunden).
• Nur relevant, wennevent: "end".
• Gibt an, wann die Live-Aktivität automatisch vom Gerät entfernt werden soll.
• Wird die Live-Aktivität nicht im Endereignis angegeben, bleibt sie sichtbar, bis sie vom Benutzer geschlossen wird.
• Muss ein zukünftiger Zeitstempel sein (nach timestamp).

Stellen Sie sicher, dass Ihre API-Payload mit der ActivityAttributes Implementierung Ihrer iOS-App übereinstimmt. Das LiveActivityAttributes-Protokoll von Adobe SDK erweitert iOS ActivityAttributes und erfordert eine liveActivityData.

Validieren der Zuordnung:

1. Ihr ActivityAttributes muss das LiveActivityAttributes-Protokoll von Adobe implementieren. Beispiel:

   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 }

   Hinweis dass das Feld liveActivityData für Adobe SDK erforderlich ist und in allen Implementierungen enthalten sein muss.

2. Ihre API-Payload muss die iOS-Struktur widerspiegeln:

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

Validierungs-Checkliste:

• Alle ContentState Felder in content-state einbeziehen (für alle Ereignistypen erforderlich).

• Alle LiveActivityAttributes Felder in attributes einbeziehen (nur Startereignisse), einschließlich:

  • liveActivityData (erforderlich; enthält normalerweise liveActivityID oder eine ähnliche Kennung)
  • Alle benutzerdefinierten Felder aus Ihrer Struktur

• Exakte Übereinstimmung der Feldnamen (unter Berücksichtigung von Groß- und Kleinschreibung)

• Übereinstimmende Datentypen (String, Int, bool, verschachtelte Objekte).

• Verschachtelte Objektstruktur beibehalten.

Häufige Fehler:

Weitere Beispiele finden Sie auf ​ Seite „Live-Aktivität erstellen.

Überprüfen der API-Ausführung und der Payload-Bereitstellung mithilfe von Assurance:

1. Öffnen Sie Ihre Assurance-Sitzung.

2. Ausführen des API-Aufrufs zum Trigger der Live-Aktivität.

3. Prüfen Sie der-Liste nach:

   • Ausführungsereignisse der Kampagne.
   • Versandereignisse für Live-Aktivitäten.
   • Payload-Validierungsfehler-Ereignisse.

4. Überprüfen Sie Ereignis-Payloads zur Überprüfung:

   • Payload wurde korrekt verarbeitet.
   • Keine Validierungsfehler aufgetreten.
   • Live-Aktivität wurde an APNs gesendet.

1. Navigieren Sie zu Ihrer Live-Kampagnenaktivität.

2. Klicken Sie auf die Berichte.

3. Wählen Alle Zeitberichte anzeigen aus.

4. Sehen Sie sich die folgenden Abschnitte an:

   1. Überprüfen Sie die Metriken Versandstatistiken, um den Erfolg des Versands zu verstehen:

      table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3
      Metrik	Bedeutung	Worauf Sie achten sollten
      Zielgruppe	Anzahl der für die Zielgruppe qualifizierten Profile	Sollte Ihr Testprofil enthalten
      Sendungen	Gesamtzahl der Push-Benachrichtigungen	Sollte Ihren API-Aufrufen entsprechen
      zugestellt	Erfolgreich an Geräte gesendet	Mit Sendungen vergleichen, um Erfolgsrate zu sehen
      Fehler senden	Push-Benachrichtigungen, die nicht gesendet werden konnten	Hohe Zahlen
      Ausschlüsse senden	Von Adobe Journey Optimizer ausgeschlossene Profile	Prüfen, ob Ihr Profil ausgeschlossen wurde

   2. Wenn Fehler senden > 0, überprüfen Sie die Fehlerursachen Tabelle auf spezifische Fehler-Codes und Meldungen:

      table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3
      häufiger Fehler	Bedeutung	Lösung
      Ungültiges Token	Push-Token ist ungültig oder abgelaufen	Live-Aktivitäts-Token vom Gerät erneut registrieren
      Token nicht gefunden	Kein gültiges Token mit Profil verknüpft	Überprüfen, ob liveActivityPushNotificationDetails vorhanden ist
      APNs abgelehnt	Apple Push Notification Service hat die Push-Benachrichtigung abgelehnt	APNs-Zertifikat, Paket-ID, Umgebung überprüfen
      Netzwerk-Timeout	APNs können nicht erreicht werden	Vorübergehendes Problem; API-Aufruf erneut versuchen

   3. Wenn Ausschlüsse senden > 0, überprüfen Sie die Tabelle Ausschlussgründe:

      table 0-row-3 1-row-3 2-row-3 3-row-3
      gemeinsamer Ausschluss	Bedeutung	Lösung
      Profil hat sich abgemeldet	Benutzer hat Benachrichtigungen abgelehnt	Einverständnisstatus des Profils überprüfen
      Token auf die Blockierungsliste gesetzt	Token als ungültig markiert	Token erneut registrieren oder Status der Blockierungsliste überprüfen
      Profil nicht geeignet	Profil erfüllt die Kampagnenkriterien nicht	Überprüfen von Zielgruppenregeln für Kampagnen

Weitere Informationen finden Sie auf der Seite Live-Kampagnenbericht.

1. Navigieren Sie Journey Optimizer zu > Profile.

2. Suchen Sie nach dem Profil und öffnen Sie es.

3. Wählen Sie die Ereignisse aus.

4. Filtern oder suchen Sie nach Ereignissen mit eventType = "message.feedback".

5. Suchen Sie nach Feedback-Ereignissen, die dem liveActivityID und event Ihrer Live-Aktivität entsprechen.

6. Überprüfen Sie die folgenden Schlüsselfelder:

   table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3
   Feld	Mögliche Werte	Bedeutung
   feedbackStatus	sent, error, denylist	Versandergebnis vom Dienstleister
   serviceProvider	apns/apnsSandbox	Sollte APNs für iOS Live-Aktivitäten sein
   errorCode	Numerischer Code oder null	APNs-spezifischer Fehler-Code, wenn fehlgeschlagen
   errorMessage	Fehlerbeschreibung oder null	Lesbare Fehlermeldung

7. Wenn feedbackStatus: "error":

   • Überprüfen Sie die errorCode und errorMessage auf spezifische APNs-Fehler
   • Zu den häufigen APNs-Fehlern gehören abgelaufene Token, ungültiges Zertifikat und falsche Paket-ID

8. Wenn kein Feedback-Ereignis gefunden wird:

   • Die Push-Benachrichtigung wurde möglicherweise nicht versucht
   • Überprüfen Sie, ob das Profil in den Kampagnenberichten ausgeschlossen wurde, wie in Schritt 1 oben beschrieben.

1. Öffnen Sie Ihre Assurance-Sitzung. Sie muss während des API-Aufrufs aktiv sein.

2. Ausführen des API-Aufrufs (Starten, Aktualisieren oder Beenden).

3. Suchen Sie in Ereignisliste nach Versandereignissen für Live-Aktivitäten.

4. Suchen Sie nach Ereignissen im Zusammenhang mit dem APNs-Push-Versand.

5. Prüfen Sie die folgenden Indikatoren:

   • Push-Anfrage an APNs: Bestätigt, dass Adobe die Push-Benachrichtigung an die Server von Apple gesendet hat
   • APNs-: Zeigt an, ob APNs die Push-Benachrichtigung akzeptiert oder abgelehnt haben
   • Versandstatus: Erfolgs- oder Fehleranzeige

6. Wenn Probleme festgestellt werden, lesen Sie die folgenden häufigen Probleme bei der Bereitstellung von APNs:

   table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3
   Problem	Symptom in Assurance	Lösung
   APNs-Zertifikat abgelaufen	Authentifizierungsfehler	Neues APNs-Zertifikat erneuern und hochladen
   Falsche Umgebung (Entwicklung vs. Produktion)	Fehler wegen nicht übereinstimmender Token	Sicherstellen, dass das Zertifikat mit dem App-Build-Typ übereinstimmt
   Paket-ID stimmt nicht überein	Ungültige Bundle-Kennung	Überprüfen, ob die Zertifikatpaket-ID mit der App übereinstimmt
   Token abgelaufen	InvalidToken-Fehler von APNs	Live-Aktivitäts-Token erneut registrieren
   Ratenbegrenzung	Zu viele Anfragen	Verringern der API-Aufruffrequenz

1. Überprüfen Sie die Lebenszyklusmetriken der Live-Aktivität im Kampagnenbericht.

   Gehen Sie im Kampagnenbericht zum Abschnitt Lebenszyklus der Live-Aktivität:

   table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2
   Metrik	Was zu überprüfen ist
   Fernstart	Sollte die Anzahl der API-ausgelösten Starts anzeigen
   Updates	Sollte die Anzahl der Update-Ereignisse anzeigen
   Endet	Sollte die Anzahl der Endereignisse anzeigen
   Gesamtzahl der Kontakte	Gesamtes Ereignisvolumen der Live-Aktivität

   Wenn diese Metriken null sind oder nicht mit Ihren API-Aufrufen übereinstimmen, gibt es ein Bereitstellungsproblem zwischen Adobe und APNs.

2. Wenn Adobe einen erfolgreichen Versand anzeigt, das Gerät die Live-Aktivität jedoch nicht anzeigt:

   • Überprüfen Sie die iOS-Geräteprotokolle auf Fehler bei Live-Aktivitäten.
   • Überprüfen, ob sich die App im Vordergrund oder Hintergrund befindet (nicht beendet).
   • Vergewissern Sie sich, dass das Gerät über eine Netzwerkverbindung verfügt.
   • Testen Sie auf mehreren Geräten, um gerätespezifische Probleme auszuschließen.
   • Stellen Sie sicher, dass iOS Version 16.1 oder höher ist.

Wenn Sie alle Schritte ausgeführt haben und das Problem weiterhin nicht behoben ist, wenden Sie sich an die Adobe-Kundenunterstützung mit:

Erforderliche Informationen:

• Kampagnen-ID und -name
• Profil-Namespace und ID
• liveActivityID aus API-Payload
• Zeitstempel von API-Aufrufen
• Screenshots von:
• Kampagnenberichte (Versandstatistiken, Fehlerursachen, Ausschlussgründe)
• Profilereignisse (liveActivity.updateToken, message.feedback)
• Assurance-Sitzung mit Versandereignissen
• Payload der API-Anfrage abschließen
• APNs-Zertifikatdetails (Ablauf, Umgebung, Paket-ID)

1. Öffnen Sie Ihre Assurance-Sitzung.

2. Stellen Sie sicher, dass die Sitzung aktiv war, als die Live-Aktivität auf dem Gerät gestartet wurde.

3. Filtern oder suchen Sie nach Ereignissen mit eventType = "liveActivity.updateToken".

4. Wählen Sie das Ereignis aus und überprüfen Sie die Payload:

   • Überprüfen Sie, ob das Feld token eine gültige Aktualisierungstoken-Zeichenfolge enthält.
   • Überprüfen Sie, ob die liveActivityID mit Ihrer Live-Aktivitätsinstanz übereinstimmt.
   • Vergewissern Sie sich, dass die activityType Ihrer attributes-type entspricht.

5. Wenn das Ereignis nicht gefunden wird:

   • Das Aktualisierungs-Token wurde von SDK nicht generiert oder erfasst.
   • Überprüfen Sie, ob der Benutzer Berechtigungen für Live-Aktivitäten erteilt hat.
   • Überprüfen Sie, ob die Live-Aktivität auf dem Gerät erfolgreich gestartet wurde.
   • Vergewissern Sie sich, dass der mobile SDK ordnungsgemäß integriert ist, um Aktualisierungstoken zu erfassen.

6. Wenn das Ereignis gefunden wird, fahren Sie mit Schritt 2 fort.

1. Navigieren Sie Journey Optimizer zu > Profile.

2. Suchen Sie nach dem Profil und öffnen Sie es.

3. Wählen Sie die Ereignisse aus.

4. Suchen Sie nach liveActivity.updateToken Ereignissen.

5. Überprüfen Sie die Ereignisdetails:

   • Überprüfen Sie, ob der Zeitstempel kürzlich war (stimmt überein mit dem Beginn der Live-Aktivität).
   • Bestätigen Sie, dass token und liveActivityID vorhanden sind.
   • Stellen Sie sicher, dass die activityType korrekt ist.

6. Wenn das Ereignis nicht im Profil gefunden wird:

   • Das Aktualisierungstoken-Ereignis wurde möglicherweise noch nicht in das Profil aufgenommen.
   • 5-10 Minuten warten und erneut überprüfen.
   • Wenn nach 15 Minuten immer noch fehlt, kann es ein Problem bei der Ereignisaufnahme geben.

7. Wenn das Ereignis gefunden wird, wurde das Aktualisierungstoken synchronisiert. Sie können mit Schritt 3 fortfahren.

1. Führen Sie in Ihrer Assurance-Sitzung einen Update- oder End-API-Aufruf aus.

2. Suchen Sie in Ereignisliste nach Versandereignissen von Live-Aktivitäten (APNs und Push-Ereignisse).

3. Prüfen Sie auf Ereignisse, die Folgendes anzeigen:

   • Push-Benachrichtigung an APNs gesendet.
   • Antwort von APNs (Erfolg oder Fehler).
   • Versandbestätigung

4. Wenn ein APNs-Versandereignis vorhanden ist: Die Push-Benachrichtigung wurde gesendet. Wenn das Gerät immer noch nicht aktualisiert wird, liegt das Problem möglicherweise auf der Geräteseite (App verarbeitet den Push nicht, Netzwerkprobleme usw.).

5. Wenn das APNs-Bereitstellungsereignis fehlt: Das Aktualisierungstoken ist im System von Adobe möglicherweise nicht ordnungsgemäß gespeichert oder mit dem Profil verknüpft.

6. Wenn Fehlerereignisse vorhanden sind: Überprüfen Sie die Fehlerdetails auf bestimmte Fehlerursachen (ungültiges Token, zurückgewiesene APNs usw.).

1. Öffnen Sie Ihre API-ausgelöste Marketing Kampagne in Journey Optimizer.

2. Navigieren Sie zum Abschnitt Zielgruppe und überprüfen Sie Folgendes:

   • Für die Kampagne wird eine Audience ausgewählt.
   • Die Zielgruppen-ID entspricht der in Ihrer API-Payload verwendeten.
   • Die Zielgruppe enthält die erwarteten Profile.

3. Navigieren Sie zum Abschnitt Aktionen .

4. Überprüfen Sie die Konfiguration der Live-Aktivität:

   • Die Konfiguration muss für die iOS-App mit der richtigen Bundle-ID festgelegt werden.
   • Der Aktivitätstyp muss mit dem attributes-type in Ihrer API-Payload übereinstimmen. Wenn Ihre Payload beispielsweise "attributes-type": "AirplaneTrackingAttributes" enthält, muss die Kampagne denselben Aktivitätstyp angeben.

Die Struktur der Broadcast-Payload unterscheidet sich von unitären Kampagnen. Vergewissern Sie sich, dass Ihre Payload das richtige Sendeformat verwendet.

Erforderliche Felder für die Übertragung:

{
   "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": { ... }
      }
      }
   }
}

Häufige Payload-Probleme:

Kritische Broadcast-spezifische Felder:

• input-push-channel

  • Erforderlich für alle Broadcast-Live-Aktivitäten.
  • Fungiert als eindeutige Kennung für diese spezifische Broadcast-Instanz.
  • Alle Profile in der Zielgruppe erhalten Live-Aktivitäten, die mit diesem Kanal verknüpft sind.
  • Muss mit dem channelID in liveActivityData.channelID übereinstimmen (siehe Schritt 3).
  • Muss vom Client für die appID im Apple-Entwicklerportal erstellt werden.
  • Nur Kanäle, die für das jeweilige appID erstellt wurden, können für die Übertragung der Live-Aktivität in diesem Programm verwendet werden.

• audience.id

  • Muss auf ein in Adobe Experience Platform erstelltes gültiges Zielgruppensegment verweisen.
  • Alle Profile in dieser Zielgruppe sind für die Live-Aktivität angesprochen.
  • Die Zielgruppe muss aktiviert sein und Profile mit gültigen liveActivityPushNotificationDetails enthalten.

Verwenden Sie immer den neuesten Zeitstempel:

• Das Feld timestamp muss bei jedem API-Aufruf immer die aktuelle Unix-Epochenzeit (in Sekunden) sein.
• Diese Anforderung gilt für alle Ereignistypen: start, update und end.
• Kritisch für Updates/Ende: Die Verwendung veralteter Zeitstempel führt dazu, dass Update- und End-Anfragen fehlschlagen.
• Generieren Sie für jeden Broadcast-API-Aufruf einen neuen Zeitstempel.

Optionale Felder:

• dismissal-date: Unix-Epochenzeit für automatische Abweisung (nur relevant für end Ereignisse)
• alert: Objekt mit title und body zur Benachrichtigung

Vollständige API-Spezifikationen finden Sie in der ​ zur Adobe Journey Optimizer Messaging-API ​.

Stellen Sie sicher, dass die Payload-Felder mit der ActivityAttributes Implementierung Ihrer iOS-App übereinstimmen und dass die input-push-channel mit der channelID in liveActivityData übereinstimmt.

1. Überprüfen Sie Ihre iOS ActivityAttributes-Definition.

Ihre benutzerdefinierte ActivityAttributes muss das LiveActivityAttributes-Protokoll von Adobe implementieren:

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
}

1. Ordnen Sie iOS-Felder der Broadcast-API-Payload zu.

Schließen Sie für alle Ereignisse sowohl attributes als auch content-state ein:

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

Kritisch: input-push-channel muss mitchannelID übereinstimmen

• Der input-push-channel am Stamm von aps muss genau mit dem channelID in liveActivityData übereinstimmen.
• Im obigen Beispiel werden beide Werte "FEt0NgvLEfEAAOqA6AXdIQ==".
• Dieser Abgleich verknüpft die Broadcast-Instanz mit den Daten der Live-Aktivität.
• Fehlende Übereinstimmung führt zu fehlgeschlagenen Sendungen.

Wichtige Validierungspunkte:

• Schließen Sie alle ContentState Felder in content-state für alle Ereignistypen ein.
• Schließen Sie alle benutzerdefinierten LiveActivityAttributes nur für Startereignisse in attributes ein.
• Bei Startereignissen muss liveActivityData.channelID mit input-push-channel übereinstimmen.
• Bei Feldnamen wird zwischen Groß- und Kleinschreibung unterschieden und sie müssen genau übereinstimmen.
• Datentypen müssen übereinstimmen (Zeichenfolge, int, bool, verschachtelte Objekte usw.).
• Verwenden Sie für Aktualisierungs-/Endereignisse denselben input-push-channel wie das ursprüngliche Startereignis.

Häufige Fehler:

Überprüfen der API-Ausführung und der Payload-Bereitstellung mithilfe von Assurance:

1. Öffnen Sie Ihre Assurance-Sitzung auf einem Testgerät, das Teil der Zielgruppe ist.

2. Führt den Broadcast-API-Aufruf aus.

3. Suchen Sie in Ereignisliste nach:

   • Ausführungsereignisse der Kampagne.
   • Versandereignisse für Live-Aktivitäten.
   • Fehlerereignisse, die auf Fehler bei der Payload-Validierung hinweisen.

4. Überprüfen Sie Ereignis-Payloads zur Bestätigung:

   • Die Payload wurde korrekt verarbeitet.
   • Die input-push-channel ist vorhanden.
   • Keine Validierungsfehler aufgetreten.
   • Live-Aktivitäten wurden für Zielgruppenmitglieder an APNs gesendet.

Bestätigen Sie zunächst, ob das Profil, das die Live-Aktivität erhalten soll, tatsächlich Teil der Zielgruppe ist.

1. Navigieren Sie zu Zielgruppen in Adobe Experience Platform.

2. Suchen und öffnen Sie die Audience mithilfe der audience.id aus Ihrer Kampagne.

3. Klicken Sie auf Durchsuchen oder Beispielprofile, um die Mitglieder der Zielgruppe anzuzeigen.

4. Suchen Sie mithilfe des Namespace und des Identitätswerts nach Ihrem Testprofil.

5. Wenn das Profil nicht in der Zielgruppe gefunden wird:

   • Das Profil erfüllt nicht die Zielgruppenkriterien oder Segmentregeln.
   • Überprüfen Sie die Zielgruppendefinition, um die Mitgliedschaftsanforderungen zu verstehen.
   • Aktualisieren Sie die Profildaten oder die Zielgruppendefinition, um das Profil einzuschließen.
   • Warten Sie, bis die Auswertung der Zielgruppe abgeschlossen ist (siehe Schritt 2).

6. Wenn ein Profil in der Zielgruppe gefunden wird: Fahren Sie mit Schritt 2 fort, um die Datenfrische zu überprüfen.

Ermitteln Sie, ob die Zielgruppe die Batch- oder Streaming-Auswertung verwendet, da dies die Datenfrische bestimmt.

1. Überprüfen Sie auf Seite Zielgruppendetails“ die Auswertungsmethode:

   • Batch: Wird einmal täglich nach einem Zeitplan ausgewertet.
   • Streaming: Wird in Echtzeit ausgewertet, wenn Profilaktualisierungen auftreten.
   • Edge: Wird an Edge-Standorten in Echtzeit ausgewertet.

Führen Sie die entsprechenden Schritte zur Fehlerbehebung auf der Grundlage der Auswertungsmethode aus:

Wenn die Zielgruppe die Batch-Auswertung verwendet:

1. Verstehen der Beschränkungen für Batch-Zielgruppen:

   • Batch-Zielgruppen werden einmal täglich ausgewertet (normalerweise über Nacht).
   • Der Zielgruppen-Snapshot kann bis zu 24 Stunden alt sein.
   • Wenn ein Profil kürzlich Live-Aktivitäts-Token registriert hat, befinden sich diese Token möglicherweise nicht in der aktuellen Momentaufnahme.
   • Aktualisierungen an Profilen werden erst bei der nächsten Batch-Auswertung angezeigt.

2. Zeitpunkt der letzten Auswertung überprüfen:

   • Suchen Sie in den Zielgruppendetails nach dem Letzte Auswertung Zeitstempel.
   • Wenn die liveActivityPushNotificationDetails des Profils nach diesem Zeitstempel aktualisiert wurden, verfügt die Zielgruppe über veraltete Daten.

3. Veraltete Daten auflösen:

   1. Option 1: Warten auf die geplante Batch-Auswertung

      • Die nächste Batch-Auswertung enthält die aktualisierten Profildaten.
      • Dies geschieht automatisch einmal pro Tag.
      • Am besten geeignet für nicht dringende Szenarien.

   2. Option 2: Trigger-On-Demand-Zielgruppenbewertung

      1. Navigieren Sie zu Zielgruppen in AEP.
      2. Wählen Sie die Zielgruppe aus.
      3. Klicken Sie Jetzt bewerten oder Bei Bedarf aktivieren.
      4. Warten Sie, bis die Auswertung abgeschlossen ist (dies kann je nach Zielgruppengröße mehrere Minuten bis Stunden dauern).
      5. Stellen Sie sicher, dass das Profil jetzt aktualisierte Daten im Zielgruppen-Snapshot enthält.
      6. Wiederholen Sie den Broadcast-API-Aufruf.

Wenn die Zielgruppe die Streaming-Auswertung verwendet:

1. Verstehen Sie das Verhalten von Streaming-Zielgruppen:

   • Streaming-Zielgruppen werden in Echtzeit ausgewertet, wenn Profilaktualisierungen stattfinden.
   • Neue Profile: Qualifizieren Sie sich kurz nach der Erstellung, wenn sie die Segmentkriterien erfüllen.
   • Aktualisierte Profile: Kurz nach der Aktualisierung qualifizieren oder disqualifizieren.
   • Bestehende unveränderte Profile: werden erst dann erneut ausgewertet, wenn eine Aktualisierung erfolgt.

2. Identifizieren Sie das Problem:

   • Wenn ein Profil bereits vorhanden ist und die Segmentkriterien erfüllt, bei diesem Profil jedoch keine Aktualisierung erfolgt, wird es möglicherweise nicht zu einer neu erstellten Streaming-Zielgruppe hinzugefügt.
   • Das Profil muss eine Aktualisierung (jede Attributänderung) erhalten, damit es erneut ausgewertet werden kann.

3. Problem beheben:

   • Für neue Profile: Sie qualifizieren sich automatisch, wenn die Kriterien erfüllt sind. Keine Aktion erforderlich.

   • Für vorhandene Profile ohne aktuelle Updates:

     • Nehmen Sie eine kleinere Aktualisierung am Profil vor (z. B. Aktualisieren eines Zeitstempelfelds).
     • Dadurch wird die Streaming-Auswertung Trigger und das Profil zur Audience hinzugefügt.
     • Alternative: Verwenden Sie eine Batch- oder Edge-Zielgruppe für vorhandene Profile.