Skip to content

Configuration de LINE

Cet article explique comment configurer le canal LINE dans Braze, y compris comment configurer les utilisateurs, réconcilier les ID utilisateur et créer des utilisateurs test LINE dans Braze.

Prérequis

Vous aurez besoin des éléments suivants pour intégrer LINE à Braze :

L’envoi de messages LINE depuis Braze utilise les crédits de messages ou d’actions de votre compte.

Types de comptes LINE

Type de compte Description
Compte non vérifié Un compte non examiné que toute personne (particulier ou entreprise) peut obtenir. Ce compte est représenté par un badge gris et n’apparaîtra pas dans les résultats de recherche de l’application LINE.
Compte vérifié Un compte ayant passé le processus de vérification de LINE Yahoo. Ce compte est représenté par un badge bleu et apparaîtra dans les résultats de recherche de l’application LINE.

Ce compte est uniquement disponible pour les comptes basés au Japon, à Taïwan, en Thaïlande et en Indonésie.
Compte premium Un compte ayant passé le processus de vérification de LINE Yahoo. Ce compte est représenté par un badge vert et apparaîtra dans les résultats de recherche de l’application LINE. Ce type de compte est automatiquement accordé lors de la vérification, à la discrétion de LINE.

Type de compte requis

Pour synchroniser les abonnés dans Braze, votre compte LINE doit être vérifié ou premium. Lorsque vous créez un compte, son statut par défaut sera non vérifié. Vous devrez demander la vérification du compte.

Demander un compte LINE vérifié

  1. Sur la page Official Account de LINE, sélectionnez Settings.
  2. Sous Information Disclosure Verification Status, sélectionnez Request Account Verification.
  3. Saisissez les informations requises.
  4. Attendez une notification contenant les résultats de l’examen.

Intégration de LINE

Pour configurer des mises à jour utilisateur cohérentes, importer les LINE ID des utilisateurs existants et les synchroniser avec les états d’abonnement LINE :

  1. Importer ou mettre à jour les utilisateurs LINE existants connus
  2. Intégrer le canal LINE
  3. Réconcilier les ID utilisateur
  4. Modifier vos méthodes de mise à jour des utilisateurs
  5. (Facultatif) Fusionner les profils utilisateur

Étape 1 : Importer ou mettre à jour les utilisateurs LINE existants

Cette étape est nécessaire si vous avez un utilisateur LINE existant et identifié, car Braze récupérera automatiquement son statut d’abonnement et mettra à jour le profil utilisateur correspondant. Si vous n’avez pas encore associé vos utilisateurs à leur ID LINE, passez cette étape.

Vous pouvez importer ou mettre à jour les utilisateurs à l’aide de n’importe quelle méthode prise en charge par Braze, y compris l’endpoint /users/track, l’importation CSV ou l’ingestion de données cloud.

Quelle que soit la méthode utilisée, mettez à jour le champ native_line_id pour fournir l’ID LINE de l’utilisateur. Pour en savoir plus sur native_line_id, consultez Configuration utilisateur.

Étape 2 : Intégrer le canal LINE

Une fois le processus d’intégration terminé, Braze récupère automatiquement les abonnés LINE de ce canal dans Braze. Pour tous les identifiants LINE déjà associés à un profil utilisateur Braze, chaque profil est mis à jour avec le statut « subscribed », et tous les identifiants LINE restants génèrent des utilisateurs anonymes. De plus, les nouveaux abonnés de votre canal LINE voient des profils utilisateur non identifiés créés lorsqu’ils s’abonnent au canal.

Étape 2.1 : Modifier les paramètres du webhook

  1. Dans LINE, accédez à l’onglet Messaging API et modifiez vos Webhook settings :
    • Définissez l’URL du webhook sur https://anna.braze.com/line/events.
      • Braze changera automatiquement cette URL lors de l’intégration, en fonction du cluster de votre tableau de bord.
    • Activez Use webhook et Webhook redelivery.

      Page des paramètres de webhook pour vérifier ou modifier l'URL du webhook, avec activation ou désactivation de « Use webhook », « Webhook redelivery » et « Error statistics aggregation ».
  2. Prenez note des informations suivantes dans l’onglet Providers :
