Skip to content

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:

Der Versand 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 nicht überprüftes Konto, das von jeder Person (privat oder geschäftlich) erstellt werden kann. Dieses Konto wird mit einem grauen Badge dargestellt und erscheint nicht in den Suchergebnissen der LINE-App.
Verifiziertes Konto Ein Konto, das die Überprüfung durch LINE Yahoo bestanden hat. Dieses Konto wird mit einem blauen Badge dargestellt und erscheint in den Suchergebnissen der LINE-App.

Dieses Konto ist nur für Konten verfügbar, die in Japan, Taiwan, Thailand und Indonesien ansässig sind.
Premium-Konto Ein Konto, das die Überprü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 Überprüfung nach Ermessen von LINE automatisch vergeben.

Erforderlicher Kontotyp

Um Follower in Braze zu synchronisieren, muss Ihr LINE-Konto verifiziert oder ein Premium-Konto sein. Wenn Sie ein Konto erstellen, ist der Standardstatus „nicht verifiziert“. Sie müssen eine Kontoverifizierung beantragen.

Beantragung eines verifizierten LINE-Kontos

  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 den Ergebnissen der Überprüfung.

LINE integrieren

Um konsistente Nutzer:innen-Updates einzurichten, die LINE-IDs bestehender Nutzer:innen zu übernehmen und sie alle mit den Abo-Status von LINE zu synchronisieren:

  1. Bestehende bekannte Nutzer:innen importieren oder aktualisieren
  2. Den LINE-Kanal integrieren
  3. Nutzer-IDs abgleichen
  4. Methoden zur Nutzer:innen-Aktualisierung ä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 korrekte 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 /users/track-Endpunkts, des CSV-Imports oder der Cloud-Datenaufnahme.

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

Schritt 2: LINE-Kanal integrieren

Nachdem der Integrationsprozess abgeschlossen ist, ruft Braze automatisch die LINE-Follower dieses Kanals in Braze ab. Für alle LINE-IDs, die bereits mit einem Braze-Nutzerprofil verknüpft sind, wird jedes Profil mit dem Status „subscribed“ aktualisiert, und alle verbleibenden LINE-IDs erzeugen anonyme Nutzer:innen. Darüber hinaus werden für neue Follower Ihres LINE-Kanals nicht identifizierte Nutzerprofile erstellt, wenn 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 URL bei der Integration automatisch in eine andere URL, basierend auf Ihrem Dashboard-Cluster.
    • Aktivieren Sie Use webhook und Webhook redelivery.

      Seite mit Webhook-Einstellungen zum Überprüfen oder Bearbeiten der Webhook-URL, mit Umschaltern für „Use webhook“, „Webhook redelivery“ und „Error statistics aggregation“.
  2. Notieren Sie sich die folgenden Informationen im 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. Falls kein Kanal-Zugriffstoken vorhanden ist, wählen Sie Issue.
  1. Gehen Sie zu Ihrer Seite Settings > Response settings und führen Sie Folgendes aus:
    • Deaktivieren Sie Greeting message. Dies kann in Braze durch Triggern bei „Follow“ gehandhabt werden.
    • Deaktivieren Sie Auto-response messages. Alle getriggerten Nachrichten sollten über Braze erfolgen. Dies hindert Sie nicht daran, direkt über die LINE-Konsole zu senden.
    • Aktivieren Sie Webhooks.

Seite mit Antworteinstellungen mit Umschaltern für die Chat-Handhabung Ihres Kontos.

Schritt 2.2: LINE-Abo-Gruppen in Braze generieren

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

Wenn Sie IP-Whitelisting in Ihrem LINE-Konto hinzufügen möchten, fügen Sie alle für Ihren Cluster aufgeführten IP-Adressen unter IP-Zulassungsliste zu Ihrer Zulassungsliste hinzu.

LINE-Messaging-Integrationsseite mit dem Abschnitt zur LINE-Integration.

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

    Alle Änderungen an Ihrer Follower-Liste (z. B. neue Follower oder Entfollower) werden automatisch in Braze übertragen.

Abschnitt LINE-Abo-Gruppen mit einer Abo-Gruppe für den Kanal „LINE“.

Schritt 3: Nutzer-IDs abgleichen

Kombinieren Sie die LINE-IDs Ihrer Nutzer:innen mit deren bestehenden Braze-Nutzerprofilen, indem Sie die Schritte unter Nutzer-ID-Abgleich befolgen.

