Zum Inhalt springen

LINE-Einrichtung

Dieser Artikel beschreibt, wie Sie den LINE-Kanal in Braze einrichten, einschließlich der Einrichtung von Nutzer:innen, der Abstimmung von Nutzer-IDs und der Erstellung von LINE-Testnutzer:innen in Braze.

Voraussetzungen

Für die Integration von LINE mit Braze benötigen Sie Folgendes:

Das Senden von LINE-Nachrichten über Braze wird von den Message- oder Action-Credits Ihres Kontos abgezogen.

Arten von LINE-Konten

Kontotyp Beschreibung
Nicht verifiziertes Konto Ein ungeprüftes Konto, das jede:r (Privatperson oder Unternehmen) erhalten kann. Dieses Konto wird mit einem grauen Badge dargestellt und erscheint nicht in den Suchergebnissen der LINE App.
Verifiziertes Konto Ein Konto, das die Prüfung durch LINE Yahoo bestanden hat. Dieses Konto wird mit einem blauen Badge dargestellt und erscheint in den Suchergebnissen der LINE App.

Dieser Kontotyp ist nur für Konten mit Sitz in Japan, Taiwan, Thailand und Indonesien verfügbar.
Premium-Konto Ein Konto, das die Prüfung durch LINE Yahoo bestanden hat. Dieses Konto wird mit einem grünen Badge dargestellt und erscheint in den Suchergebnissen der LINE App. Dieser Kontotyp wird während der Prüfung nach Ermessen von LINE automatisch vergeben.

Erforderlicher Kontotyp

Um Follower:innen mit Braze zu synchronisieren, muss Ihr LINE-Konto verifiziert oder ein Premium-Konto sein. Wenn Sie ein Konto erstellen, ist es standardmäßig nicht verifiziert. Sie müssen die Verifizierung des Kontos beantragen.

Ein verifiziertes LINE-Konto beantragen

  1. Wählen Sie auf der LINE-Seite Official Account die Option Settings aus.
  2. Wählen Sie unter Information Disclosure Verification Status die Option Request Account Verification aus.
  3. Geben Sie die erforderlichen Informationen ein.
  4. Warten Sie auf eine Benachrichtigung mit dem Ergebnis der Prüfung.

LINE integrieren

So richten Sie konsistente Nutzer-Updates ein, übernehmen die LINE-IDs bestehender Nutzer:innen und synchronisieren alle mit den Abo-Status von LINE:

  1. Bestehende bekannte Nutzer:innen importieren oder aktualisieren
  2. LINE-Kanal integrieren
  3. Nutzer-IDs abgleichen
  4. Methoden für Nutzer-Updates ändern
  5. (Optional) Nutzerprofile zusammenführen

Schritt 1: Bestehende LINE-Nutzer:innen importieren oder aktualisieren

Dieser Schritt ist erforderlich, wenn Sie bereits identifizierte LINE-Nutzer:innen haben, da Braze später automatisch deren Abo-Status abruft und das richtige Nutzerprofil aktualisiert. Wenn Sie Nutzer:innen bisher nicht mit ihrer LINE-ID abgeglichen haben, überspringen Sie diesen Schritt.

Sie können Nutzer:innen mit jeder von Braze unterstützten Methode importieren oder aktualisieren, einschließlich des Endpunkts /users/track, des CSV-Imports oder der Cloud-Datenaufnahme.

Unabhängig von der verwendeten Methode aktualisieren Sie native_line_id, um die LINE-ID der Nutzer:innen anzugeben. Weitere Informationen zu native_line_id finden Sie unter Nutzer-Einrichtung.

Schritt 2: LINE-Kanal integrieren

Nach Abschluss der Integration überträgt Braze automatisch die LINE-Follower dieses Kanals in Braze. Alle LINE-IDs, die bereits mit einem Braze-Nutzerprofil verknüpft sind, erhalten in ihrem Profil den Status „subscribed“. Für alle übrigen LINE-IDs werden anonyme Nutzer:innen angelegt. Außerdem erstellt Braze für neue Follower Ihres LINE-Kanals nicht identifizierte Nutzerprofile, sobald sie dem Kanal folgen.