Type d’information Emplacement
ID du fournisseur Sélectionnez votre fournisseur, puis accédez à Settings > Basic information
ID du canal Sélectionnez votre fournisseur, puis accédez à Channels > votre canal > Basic settings
Secret du canal Sélectionnez votre fournisseur, puis accédez à Channels > votre canal > Basic settings.
Jeton d’accès du canal Sélectionnez votre fournisseur, puis accédez à Channels > votre canal > Messaging API. S’il n’y a pas de jeton d’accès au canal, sélectionnez Issue.
  1. Accédez à votre page Settings > Response settings et effectuez les opérations suivantes :
    • Désactivez Greeting message. Cela peut être géré dans Braze en déclenchant un message lors de l’abonnement.
    • Désactivez Auto-response messages. Tous les messages déclenchés doivent passer par Braze. Cela ne vous empêchera pas d’envoyer directement depuis la console LINE.
    • Activez Webhooks.

Page des paramètres de réponse avec des bascules pour définir comment votre compte gère les discussions.

Étape 2.2 : Générer des groupes d’abonnement LINE dans Braze

Braze crée un groupe d’abonnement pour chaque canal LINE que vous intégrez. Pour comprendre le fonctionnement des groupes d’abonnement LINE, consultez Groupes d’abonnement LINE.

  1. Accédez à la page des partenaires technologiques Braze pour LINE et saisissez les informations que vous avez notées depuis l’onglet Providers de LINE :
    • ID du fournisseur
    • ID du canal
    • Secret du canal
    • Jeton d’accès du canal

Si vous souhaitez ajouter une liste blanche d’adresses IP dans votre compte LINE, ajoutez toutes les adresses IP répertoriées pour votre cluster dans Liste d’autorisation d’adresses IP à votre liste d’autorisation.

Page d'intégration de la messagerie LINE avec la section d'intégration LINE.

  1. Après la connexion, Braze génère automatiquement un groupe d’abonnement Braze pour chaque intégration LINE ajoutée avec succès à votre espace de travail.

    Toute modification de votre liste d’abonnés (comme de nouveaux abonnés ou des désabonnements) sera automatiquement transmise à Braze.

Section des groupes d'abonnement LINE affichant un groupe d'abonnement pour le canal « LINE ».

Étape 3 : Réconcilier les ID utilisateur

Combinez les ID LINE de vos utilisateurs avec leurs profils utilisateur Braze existants en suivant les étapes décrites dans Réconciliation des ID utilisateur.

Étape 4 : Modifier vos méthodes de mise à jour des utilisateurs

En supposant que vous disposez déjà d’une méthode pour fournir des mises à jour utilisateur à Braze, vous devrez la mettre à jour pour inclure le nouveau champ native_line_id afin que les mises à jour utilisateur ultérieures envoyées à Braze incluent ce champ.

Des profils utilisateur non identifiés avec un native_line_id peuvent exister dans Braze, créés dans le cadre du processus de synchronisation du statut d’abonnement, ou lorsqu’un nouvel abonné a suivi votre canal.

Lorsqu’un utilisateur LINE est identifié dans votre application via la réconciliation des utilisateurs ou par d’autres moyens, vous pouvez cibler un profil utilisateur potentiellement non identifié dans Braze en utilisant l’endpoint /users/identify. Chaque profil utilisateur non identifié avec un native_line_id possède également un alias d’utilisateur line_id qui peut être utilisé pour cibler le profil utilisateur à identifier.

Voici un exemple de payload pour /users/identify qui cible un profil utilisateur non identifié par l’alias d’utilisateur line_id :

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

Si aucun profil utilisateur existant ne correspond à l’external_id fourni, celui-ci sera ajouté au profil utilisateur non identifié, le rendant ainsi identifié. Si un profil utilisateur existe déjà pour l’external_id, tous les attributs qui sont exclusivement sur le profil utilisateur non identifié seront copiés vers le profil utilisateur connu, y compris native_line_id et le statut d’abonnement de l’utilisateur.

