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.

Deeplink zu In-App-Inhalten

Tipp

Für Entwickler:innen: Eine Anleitung 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, eine native App zu starten und ihr zusätzliche Informationen bereitzustellen, die sie anweisen, eine bestimmte Aktion auszuführen oder bestimmte Inhalte anzuzeigen.

Dies besteht aus drei Teilen:

1. Identifizieren, welche App gestartet werden soll.
2. Die App anweisen, welche Aktion ausgeführt werden soll.
3. 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. Da es praktisch kein zentrales Register gibt, um Konflikte zu vermeiden, ist es eine Best Practice, Ihren Domain-Namen 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.

Wichtig

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.

System-URI-Schemata

Standard-URI-Schemata, die nativ von iOS und Android verarbeitet werden (wie tel:, mailto: und sms:), können direkt in das Deeplink-URL-Feld eingegeben werden, ohne dass eine benutzerdefinierte Deeplink-Integration in Ihrer App erforderlich ist.

Diese funktionieren für Push-Benachrichtigungs-Klickverhalten und In-App-Nachricht-Button-Aktionen. Es sind keine zusätzlichen SDK-Konfigurationen oder App-Code-Änderungen erforderlich.

UTM Tags und Campaign-Attribution

Was ist ein UTM Tag?

UTM (Urchin Traffic Manager) Tags ermöglichen es Ihnen, Campaign-Attribution-Details direkt in Links einzubinden. UTM Tags werden von Google Analytics verwendet, um Campaign-Attribution-Daten zu erfassen, und können zum Tracking der folgenden Eigenschaften verwendet werden:

• utm_source: Der Bezeichner für die Traffic-Quelle (zum Beispiel my_app)
• utm_medium: Das Campaign-Medium (zum Beispiel newsfeed)
• utm_campaign: Der Bezeichner für die Campaign (zum Beispiel spring_2016_campaign)
• utm_term: Bezeichner für einen bezahlten Suchbegriff, der Nutzer:innen zu Ihrer App oder Website geführt hat (zum Beispiel pizza)
• utm_content: Ein Bezeichner für den spezifischen Link oder Inhalt, auf den Nutzer:innen geklickt haben (zum Beispiel toplink oder android_iam_button2)

UTM Tags können sowohl in reguläre HTTP-(Web-)Links als auch in Deeplinks eingebettet und über Google Analytics getrackt werden.

UTM-Tag-Berechnungen

Braze meldet Gesamtklicks für alle Links in einer Campaign oder einem Canvas-Schritt, was auch Links ohne UTM Tags umfassen kann. Das bedeutet, dass Sie in Ihren Google-Analytics-Campaign-Tracking-Links möglicherweise ein anderes (oft niedrigeres) Ergebnis sehen als die in Ihrer Campaign-Performance oder im Berichts-Builder angezeigten Gesamtklicks.

UTM Tags mit Braze verwenden

Wenn Sie UTM Tags mit regulären HTTP-(Web-)Links verwenden möchten (zum Beispiel für Campaign-Attribution Ihrer E-Mail-Campaigns) 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 in den Braze-Campaign-Text eingebettet werden.

Um UTM Tags in Deeplinks zu Ihrer App zu verwenden, muss Ihre App das entsprechende Google Analytics SDK integriert und korrekt für die Verarbeitung von Deeplinks konfiguriert haben. 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-Campaigns verwendet werden. Um UTM Tags für Ihre Campaign 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-Nachricht-Klicks mit UTM Tags zuordnen

• push-öffnungen
• in-app-nachricht-klicks

1
myapp://products/20-gift-card?utm_source=my_app&utm_medium=push&utm_campaign=spring2016giftcards&utm_content=ios_deeplink

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, um dynamische UTM-Parameter zu Ihren URLs hinzuzufügen oder Nutzer:innen eindeutige Links zu senden (z. B. um Nutzer:innen zu ihrem abgebrochenen Warenkorb 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 Kürzung benutzerdefinierter Liquid-Variablen, wie in den folgenden Beispielen:

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 kürzen

Unterstützte Kanäle: KakaoTalk, LINE, SMS, RCS, WhatsApp

Wir kürzen URLs, die von Liquid gerendert werden, einschließlich solcher, die in API-Trigger-Eigenschaften enthalten sind. Wenn beispielsweise {{api_trigger_properties.${url_value}}} eine gültige URL darstellt, kürzen und tracken wir diese URL, bevor die Nachricht gesendet wird.

URLs im /messages/send-Endpunkt kürzen

Die Linkkürzung ist auch für reine API-Nachrichten über den /messages/send-Endpunkt aktiviert. Eine vollständige Liste der Anfrageparameter finden Sie unter Anfrageparameter.