Angebote mit Entscheidungs-Management erstellen und anzeigen
Erfahren Sie, wie Sie Angebote aus dem Journey Optimizer Entscheidungs-Management in Ihren Mobile Apps mit Experience Platform Mobile SDK anzeigen.
Mit dem Journey Optimizer Entscheidungs-Management können Sie Ihren Kunden über alle Touchpoints hinweg zur richtigen Zeit das beste Angebot und Erlebnis bieten. Nach der Erstellung können Sie personalisierte Angebote an Ihre Audience senden.
Entscheidungs-Management erleichtert die Personalisierung durch eine zentrale Bibliothek mit Marketing-Angeboten und eine Entscheidungs-Engine, die Regeln und Einschränkungen auf die von Adobe Experience Platform erstellten Echtzeitprofile anwendet. Dadurch können Sie Ihren Kunden das richtige Angebot zum richtigen Zeitpunkt senden. Weitere Informationen Sie unterÜber das Entscheidungs-Management“.
Voraussetzungen
- App mit installierten und konfigurierten SDKs erfolgreich erstellt und ausgeführt.
- Richten Sie die App für Adobe Experience Platform ein.
- Zugriff auf Journey Optimizer - Entscheidungs-Management mit den entsprechenden Berechtigungen zum Verwalten von Angeboten und Entscheidungen, wie beschrieben.
Lernziele
In dieser Lektion werden Sie
- Aktualisieren Sie Ihre Edge-Konfiguration für das Entscheidungs-Management.
- Aktualisieren Sie Ihre Tag-Eigenschaft mit der Journey Optimizer - Decisioning-Erweiterung.
- Schema zur Erfassung von Vorschlagsereignissen aktualisieren
- Überprüfen Sie das Setup in Assurance.
- Erstellen einer Angebotsentscheidung basierend auf Angeboten in Journey Optimizer - Entscheidungs-Management.
- Aktualisieren Sie Ihre App, um die Optimizer-Erweiterung zu registrieren.
- Implementieren Sie Angebote aus dem Entscheidungs-Management in Ihrer App.
Einrichten
Aktualisieren der Datenstromkonfiguration
Um sicherzustellen, dass Daten, die von Ihrer Mobile App an Platform Edge Network gesendet werden, an Journey Optimizer - Entscheidungs-Management weitergeleitet werden, aktualisieren Sie Ihren Datenstrom.
-
Wählen Sie in der Datenerfassungs-Benutzeroberfläche Datenströme und wählen Sie Ihren Datenstrom aus, z. B. Luma Mobile App.
-
Experience Platform Wählen Sie
-
Stellen Sie sicher dass im Bildschirm Datenströme
-
Um Ihre Datenstromkonfiguration zu speichern, wählen Sie Speichern aus.
Installieren der Erweiterung "Journey Optimizer - Decisioning Tags“
-
Navigieren Sie zu Tags, suchen Sie die Eigenschaft für mobile Tags und öffnen Sie sie.
-
Wählen Sie Erweiterungen aus.
-
Wählen Sie Katalog aus.
-
Suchen Sie nach der Erweiterung Adobe Journey Optimizer - Decisioning.
-
Installieren Sie die Erweiterung . Die Erweiterung erfordert keine zusätzliche Konfiguration.
Schema aktualisieren
- Navigieren Sie zur Datenerfassungs-Oberfläche und wählen Sie Schemata in der linken Leiste aus.
- Wählen Durchsuchen in der oberen Leiste aus.
- Wählen Sie Ihr Schema aus, um es zu öffnen.
- Wählen Sie im Schema-Editor
- Suchen Sie im Feldergruppen hinzufügen-Dialogfeld nach
proposition
Erlebnisereignis - Vorschlagsinteraktionen und dann Feldergruppen hinzufügen. Diese Feldergruppe erfasst die für Angebote relevanten Erlebnisereignisdaten: welches Angebot wird als Teil der Sammlung, Entscheidung und anderer Parameter angezeigt (siehe weiter unten in dieser Lektion). Aber auch was passiert mit dem Angebot? Wird sie angezeigt, mit ihr interagiert, abgelehnt usw.
- Klicken Sie Speichern, um die Änderungen an Ihrem Schema zu speichern.
Überprüfen des Setups in Assurance
So validieren Sie das Setup in Assurance:
- Navigieren Sie zur Assurance-Benutzeroberfläche.
- Wählen Sie Konfigurieren in der linken Leiste und wählen Sie
- Wählen Sie Speichern aus.
- Wählen in der Leiste Setup validieren aus. Sowohl die Datenstromeinrichtung als auch die SDK-Einrichtung in Ihrem Programm werden validiert.
Platzierung erstellen
Bevor Sie tatsächlich Angebote erstellen können, müssen Sie definieren, wie und wo diese Angebote in der Mobile App platziert werden können. Im Entscheidungs-Management definieren Sie zu diesem Zweck Platzierungen und eine Platzierung für den mobilen Kanal, der eine JSON-Payload unterstützt:
-
Wählen Sie in der Benutzeroberfläche von Journey Optimizer
-
Wählen Platzierungen in der oberen Leiste aus.
-
Wenn keine Platzierung mit dem Namen Mobile JSON, Mobile als Kanaltyp und JSON als Inhaltstyp aufgeführt ist, müssen Sie eine Platzierung erstellen. Fahren Sie andernfalls mit Angebote erstellen fort.
So erstellen Sie die mobile JSON-Platzierung:
-
Wählen Sie
- Geben Sie im Abschnitt Details den
Mobile JSON
als Name ein, wählen Sie Mobile aus Kanaltyp und JSON aus Content-Typ. - Wählen Speichern, um die Platzierung zu speichern.
- Geben Sie im Abschnitt Details den
Angebote erstellen
-
Wählen Sie in der Benutzeroberfläche von Journey Optimizer
-
Wählen Sie auf dem Angebote die Option Durchsuchen, um die Liste der Angebote anzuzeigen.
-
Wählen Sie Angebot erstellen aus.
-
Wählen Sie im Neues Angebot die Option Personalisiertes Angebot und klicken Sie auf Weiter.
-
Im Schritt Details von Neues personalisiertes Angebot erstellen:
-
Geben Sie einen Namen für das Angebot ein, z. B.
Luma - Juno Jacket
, und geben Sie ein Startdatum und -zeit und ein Enddatum und -zeit ein. Außerhalb dieses Datumsbereichs wird das Angebot nicht von der Entscheidungs-Engine ausgewählt. -
Klicken Sie auf Weiter.
-
-
Im Schritt Darstellungen hinzufügen von Neues personalisiertes Angebot erstellen:
-
Wählen Sie
-
Wählen Sie Benutzerdefiniert für Inhalt aus.
-
Wählen Sie Inhalt hinzufügen aus. Im Dialogfeld Personalisierung hinzufügen:
-
Ist ein Modus-Selektor verfügbar, stellen Sie sicher, dass er auf "".
-
Geben Sie die folgende JSON ein:
code language-json { "title": "Juno Jacket", "text": "On colder-than-comfortable mornings, you'll love warming up in the Juno All-Ways Performance Jacket, designed to compete with wind and chill. Built-in Cocona™ technology aids evaporation, while a special zip placket and stand-up collar keep your neck protected.", "image": "https://luma.enablementadobe.com/content/dam/luma/en/products/women/tops/jackets/wj06-purple_main.jpg" }
-
Wählen Sie Speichern aus.
-
-
Klicken Sie auf Weiter.
-
-
Im Schritt Einschränkungen hinzufügen des Neues personalisiertes Angebot erstellen:
-
Legen Priorität auf
10
fest. -
Schalten Sie Begrenzung einschließen aus.
-
Klicken Sie auf Weiter.
-
-
Im Schritt Überprüfen von Neues personalisiertes erstellen:
- Überprüfen Sie das Angebot und wählen Sie dann Beenden aus.
- Wählen Sie im Angebot speichern die Option Speichern und genehmigen aus.
-
Wiederholen Sie die Schritte 3 bis 8, um vier weitere Angebote mit unterschiedlichen Namen und Inhalten zu erstellen. Alle anderen Konfigurationswerte, z. B. Startdatum und -zeit oder Priorität, ähneln dem ersten von Ihnen erstellten Angebot. Sie können Angebote schnell duplizieren und bearbeiten.
-
Wählen Sie in der Journey Optimizer
-
Wählen Sie die Zeile des erstellten Angebots aus.
-
Wählen Sie im rechten Bereich
Definieren Sie anhand der folgenden Tabelle die vier anderen Angebote.
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 layout-fixed Name des Angebots Angebotsinhalte in JSON Luma - Flasche Wasser bestätigen { "title": "Affirm Water Bottle", "text": "You'll stay hydrated with ease with the Affirm Water Bottle by your side or in hand. Measurements on the outside help you keep track of how much you're drinking, while the screw-top lid prevents spills. A metal carabiner clip allows you to attach it to the outside of a backpack or bag for easy access.", "image": "https://luma.enablementadobe.com/content/dam/luma/en/products/gear/fitness-equipment/ug06-lb-0.jpg" }
Luma - Desiree Fitness-T-Shirt { "title": "Desiree Fitness Tee", "text": "When you're too far to turn back, thank yourself for choosing the Desiree Fitness Tee. Its ultra-lightweight, ultra-breathable fabric wicks sweat away from your body and helps keeps you cool for the distance.", "image": "https://luma.enablementadobe.com/content/dam/luma/en/products/women/tops/tees/ws05-yellow_main.jpg" }
Luma - Adrienne Trek Jacke { "title": "Adrienne Trek Jacket", "text": "You're ready for a cross-country jog or a coffee on the patio in the Adrienne Trek Jacket. Its style is unique with stand collar and drawstrings, and it fits like a jacket should.", "image": "https://luma.enablementadobe.com/content/dam/luma/en/products/women/tops/jackets/wj08-gray_main.jpg" }
Luma - Aero Daily Fitness-T-Shirt { "title": "Aero Daily Fitness Tee", "text": "Need an everyday action tee that helps keep you dry? The Aero Daily Fitness Tee is made of 100% polyester wicking knit that funnels moisture away from your skin. Don't be fooled by its classic style; this tee hides premium performance technology beneath its unassuming look.", "image": "https://luma.enablementadobe.com/content/dam/luma/en/products/men/tops/tees/ms01-black_main.jpg" }
-
-
Als letzten Schritt müssen Sie ein Fallback-Angebot erstellen, bei dem es sich um ein Angebot handelt, das an Kunden gesendet wird, wenn sie für andere Angebote nicht infrage kommen.
-
Wählen Sie Angebot erstellen aus.
-
Wählen Sie Dialogfeld Neues Angebot“ Personalisiertes Angebot und klicken Sie auf Weiter.
-
Geben Sie im Details von Neues Fallback-Angebot erstellen einen Namen für das Angebot ein, z. B.
Luma - Fallback Offer
, und wählen Sie Weiter. -
Im Schritt Darstellungen hinzufügen von Neues Fallback-Angebot erstellen:
-
Wählen Sie
-
Wählen Sie Benutzerdefiniert für Inhalt aus.
-
Wählen Sie Inhalt hinzufügen aus.
-
Geben Sie im Dialogfeld Personalisierung hinzufügen die folgende JSON ein und wählen Sie Speichern:
code language-json { "title": "Luma", "text": "Your store for sports wear and equipment.", "image": "https://luma.enablementadobe.com/content/dam/luma/en/logos/Luma_Logo.png" }
-
Klicken Sie auf Weiter.
-
-
-
Im Schritt Überprüfen von Neues Fallback erstellen Angebot:
- Überprüfen Sie das Angebot und wählen Sie dann Beenden aus.
- Wählen Sie im Angebot speichern die Option Speichern und genehmigen aus.
Sie sollten jetzt über die folgende Liste von Angeboten verfügen:
Erstellen einer Sammlung
Um Ihrem Mobile-App-Benutzer ein Angebot zu unterbreiten, müssen Sie eine Angebotssammlung definieren, die aus einem oder mehreren der von Ihnen erstellten Angebote besteht.
-
Wählen Sie in der Journey Optimizer-Benutzeroberfläche Angebote in der linken Leiste aus.
-
Wählen Sammlungen in der oberen Leiste aus.
-
Wählen Sie
-
Geben Sie im Dialogfeld Neue Sammlung einen Namen für Ihre Sammlung ein, z. B.
Luma - Mobile App Collection
, wählen Sie Statische Sammlung erstellen und klicken Sie auf Weiter. -
Wählen Sie Luma - Mobile App Collection die Angebote aus, die Sie in die Sammlung aufnehmen möchten. Wählen Sie für dieses Tutorial die fünf von Ihnen erstellten Angebote aus. Sie können die Liste einfach mithilfe des Suchfelds filtern, indem Sie z. B. Luma eingeben.
-
Wählen Sie Speichern aus.
Eine Entscheidung erstellen
Der letzte Schritt besteht darin, eine Entscheidung zu definieren, bei der es sich um die Kombination aus einem oder mehreren Entscheidungsumfängen und Ihrem Fallback-Angebot handelt.
Ein Entscheidungsumfang ist eine Kombination aus einer bestimmten Platzierung (z. B. HTML in einer E-Mail oder JSON in einer Mobile App) und einem oder mehreren Auswertungskriterien.
Ein Bewertungskriterium ist die Kombination aus
- eine Angebotssammlung,
- Eignungsregeln: Ist das Angebot beispielsweise nur für eine bestimmte Zielgruppe verfügbar,
- eine Ranking-Methode: Wenn mehrere Angebote zur Auswahl verfügbar sind, nach welcher Methode werden sie sortiert (z. B. nach Angebotspriorität, mithilfe einer Formel oder eines KI-Modells)?
Siehe Wichtige Schritte zum Erstellen und Verwalten von Angeboten, wenn Sie besser verstehen möchten, wie Platzierungen, Regeln, Rankings, Angebote, Darstellungen, Sammlungen, Entscheidungen usw. interagieren und miteinander in Beziehung stehen. Diese Lektion konzentriert sich ausschließlich auf die Verwendung der Ausgabe einer Entscheidung und nicht auf die Flexibilität bei der Definition von Entscheidungen innerhalb von Journey Optimizer - Entscheidungs-Management.
-
Wählen Sie in der Journey Optimizer-Benutzeroberfläche Angebote in der linken Leiste aus.
-
Wählen Sie Entscheidungen in der oberen Leiste aus.
-
Wählen Sie
-
Im Schritt Details von Neue Angebotsentscheidung erstellen:
- Geben Sie einen Namen für die Entscheidung ein, z. B.
Luma - Mobile App Decision
, geben Sie Startdatum und -zeit und Enddatum und -zeit ein. - Klicken Sie auf Weiter.
- Geben Sie einen Namen für die Entscheidung ein, z. B.
-
Im Entscheidungsumfänge hinzufügen von Neue Angebotsentscheidung erstellen:
-
Wählen Sie Mobile JSON in der Liste Platzierung aus.
-
Wählen in der Kachel Auswertungskriterien“
-
Wählen im Dialogfeld " hinzufügen“ Ihre Angebotssammlung aus. Beispiel: Luma - Mobile App Collection.
-
Wählen Sie Hinzufügen aus.
-
-
Stellen Sie sicher dass Keine“ für Eignung und Angebotspriorität als ausgewählt ist.
-
Klicken Sie auf Weiter.
-
-
Im Schritt Fallback-Angebot hinzufügen von Neue Angebotsentscheidung erstellen:
- Wählen Sie Ihr Fallback-Angebot aus, z. B. die Luma - Fallback offer.
- Klicken Sie auf Weiter.
-
Im Schritt Zusammenfassung von Neue Angebotsentscheidung erstellen:
- Wählen Sie Beenden aus.
- Wählen Sie im Angebotsentscheidung speichern die Option Speichern und aktivieren.
- Auf der Registerkarte Entscheidungen wird Ihre Entscheidung mit dem Status Live angezeigt.
Ihre Angebotsentscheidung, die aus einer Reihe von Angeboten besteht, ist jetzt einsatzbereit. Um die Entscheidung in Ihrer App zu verwenden, müssen Sie in Ihrem Code auf den Entscheidungsumfang verweisen.
-
Wählen Sie in der Journey Optimizer-Benutzeroberfläche Angebote.
-
Wählen Sie Entscheidungen in der oberen Leiste aus.
-
Wählen Sie Ihre Entscheidung aus, z. B. Luma - Mobile App Decision.
-
Wählen in der Kachel Entscheidungsumfänge“ die Option
-
Wählen Sie im Kontextmenü die Option Entscheidungsumfang aus.
-
Verwenden Sie einen beliebigen Texteditor, um den Entscheidungsumfang zur späteren Verwendung einzufügen. Der Entscheidungsumfang hat das folgende JSON-Format.
code language-json { "xdm:activityId":"xcore:offer-activity:xxxxxxxxxxxxxxx", "xdm:placementId":"xcore:offer-placement:xxxxxxxxxxxxxxx" }
Implementieren von Angeboten in Ihrer App
Wie in den vorherigen Lektionen erläutert, wird bei der Installation einer mobilen Tag-Erweiterung nur die Konfiguration bereitgestellt. Als Nächstes müssen Sie die Optimize SDK installieren und registrieren. Wenn diese Schritte nicht klar sind, lesen Sie den Abschnitt Installieren von SDKs.
-
Stellen Sie in Xcode sicher dass „AEP Optimize zur Liste der Pakete in den Paketabhängigkeiten hinzugefügt wird. Siehe Swift Package Manager.
-
Navigieren Sie im Xcode-Projekt Navigator zu Luma > Luma > AppDelegate.
-
Stellen Sie sicher, dass
AEPOptimize
Teil Ihrer Importliste ist.code language-swift import AEPOptimize
-
Stellen Sie sicher, dass
Optimize.self
Teil des Arrays von Erweiterungen ist, die Sie registrieren.code language-swift let extensions = [ AEPIdentity.Identity.self, Lifecycle.self, Signal.self, Edge.self, AEPEdgeIdentity.Identity.self, Consent.self, UserProfile.self, Places.self, Messaging.self, Optimize.self, Assurance.self ]
-
Navigieren Sie im Xcode-Projekt-Navigator zu Luma > Luma > Model > Data Entscheidungen. Aktualisieren Sie die
activityId
- undplacementId
mit den Details zum Entscheidungsumfang , die Sie aus der Journey Optimizer-Oberfläche kopiert haben. -
Navigieren Sie im Xcode-Projekt Navigator zu Luma > Luma > Utils > MobileSDK“. Suchen Sie die
func updatePropositionOD(ecid: String, activityId: String, placementId: String, itemCount: Int) async
. Fügen Sie den folgenden Code hinzu:code language-swift // set up the XDM dictionary, define decision scope and call update proposition API Task { let ecid = ["ECID" : ["id" : ecid, "primary" : true] as [String : Any]] let identityMap = ["identityMap" : ecid] let xdmData = ["xdm" : identityMap] let decisionScope = DecisionScope(activityId: activityId, placementId: placementId, itemCount: UInt(itemCount)) Optimize.clearCachedPropositions() Optimize.updatePropositions(for: [decisionScope], withXdm: xdmData) }
Diese Funktion:
-
richtet eine XDM-
xdmData
ein, die die ECID enthält, um das Profil zu identifizieren, für das Sie Angebote unterbreiten müssen. -
definiert
decisionScope
, ein Objekt, das auf der von Ihnen in der Benutzeroberfläche von Journey Optimizer - Entscheidungs-Management definierten Entscheidung basiert und mithilfe des kopierten Entscheidungsumfangs aus Entscheidung erstellen“ definiert. Die Luma-App verwendet eine Konfigurationsdatei (decisions.json
), die die Bereichsparameter basierend auf dem folgenden JSON-Format abruft:code language-swift "scopes": [ { "name": "name of the scope", "activityId": "xcore:offer-activity:xxxxxxxxxxxxxxx", "placementId": "xcore:offer-placement:xxxxxxxxxxxxxxx", "itemCount": 2 } ]
Sie können jedoch jede Art von Implementierung verwenden, um sicherzustellen, dass die Optimieren-APIs die richtigen Parameter (
activityId
,placementId
unditemCount
) erhalten, um ein gültigesDecisionScope
für Ihre Implementierung zu erstellen.
Zu Ihrer Information: Die anderen Schlüsselwerte in derdecisions.json
-Datei sind für die zukünftige Verwendung vorgesehen und sind nicht relevant und werden derzeit in dieser Lektion und als Teil des Tutorials verwendet. -
ruft zwei APIs auf:
Optimize.clearCachePropositions
undOptimize.updatePropositions
. Diese Funktionen löschen alle zwischengespeicherten Vorschläge und aktualisieren die Vorschläge für dieses Profil.
-
-
Navigieren Sie im Xcode-Projekt-Navigator zu Luma > Luma > Views > {}Personalization> EdgeOffersView . Suchen Sie die Funktion
func onPropositionsUpdateOD(activityId: String, placementId: String, itemCount: Int) async
und überprüfen Sie den Code dieser Funktion. Der wichtigste Teil dieser Funktion ist derOptimize.onPropositionsUpdate
-API-Aufruf, der- ruft die Vorschläge für das aktuelle Profil basierend auf dem Entscheidungsumfang ab (den Sie unter Journey Optimizer - Entscheidungs-Management definiert haben),
- das Angebot aus dem Vorschlag abruft,
- den Inhalt des Angebots entpackt, damit es ordnungsgemäß in der App angezeigt werden kann, und
- Trigger : Die
displayed()
für das Angebot, die ein Ereignis zurück an das Edge Network sendet und darüber informiert, dass es angezeigt wird.
-
Fügen Sie in EdgeOffersView den folgenden Code zum Modifikator
.onFirstAppear
hinzu. Dieser Code stellt sicher, dass der Callback zum Aktualisieren der Angebote nur einmal registriert wird.code language-swift // Invoke callback for offer updates Task { await self.onPropositionsUpdateOD(activityId: decision.activityId, placementId: decision.placementId, itemCount: decision.itemCount) }
-
Fügen Sie EdgeOffersView noch den folgenden Code zum Modifikator
.task
hinzu. Dieser Code aktualisiert die Angebote, wenn die Ansicht aktualisiert wird.code language-swift // Clear and update offers await self.updatePropositionsOD(ecid: currentEcid, activityId: decision.activityId, placementId: decision.placementId, itemCount: decision.itemCount)
Validieren mit der App
-
Erstellen Sie die App neu und führen Sie sie im Simulator oder auf einem physischen Gerät aus Xcode mithilfe von
-
Navigieren Sie zur Registerkarte Personalisation.
-
Wählen Sie Edge Personalisation aus.
-
Scrollen Sie nach oben, und Sie sehen zwei zufällige Angebote aus der Sammlung, die Sie in der Kachel DECISION LUMA - MOBILE APP DECISION definiert haben.
Die Angebote sind zufällig, da Sie allen Angeboten dieselbe Priorität eingeräumt haben und die Rangfolge für die Entscheidung auf der Priorität basiert.
Implementierung in Assurance validieren
So validieren Sie die Angebotsimplementierung in Assurance:
-
Lesen Sie den Abschnitt Setup-Anweisungen, um Ihren Simulator oder Ihr Gerät mit Assurance zu verbinden.
-
Wählen Sie Konfigurieren in der linken Leiste und wählen Sie
-
Wählen Sie Speichern aus.
-
Wählen Überprüfen und) in der linken Leiste aus. Sowohl die Datenstromeinrichtung als auch die SDK-Einrichtung in Ihrer Anwendung werden validiert.
-
Wählen Anfragen in der oberen Leiste aus. Sie sehen Ihre Angebote Anfragen.
-
Sie können die Registerkarten Simulieren und Ereignisliste für weitere Funktionen durchsuchen und Ihre Einrichtung von Journey Optimizer Entscheidungs-Management überprüfen.
Nächste Schritte
Sie sollten jetzt über alle Tools verfügen, um Ihrer Implementierung von Journey Optimizer - Entscheidungs-Management mehr Funktionen hinzuzufügen. z. B.:
- Anwenden verschiedener Parameter auf Ihre Angebote (z. B. Priorität, Begrenzung)
- Erfassen Sie Profilattribute in der App (siehe Profile) und verwenden Sie diese Profilattribute, um Zielgruppen zu erstellen. Verwenden Sie diese Zielgruppen dann als Teil der Eignungsregeln in Ihrer Entscheidung.
- mehr als einen Entscheidungsumfang kombinieren.
Weiter: Durchführen von A/B-Tests