Vous pouvez mettre à jour les utilisateurs LINE connus dans votre application via l’endpoint /users/track en transmettant leurs identifiants externes et native_line_id. Si un profil utilisateur non identifié existe déjà pour un utilisateur et que le même native_line_id est ajouté à un profil utilisateur différent via /users/track, il héritera de tous les états d’abonnement du profil utilisateur non identifié. Cependant, des profils utilisateur en double existeront avec le même native_line_id. Toute mise à jour d’abonnement ultérieure provenant de mises à jour d’événements mettra à jour tous les profils en conséquence.

Voici un exemple de payload pour /users/track qui met à jour un profil utilisateur par l’ID externe d’utilisateur pour ajouter un native_line_id :

1
2
3
4
5
6
7
8
9

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

Étape 5 : Fusionner les profils (facultatif)

Comme décrit précédemment dans cette section, il est possible que plusieurs profils utilisateur existent avec le même native_line_id. Si vos méthodes de mise à jour créent des profils utilisateur en double, vous pouvez fusionner les profils utilisateur non identifiés avec les profils utilisateur identifiés à l’aide de l’endpoint /user/merge.

Voici un exemple de payload pour /users/merge qui cible un profil utilisateur non identifié par alias d’utilisateur line_id :

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

Configuration des utilisateurs

LINE est la source de référence pour les états d’abonnement des utilisateurs. Même si vous disposez de l’ID LINE d’un utilisateur (native_line_id), si cet utilisateur n’a pas suivi le canal LINE depuis lequel vous envoyez, LINE ne lui distribuera pas les messages.

Pour faciliter cette gestion, Braze propose des outils et une logique qui prennent en charge une base d’utilisateurs bien intégrée, notamment la synchronisation des abonnements et les mises à jour d’événements pour les suivis et désabonnements LINE.

Synchronisation des abonnements et logique événementielle

Pour savoir comment l’outil de synchronisation des abonnements et les mises à jour d’événements de suivi et de désabonnement maintiennent le statut d’abonnement LINE aligné avec Braze, consultez Statut d’abonnement.

Réintégrer un canal LINE dans un autre espace de travail

Pour utiliser un canal LINE dans un autre espace de travail Braze :

  1. Dans l’espace de travail d’origine, archivez le groupe d’abonnement de ce canal.
  2. Dans l’espace de travail cible, intégrez le canal en suivant l’étape 2 : intégrer le canal LINE.

Vérifiez que vous disposez de la permission Manage Subscription Groups dans les deux espaces de travail. Sans les permissions dans les deux espaces de travail, l’intégration échoue avec une erreur indiquant que le canal est déjà connecté.

Pour savoir comment l’archivage affecte les groupes d’abonnement, consultez Groupes d’abonnement LINE.

Cas d’usage

Voici les cas d’usage illustrant comment les utilisateurs peuvent être mis à jour après avoir suivi les étapes de configuration.

Un profil utilisateur Braze existant suit déjà le canal LINE

  1. Le profil utilisateur Braze est mis à jour avec un attribut native_line_id. Son statut d’abonnement par défaut est unsubscribed.
  2. L’outil de synchronisation des abonnements est exécuté, détecte que l’utilisateur suit le canal LINE, puis met à jour le profil utilisateur avec le statut d’abonnement subscribed.
  3. Si un changement de statut d’abonnement survient (par exemple, l’utilisateur bloque, supprime de ses amis ou se réabonne au canal), Braze reçoit la mise à jour de LINE et met à jour le profil utilisateur avec le native_line_id en conséquence.

Un profil utilisateur existant a bloqué, supprimé ou ne suit plus le canal LINE

  1. Le profil utilisateur Braze est mis à jour avec un attribut native_line_id. Son statut d’abonnement par défaut est unsubscribed.
  2. L’outil de synchronisation des abonnements ne détecte pas que l’utilisateur suit le canal LINE et le statut d’abonnement de l’utilisateur reste unsubscribed.
  3. Si l’utilisateur suit le canal ultérieurement, Braze reçoit la mise à jour de LINE et met à jour le profil utilisateur avec le statut d’abonnement subscribed.

