DokumentationJourney OptimizerHandbuch für Journey Optimizer

Erstellen einer Live-Aktivität create-mobile-live

Letzte Aktualisierung: 20. August 2026

Erstellt für:

  • {"id":"e8ccd51f-da0d-4e3b-939b-e30d5ebb1ea5"}
  • {"id":"b69b2659-1057-424e-8fc5-ed9e016dc554"}

Auf dieser Seite: Erstellen Sie eine durch API ausgelöste Kampagne in Journey Optimizer, damit Sie Live-Aktivitäten für einzelne Benutzende oder Zielgruppen remote starten, aktualisieren und beenden können.

style
shade-box

Nachdem Sie Ihre Mobile-Konfiguration konfiguriert und Ihr Adobe Experience Platform Mobile SDK implementiert haben, können Sie mit der Erstellung Ihrer Live-Aktivität in Journey Optimizer beginnen:

  1. Rufen Sie das Menü Kampagnen auf und klicken Sie auf Kampagne erstellen.

  2. Wählen Sie den Kampagnentyp Durch API ausgelöst aus.

    • Wählen Sie API-ausgelöst (Marketing) für zielgruppenbasierte Kampagnen aus.

    • Wählen Sie API-ausgelöst (Transaktion) für einzelne Kampagnen aus.

    note important
    IMPORTANT
    Beachten Sie, dass für API-ausgelöst (Transaktion) die Option Hoher Durchsatz nicht aktiviert werden sollte.

  3. Bearbeiten Sie im Bereich Eigenschaften den Titel und die Beschreibung Ihrer Kampagne.

  4. Wählen Sie im Abschnitt Aktionen die Option Live-Aktivität und eine Konfiguration aus oder erstellen Sie eine neue Konfiguration.

    Weitere Informationen zur Konfiguration von Live-Aktivitäten finden Sie auf dieser Seite.

  5. Klicken Sie auf Experiment erstellen, um mit der Konfiguration Ihres Inhaltsexperiments zu beginnen und Abwandlungen zu erstellen, deren Performance zu messen und die beste Option für Ihre Zielgruppe zu ermitteln. Weitere Informationen

  6. Wählen Sie auf der Registerkarte Zielgruppe Ihren Identitätstyp aus. Weitere Informationen.

    note
    NOTE
    Bei durch API ausgelösten Marketing-Kampagnen können Sie eine vorhandene Zielgruppe auswählen, die als erste Segmentierung fungiert, bevor Sie das APNs-channelID-Abonnement über die API-Payload überprüfen.

  7. Kampagnen sind so konzipiert, dass sie an einem bestimmten Datum oder in regelmäßigen Abständen ausgeführt werden. Erfahren Sie in diesem Abschnitt, wie Sie den Zeitplan der Kampagne konfigurieren können.

  8. Klicken Sie nach der Konfiguration auf Zum Aktivieren überprüfen und dann auf Aktivieren.

  9. Verwenden Sie nach dem Aktivieren der Kampagne die bereitgestellte cURL-Anfrage als Vorlage, um Start-, Aktualisierungs- und Endereignisse für Live-Aktivitäten auszulösen. Aktualisieren Sie die Beispiel-Payload vor der Ausführung mit Ihren konkreten Daten.

    Stellen Sie sicher, dass Sie auch die Kampagnen-ID-Kennungen kopieren, die in Ihre Payload aufgenommen werden sollen.

    ➡️ Informationen zu Authentifizierungspflichten, einschließlich OAuth-Token und API-Schlüsseln, finden Sie der Dokumentation zu durch API ausgelösten Kampagnen.

    accordion
    Beispiel einer Payload für unitäre Anwendungsfälle (durch API ausgelöste Transaktionskampagne)

    Dieses Payload-Beispiel ist für einzelne Kampagnen mit dem Kampagnentyp API-ausgelöst – Transaktion vorgesehen. Beachten Sie, dass die meisten Felder aus dem folgenden Payload-Beispiel obligatorisch sind. Nur requestId, dismissal-date und alert sind optional.

    code language-json 
    {
    "requestId": "your-request-id",
    "campaignId": "your-campaign-id",
    "recipients": [
{
    "type": "aep",
    "userId": "testemail@gmail.com",
    "namespace": "email",
    "context": {
     "requestPayload": {
    "aps": {
    "content-available": 1,
    "timestamp": 1756984054,              // current epoch time
    "dismissal-date": 1756984084,         // optional – auto remove when event="end"
    "event": "update",                    // start | update | end

    // Fields from FoodDeliveryLiveActivityAttributes
    "content-state": {
      "orderStatus": "Delivered"
    },

    "attributes-type": "FoodDeliveryLiveActivityAttributes",
    "attributes": {
      "restaurantName": "Pizza",
      "liveActivityData": {
        "liveActivityID": "orderId1"       // customer reference ID
      }
    },

    "alert": {
      "title": "Order Delivered!",
      "body": "Your pizza has arrived."
    }
  }
}
}
}
]
}
    accordion
    Beispiel einer Payload für Broadcast-Anwendungsfälle (durch API ausgelöste Marketing-Kampagne)

    Dieses Payload-Beispiel ist für zielgruppenbasierte Kampagnen vorgesehen, bei denen der Kampagnentyp API-ausgelöst – Marketing verwendet wird.

    code language-json 
    {
    "requestId": "123400000",
    "campaignId": "d32e6f6c-56df-4a98-a2c0-6db6008f8f32",
    "audience": {
        "id": "508f9416-52d0-4898-ba47-08baaa22e9c7"
    },
    "context": {
        "requestPayload": {
            "aps": {
                "input-push-channel": "V+8UslywEfAAAOq9SbTrLg==",  //apns-channel-id
                "content-available": 1,
                "timestamp": 1770808339,
                "event": "update",   // start | update | end

                // Fields from GameScoreLiveActivityAttributes
                "content-state": {
                    "homeTeamScore": 33,
                    "awayTeamScore": 49,
                    "statusText": "Wingdom keeps scoring!"
                },
                "attributes-type": "GameScoreLiveActivityAttributes",
                "attributes": {
                    "liveActivityData": {
                        "channelID": "V+8UslywEfAAAOq9SbTrLg=="   //apns-channel-id, must match the "input-push-channel" value
                    }
                },
                "alert": {
                    "title": "This is the title for game",
                    "body": "This is the body for body"
                }
            }
        }
    }
}

