Skip to content

OtherLevels

Die OtherLevels Experience Platform nutzt GenAI, um die Art und Weise zu verändern, wie Sportmarken, Verlage und Betreiber mit ihren Kund:innen in Kontakt treten, indem sie traditionelle Inhalte in markengerechte, personalisierte Video- und Rich-Media-Erlebnisse in großem Umfang umwandelt.

Diese Integration wird von OtherLevels gepflegt.

Übersicht

Die Integration von Braze und OtherLevels ermöglicht es Ihnen, angepasste GenAI-Videos über API-Aufrufe an die OtherLevels Experience Platform zu erstellen und diese Videos dann als iOS-Push-Videos über Braze Connected-Content an Ihre Nutzer:innen zu senden.

Bieten Sie Ihren Nutzer:innen ein besseres Erlebnis mit den KI-gestützten Erfahrungen von OtherLevels. Transformieren Sie vorhandene und Drittanbieter-Inhalte in hochskalierbare Videos und Rich Media für Zielgruppen, die Inhalte bereits anders konsumieren und stark auf kontextuell personalisierte Erlebnisse reagieren.

Voraussetzungen

Bevor Sie beginnen, benötigen Sie Folgendes:

Voraussetzung Beschreibung
Ein OtherLevels-Konto Um die Vorteile dieser Partnerschaft zu nutzen, ist ein OtherLevels-Konto erforderlich.
Ein Braze-REST-API-Schlüssel Ein Braze-REST-API-Schlüssel mit users.track-Berechtigungen.

Dieser kann im Braze-Dashboard unter Einstellungen > API-Schlüssel erstellt werden.
Ein Braze-REST-Endpunkt Ihre REST-Endpunkt-URL. Ihr Endpunkt hängt von der Braze-URL für Ihre Instanz ab.

Diese Integration erfordert den Aufruf der OtherLevels Experience Platform API als Teil des Video-Generierungsprozesses, bevor Nachrichten von Braze an Ihre Nutzer:innen gesendet werden können. cURL-Beispiele werden als Teil dieser Dokumentation bereitgestellt, wir empfehlen jedoch die Verwendung von API-Clients wie Postman, um die API-Aufrufe zu automatisieren.

Anwendungsfälle

Nutzen Sie GenAI-Videos, die mit der OtherLevels Experience Platform erstellt wurden, um:

  • Bessere Erlebnisse für Sporteigentümer:innen und Ligen, Fan-Engagement, Sportwetten, iGaming und Lotterien zu schaffen.
  • Ihr Kundenmarketing zu verstärken, indem Sie textbasierte Inhalte in Rich Media und Video transformieren und so menschliche und ansprechende Erlebnisse schaffen.
  • Ergebnisse von der Akquise bis zur Bindung zu verbessern, indem Sie Ihre bestehende Braze-Integration erweitern, statt sie umzurüsten.

Integration der OtherLevels Experience Platform

1. Schritt: Rufen Sie die OtherLevels Experience Platform API auf, um ein Video zu generieren

Der erste Schritt der Integration besteht darin, die OtherLevels Experience Platform API aufzurufen, um ein neues Video zu generieren. Beachten Sie, dass die Videogenerierung nicht sofort erfolgt. Je nach Länge und Komplexität des Videos kann die Erstellung der Inhalte bis zu einer halben Stunde dauern. Planen Sie Ihre Messaging-Zeitpläne und API-Aufrufe entsprechend, damit die API-Aufrufe zur Videogenerierung rechtzeitig vor dem geplanten Versand Ihrer Braze-Nachrichten erfolgen.