Schritt 2.1: Webhook-Einstellungen bearbeiten

  1. Gehen Sie in LINE zum Tab Messaging API und bearbeiten Sie Ihre Webhook settings:
    • Setzen Sie die Webhook URL auf https://anna.braze.com/line/events.
      • Braze ändert diese bei der Integration automatisch in eine andere URL, die von Ihrem Dashboard-Cluster abhängt.
    • Aktivieren Sie Use webhook und Webhook redelivery.

      Seite mit den Webhook-Einstellungen zum Überprüfen oder Bearbeiten der Webhook-URL sowie zum Ein- oder Ausschalten von „Use webhook“, „Webhook redelivery“ und „Error statistics aggregation“.
  2. Notieren Sie sich die folgenden Informationen aus dem Tab Providers:
Informationstyp Ort
Provider-ID Wählen Sie Ihren Provider aus und gehen Sie dann zu Settings > Basic information.
Kanal-ID Wählen Sie Ihren Provider aus und gehen Sie dann zu Channels > Ihr Kanal > Basic settings.
Kanal-Secret Wählen Sie Ihren Provider aus und gehen Sie dann zu Channels > Ihr Kanal > Basic settings.
Kanal-Zugriffstoken Wählen Sie Ihren Provider aus und gehen Sie dann zu Channels > Ihr Kanal > Messaging API. Wenn noch kein Kanal-Zugriffstoken vorhanden ist, wählen Sie Issue aus.
  1. Gehen Sie zu Ihrer Seite Settings > Response settings und führen Sie folgende Schritte aus:
    • Deaktivieren Sie Greeting message. Dies können Sie in Braze über einen Trigger beim Folgen abbilden.
    • Deaktivieren Sie Auto-response messages. Alle getriggerten Nachrichten sollten über Braze laufen. Das hindert Sie nicht daran, Nachrichten direkt über die LINE-Konsole zu versenden.
    • Aktivieren Sie Webhooks.

Seite mit den Antworteinstellungen und Schaltern, mit denen Sie festlegen, wie Ihr Konto Chats handhabt.

Schritt 2.2: LINE-Abo-Gruppen in Braze generieren

Braze erstellt für jeden integrierten LINE-Kanal eine Abo-Gruppe. Wie LINE-Abo-Gruppen funktionieren, erfahren Sie unter LINE-Abo-Gruppen.

  1. Gehen Sie in Braze zur Technologie-Partnerseite für LINE und geben Sie die Informationen ein, die Sie sich im LINE-Tab Providers notiert haben:
    • Provider-ID
    • Kanal-ID
    • Kanal-Secret
    • Kanal-Zugriffstoken

Wenn Sie in Ihrem LINE-Konto eine IP-Whitelist einrichten möchten, fügen Sie Ihrer Allowlist alle IP-Adressen hinzu, die unter IP-Allowlisting für Ihren Cluster aufgeführt sind.

Seite für die LINE-Messaging-Integration mit dem Abschnitt zur LINE-Integration.

  1. Nach dem Verbinden generiert Braze automatisch eine Braze-Abo-Gruppe für jede LINE-Integration, die Ihrem Workspace erfolgreich hinzugefügt wurde.

    Alle Änderungen an Ihrer Follower-Liste (etwa neue Follower oder Entfolgungen) werden automatisch an Braze übertragen.

Abschnitt mit LINE-Abo-Gruppen, der eine Abo-Gruppe für den Kanal „LINE“ anzeigt.

Schritt 3: Nutzer-IDs abgleichen

Führen Sie die LINE-IDs Ihrer Nutzer:innen mit deren bestehenden Braze-Nutzerprofilen zusammen, indem Sie die Schritte unter Abgleich der Nutzer-IDs befolgen.

Schritt 4: Ändern Sie Ihre Methoden für Nutzer-Updates

Wenn Sie bereits eine Methode nutzen, um Nutzer-Updates an Braze zu senden, müssen Sie diese um das neue Feld native_line_id erweitern. So enthalten alle nachfolgenden Nutzer-Updates an Braze dieses Feld.

In Braze kann es nicht identifizierte Nutzerprofile mit einer native_line_id geben. Diese entstehen bei der Synchronisierung des Abo-Status oder wenn Ihrem Kanal neue Follower:innen folgen.