Schritt 4: Methoden zur Nutzeraktualisierung ändern

Wenn Sie bereits eine Methode haben, um Nutzeraktualisierungen an Braze zu übermitteln, müssen Sie diese aktualisieren, damit das neue Feld native_line_id enthalten ist, sodass nachfolgende Nutzeraktualisierungen, die an Braze gesendet werden, dieses Feld beinhalten.

In Braze können nicht identifizierte Nutzerprofile mit einer native_line_id existieren, die im Rahmen des Synchronisierungsprozesses für den Abo-Status erstellt wurden oder wenn ein:e neue:r Follower:in Ihrem Kanal gefolgt ist.

Wenn ein:e LINE-Nutzer:in in Ihrer Anwendung durch Nutzer-Abgleich oder auf anderem Wege identifiziert wird, können Sie ein potenziell nicht identifiziertes Nutzerprofil in Braze über den Endpunkt /users/identify ansprechen. Jedes nicht identifizierte Nutzerprofil mit einer native_line_id hat auch einen Nutzer-Alias line_id, der verwendet werden kann, um das Nutzerprofil zur Identifizierung anzusprechen.

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

1
2
3
4
5
6
7
8
9
10
11

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

Wenn kein bestehendes Nutzerprofil für die angegebene external_id existiert, wird diese dem nicht identifizierten Nutzerprofil hinzugefügt und es damit identifiziert. Wenn bereits ein Nutzerprofil für die external_id existiert, werden alle Attribute, die ausschließlich im nicht identifizierten Nutzerprofil vorhanden sind, in das bekannte Nutzerprofil kopiert, einschließlich native_line_id und des Abo-Status der Nutzer:innen.

Sie können LINE-Nutzer:innen, die in Ihrer Anwendung bekannt sind, über den Endpunkt /users/track aktualisieren, indem Sie deren externe Bezeichner und native_line_id übergeben. Wenn bereits ein nicht identifiziertes Nutzerprofil für eine:n Nutzer:in existiert und dieselbe native_line_id über /users/track einem anderen Nutzerprofil hinzugefügt wird, erbt dieses alle Abo-Status des nicht identifizierten Nutzerprofils. Es entstehen jedoch doppelte Nutzerprofile mit derselben native_line_id. Alle nachfolgenden Abo-Aktualisierungen durch Ereignis-Updates aktualisieren alle Profile entsprechend.

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

1
2
3
4
5
6
7
8
9

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

Schritt 5: Profile zusammenführen (optional)

Wie bereits in diesem Abschnitt beschrieben, besteht die Möglichkeit, dass mehrere Nutzerprofile mit derselben native_line_id existieren. Wenn Ihre Aktualisierungsmethoden doppelte Nutzerprofile erzeugen, können Sie nicht identifizierte Nutzerprofile mit identifizierten Nutzerprofilen über den Endpunkt /user/merge zusammenführen.

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

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

{
 "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"
     }
   }
 ]
}

Nutzer:innen-Einrichtung

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 haben (native_line_id): Wenn diese:r Nutzer:in dem LINE-Kanal, von dem Sie senden, nicht folgt, stellt LINE keine Nachrichten an diese:n Nutzer:in zu.

Um dies zu verwalten, bietet Braze Tools und Logik, die eine gut integrierte Nutzerbasis unterstützen, einschließlich Abo-Synchronisierung und Ereignis-Updates für LINE-Follows und -Unfollows.

Abo-Synchronisierung und Ereignislogik

Informationen dazu, wie das Tool zur Abo-Synchronisierung sowie Ereignis-Updates für Follows und Unfollows den LINE-Abo-Status mit Braze abgleichen, finden Sie unter Abo-Status.

Einen 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 im Ziel-Workspace den Kanal mithilfe von Schritt 2: LINE-Kanal integrieren.

Stellen Sie sicher, dass Sie in beiden Workspaces über die Berechtigung Abo-Gruppen verwalten verfügen. Ohne Berechtigungen in beiden Workspaces schlägt die Integration mit einem Fehler fehl, der darauf hinweist, dass der Kanal bereits verbunden ist.

Informationen dazu, wie sich die Archivierung auf Abo-Gruppen auswirkt, finden Sie unter LINE-Abo-Gruppen.