Das folgende Beispiel zeigt, wie Sie Ihren API-Aufruf strukturieren sollten. Weitere Informationen zum Anpassen der Video-Spezifikationen und zur Strukturierung Ihres API-Aufrufs finden Sie unter Anpassen des GenAI-Videos.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
curl --request POST \
  --url 'https://exp-platform-api.prod.awsotherlevels.com/v1/app/OTHERLEVELS_PROJECT_KEY/media?=' \
  --header 'Content-Type: application/json' \
  --header 'User-Agent: insomnia/10.3.0' \
  --data '{
    "task": {
        "type": "tasks",
        "tasks": {
            "image_video_overlay": {
                "width": "= .orientation == '\''portrait'\'' ? '\''1080'\'' : .orientation == '\''landscape'\'' ? '\''1920'\''",
                "height": "= .orientation == '\''portrait'\'' ? '\''1920'\'' : .orientation == '\''landscape'\'' ? '\''1080'\''",
                "color": "255,255,255,0",
                "y_pos": "0",
                "x_pos": "0",
                "image_input": "= tasks.resize_image.jpg ?? tasks.resize_image.png",
                "video_input": "= tasks.talking_talent_replace_bg.mp4",
                "type": "compose.ImageVideoOverlay"
            },
            "resize_image": {
                "media_input": "= tasks.bg_image.jpg ?? tasks.bg_image.png",
                "type": "compose.MediaResize",
                "width": "= .orientation == '\''portrait'\'' ? '\''1080'\'' : .orientation == '\''landscape'\'' ? '\''1920'\''",
                "height": "= .orientation == '\''portrait'\'' ? '\''1920'\'' : .orientation == '\''landscape'\'' ? '\''1080'\''"
            },
            "bg_image": {
                "type": "load",
                "url": "BACKGROUND_IMAGE_URL",
                "refresh_interval": "12h"
            },
            "talking_head": {
                "test": false,
                "title": "INSERT_TITLE",
                "caption": false,
                "templateId": "TALENT_TEMPLATE",
                "type": "TALENT_MODEL",
                "variables": {
                    "script": {
                        "name": "script",
                        "properties": {
                            "content": "= tasks.translate_text.text"
                        },
                        "type": "text"
                    }
                }
            },
            "translate_text": {
                "type": "translate_text",
                "source": "en",
                "target": "en",
                "text": "INSERT_SCRIPT"
            },
            "talking_talent_speed": {
                "type": "compose.VideoSetSpeed",
                "speed": "1.0",
                "video_input": "= tasks.talking_head.mp4"
            },
            "talking_talent_replace_bg": {
                "type": "compose.VideoReplaceBg",
                "video_background": "= tasks.resize_image.jpg ?? tasks.resize_image.png",
                "video_input": "= tasks.talking_talent_speed.mp4"
            }
        },
        "output": "image_video_overlay"
    }
}'

Ersetzen Sie Folgendes:

Platzhalter Beschreibung
OTHERLEVELS_PROJECT_KEY Ein OtherLevels-Projektschlüssel wird Ihnen bei der Einrichtung Ihres OtherLevels-Kontos bereitgestellt.
BACKGROUND_IMAGE_URL Eine HTTPS-URL für den Hintergrund des Videos.
INSERT_TITLE Der Titel des Videos – dies ist eine interne Referenz und wird im Video nicht angezeigt.
TALENT_TEMPLATE Eine Talent-Template-ID. OtherLevels wird bei der Kontoeinrichtung mit Ihnen zusammenarbeiten, um ein Talent (Avatar) zu erstellen. Sie erhalten eine oder mehrere Talent-IDs, die Sie verwenden können.
TALENT_MODEL Eine Talent-Model-ID. OtherLevels wird bei der Kontoeinrichtung mit Ihnen zusammenarbeiten, um ein Talent (Avatar) zu erstellen. Sie erhalten ein oder mehrere Talent-Modelle, die Sie verwenden können.
INSERT_SCRIPT Das genaue Skript, das das Talent während des Videos sprechen soll.

Als Teil der API-Antwort gibt OtherLevels eine JSON-Nutzlast zurück, die einen erfolgreichen API-Aufruf anzeigt. Die JSON-Datei enthält eine eindeutige recipe_id zur Identifizierung des generierten Videos. Die recipe_id wird im nächsten Schritt benötigt.

Hier ist eine Beispielantwort der API:

1
{"$schema":"https://exp-platform-api.prod.awsotherlevels.com/schemas/GenerateMediaResBody.json","message":"success","recipe_id":"LMINHWXV2BBD6JGV5VF3ZNZV7BDDRR7FH5FJH6MMX4BVLTPRKTWQ","media_short_id":"LMINHWX","status":"triggered"}

2. Schritt: Festlegen der recipe_id als angepasstes Attribut

Die recipe_id, die Sie in Schritt 1 erhalten haben, wird nun als angepasstes Braze-Attribut für die Nutzer:innen festgelegt, an die Sie die Videos senden möchten.

Je nach Anwendungsfall haben Sie möglicherweise ein einzelnes Video erstellt, das für eine große Zielgruppe bestimmt ist – in diesem Fall kann dieselbe recipe_id für mehrere Nutzer:innen festgelegt werden. Alternativ haben Sie möglicherweise mehrere eindeutige Videos erstellt, die jeweils auf unterschiedliche Nutzer:innen abzielen – in diesem Fall sollte für jede:n Nutzer:in die jeweilige recipe_id als angepasstes Braze-Attribut festgelegt werden.

1
2
3
4
5
6
7
8
9
10
11
curl --location --request POST 'BRAZE_API_ENDPOINT/users/track' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer BRAZE_API_KEY' \
--data-raw '{
  "attributes": [
    {
      "external_id": "USER_ID",
      "olxpmedia": "RECIPE_ID"
    }
  ]
}'

Ersetzen Sie Folgendes:

Platzhalter Beschreibung
BRAZE_API_ENDPOINT Die URL des Braze-REST-Endpunkts Ihrer aktuellen Braze-Instanz. Weitere Informationen finden Sie unter REST-API-Schlüssel.
BRAZE_API_KEY Ihr Braze-REST-API-Schlüssel mit der Berechtigung users.track.
USER_ID Die Nutzer-ID der Person, die dieses Video erhalten soll. Weitere Beispiele für verwendbare Bezeichner finden Sie unter /users/track.
RECIPE_ID Die recipe_id, die Sie aus der OtherLevels-API-Antwort in Schritt 1 erhalten haben.

3. Schritt: Versand über Braze Connected-Content

Um die GenAI-Videos als iOS-Push-Nachrichten an Ihre Nutzer:innen zu senden, gehen Sie folgendermaßen vor:

  1. Erstellen Sie eine Braze-iOS-Push-Benachrichtigungs-Campaign.
  2. Gehen Sie bei der Erstellung Ihrer Campaign in den Bereich Assets und fügen Sie die folgende Connected-Content-Syntax in das Feld Add from URL ein.
1
{% connected_content https://exp-platform-api-external.prod.awsotherlevels.com/v1/app/OTHERLEVELS_PROJECT_KEY/media/{{custom_attribute.${olxpmedia}}} %}

Ersetzen Sie anschließend OTHERLEVELS_PROJECT_KEY durch den von OtherLevels bereitgestellten Projektschlüssel.

  1. Wählen Sie im Dropdown-Menü für URL file format die Option MP4 aus.
  2. Konfigurieren Sie den Rest der Campaign (z. B. Nachrichteninhalt, Versandzeitplan und Zielgruppe) nach Ihren Wünschen.

Beispiel für Asset-Felder bei Connected-Content.

Anpassen des GenAI-Videos

Videogröße und Attribute

Der Video-Hintergrund kann über den Schlüssel bg_image festgelegt werden.

Parameter Beschreibung
url HTTPS-URL für das Hintergrundbild.

Die Größe des Video-Hintergrunds kann über den Schlüssel resize_image festgelegt werden. Wir empfehlen, dass das Hintergrundbild dieselbe Größe hat wie die hier konfigurierte.

Parameter Beschreibung
width Breite des Hintergrundbildes, mit Optionen für Hoch- und Querformat.
height Höhe des Hintergrundbildes, mit Optionen für Hoch- und Querformat.

Video-Overlay-Optionen können über den Schlüssel image_video_overlay festgelegt werden.

Parameter Beschreibung
width Breite des Overlays, mit Optionen für Hoch- und Querformat.
height Höhe des Overlays, mit Optionen für Hoch- und Querformat.
color Farbe des Overlays, angegeben in RGB zusammen mit dem Transparenzwert.
y_pos Y-Achsen-Versatz vom Zentrum.
x_pos X-Achsen-Versatz vom Zentrum.

Talent und Skript

Im Rahmen der Bereitstellung wird OtherLevels mit Ihnen zusammenarbeiten, um ein oder mehrere Talente (manchmal auch als Avatare bezeichnet) für die Verwendung in Ihren Videos zu erstellen. Je nach Anwendungsfall und Marke kann dies in Form eines Ihrer bestehenden Markenbotschafter:innen oder einer einzigartigen Kreation erfolgen.

Nachdem diese erstellt wurden, erhalten Sie verwendbare TALENT_TEMPLATE- und TALENT_MODEL-IDs zur Nutzung mit unserer API.

Das Sprachmodell, das zur Verarbeitung von Eingabeskripten verwendet wird, funktioniert am besten mit einem natürlichen Skript, das ein Mensch vorlesen würde. In den meisten Fällen benötigen Sie keine zusätzliche Interpunktion, um das Skript manuell zu steuern. Wir empfehlen jedoch, alle Ihre Skripte zu testen, bevor Sie sie an eine echte Zielgruppe senden. Die Geschwindigkeit, mit der das Talent das Skript liest, kann über den Schlüssel talking_talent_speed festgelegt werden.

Parameter Beschreibung
speed Legen Sie die Geschwindigkeit fest, mit der das Talent das Skript lesen soll. Zum Beispiel: 1.5.

Zusätzliche Hinweise

  • Nur die iOS-Push-Benachrichtigungsplattform unterstützt nativ Videomedien. Android-Push-Benachrichtigungen unterstützen nativ keine Videos, daher kann diese Integration nur für Ihre iOS-Zielgruppe verwendet werden.
  • Beim Empfang von Video-Push-Benachrichtigungen auf iOS-Geräten müssen Nutzer:innen die Push-Benachrichtigung gedrückt halten, damit das Video geladen und abgespielt wird. Dies ist ein Standardverhalten auf der iOS-Plattform und kann nicht angepasst werden.
New Stuff!