Wenn Sie LINE-Nutzer:innen in Ihrer Anwendung über den Nutzerabgleich oder auf anderem Weg identifizieren, können Sie ein mögliches nicht identifiziertes Nutzerprofil in Braze über den Endpunkt /users/identify ansprechen. Jedes nicht identifizierte Nutzerprofil mit einer native_line_id hat außerdem einen Nutzer-Alias line_id. Über diesen Alias können Sie das zu identifizierende Nutzerprofil ansprechen.

Hier ist ein Beispiel-Payload für /users/identify, der ein nicht identifiziertes Nutzerprofil über den Nutzer-Alias line_id anspricht:

{
   "aliases_to_identify": [
       {
           "external_id": "known_external_id_from_your_application",
           "user_alias": {
               "alias_name": "U89f4a626548ccd48482f529a482f138b",
               "alias_label": "line_id"
           }
       }
   ]
}

Gibt es für die angegebene external_id noch kein Nutzerprofil, wird sie dem nicht identifizierten Nutzerprofil hinzugefügt, das damit identifiziert ist. Gibt es für die external_id bereits ein Nutzerprofil, werden alle Attribute, die ausschließlich im nicht identifizierten Nutzerprofil vorhanden sind, in das bekannte Nutzerprofil kopiert. Dazu gehören auch die native_line_id und der Abo-Status der Nutzer:innen.

LINE-Nutzer:innen, die in Ihrer Anwendung bekannt sind, können Sie über den Endpunkt /users/track aktualisieren, indem Sie deren externe Bezeichner und die native_line_id übergeben. Gibt es für Nutzer:innen bereits ein nicht identifiziertes Nutzerprofil und wird dieselbe native_line_id über /users/track einem anderen Nutzerprofil hinzugefügt, übernimmt dieses alle Abo-Status des nicht identifizierten Nutzerprofils. Allerdings existieren dann doppelte Nutzerprofile mit derselben native_line_id. Alle nachfolgenden Abo-Updates aus Event-Updates aktualisieren entsprechend alle Profile.

Hier ist ein Beispiel-Payload für /users/track, der ein Nutzerprofil über die externe Nutzer-ID aktualisiert, um eine native_line_id hinzuzufügen:

{
   "attributes": [
       {
           "external_id": "known_external_id_from_your_application",
           "native_line_id": "U89f4a626548ccd48482f529a482f138b",
           "other": "attribute"
       }
   ]
}

Schritt 5: Profile zusammenführen (optional)

Wie weiter oben in diesem Abschnitt beschrieben, können mehrere Nutzerprofile mit derselben native_line_id existieren. Wenn Ihre Update-Methoden doppelte Nutzerprofile erstellen, können Sie nicht identifizierte Nutzerprofile mit dem Endpunkt /user/merge mit identifizierten Nutzerprofilen zusammenführen.

Hier sehen Sie ein Beispiel für einen Payload an /users/merge, der ein nicht identifiziertes Nutzerprofil über den Nutzer-Alias line_id adressiert:

{
 "merge_updates": [
   {
     "identifier_to_merge": {
       "user_alias": {
         "alias_name": "U89f4a626548ccd48482f529a482f138b",
         "alias_label": "line_id"
       }
     },
     "identifier_to_keep": {
       "external_id": "known_external_id_from_your_application"
     }
   }
 ]
}

Einrichtung der Nutzer:innen

LINE ist die maßgebliche Quelle für den Abo-Status von Nutzer:innen. Selbst wenn Sie die LINE-ID einer Nutzerin oder eines Nutzers (native_line_id) kennen, stellt LINE keine Nachrichten zu, solange diese Person dem LINE-Kanal, über den Sie senden, nicht folgt.

Um Sie dabei zu unterstützen, bietet Braze Tools und Logik für eine gut integrierte Nutzerbasis, darunter Abo-Synchronisierung und Event-Updates für Follows und Unfollows auf LINE.

Abo-Synchronisierung und Event-Logik

Wie das Tool zur Abo-Synchronisierung und die Event-Updates für Follows und Unfollows den LINE-Abo-Status mit Braze abgleichen, erfahren Sie unter Abo-Status.

