Passer au contenu

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.

Conditions préalables

Pour intégrer LINE à Braze, vous aurez besoin des éléments suivants :

L’envoi de messages LINE depuis Braze consomme les crédits de message ou d’action de votre compte.

Types de comptes LINE

Type de compte Description
Compte non vérifié Un compte non examiné que tout le monde peut obtenir (particulier ou entreprise). Ce compte est représenté par un badge gris et n’apparaît pas dans les résultats de recherche de l’application LINE.
Compte vérifié Un compte qui a passé l’examen de LINE Yahoo. Ce compte est représenté par un badge bleu et apparaît dans les résultats de recherche de l’application LINE.

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

Type de compte requis

Pour synchroniser vos abonnés dans Braze, votre compte LINE doit être vérifié ou premium. Lorsque vous créez un compte, son statut par défaut est non vérifié. Vous devrez donc 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 la notification contenant les résultats de l’examen.

Intégrer LINE

Pour mettre en place des mises à jour cohérentes des utilisateurs, récupérer les ID LINE des utilisateurs existants et les synchroniser avec les statuts d’abonnement de LINE :

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

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

Cette étape est nécessaire si vous disposez déjà d’un utilisateur LINE identifié : Braze récupérera ensuite automatiquement son statut d’abonnement et mettra à jour le bon profil utilisateur. Si vous n’avez pas encore rapproché vos utilisateurs de leur ID LINE, passez cette étape.

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

Quelle que soit la méthode utilisée, renseignez l’ID LINE de l’utilisateur dans native_line_id. Pour en savoir plus sur native_line_id, consultez la section Configuration des utilisateurs.

Étape 2 : Intégrer le canal LINE

Une fois l’intégration terminée, Braze importe automatiquement les abonnés LINE de ce canal. Pour les ID LINE déjà associés à un profil utilisateur Braze, chaque profil est mis à jour avec le statut « abonné ». Les ID LINE restants génèrent des utilisateurs anonymes. De plus, un profil utilisateur non identifié est créé pour chaque nouvel abonné qui suit votre canal LINE.

É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 remplacera 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 du webhook permettant de vérifier ou de modifier l’URL du webhook et d’activer ou désactiver « Use webhook », « Webhook redelivery » et « Error statistics aggregation ».
  2. Notez les 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 au canal Sélectionnez votre fournisseur, puis accédez à Channels > votre canal > Messaging API. S’il n’existe pas de jeton d’accès au canal, sélectionnez Issue.
  1. Accédez à votre page Settings > Response settings et procédez comme suit :
    • Désactivez Greeting message. Vous pouvez gérer ce message dans Braze avec un déclencheur basé sur l’abonnement au canal.
    • Désactivez Auto-response messages. Tous les messages déclenchés doivent passer par Braze. Cela ne vous empêche pas d’envoyer des messages directement depuis la console LINE.
    • Activez Webhooks.

Page des paramètres de réponse avec des boutons pour définir la façon dont votre compte gère les discussions.

Étape 2.2 : Générer les 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 Partenaires technologiques de Braze pour LINE et saisissez les informations notées dans l’onglet Providers de LINE :
    • ID du fournisseur
    • ID du canal
    • Secret du canal
    • Jeton d’accès au canal

Si vous souhaitez configurer une liste d’autorisation IP dans votre compte LINE, ajoutez-y toutes les adresses IP indiquées pour votre cluster dans Liste d’autorisation IP.

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

  1. Une fois la connexion établie, 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 (nouveaux abonnés ou désabonnements, par exemple) est automatiquement transmise à Braze.

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

Étape 3 : Rapprocher les ID utilisateur

Associez les ID LINE de vos utilisateurs à leurs profils utilisateurs Braze existants en suivant les étapes de la section Rapprochement des ID utilisateur.

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

Si vous disposez déjà d’une méthode pour envoyer des mises à jour d’utilisateurs à Braze, vous devez la modifier pour y inclure le nouveau champ native_line_id. Les mises à jour d’utilisateurs envoyées ensuite à Braze contiendront ainsi ce champ.

