Aktions- und Medien-URLs mit Liquid personalisieren
Personalisieren Sie Linkziele und Inhalte für alle Nutzer:innen, die Ihre Nachricht erhalten, indem Sie Liquid-Variablen zu den URLs für Buttons, Links, Bilder und Videos hinzufügen.
Deeplinking zu In-App-Inhalten

Für Entwickler:innen: Einen Leitfaden zur Auswahl zwischen benutzerdefinierten Schemata, Universal Links und anderen Optionen – einschließlich der Frage, wann Sie eine AASA-Datei benötigen, welche App-Delegate-Methoden zu implementieren sind und wie Sie Probleme debuggen – finden Sie unter iOS-Deeplinking-Leitfaden und Fehlerbehebung bei Deeplinking.
Was ist Deeplinking?
Deeplinking ist eine Methode, um eine native App zu starten und ihr zusätzliche Informationen zu übergeben, damit sie eine bestimmte Aktion ausführt oder bestimmte Inhalte anzeigt.
Dies besteht aus drei Teilen:
- Identifizieren, welche App gestartet werden soll.
- Die App anweisen, welche Aktion ausgeführt werden soll.
- Der Aktion alle zusätzlichen Daten bereitstellen, die sie benötigt.
Deeplinks sind benutzerdefinierte URIs, die auf einen bestimmten Teil der App verweisen und alle drei dieser Teile enthalten. Der Schlüssel liegt in der Definition eines benutzerdefinierten Schemas. http: ist das Schema, mit dem fast jeder vertraut ist, aber Schemata können mit jedem Wort beginnen. Ein Schema muss mit einem Buchstaben beginnen, kann dann aber Buchstaben, Zahlen, Pluszeichen, Minuszeichen oder Punkte enthalten. Praktisch gesehen gibt es kein zentrales Register zur Vermeidung von Konflikten, daher ist es eine Best Practice, Ihren Domainnamen in das Schema aufzunehmen. Zum Beispiel ist twitter:// der iOS-URI zum Starten der mobilen App für X, ehemals Twitter.
Alles nach dem Doppelpunkt innerhalb eines Deeplinks ist Freitext. Es liegt an Ihnen, dessen Struktur und Interpretation zu definieren; eine gängige Konvention ist jedoch, ihn nach dem Vorbild von http:-URLs zu modellieren, einschließlich eines führenden // und Abfrageparametern (zum Beispiel ?foo=1&bar=2). Für das vorherige Beispiel würde twitter://user?screen_name=[id] verwendet, um ein bestimmtes Profil in der App zu starten.