LINE-Kanal in einem anderen Workspace erneut integrieren

So verwenden Sie einen LINE-Kanal in einem anderen Braze-Workspace:

  1. Archivieren Sie im ursprünglichen Workspace die Abo-Gruppe für diesen Kanal.
  2. Integrieren Sie den Kanal im Ziel-Workspace wie in Schritt 2: LINE-Kanal integrieren beschrieben.

Vergewissern Sie sich, dass Sie in beiden Workspaces die Berechtigung Abo-Gruppen verwalten haben. Fehlen die Berechtigungen in einem der beiden Workspaces, schlägt die Integration mit einer Fehlermeldung fehl, die besagt, dass der Kanal bereits verbunden ist.

Wie sich die Archivierung auf Abo-Gruppen auswirkt, erfahren Sie unter LINE-Abo-Gruppen.

Anwendungsfälle

Die folgenden Anwendungsfälle zeigen, wie Nutzer:innen aktualisiert werden können, nachdem Sie die Einrichtungsschritte abgeschlossen haben.

Bestehendes Braze-Nutzerprofil folgt bereits dem LINE-Kanal

  1. Das Braze-Nutzerprofil wird mit einem native_line_id-Attribut aktualisiert. Der Standard-Abostatus ist unsubscribed.
  2. Das Tool zur Abo-Synchronisierung wird ausgeführt, erkennt, dass die Nutzer:in dem LINE-Kanal folgt, und aktualisiert das Nutzerprofil dann mit dem Abostatus subscribed.
  3. Wenn sich der Abostatus ändert (etwa weil die Nutzer:in den Kanal blockiert, als Freund:in entfernt oder ihm erneut folgt), erhält Braze das Update von LINE und aktualisiert das Nutzerprofil mit der native_line_id entsprechend.

Bestehendes Nutzerprofil hat den LINE-Kanal blockiert, als Freund entfernt oder ihm nicht mehr gefolgt

  1. Das Braze-Nutzerprofil wird mit einem native_line_id-Attribut aktualisiert. Der Standard-Abostatus ist unsubscribed.
  2. Das Tool zur Abo-Synchronisierung stellt nicht fest, dass die Nutzer:in dem LINE-Kanal folgt, und der Abostatus der Nutzer:in bleibt unsubscribed.
  3. Folgt die Nutzer:in dem Kanal später, erhält Braze das Update von LINE und aktualisiert das Nutzerprofil mit dem Abostatus subscribed.

Nutzerprofil wird nach dem Folgen auf LINE erstellt

  1. Der Kanal erhält eine neue LINE-Follower:in.
  2. Braze erstellt ein anonymes Nutzerprofil, bei dem das Attribut native_line_id auf die LINE-ID der Follower:in gesetzt ist, sowie einen Nutzer-Alias line_id, der ebenfalls auf die LINE-ID der Follower:in gesetzt ist. Das Profil hat den Abostatus subscribed.
  3. Die Nutzer:in wird über den Nutzerabgleich als Inhaber:in der LINE-ID identifiziert.
{
   "aliases_to_identify": [
       {
           "external_id": "known_external_id_from_your_application",
           "user_alias": {
               "alias_name": "U89f4a626548ccd48482f529a482f138b",
               "alias_label": "line_id"
           }
       }
   ]
}
  • Ein neues Nutzerprofil kann erstellt werden (über den Endpunkt /users/track, den CSV-Import oder die Cloud-Datenaufnahme), indem Sie die native_line_id festlegen. Dieses neue Profil übernimmt den Abostatus des bestehenden anonymen Nutzerprofils. Beachten Sie, dass dadurch mehrere Profile dieselbe native_line_id haben. Diese können jederzeit über den Endpunkt /users/merge zusammengeführt werden, wie in Schritt 5 beschrieben.

Nutzerprofil wird vor dem Folgen auf LINE erstellt

  1. Sie gewinnen eine neue Nutzer:in und senden die Informationen an Braze. Ein neues Nutzerprofil wird erstellt (Profil 1).
  2. Die Nutzer:in folgt Ihrem LINE-Konto.
  3. Braze erhält ein Follow-Event und erstellt ein anonymes Nutzerprofil (Profil 2).
  4. Die Nutzer:in wird über den Nutzerabgleich als Inhaber:in der LINE-ID identifiziert.
  5. Sie aktualisieren Profil 1, um das Attribut native_line_id festzulegen. Dieses Profil übernimmt den Abostatus von Profil 2.
    • Nun gibt es zwei Nutzerprofile mit derselben native_line_id. Diese können jederzeit über den Endpunkt /users/merge zusammengeführt werden, wie in Schritt 5 beschrieben.

