Skip to content

Braze-LernkursLink Aliasing

Verwenden Sie Link Aliasing, um erkennbare, selbst erstellte Namen zur Identifizierung von Links zu erstellen, die in E-Mail-Nachrichten von Braze gesendet werden. Diese Links stehen für Segmentierungs-Retargeting, aktionsbasiertes Triggern und Link-Analytics zur Verfügung.

Mit Link Aliasing können Sie selbst erstellte Namen erstellen, um Links zu identifizieren und zu verfolgen, die in E-Mails gesendet werden. So können Sie diese erkennbaren Link-Aliase effizient in Ihren E-Mails verwenden, um das Engagement zu verfolgen und die Campaign-Performance zu analysieren, ohne den vollständigen Link referenzieren zu müssen.

Mit Link Aliasing können Sie:

  • Nutzer:innen retargeten, die auf bestimmte Links geklickt haben: Identifizieren und targeten Sie Nutzer:innen, die auf einen Link geklickt haben.
  • Aktionsbasierte Trigger erstellen: Senden Sie eine E-Mail, wenn ein:e Nutzer:in auf einen Link klickt.
  • Metriken analysieren: Vergleichen Sie, wie viele Nutzer:innen auf Link A im Vergleich zu Link B geklickt haben.

Funktionsweise

Braze identifiziert Links innerhalb von E-Mails eindeutig, indem ein zusätzlicher Parameter namens lid (auch als Link-Bezeichner bekannt) an jede Link-URL angehängt wird. Dieser lid-Wert ermöglicht es Braze, Nutzerinteraktionen mit dem Link zu verfolgen, zu überwachen und zu aggregieren, auch wenn sich die übrigen URL-Parameter unterscheiden können. Dies hilft dabei, Insights darüber zu gewinnen, wie Nutzer:innen mit dem Inhalt Ihrer E-Mail-Campaigns interagieren.

Link-Bezeichner werden auch aktualisiert, wenn eine E-Mail-Campaign, ein Canvas mit einer E-Mail-Nachricht oder ein Content Block dupliziert wird.

Um einen Link-Alias zu erstellen, öffnen Sie Ihren E-Mail-Body in der Campaign oder Canvas-Komponente und öffnen Sie dann Link Management im Bereich Content. Der Drag-and-Drop- und der HTML-Composer verwenden dasselbe Seitenleisten-Layout:

Drag-and-Drop-Editor

  1. Wählen Sie Edit Email Body aus, um den Drag-and-Drop-Composer zu öffnen.
  2. Wählen Sie in der Composer-Seitenleiste Content aus (neben Sending Settings und Preview & Test). Weitere Informationen zu diesem Layout finden Sie unter Eine E-Mail mit Drag-and-Drop erstellen.
  3. Wählen Sie im Untermenü Content die Option Link Management aus (unter Design and Build). Wenn das Untermenü eingeklappt ist, erweitern Sie es mit dem Pfeil-Steuerelement in der Seitenleiste.

HTML-Editor

  1. Navigieren Sie zu Ihrem E-Mail-Body im Composer.
  2. Wählen Sie in der Composer-Seitenleiste Content aus.
  3. Wählen Sie im Untermenü Content die Option Link Management unter Design and Build aus.

In Link Management:

  1. Braze generiert automatisch eindeutige Standard-Link-Aliase für jeden Ihrer Links.
  2. Geben Sie dem Alias einen Namen. Aliase müssen pro E-Mail-Kampagnenvariante oder Canvas-Komponente eindeutig benannt sein.

Sie können auch einen Alias festlegen, der verwendet wird, um einen bestimmten Link beim Reporting oder bei der Segmentierung zu referenzieren.

Link-Management-Seite mit vier Link-Aliasen.

Um alle Ihre verfolgten Link-Aliase anzuzeigen, gehen Sie wie folgt vor:

  1. Gehen Sie zu Einstellungen > E-Mail-Präferenzen unter Workspace-Einstellungen.
  2. Wählen Sie den Tab Link Aliasing Settings aus.

Hier können Sie Link-Aliase sortieren, suchen und das Tracking deaktivieren.

Seite „Tracked Link Aliases“ mit aktiven und inaktiven Link-Aliasen, die verschiedenen Campaigns zugeordnet sind.