Für Apps, die mit Wrapper-Frameworks erstellt wurden (zum Beispiel Flutter oder Cordova), bietet Braze keine Wrapper-spezifische Deeplinking-Unterstützung. Sie müssen Deeplinks auf den nativen iOS- und Android-Ebenen konfigurieren. Für Cordova siehe Deeplinking in Push-Benachrichtigungen.
UTM Tags und Kampagnen-Attribution
Was ist ein UTM Tag?
UTM (Urchin Traffic Manager) Tags ermöglichen es Ihnen, Kampagnen-Attributionsdetails direkt in Links einzubetten. UTM Tags werden von Google Analytics verwendet, um Kampagnen-Attributionsdaten zu erfassen, und können zum Tracking der folgenden Eigenschaften verwendet werden:
utm_source: Der Bezeichner für die Traffic-Quelle (zum Beispielmy_app)utm_medium: Das Kampagnenmedium (zum Beispielnewsfeed)utm_campaign: Der Bezeichner für die Kampagne (zum Beispielspring_2016_campaign)utm_term: Bezeichner für einen bezahlten Suchbegriff, der die Nutzer:innen zu Ihrer App oder Website geführt hat (zum Beispielpizza)utm_content: Ein Bezeichner für den spezifischen Link oder Inhalt, auf den die Nutzer:innen geklickt haben (zum Beispieltoplinkoderandroid_iam_button2)
UTM Tags können sowohl in reguläre HTTP-(Web-)Links als auch in Deeplinks eingebettet und über Google Analytics getrackt werden.
Berechnung von UTM Tags
Braze meldet Gesamtklicks für alle Links in einer Kampagne oder einem Canvas-Schritt, was auch Links ohne UTM Tags einschließen kann. Das bedeutet, dass Sie in Ihren Google-Analytics-Kampagnen-Tracking-Links möglicherweise ein anderes (oft niedrigeres) Ergebnis sehen als die Gesamtklicks, die in Ihrer Kampagnen-Performance oder im Berichts-Builder angezeigt werden.
UTM Tags mit Braze verwenden
Wenn Sie UTM Tags mit regulären HTTP-(Web-)Links verwenden möchten (zum Beispiel für die Kampagnen-Attribution Ihrer E-Mail-Kampagnen) und Ihre Organisation bereits Google Analytics nutzt, können Sie Googles URL-Builder verwenden, um UTM-Links zu generieren. Diese Links können wie jeder andere Link einfach in den Braze-Kampagnentext eingebettet werden.
Um UTM Tags in Deeplinks zu Ihrer App zu verwenden, muss Ihre App das entsprechende Google Analytics SDK integriert und korrekt konfiguriert haben, um Deeplinks zu verarbeiten. Wenden Sie sich an Ihre Entwickler:innen, wenn Sie sich diesbezüglich unsicher sind.
Nachdem das Analytics SDK integriert und konfiguriert ist, können UTM Tags mit Deeplinks in Braze-Kampagnen verwendet werden. Um UTM Tags für Ihre Kampagne einzurichten, fügen Sie die erforderlichen UTM Tags in die Ziel-URL oder die Deeplinks ein. Die folgenden Beispiele zeigen, wie UTM Tags in Push-Benachrichtigungen und In-App-Nachrichten verwendet werden.
Push-Öffnungen und In-App-Nachrichten-Klicks mit UTM Tags zuordnen
Um UTM Tags in Ihre Deeplinks für Push-Benachrichtigungen einzufügen, setzen Sie das Klickverhalten der Push-Nachricht auf einen Deeplink und geben Sie die Deeplink-Adresse mit den gewünschten UTM Tags wie folgt ein:
1
myapp://products/20-gift-card?utm_source=my_app&utm_medium=push&utm_campaign=spring2016giftcards&utm_content=ios_deeplink

Um UTM Tags in die Deeplinks Ihrer In-App-Nachrichten einzufügen, verwenden Sie Folgendes:
1
myapp://products/20-gift-card?utm_source=my_app&utm_medium=iam&utm_campaign=spring2021giftcards&utm_content=web_link

Liquid-Personalisierung in URLs verwenden
Sie können Ihre URL direkt im Braze-Composer dynamisch erstellen, sodass Sie dynamische UTM-Parameter zu Ihren URLs hinzufügen oder Nutzer:innen eindeutige Links senden können (z. B. um Nutzer:innen zu ihrem Warenkorb-Abbruch oder zu einem bestimmten Produkt weiterzuleiten, das wieder auf Lager ist).
Eine URL mit unterstützten Liquid-Personalisierungs-Tags erstellen
URLs können durch die Verwendung beliebiger unterstützter Liquid-Personalisierungs-Tags dynamisch generiert werden.
1
https://example.com/?campaign_utm={{campaign.${api_id}}}&user_attribute={{custom_attribute.${attribute1}}}
Wir unterstützen auch die Verkürzung von benutzerdefinierten Liquid-Variablen. Nachfolgend finden Sie einige Beispiele:
Eine URL mit Liquid-Variablen erstellen
1
2
{% assign url_var = {{event_properties.${url_slug}}} %}
https://example.com/{{url_var}}
Von Liquid-Variablen gerenderte URLs verkürzen
Unterstützte Kanäle: KakaoTalk, LINE, SMS, RCS, WhatsApp
Wir verkürzen URLs, die von Liquid gerendert werden, auch solche, die in API-Trigger-Eigenschaften enthalten sind. Wenn zum Beispiel {{api_trigger_properties.${url_value}}} eine gültige URL darstellt, verkürzen und tracken wir diese URL, bevor die Nachricht gesendet wird.
URLs im /messages/send-Endpunkt verkürzen
Die Linkverkürzung ist auch für reine API-Nachrichten über den /messages/send-Endpunkt aktiviert. Eine vollständige Liste der Anfrageparameter finden Sie unter Anfrageparameter.
| Parameter | Erforderlich | Datentyp | Beschreibung |
|---|---|---|---|
link_shortening_enabled |
Ja | Boolescher Wert | Setzen Sie link_shortening_enabled auf true, um die Linkverkürzung zu aktivieren. Um Tracking zu verwenden, müssen eine campaign_id und eine message_variation_id vorhanden sein. |