Abgleich von Nutzer-IDs

LINE-IDs werden automatisch von Braze empfangen, wenn Nutzer:innen Ihrem Kanal folgen oder wenn Sie den einmaligen Workflow „Follower synchronisieren“ verwenden. LINE-IDs sind zudem spezifisch für den Kanal, dem Nutzer:innen folgen. Daher ist es unwahrscheinlich, dass Nutzer:innen ihre LINE-IDs selbst angeben können.

Es gibt zwei Möglichkeiten, eine LINE-ID mit einem bestehenden Braze-Nutzerprofil zusammenzuführen:

LINE Login

Diese Methode verwendet Social-Media-Anmeldungen für den Abgleich. Wenn sich Nutzer:innen bei Ihrer App anmelden, haben sie die Möglichkeit, mit LINE Login ein Nutzerkonto zu erstellen oder sich anzumelden.

  1. Rufen Sie die LINE-Entwicklungskonsole auf und beantragen Sie die Berechtigung, die E-Mail-Adressen von Nutzer:innen zu erhalten, die sich über LINE Login bei Ihrer App anmelden.

  2. Folgen Sie den entsprechenden Schritten von LINE, um LINE Login zu implementieren:

  1. Verwenden Sie den Aufruf „Verify ID token“, um die E-Mail-Adresse der Nutzer:innen zu erhalten.

  2. Speichern Sie die LINE-ID der Nutzer:innen (native_line_id) im Nutzerprofil mit der passenden E-Mail-Adresse in Ihrer Datenbank oder erstellen Sie ein neues Nutzerprofil mit der E-Mail-Adresse und der LINE-ID.

  3. Senden Sie die neuen oder aktualisierten Nutzerinformationen über den Endpunkt /user/track, den CSV-Import oder Cloud Data Ingestion an Braze.

Workflows

Bestehende:r Follower:in verwendet LINE Login

Szenario: Ein:e anonyme:r Nutzer:in wurde bei der anfänglichen Synchronisierung der Abonnent:innen oder nach der Integration durch ein „Follow“-Event erstellt.

  1. Die Nutzer:innen melden sich mit LINE Login bei Ihrer App an.
  2. LINE übermittelt Ihnen die E-Mail-Adresse der Nutzer:innen.
  3. Sie senden Braze die aktualisierten Nutzerdaten (das bestehende Nutzerprofil mit dieser E-Mail-Adresse, um die LINE-ID hinzuzufügen) oder Sie aktualisieren das Profil der anonymen Nutzer:innen mit der E-Mail-Adresse.
Neue:r Follower:in verwendet LINE Login

Szenario: In Braze existiert kein Nutzerprofil mit der LINE-ID der Nutzer:innen.

  1. Die Nutzer:innen melden sich mit LINE Login bei Ihrer App an.
  2. LINE übermittelt Ihnen die E-Mail-Adresse der Nutzer:innen.
  3. Sie haben zwei Möglichkeiten:
    • Aktualisieren Sie ein bestehendes Nutzerprofil mit dieser E-Mail-Adresse, sodass es auch die LINE-ID der Nutzer:innen enthält.
    • Erstellen Sie ein neues Nutzerprofil mit der E-Mail-Adresse und der LINE-ID.
  4. Wenn die Nutzer:innen Ihrem offiziellen LINE-Account folgen, empfängt Braze ein Follow-Event und aktualisiert den Abo-Status der Nutzer:innen auf subscribed.

Verknüpfung von Nutzerkonten