Braze empfiehlt, die Links innerhalb der E-Mail zu evaluieren, Link-Templates hinzuzufügen und eine Namenskonvention bereitzustellen, die für Segmentierungs- und Reporting-Zwecke geeignet ist. Dies hilft Ihnen, den Überblick über alle Links zu behalten.

Wenn Link Aliasing aktiviert ist, werden Nachrichten, Content Blocks und Link-Templates nicht verändert. Alle bestehenden Nachrichten, die Link-Templates oder Content Blocks verwenden, bleiben gleich. Wenn Sie jedoch eine Nachricht aktualisieren, wird das Link-Alias-Markup auf alle Links angewendet, sodass Sie die Link-Templates erneut anwenden müssen, damit die Links sichtbar sind.

Die folgenden Tabellen zeigen Beispiele für Links in einem E-Mail-Body, Link-Aliasing-Ergebnisse und Erklärungen dafür, wie der ursprüngliche Link mit Link Aliasing aktualisiert wird.

Logik: Braze fügt ein Fragezeichen (?) ein und fügt den ersten Query-Parameter in die URL ein.

Link im E-Mail-Body Link mit Aliasing
https://www.braze.com https://www.braze.com?lid=slfdldtqdhdk

Logik: Braze erkennt andere Query-Parameter und hängt lid= am Ende der URL an.

Link im E-Mail-Body Link mit Aliasing
https://www.braze.com?utm_campaign=retention&utm_source=email https://www.braze.com?utm_campaign=retention&utm_source=email&lid=0goty30mviyz

Logik: Braze erkennt, dass ein Link eine URL ist und bereits ein Fragezeichen (?) vorhanden ist, sodass der lid-Query-Parameter nach dem Fragezeichen angehängt wird.

Link im E-Mail-Body Link mit Aliasing
<a href="{{custom_attribute.{product_url}}}?"> <a href="{{custom_attribute.{product_url}}}?lid=ac7a548g5kl7">