Anwendungsfälle

Dies sind Anwendungsfälle, wie Nutzer:innen aktualisiert werden können, nachdem Sie die Einrichtungsschritte befolgt haben.

Bestehendes Braze-Nutzerprofil folgt bereits dem LINE-Kanal

  1. Das Braze-Nutzerprofil wird mit einem native_line_id-Attribut aktualisiert. Der Standard-Abo-Status ist unsubscribed.
  2. Das Abo-Synchronisierungstool wird ausgeführt, stellt fest, dass die Nutzer:in dem LINE-Kanal folgt, und aktualisiert dann das Nutzerprofil mit dem Abo-Status subscribed.
  3. Wenn sich der Abo-Status ändert (z. B. wenn die Nutzer:in den Kanal blockiert, die Freundschaft aufhebt oder dem Kanal erneut folgt), erhält Braze die Aktualisierung von LINE und aktualisiert das Nutzerprofil mit der native_line_id entsprechend.

Bestehendes Nutzerprofil hat den LINE-Kanal blockiert, die Freundschaft aufgehoben oder entfolgt

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

Nutzerprofil wird nach dem LINE-Follow erstellt

  1. Der Kanal erhält eine:n neue:n LINE-Follower:in.
  2. Braze erstellt ein anonymes Nutzerprofil, bei dem das native_line_id-Attribut auf die LINE-ID der Follower:in und ein Nutzer-Alias line_id auf die LINE-ID der Follower:in gesetzt wird. Das Profil hat den Abo-Status subscribed.
  3. Die Nutzer:in wird durch Nutzerabgleich als Inhaber:in der LINE-ID identifiziert. 
1
2
3
4
5
6
7
8
9
10
11