Des profils utilisateurs non identifiés avec un native_line_id peuvent exister dans Braze. Ils ont été créés lors du processus de synchronisation du statut d’abonnement ou lorsqu’un nouvel abonné a suivi votre chaîne.

Lorsqu’un utilisateur LINE est identifié dans votre application grâce au rapprochement des utilisateurs ou par un autre moyen, vous pouvez cibler un éventuel profil utilisateur non identifié dans Braze à l’aide de l’endpoint /users/identify. Chaque profil utilisateur non identifié avec un native_line_id possède également un alias d’utilisateur line_id, qui permet de cibler le profil utilisateur à identifier.

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

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

S’il n’existe aucun profil utilisateur pour l’external_id fourni, celui-ci est ajouté au profil utilisateur non identifié, qui devient alors identifié. Si un profil utilisateur existe déjà pour cet external_id, tous les attributs présents uniquement sur le profil utilisateur non identifié sont copiés vers le profil utilisateur connu, y compris le 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 leur 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 autre profil utilisateur via /users/track, ce dernier hérite de tous les états d’abonnement du profil utilisateur non identifié. Des profils utilisateurs en double existeront toutefois avec le même native_line_id. Toutes les mises à jour d’abonnement ultérieures issues des événements mettront à jour l’ensemble de ces profils.

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

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

Étape 5 : Fusionner les profils (facultatif)

Comme indiqué plus haut dans cette section, plusieurs profils utilisateurs peuvent exister avec le même native_line_id. Si vos méthodes de mise à jour créent des profils utilisateurs en double, vous pouvez fusionner les profils utilisateurs non identifiés avec les profils utilisateurs identifiés à l’aide de l’endpoint /user/merge.

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