Mit dieser Methode können Nutzer:innen ihren LINE-Account mit dem Nutzerkonto in Ihrer App verknüpfen. Anschließend können Sie Liquid in Braze verwenden, etwa {{line_id}}, um eine personalisierte URL für die Nutzer:innen zu erstellen, die deren LINE-ID an Ihre Website oder App zurückgibt. Dort kann sie dann bekannten Nutzer:innen zugeordnet werden.

  1. Erstellen Sie ein aktionsbasiertes Canvas, das auf einer Änderung des Abo-Status basiert und getriggert wird, wenn Nutzer:innen Ihren LINE-Kanal abonnieren.
    Canvas, das getriggert wird, wenn Nutzer:innen den LINE-Kanal abonnieren.
  2. Erstellen Sie eine Nachricht, die Nutzer:innen einen Anreiz bietet, sich bei Ihrer Website oder App anzumelden, und die LINE-ID der Nutzer:innen als Abfrageparameter (über Liquid) übergibt, zum Beispiel:
Thanks for following Flash n' Thread on LINE! For personalized offers and 20% off your next purchase, sign-in to your account: https://flashandthread.com/sign_in?line_user_id=
  1. Erstellen Sie eine Folgenachricht, die den Gutscheincode zustellt.
  2. (Optional) Erstellen Sie eine aktionsbasierte Campaign oder ein aktionsbasiertes Canvas, die bzw. das getriggert wird, wenn die LINE-Nutzer:innen identifiziert werden, um ihnen ihren Gutscheincode zu senden.
    Aktionsbasierte Campaign, die getriggert wird, wenn die LINE-Nutzer:innen identifiziert werden.

Funktionsweise

Nachdem sich die Nutzer:innen angemeldet haben, wird eine Änderung an Ihrer Website oder App vorgenommen, sodass die Nutzer-ID an Braze zurückgesendet wird, um sie mit der LINE-ID zu verknüpfen, die als Teil der URL übergeben wurde. Beispielcode:

const currentUrl = new URL(window.location.href)
const queryParams = new URLSearchParams(currentUrl.search);
const lineUserId = queryParams.get("line_user_id")

if (user && isLoggedIn && lineUserId) {
  post(
   "https://rest.iad-03.braze.com	/users/identify",
   {
     "aliases_to_identify": [
       {
   "external_id": user.getUserId(),
   "user_alias": {
     "alias_name": lineUserId,
     "alias_label": "line_id"
   }
 }
      ]
    }
  )
  braze.logCustomEvent("identified_line_user_for_promotion");
}

Workflows

Bestehende:r Nutzer:in folgt Ihrem LINE-Kanal

Szenario: Bestehende Nutzer:innen in Braze folgen Ihrem Kanal auf LINE.

  1. LINE sendet Braze ein Follow-Event.
  2. Braze erstellt ein anonymes Nutzerprofil mit der LINE-ID, dem Nutzer-Alias line_id und dem LINE-Abo-Gruppenstatus subscribed.
  3. Die Nutzer:innen erhalten eine LINE-Nachricht mit einem Link zu Ihrer Website und App und melden sich an. Ihr Nutzerprofil ist nun bekannt.
  4. Das erstellte anonyme Nutzerprofil wird identifiziert und über den Endpunkt /users/identify mit dem bekannten Nutzerprofil zusammengeführt. Das bekannte Nutzerprofil enthält nun die LINE-ID und hat den Abo-Status subscribed.
  5. (Optional) Die Nutzer:innen erhalten eine LINE-Nachricht mit dem Gutscheincode, und Braze protokolliert den Versand im Braze-Nutzerprofil.

LINE-Testnutzer:innen in Braze erstellen

Sie können Ihren LINE-Kanal testen, bevor Sie den Nutzerabgleich einrichten, indem Sie ein „Who am I“-Canvas oder eine „Who am I“-Campaign erstellen.

  1. Richten Sie ein Canvas ein, das bei einem bestimmten Trigger-Wort die Braze-Nutzer-ID einer Nutzerin oder eines Nutzers zurückgibt.

    Beispiel-Trigger

    Trigger zum Senden der Campaign an Nutzer:innen, die eine eingehende LINE-Nachricht an eine bestimmte Abo-Gruppe gesendet haben.

    Beispielnachricht

    LINE-Nachricht mit der Braze-Nutzer-ID.

  2. In Braze können Sie mit der Braze-ID nach bestimmten Nutzer:innen suchen und diese bei Bedarf bearbeiten.

New Stuff!