La création du profil utilisateur intervient après l’abonnement LINE

  1. Le canal reçoit un nouvel abonné LINE.
  2. Braze crée un profil utilisateur anonyme avec l’attribut native_line_id défini sur l’ID LINE de l’abonné, ainsi qu’un alias d’utilisateur line_id défini sur l’ID LINE de l’abonné. Le profil a un statut d’abonnement subscribed.
  3. L’utilisateur est identifié comme possédant l’ID LINE via la réconciliation des utilisateurs. 
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"
           }
       }
   ]
}
  • Un nouveau profil utilisateur peut être créé (via l’endpoint /users/track, l’import CSV ou l’ingestion de données cloud) en définissant le native_line_id. Ce nouveau profil héritera de l’état du statut d’abonnement du profil utilisateur anonyme existant. Notez que cela entraînera la présence de plusieurs profils partageant le même native_line_id. Ceux-ci peuvent être fusionnés à tout moment à l’aide de l’endpoint /users/merge selon le processus décrit dans l’Étape 5.

La création du profil utilisateur intervient avant l’abonnement LINE

  1. Vous acquérez un nouvel utilisateur et envoyez les informations à Braze. Un nouveau profil utilisateur est créé (profil 1).
  2. L’utilisateur suit votre compte LINE.
  3. Braze reçoit un événement d’abonnement et crée un profil utilisateur anonyme (profil 2).
  4. L’utilisateur est identifié comme possédant l’ID LINE via la réconciliation des utilisateurs.
  5. Vous mettez à jour le profil 1 pour définir l’attribut native_line_id. Ce profil hérite de l’état du statut d’abonnement du profil 2.
    • Il y a désormais deux profils utilisateur avec le même native_line_id. Ceux-ci peuvent être fusionnés à tout moment à l’aide de l’endpoint /users/merge selon le processus décrit dans l’Étape 5.

Réconciliation des ID utilisateur

Les ID LINE sont automatiquement reçus par Braze lorsqu’un utilisateur suit votre canal, ou lorsque vous utilisez le flux de travail ponctuel « synchroniser les abonnés ». Les ID LINE sont également spécifiques au canal que les utilisateurs suivent, il est donc peu probable que les utilisateurs puissent fournir leurs ID LINE.

Il existe deux façons de combiner un ID LINE avec un profil utilisateur Braze existant :

LINE Login

Cette méthode utilise les connexions via les réseaux sociaux pour la réconciliation. Lorsqu’un utilisateur se connecte à votre application, il a la possibilité d’utiliser LINE Login pour créer un compte utilisateur ou se connecter.

  1. Accédez à la console LINE Developer et demandez l’autorisation d’obtenir les adresses e-mail des utilisateurs qui se connectent à votre application via LINE Login.

  2. Suivez les étapes appropriées fournies par LINE pour implémenter LINE Login :

  1. Utilisez l’appel Verify ID token pour obtenir l’adresse e-mail de l’utilisateur.

  2. Enregistrez l’ID LINE de l’utilisateur (native_line_id) dans le profil de l’utilisateur avec un e-mail correspondant dans votre base de données, ou créez un nouveau profil utilisateur avec l’e-mail et l’ID LINE de l’utilisateur.

  3. Envoyez les informations utilisateur nouvelles ou mises à jour à Braze en utilisant l’endpoint /user/track, l’import CSV ou l’ingestion de données cloud.

Flux de travail

Un abonné existant utilise LINE Login

Scénario : Un utilisateur anonyme a été créé lors de la synchronisation initiale des abonnés ou après l’intégration via un événement « follow ».

  1. L’utilisateur se connecte à votre application via LINE Login.
  2. LINE vous fournit l’adresse e-mail de l’utilisateur.
  3. Vous envoyez à Braze l’utilisateur mis à jour (le profil utilisateur existant avec cet e-mail pour ajouter l’ID LINE) ou vous mettez à jour l’utilisateur anonyme avec l’e-mail.