Logik: Braze erwartet, dass die URL eine Standardstruktur verwendet, bei der Anker (#) nach einem Fragezeichen (?) stehen. Da Braze von links nach rechts liest, werden das Fragezeichen und der lid-Wert vor dem Anker angehängt.

Link im E-Mail-Body Link mit Aliasing
https://www.braze.com#bookmark1?utm_source=email https://www.braze.com?lid=eqslgd5a9m3y#bookmark1?utm_source=email

Logik: Bei der Verwendung von Link Aliasing mit URLs, die Anker (#) enthalten, erwartet Braze, dass der Anker nach den Query-Parametern platziert wird. Das bedeutet, dass der lid-Wert vor dem Anker angehängt werden muss, damit das Tracking korrekt funktioniert, und da Braze die URL von links nach rechts liest, sollten das Fragezeichen (?) und lid vor dem Anker stehen.

Link im E-Mail-Body Link mit Aliasing
<a href="https://www.braze.com/promotions#special-offer">Check out our special offer!</a> <a href="https://www.braze.com/promotions?lid={{link_alias}}#special-offer">Check out our special offer!</a>

Wählen Sie in der Composer-Seitenleiste Content > Link Management (unter Design and Build) aus und wählen Sie dann aus, welche Aliase verfolgt werden sollen. Verfolgte Aliase sind in Segmentierungsfiltern verfügbar, die auf Link-Aliase verweisen (siehe Segmentierungsfilter). Sie können auch aktionsbasierte Nachrichten senden oder Nutzer:innen durch einen Canvas bewegen, wenn sie auf einen Link-Alias in einer E-Mail klicken – siehe Aktionsbasierte Filter. Die Einstellung Verfolgt hat keinen Einfluss darauf, ob Klicks auf diesen Link im E-Mail-Performance-Reporting gezählt werden.

Braze ermöglicht es Ihnen, eine unbegrenzte Anzahl von Links zu verfolgen, wobei Sie Nutzer:innen jedoch nur auf Basis der zuletzt geöffneten Links retargeten können. Nutzerprofile enthalten die 100 zuletzt angeklickten Links. Wenn Sie beispielsweise 500 Links verfolgen und ein:e Nutzer:in auf alle 500 klickt, können Sie auf Basis der 100 zuletzt angeklickten Links retargeten oder Segmente erstellen.

Der Tab „Link Management“ mit zwei ausgewählten Links.

Aktionsbasierte Filter

Sie können aktionsbasierte Nachrichten erstellen, die auf jeden Link abzielen (verfolgt oder nicht verfolgt), oder Nutzer:innen retargeten, je nachdem, ob sie auf einen Alias in einer beliebigen E-Mail-Campaign oder Canvas-Komponente geklickt haben.

Aktionsbasierte Optionen zum Targeten von Nutzer:innen, die auf einen Alias in einer Canvas-Komponente geklickt oder mit einer Campaign interagiert haben.

Segmentierungsfilter

Wenn Sie in Braze einen Link-Alias in Ihrer E-Mail haben und ein:e Nutzer:in darauf klickt, wird das Ereignis im Nutzerprofil mit dem Alias aufgezeichnet.

Wenn Sie den Segmentierungsfilter „Alias in einer beliebigen Campaign oder einem Canvas-Schritt angeklickt“ verwenden und sich später entscheiden, diesen Link-Alias umzubenennen, werden die vorherigen Klickdaten im Nutzerprofil nicht aktualisiert, d. h. sie zeigen weiterhin den vorherigen Link-Alias an. Wenn Sie also Nutzer:innen auf Basis des neuen Link-Alias targeten, sind die Daten des vorherigen Link-Alias nicht enthalten.

Wenn Sie den Segmentierungsfilter „Alias in Campaign angeklickt“ oder „Alias in Canvas angeklickt“ verwenden, filtert dieser Ihre Nutzer:innen danach, ob sie auf einen bestimmten Alias in einer bestimmten Campaign oder einem Canvas geklickt haben. Wenn mehrere Nutzer:innen dieselbe E-Mail-Adresse teilen und der Link-Alias angeklickt wird, werden die Nutzerprofile aller anderen Nutzer:innen, die dieselbe E-Mail-Adresse teilen, aktualisiert. Diese Profile werden auch durch Zustellungs- und Öffnungsereignisse aktualisiert, nicht nur durch Klickereignisse.

Die folgenden Segmentierungsfilter gelten für Klickereignisse, die zum Zeitpunkt der Verarbeitung des Ereignisses verfolgt werden. Das bedeutet, dass nicht verfolgte Links keine bestehenden Daten entfernen und das Verfolgen eines Links keine Daten rückwirkend auffüllt. Weitere Details finden Sie unter Segmentierungsfilter.

Das Aufheben des Trackings eines Links ordnet bestehende Segmente mit dem Filter nicht dem nicht verfolgten Alias neu zu. Die alten Daten verbleiben in den Nutzerprofilen, bis sie durch neuere Daten ersetzt werden.

Links in archivierten Nachrichten werden automatisch nicht mehr verfolgt. Wenn archivierte Nachrichten jedoch wiederhergestellt werden, müssen die Links erneut verfolgt werden. Wenn Link-Aliase verfolgt werden, wird das Link-Reporting nach dem Alias indexiert, anstatt nach Top-Level-Domains oder vollständigen URLs.

Um alle Links in Ihrer E-Mail-Campaign und deren jeweilige Gesamtklicks anzuzeigen, gehen Sie zu Message Analytics > Email Performance > Preview & Heatmap und aktivieren Sie den Schalter Show Heatmap.

Panel „Link-Tabelle nach Gesamtklicks“ mit Link-Aliasen und deren Gesamtklicks.

E-Mail-Klick-Ereignis

Wenn Sie Ihre Engagement-Daten mit Currents exportieren, sieht ein E-Mail-Klick-Ereignis etwas anders aus, wenn Link Aliasing aktiviert ist. Es enthält zwei zusätzliche Felder für das E-Mail-Klick-Ereignis, wenn Link Aliasing aktiviert ist: link_id und link_alias.

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
// Email Click: users.messages.email.Click
{
  "id": (string) unique ID of this event,
  "user_id": (string) Braze user ID of the user,
  "external_user_id": (string) External ID of the user,
  "time": (int) 10-digit UTC time of the event in seconds since the epoch,
  "timezone": (string) IANA time zone of the user at the time of the event,
  "campaign_id": (string) ID of the campaign if from a campaign,
  "campaign_name": (string) name of the campaign,
  "message_variation_id": (string) ID of the message variation if from a campaign,
  "message_variation_name": (string) the name of the message variation if from a campaign,
  "canvas_id": (string) ID of the Canvas if from a Canvas,
  "canvas_name": (string) name of the Canvas,
  "canvas_variation_id": (string) ID of the Canvas variation the user is in if from a Canvas,
  "canvas_variation_name": (string) name of the Canvas variation the user is in if from a Canvas,
  "canvas_step_id": (string) ID of the step for this message if from a Canvas,
  "canvas_step_name": (string) name of the step for this message if from a Canvas,
  "send_id": (string) ID of the message if specified for the campaign (See Send Identifier under API Identifier Types),
  "dispatch_id": (string) ID of the message dispatch (unique ID for each 'transmission' sent from the Braze platform). Users who are sent a schedule message get the same dispatch_id. Action-based or API-triggered messages get a unique dispatch_id per user.,
  "email_address": (string) email address for this event,
  "url": (string) the URL that was clicked (Email Click events only),
  "user_agent": (string) description of the user's system and browser for the event (Email Click and Open events only),
  "ip_pool": (string) IP pool used for message sending,
  "link_id": (string) unique value generated by Braze for the URL,
  "link_alias": (string) alias name set when the message was sent
}

Bei neuen Content Blocks werden die Links modifiziert, wobei Braze jedem Link, wo zutreffend, ein lid= anhängt. Dieser Platzhalterwert wird aufgelöst, wenn er in eine E-Mail-Nachrichtenvariante eingefügt wird.

Um die Links in bestehenden Content Blocks zu modifizieren, die erstellt wurden, bevor Braze Link Aliasing aktiviert hat, duplizieren Sie die bestehenden Content Blocks und modifizieren Sie dann die Links in den duplizierten Content Blocks.

Wenn ein Content Block ohne lid-Wert in eine neue Nachricht eingefügt wird, werden die Links aus diesem Content Block nicht mit einem Alias verfolgt. Wenn ein neuer Content Block in eine „alte“ Nachrichtenvariante eingefügt wird, werden die Links aus dieser Nachrichtenvariante durch Link Aliasing erkannt. Links aus dem Content Block werden ebenfalls erkannt. Allerdings können „alte“ Content Blocks keine „neuen“ Content Blocks verschachteln.

Für URLs, die durch Liquid generiert werden (z. B. assign im HTML, Werte aus einem Content Block oder Liquid in einem angepassten Attribut), benötigt Braze eine eindeutige Stelle, um den lid-Query-Parameter einzufügen. In den meisten Fällen, wenn Liquid in der URL verbleibt, leitet Braze nicht ab, ob ein neuer Query-String mit ? begonnen oder ein bestehender Query mit & verbunden werden soll, es sei denn, Sie fügen dieses Trennzeichen selbst hinzu.

Gehen Sie wie folgt vor:

  • Wenn die URL noch keinen Query-String enthält, hängen Sie ? nach dem Liquid an (z. B. ?).
  • Wenn die URL bereits ? und Query-Parameter enthält, hängen Sie & nach dem Liquid an (z. B. &).

Ohne ein abschließendes ? oder & (oder einen anderen unterstützten Einfügepunkt) erkennt Link Aliasing die URL nicht, Link Management listet sie nicht auf und Link-Templates werden nicht angewendet.

URL-Fragmente (#) und Tracking-Parameter

Das Fragment (# und alles danach) wird bei einer normalen Link-Anfrage nicht an den Server gesendet. Braze fügt lid in den Query-String ein, der vor dem # stehen muss. Wenn Ihr href Liquid und ein #-Fragment enthält, aber kein ? oder & vor dem #, kann Braze lid nicht sicher anhängen, sodass der Link möglicherweise nicht in Link Management erscheint oder als Link-Alias verfolgt wird.

Dies kommt besonders häufig im Drag-and-Drop-Editor vor, wenn eine Button-URL Liquid mit einem Hash-basierten Muster kombiniert (z. B. ein statischer Pfad, dann #, dann zusätzliche Schlüssel-Wert-Paare). Fügen Sie in diesem Fall ? direkt vor dem # ein, damit der Query-String (einschließlich lid) vor dem Fragment geparst wird.

1
https://example.com/campaign/to/abc123?#user_id={{${user_id}}}&source=email

Im vorherigen Beispiel gibt das ? vor # Braze ein Query-Segment, an das lid angehängt werden kann. Ohne dieses erscheint der Link möglicherweise nicht in Link Management.

Ohne die Möglichkeit zu erkennen, wo Query-Parameter angehängt werden sollen, erkennt Link Aliasing diese URLs nicht und Link-Templates werden nicht angewendet. Wenn Sie Fehler wie Failed to be assigned an LID für eine dynamische URL sehen, überprüfen Sie, ob das href das in den Beispielen in diesem Abschnitt gezeigte ?- oder &-Muster verwendet.

Überlegungen zum Drag-and-Drop-Editor

Im Drag-and-Drop-Editor validieren Felder, die einen Link enthalten (z. B. eine Button-URL), das zugrunde liegende href, bevor Liquid ausgeführt wird. Leerzeichen, Zeilenumbrüche und andere nicht URL-sichere Zeichen können unerwartetes Verhalten verursachen, wenn Braze Link-Templates oder Link-Aliasing-Parameter anhängt. Wenn Sie verzweigendes Liquid für das Ziel benötigen, setzen Sie die URL in einem HTML-Block mit assign (siehe folgenden Abschnitt) und referenzieren Sie eine einzelne Variable im Drag-and-Drop-URL-Feld, anstatt komplexes Liquid direkt in dieses Feld einzufügen.

Content-Block-Beispiel

Wenn ein Content Block einen Link wie https://www.braze.com/{{custom_attribute.${offer_id}}} ohne abschließendes ? oder & enthält, weiß Braze nicht, wo lid angehängt werden soll, sodass der Link nicht für Link Management erfasst wird. Fügen Sie ? oder & am Ende der URL im Content Block hinzu (je nachdem, ob bereits ein Query-String vorhanden ist), speichern Sie den Content Block, und der Link kann erkannt werden.

Reporting, wenn die URL pro Nutzer:in variiert

Jedes eindeutige href in der Nachricht wird einer Link-ID und einem Link-Alias für Link Management und Alias-basiertes Reporting zugeordnet. Wenn Link-Aliase verfolgt werden, wird das E-Mail-Reporting im Dashboard nach dem Alias indexiert, anstatt nach jeder möglichen aufgelösten URL.

Verwenden Sie zunächst die folgenden Ansätze in Braze:

  • Campaign- und Canvas-E-Mail-Analytics: Überprüfen Sie aggregierte Klicks nach Link unter Message Analytics > Email Performance > Preview & Heatmap mit aktiviertem Show Heatmap, wie unter Tracking von Links aufheben beschrieben.
  • Klicks pro Empfänger:in im Abfrage-Builder: Führen Sie das Email URLs clicked-Abfrage-Builder-Template für eine Campaign oder einen Canvas aus. Das Template zeigt depersonalisierte Links für zusammenfassende Zählungen an; der CSV-Export enthält die Nutzer-IDs der Klickenden, den angeklickten Link und einen Zeitstempel. (Depersonalisierte URLs entfernen Liquid-Tags für die Zusammenfassungsansicht; Details finden Sie in der Template-Beschreibung.)
  • Aufschlüsselungen auf Alias-Ebene im Composer: Wenn jedes Ziel (z. B. jede offer_id) als eigene Zeile in Link Management und im Alias-basierten Reporting erscheinen soll, verwenden Sie separate href-Werte (und damit separate Aliase) – z. B. unterschiedliche Links pro Branch – anstatt eines Links, dessen Pfad sich pro Nutzer:in ändert.

Wenn Sie auch Streaming-Engagement-Exporte verwenden, enthalten E-Mail-Klick-Ereignisse ein url-Feld; siehe E-Mail-Klick-Ereignis auf dieser Seite für die Beziehung dieses Payloads zu Link Aliasing.

Beispiel

Verwenden Sie dieses Muster, wenn die zugewiesene URL keine Query-Parameter hat:

1
2
3
{% assign link1 = "https://www.braze1.com" %}

<a href="{{link1}}?">Visit Braze</a>

Wenn die zugewiesene URL bereits ? und Query-Parameter enthält, hängen Sie & nach dem Liquid an, anstatt ?:

1
2
3
{% assign link_with_params = "https://www.braze1.com?campaign=test" %}

<a href="{{link_with_params}}&">Visit Braze</a>

URLs mit bedingtem Liquid

Wenn bedingte Liquid-Tags innerhalb eines href verwendet werden (z. B. um eine URL mit {% if %}, {% elsif %} oder {% unless %} festzulegen), wird Link Aliasing nicht auf diese Links angewendet. Das bedeutet, dass diese Links nicht in Link Management erscheinen und kein lid für das Klick-Tracking erhalten.

Empfohlen: Erstellen Sie die endgültige URL in einem HTML-Block mit assign (oder {% capture %}) und referenzieren Sie diese Variable dann überall dort, wo Sie den Link benötigen. Im Drag-and-Drop-Editor fügen Sie die Variable in das Button-URL-Feld mit einem abschließenden ? oder & ein – z. B. ?.

1
2
3
4
5
{% if {{custom_attribute.${account_tier}}} == "pro" %}
{% assign url = "https://example.com/pro/verify" %}
{% else %}
{% assign url = "https://example.com/retail/account" %}
{% endif %}

Im Button-URL-Feld (Drag-and-Drop) oder in HTML verweisen Sie das href mit einem Trennzeichen auf die Variable:

1
<a href="{{ url }}?">Go to account</a>

Alternativ können Sie die URL in einer Variablen erfassen:

1
2
3
4
5
6
7
8
9
{% capture url %}
  {%- if condition -%}
    https://example.com/url1
  {%- else -%}
    https://example.com/url2
  {%- endif -%}
{% endcapture %}

<a href="{{ url }}?">Go to account</a>

Fehlerbehebung

Ziele, die den lid-Parameter nicht akzeptieren

Wenn Sie eine Testnachricht aus dem E-Mail-Editor senden, hängt Braze lid={{placeholder}} an Ihre Links an (der Platzhalter wird zum Sendezeitpunkt zu einem eindeutigen Wert). Wenn die Zielseite oder API keine zusätzlichen Query-Parameter toleriert, kann der Link im Editor funktionieren, aber beim Öffnen aus der E-Mail fehlschlagen.

Ohne den lid-Wert behandelt Braze die URL nicht als Link-Alias für Tracking und Segmentierung. Wir empfehlen, Ihr Backend oder Ihre Website so zu aktualisieren, dass der lid-Query-Parameter ignoriert wird, wenn er vorhanden ist. Dadurch bleiben Link Aliasing, Reporting und die in diesem Artikel beschriebenen Segment-Anwendungsfälle erhalten.

Alternativ können Sie Link Aliasing im Dashboard deaktivieren, während Sie eine Backend-Änderung planen. Gehen Sie zu Einstellungen > E-Mail-Präferenzen > Link Aliasing Settings.

Wenn Sie Ihre Zielsysteme nicht ändern können, wenden Sie sich an den Braze-Support, um Link Aliasing für Ihren Workspace zu deaktivieren. Beachten Sie die folgenden Hinweise, wenn Link Aliasing für Ihren Workspace deaktiviert wird:

  • Neue E-Mail-Nachrichten und Content Blocks erhalten in der Regel kein neues Link-Alias-Markup (wie den lid-Query-Parameter).
  • Bestehende Nachrichten, die erstellt wurden, als Link Aliasing aktiviert war, können weiterhin Link-Alias-Markup im HTML enthalten. Möglicherweise müssen Sie verbleibende lid-Parameter manuell entfernen, wo Sie sie nicht mehr benötigen.
  • Wenn Sie eine bestehende Campaign, einen Canvas-E-Mail-Schritt oder einen Content Block bearbeiten, müssen Sie möglicherweise Link-Templates erneut hinzufügen, damit Template-Links korrekt angezeigt werden.
  • Das Klick-Reporting für Sendungen, die durchgeführt wurden, als Link Aliasing aktiviert war, stimmt möglicherweise nicht sauber mit dem Reporting überein, nachdem das Feature deaktiviert wurde.
  • Segmente, die Link-Alias-basierte Filter verwenden (z. B. Alias angeklickt-Filter), liefern möglicherweise nicht mehr die erwarteten Zielgruppen.
New Stuff!