{
   "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 /users/track-Endpunkt, CSV-Import oder Cloud-Datenaufnahme), indem die native_line_id gesetzt wird. Dieses neue Profil übernimmt den Abo-Status des bestehenden anonymen Nutzerprofils. Beachten Sie, dass dies dazu führt, dass mehrere Profile dieselbe native_line_id teilen. Diese können jederzeit über den /users/merge-Endpunkt im in Schritt 5 beschriebenen Prozess zusammengeführt werden.

Nutzerprofil wird vor dem LINE-Follow erstellt

  1. Sie gewinnen eine:n neue:n 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 empfängt ein Follow-Ereignis und erstellt ein anonymes Nutzerprofil (Profil 2).
  4. Die Nutzer:in wird durch Nutzerabgleich als Inhaber:in der LINE-ID identifiziert.
  5. Sie aktualisieren Profil 1, um das native_line_id-Attribut zu setzen. Dieses Profil übernimmt den Abo-Status von Profil 2.
    • Jetzt gibt es zwei Nutzerprofile mit derselben native_line_id. Diese können jederzeit über den /users/merge-Endpunkt im in Schritt 5 beschriebenen Prozess zusammengeführt werden.

Abgleich der Nutzer-ID

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 außerdem spezifisch für den Kanal, dem Nutzer:innen folgen, sodass es unwahrscheinlich ist, dass Nutzer:innen ihre LINE-IDs selbst angeben können.

Es gibt zwei Möglichkeiten, eine LINE-ID mit einem bestehenden Braze-Nutzerprofil zu kombinieren:

LINE Login

Diese Methode nutzt Social-Media-Anmeldungen für den Abgleich. Wenn sich Nutzer:innen in Ihrer App anmelden, erhalten sie die Option, LINE Login zu verwenden, um ein Nutzerkonto zu erstellen oder sich anzumelden.

  1. Gehen Sie zur LINE Developer Console und beantragen Sie die Berechtigung, die E-Mail-Adressen von Nutzer:innen abzurufen, die sich über LINE Login in Ihrer App anmelden.

  2. Befolgen Sie die entsprechenden von LINE bereitgestellten Schritte, um LINE Login zu implementieren:

  1. Verwenden Sie den Verify-ID-Token-Aufruf, um die E-Mail-Adresse der Nutzer:innen abzurufen.

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

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

Workflows

Bestehende:r Follower:in verwendet LINE Login

Szenario: Eine anonyme Nutzer:in wurde während der initialen Abonnent:innen-Synchronisierung oder nach der Integration durch ein „Folgen“-Ereignis erstellt.

  1. Die Nutzer:in meldet sich über LINE Login in Ihrer App an.
  2. LINE stellt Ihnen die E-Mail-Adresse der Nutzer:in bereit.
  3. Sie senden Braze die aktualisierte Nutzer:in (das bestehende Nutzerprofil mit dieser E-Mail-Adresse, um die LINE-ID hinzuzufügen) oder Sie aktualisieren die anonyme Nutzer:in mit der E-Mail-Adresse.
Neue:r Follower:in verwendet LINE Login

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

  1. Die Nutzer:in meldet sich über LINE Login in Ihrer App an.
  2. LINE stellt Ihnen die E-Mail-Adresse der Nutzer:in bereit.
  3. Sie können entweder:
    • Ein bestehendes Nutzerprofil mit dieser E-Mail-Adresse aktualisieren, um auch die LINE-ID der Nutzer:in hinzuzufügen.
    • Ein neues Nutzerprofil mit der E-Mail-Adresse und LINE-ID erstellen.
  4. Wenn die Nutzer:in Ihrem offiziellen LINE-Konto folgt, empfängt Braze ein Folgen-Ereignis und aktualisiert den Abo-Status der Nutzer:in auf subscribed.

Kontoverknüpfung

Diese Methode ermöglicht es Nutzer:innen, ihr LINE-Konto mit dem Nutzerkonto Ihrer App zu verknüpfen. Sie können dann Liquid in Braze verwenden, wie z. B. {{line_id}}, um eine personalisierte URL für die Nutzer:in zu erstellen, die die LINE-ID der Nutzer:in an Ihre Website oder App zurückgibt, wo sie dann einer bekannten Nutzer:in zugeordnet werden kann.

  1. Erstellen Sie einen aktionsbasierten Canvas, der auf einer Änderung des Abo-Status basiert und ausgelöst wird, wenn Nutzer:innen Ihren LINE-Kanal abonnieren.
    Canvas, das ausgelöst wird, wenn Nutzer:innen den LINE-Kanal abonnieren.
  2. Erstellen Sie eine Nachricht, die Nutzer:innen dazu motiviert, sich auf Ihrer Website oder in Ihrer App anzumelden, wobei die LINE-ID der Nutzer:in als Abfrageparameter (über Liquid) übergeben wird, zum Beispiel:
1

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 übermittelt.
  2. (Optional) Erstellen Sie eine aktionsbasierte Campaign oder einen Canvas, der ausgelöst wird, wenn die LINE-Nutzer:in identifiziert wird, um der Nutzer:in ihren Gutscheincode zu senden.
    Aktionsbasierte Campaign, die ausgelöst wird, wenn die LINE-Nutzer:in identifiziert wird.

So funktioniert es

Nachdem sich die Nutzer:in angemeldet hat, wird auf Ihrer Website oder in Ihrer App eine Änderung 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:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21

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 Nutzer:in folgt Ihrem LINE-Kanal

Szenario: Eine bestehende Nutzer:in in Braze folgt Ihrem Kanal auf LINE.

  1. LINE sendet Braze ein Folgen-Ereignis.
  2. Braze erstellt ein anonymes Nutzerprofil mit der LINE-ID, dem Nutzer-Alias line_id und dem LINE-Abo-Gruppenstatus subscribed.
  3. Die Nutzer:in erhält eine LINE-Nachricht mit einem Link zu Ihrer Website und App und meldet sich an. Ihr Nutzerprofil ist jetzt bekannt.
  4. Das erstellte anonyme Nutzerprofil wird identifiziert und über den /users/identify-Endpunkt mit dem bekannten Nutzerprofil zusammengeführt. Das bekannte Nutzerprofil enthält jetzt die LINE-ID und hat den Abo-Status subscribed.
  5. (Optional) Die Nutzer:in erhält 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 die Nutzer-Abgleichung einrichten, indem Sie ein „Wer bin ich“-Canvas oder eine Campaign erstellen.

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

    Beispiel-Trigger

    Trigger, um die Campaign an Nutzer:innen zu senden, die eine eingehende LINE-Nachricht an eine bestimmte Abo-Gruppe gesendet haben.

    Beispiel-Nachricht

    LINE-Nachricht mit der Braze-Nutzer-ID.

  2. In Braze können Sie die Braze-ID verwenden, um bestimmte Nutzer:innen zu suchen und bei Bedarf zu bearbeiten.
New Stuff!