Un nouvel abonné utilise LINE Login

Scénario : Aucun profil utilisateur n’existe dans Braze avec l’ID LINE de l’utilisateur.

  1. L’utilisateur se connecte à votre application via LINE Login.
  2. LINE vous fournit l’adresse e-mail de l’utilisateur.
  3. Vous pouvez soit :
    • Mettre à jour un profil utilisateur existant avec cet e-mail pour y ajouter également l’ID LINE de l’utilisateur.
    • Créer un nouveau profil utilisateur avec l’e-mail et l’ID LINE.
  4. Lorsque l’utilisateur suit votre compte officiel LINE, Braze reçoit un événement « follow » et met à jour le statut d’abonnement de l’utilisateur à subscribed.

Liaison de compte utilisateur

Cette méthode permet aux utilisateurs de lier leur compte LINE au compte utilisateur de votre application. Vous pouvez ensuite utiliser Liquid dans Braze, comme {{line_id}}, pour créer une URL personnalisée pour l’utilisateur qui renvoie l’ID LINE de l’utilisateur vers votre site web ou application, où il peut ensuite être associé à un utilisateur connu.

  1. Créez un Canvas basé sur une action qui se déclenche lors d’un changement d’état d’abonnement lorsqu’un utilisateur s’abonne à votre canal LINE.
    Canvas qui se déclenche lorsqu'un utilisateur s'abonne au canal LINE.
  2. Créez un message incitant les utilisateurs à se connecter à votre site web ou application, en transmettant l’ID LINE de l’utilisateur comme paramètre de requête (via Liquid), par exemple :
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. Créez un message de suivi qui fournit le code de réduction.
  2. (Facultatif) Créez une Campaign ou un Canvas basé sur une action qui se déclenche lorsque l’utilisateur LINE est identifié pour lui envoyer son code de réduction.
    Campaign basée sur une action qui se déclenche lorsque l'utilisateur LINE est identifié.

Fonctionnement

Après la connexion de l’utilisateur, une modification est effectuée sur votre site web ou application afin que l’ID utilisateur soit renvoyé à Braze pour l’associer à l’ID LINE transmis dans l’URL, avec un code d’exemple tel que :

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");
}

Flux de travail

Un utilisateur existant suit votre canal LINE

Scénario : Un utilisateur existant dans Braze suit votre canal sur LINE.

  1. LINE envoie un événement « follow » à Braze.
  2. Braze crée un profil utilisateur anonyme avec l’ID LINE, l’alias d’utilisateur line_id et le statut du groupe d’abonnement LINE défini sur subscribed.
  3. L’utilisateur reçoit un message LINE avec un lien vers votre site web et votre application, et se connecte. Son profil utilisateur est désormais connu.
  4. Le profil utilisateur anonyme qui a été créé est identifié et fusionné via l’endpoint /users/identify avec le profil utilisateur connu de l’utilisateur. Le profil utilisateur connu contient désormais l’ID LINE et a un statut d’abonnement subscribed.
  5. (Facultatif) L’utilisateur reçoit un message LINE avec le code de réduction et Braze enregistre l’envoi dans le profil utilisateur Braze.

Créer des utilisateurs test LINE dans Braze

Vous pouvez tester votre canal LINE avant de configurer la réconciliation des utilisateurs en créant un Canvas ou une Campaign « Qui suis-je ».

  1. Configurez un Canvas qui renvoie l’ID utilisateur Braze d’un utilisateur en réponse à un mot déclencheur spécifique.

    Exemple de déclencheur

    Déclencheur pour envoyer la Campaign aux utilisateurs qui ont envoyé un message LINE entrant à un groupe d'abonnement spécifique.

    Exemple de message

    Message LINE indiquant l'ID utilisateur Braze.

  2. Dans Braze, vous pouvez utiliser l’ID Braze pour rechercher des utilisateurs spécifiques et les modifier selon vos besoins.
New Stuff!