{
 "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 fait autorité pour les statuts d’abonnement des utilisateurs. Même si vous disposez de l’ID LINE d’un utilisateur (native_line_id), LINE ne lui distribuera pas de messages s’il ne suit pas la chaîne LINE à partir de laquelle vous envoyez.

Pour vous aider à gérer cela, Braze propose des outils et une logique qui favorisent une base d’utilisateurs bien intégrée, notamment la synchronisation des abonnements et la mise à jour des événements lorsque des utilisateurs suivent ou ne suivent plus votre chaîne LINE.

Synchronisation des abonnements et logique des événements

Pour découvrir comment l’outil de synchronisation des abonnements et la mise à jour des événements de suivi et d’arrêt de suivi maintiennent l’alignement du statut d’abonnement LINE avec Braze, consultez la section 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 l’autorisation Gérer les groupes d’abonnement dans les deux espaces de travail. Sans ces autorisations dans les deux espaces de travail, l’intégration échoue et une erreur indique 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 quelques cas d’usage illustrant comment les utilisateurs peuvent être mis à jour une fois les étapes de configuration terminées.

Le profil utilisateur Braze existant suit déjà la chaîne 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 s’exécute, détecte que l’utilisateur suit la chaîne LINE, puis met à jour le profil utilisateur avec le statut d’abonnement subscribed.
  3. En cas de changement de statut d’abonnement (par exemple si l’utilisateur bloque la chaîne, la retire de ses amis ou la suit à nouveau), Braze reçoit la mise à jour de LINE et met à jour le profil utilisateur associé au native_line_id en conséquence.

Le profil utilisateur existant a bloqué la chaîne LINE, l’a retirée de ses amis ou a cessé de la suivre

  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 la chaîne LINE, et le statut d’abonnement de l’utilisateur reste unsubscribed.
  3. Si l’utilisateur suit la chaîne ultérieurement, Braze reçoit la mise à jour de LINE et met à jour le profil utilisateur avec le statut d’abonnement subscribed.

Le profil utilisateur est créé après l’abonnement à LINE

  1. La chaîne obtient un nouvel abonné LINE.
  2. Braze crée un profil utilisateur anonyme dont l’attribut native_line_id correspond à l’ID LINE de l’abonné, ainsi qu’un alias d’utilisateur line_id correspondant également à l’ID LINE de l’abonné. Le profil a le statut d’abonnement subscribed.
  3. L’utilisateur est identifié comme possédant l’ID LINE grâce au rapprochement des utilisateurs.
{
   "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’importation CSV ou l’ingestion de données cloud) en définissant le native_line_id. Ce nouveau profil hérite du statut d’abonnement du profil utilisateur anonyme existant. Notez que plusieurs profils partageront alors le même native_line_id. Vous pouvez les fusionner à tout moment à l’aide de l’endpoint /users/merge, en suivant le processus décrit à l’étape 5.

Le profil utilisateur est créé avant l’abonnement à LINE

  1. Vous acquérez un nouvel utilisateur et envoyez ses 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 grâce au rapprochement des utilisateurs.
  5. Vous mettez à jour le profil 1 pour définir l’attribut native_line_id. Ce profil hérite du statut d’abonnement du profil 2.
    • Deux profils utilisateurs partagent désormais le même native_line_id. Vous pouvez les fusionner à tout moment à l’aide de l’endpoint /users/merge, en suivant le processus décrit à l’étape 5.

Rapprochement des ID utilisateur

Braze reçoit automatiquement les ID LINE lorsqu’un utilisateur suit votre canal ou lorsque vous utilisez le flux unique de « synchronisation des abonnés ». Les ID LINE sont propres au fournisseur LINE : il est donc peu probable que les utilisateurs puissent fournir eux-mêmes leur ID LINE.

Vous pouvez associer un ID LINE à un profil utilisateur Braze existant de deux façons :

LINE Login

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

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

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

  1. Utilisez l’appel de vérification du jeton d’ID pour obtenir l’e-mail de l’utilisateur.

  2. Enregistrez l’ID LINE de l’utilisateur (native_line_id) dans le profil de l’utilisateur correspondant à cet e-mail 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 nouvelles ou mises à jour de l’utilisateur à Braze à l’aide de l’endpoint /user/track, de l’importation CSV ou de 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 avec LINE Login.
  2. LINE vous fournit l’e-mail de l’utilisateur.
  3. Vous envoyez à Braze l’utilisateur mis à jour (le profil utilisateur existant associé à cet e-mail, auquel vous ajoutez 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 avec LINE Login.
  2. LINE vous fournit l’e-mail de l’utilisateur.
  3. Vous pouvez alors :
    • Mettre à jour un profil utilisateur existant associé à cet e-mail pour y ajouter 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 sur subscribed.

Liaison de comptes utilisateurs

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

  1. Créez un Canvas basé sur l’action, reposant sur un changement d’état d’abonnement et qui se déclenche 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 à votre application, en transmettant l’ID LINE de l’utilisateur comme paramètre de requête (via Liquid), par exemple :
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 envoie le code promo.
  2. (Facultatif) Créez une Campaign ou un Canvas basé sur l’action qui se déclenche lorsque l’utilisateur LINE est identifié, afin de lui envoyer son code promo.
    Campaign basée sur l’action qui se déclenche lorsque l’utilisateur LINE est identifié.

Comment cela fonctionne-t-il ?

Une fois l’utilisateur connecté, une modification est apportée à votre site web ou à votre application afin que l’ID utilisateur soit renvoyé à Braze pour l’associer à l’ID LINE transmis dans l’URL, avec un exemple de code tel que :

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 subscribed.
  3. L’utilisateur reçoit un message LINE contenant un lien vers votre site web et votre application, puis se connecte. Son profil utilisateur est désormais connu.
  4. Le profil utilisateur anonyme créé est identifié et fusionné, via l’endpoint /users/identify, avec le profil utilisateur connu. Ce dernier contient désormais l’ID LINE et présente le statut d’abonnement subscribed.
  5. (Facultatif) L’utilisateur reçoit un message LINE contenant le code promo, 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 campagne « Qui suis-je ».

  1. Configurez un Canvas qui renvoie l’ID utilisateur Braze d’un utilisateur lorsqu’il envoie un mot déclencheur spécifique.

    Exemple de déclencheur

    Déclencheur pour envoyer la campagne aux utilisateurs ayant 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 si nécessaire.

New Stuff!