Nachdem Sie Ihre Live-Aktivität entworfen haben, können Sie mit integrierten Berichten die Wirkung Ihrer Live-Aktivität messen.

TIP
Wenn Ihre Live-Aktivität nicht erwartungsgemäß angezeigt oder aktualisiert wird, finden Sie unter Fehlerbehebung bei Live-Aktivitäten eine schrittweise Debugging-Anleitung.

Hinzufügen benutzerdefinierter Daten mit Ausführungsmetadaten metadata

AVAILABILITY
executionMetadata ist sowohl für API-ausgelöste- als auch für API-ausgelöste Marketing Kampagnen verfügbar.

Fügen Sie mithilfe optionalen Felds executionMetadata Ihre eigenen benutzerdefinierten Daten“ an ein Profil an, z. B. eine Bestell-ID, eine Treuestufe oder einen Regionscode. Journey Optimizer speichert diese Daten zusammen mit der Ausführung, damit Sie sie später aus Ihrem Live-Aktivitäts-Feedback-Datensatz abrufen und die Versandergebnisse mit Ihren eigenen Geschäftsdatensätzen abgleichen können.
So fügen Sie benutzerdefinierte Daten mit Ausführungsmetadaten hinzu:

  • Fügen Sie executionMetadata zu einem Profil hinzu, neben userId und namespace. Es werden nur Zeichenfolgenschlüssel und Zeichenfolgenwerte akzeptiert. Konvertieren Sie alle Werte, die keine Zeichenfolgen sind, in eine Zeichenfolge, bevor Sie sie senden.

  • Werte werden genau so aufgezeichnet, wie gesendet. executionMetadata unterstützt keine Personalisierungsausdrücke, sodass jeder {{...}}-Ausdruck als literaler Text behandelt wird, anstatt ihn aufzulösen. Sie sollten immer endgültige, literale Werte senden.

  • Jedes Profil kann bis zu 50 Schlüssel/Wert-Paare, mit einer kombinierten Größenbeschränkung von 2 KB für alle Schlüssel und Werte. Metadaten, die dieses Limit überschreiten, werden verworfen, die Live-Aktivität wird jedoch weiterhin bereitgestellt. Payload auf die für Reporting-Zwecke erforderlichen Informationen beschränken.

JSON-Beispiel

In diesem Beispiel sind orderId, tier, restaurant und region Ihre eigenen Werte. Nachdem die Live-Aktivität ausgelöst wurde, können Sie sie aus dem Feedback-Datensatz zurücklesen, um den Versand mit Ihrem Bestelldatensatz zu verknüpfen.

code language-json 
{
    "requestId": "your-request-id",
    "campaignId": "your-campaign-id",
    "recipients": [
        {
            "type": "aep",
            "userId": "testemail@gmail.com",
            "namespace": "email",
            "executionMetadata": {
                "orderId": "A-123",
                "tier": "gold",
                "restaurant": "PizzaPlace",
                "region": "EU"
            },
            "context": {
                "requestPayload": {
                    "aps": {
                        "content-available": 1,
                        "timestamp": 1756984054,
                        "dismissal-date": 1756984084,
                        "event": "update",
                        "content-state": {
                            "orderStatus": "Delivered"
                        },
                        "attributes-type": "FoodDeliveryLiveActivityAttributes",
                        "attributes": {
                            "restaurantName": "PizzaPlace",
                            "liveActivityData": {
                                "liveActivityID": "orderId1"
                            }
                        },
                        "alert": {
                            "title": "Order Delivered!",
                            "body": "Your pizza has arrived."
                        }
                    }
                }
            }
        }
    ]
}

Nachdem Sie Ihre Live-Aktivität entworfen haben, können Sie mit integrierten Berichten die Wirkung Ihrer Live-Aktivität messen.

Anleitungsvideo

Erfahren Sie, wie Sie iOS-Live-Aktivitäten mit Adobe Journey Optimizer konfigurieren, um umfangreiche Echtzeit-Updates auf dem iPhone-Sperrbildschirm und auf Dynamic Island bereitzustellen.

https://video.tv.adobe.com/v/3479873?captions=ger&learn=on
recommendation-more-help
journey-optimizer-help