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 :

• Compte professionnel LINE
• Statut de compte premium ou vérifié (nécessaire pour synchroniser les abonnés existants)
  • Consultez les directives relatives aux comptes LINE
• Compte développeur LINE
• Canal API de messagerie LINE

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

Remarque

Définir native_line_id : Vous pouvez définir native_line_id en envoyant des mises à jour utilisateur à Braze (par exemple, avec l’endpoint /users/track, l’import CSV ou l’ingestion de données cloud). Si votre SDK côté client ne dispose pas d’un champ dédié pour native_line_id, envoyez-le dans les mises à jour utilisateur côté serveur en utilisant l’une de ces méthodes.

Types de comptes 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é

Important

Les comptes vérifiés sont uniquement disponibles pour les comptes basés au Japon, à Taïwan, en Thaïlande et en Indonésie.

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 avec les résultats de l’examen.

Intégrer LINE

Pour configurer des mises à jour utilisateur cohérentes, importer les LINE ID des utilisateurs existants et les synchroniser avec les statuts 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

Remarque

Vous ne pouvez avoir qu’un seul compte LINE dans un même espace de travail. Si vous avez plusieurs comptes LINE, nous vous recommandons d’utiliser chacun d’entre eux dans un espace de travail différent.

É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, ignorez cette étape.

Vous pouvez importer ou mettre à jour les utilisateurs en utilisant l’une des méthodes prises en charge par Braze, notamment l’endpoint /users/track, l’import 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 la section Configuration utilisateur.

Remarque

Le statut du groupe d’abonnement ne doit pas être spécifié et sera ignoré. LINE est la source de vérité pour le statut d’abonnement des utilisateurs, qui sera synchronisé avec Braze soit par l’outil de synchronisation des abonnements, soit par les mises à jour d’événements.

Étape 2 : Intégrer le canal LINE

Une fois le processus d’intégration terminé, Braze récupérera automatiquement les abonnés LINE de ce canal dans Braze. Pour tous les ID LINE déjà associés à un profil utilisateur Braze, chaque profil sera mis à jour avec le statut « subscribed », et les ID LINE restants généreront des utilisateurs anonymes. De plus, les nouveaux abonnés de votre canal LINE auront des profils utilisateur non identifiés créés lorsqu’ils s’abonneront 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.
     
     
2. Prenez note des informations suivantes dans l’onglet Providers :

Remarque

Vous pouvez mettre à jour ou renouveler le channel secret et le channel access token pour un canal LINE déjà intégré en accédant à Partner Integrations > Technology Partners > LINE et en sélectionnant votre intégration.

3. Accédez à votre page Settings > Response settings et effectuez les actions 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.

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

Remarque

Vous pouvez ajouter jusqu’à 450 groupes d’abonnement par espace de travail.

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 :
   • Provider ID
   • Channel ID
   • Channel secret
   • Channel access token

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 la section Liste d’adresses IP autorisées à votre liste autorisée.

Important

Lors de l’intégration, assurez-vous de vérifier que votre channel secret est correct. S’il est incorrect, il peut y avoir des incohérences dans le statut d’abonnement.

2. Après la connexion, Braze générera 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.

É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 exclusivement présents 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, celui-ci héritera de tous les statuts 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.

Remarque

Les statuts d’abonnement LINE sont suivis par native_line_id, et non par external_id. Par exemple, si le profil utilisateur de l’Utilisateur B est créé avec le même native_line_id que l’Utilisateur A, mais pas le même external_id, l’Utilisateur B hérite du statut d’abonnement LINE de l’Utilisateur A.

Voici un exemple de payload pour /users/track qui met à jour un profil utilisateur par l’ID externe 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 l’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"
     }
   }
 ]
}

Conseil

Pour en savoir plus sur la gestion des utilisateurs en double dans Braze, consultez Utilisateurs en double.

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 des événements

Pour comprendre 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 espace de travail Braze différent :

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 des 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é de ses amis 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 a lieu 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é, et 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.
   • Le profil utilisateur anonyme peut être identifié à l’aide de l’endpoint /users/identify. Les mises à jour ultérieures (via l’endpoint /users/track, l’import CSV ou l’ingestion de données cloud) de ce profil utilisateur peuvent cibler l’utilisateur par cet external_id connu.

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 du statut d’abonnement du profil utilisateur anonyme existant. Notez que cela entraînera 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 à l’étape 5.

La création du profil utilisateur a lieu 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 du statut d’abonnement du profil 2.
   • Il existe 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 à 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 workflow ponctuel de « synchronisation des 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
• Liaison de compte utilisateur

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.

Remarque

Pour obtenir l’ID LINE correct de chaque utilisateur, configurez LINE Login sous le même fournisseur que votre compte ou canal officiel LINE intégré à Braze.

1. Accédez à la console développeur 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 appropriées fournies par LINE pour implémenter LINE Login :
   
   

   • Instructions pour les applications web
   • Instructions pour les applications natives
     
     Assurez-vous d’inclure email dans la configuration du scope pour les requêtes de vérification.

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

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

5. 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.

Workflows

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 en utilisant 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 cette adresse e-mail pour y ajouter l’ID LINE) ou vous mettez à jour l’utilisateur anonyme avec l’adresse 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 en utilisant LINE Login.
2. LINE vous fournit l’adresse e-mail de l’utilisateur.
3. Vous pouvez soit :
   • Mettre à jour un profil utilisateur existant avec cette adresse e-mail pour y ajouter également l’ID LINE de l’utilisateur.
   • Créer un nouveau profil utilisateur avec l’adresse 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 transmet l’ID LINE de l’utilisateur à 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 de statut d’abonnement et qui se lance lorsqu’un utilisateur s’abonne à votre 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=

3. Créez un message de suivi qui délivre le code de réduction.
4. (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.
   

Fonctionnement

Une fois que l’utilisateur s’est connecté, 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 exemple de code 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");
}

Workflows

Un utilisateur existant suit votre canal LINE

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

1. LINE envoie à Braze un événement « follow ».
2. Braze crée un profil utilisateur anonyme avec l’ID LINE, l’alias d’utilisateur line_id et un statut de groupe d’abonnement LINE de 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 de 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
   
   
   
   Exemple de message
   
   
   
   

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

Important

Assurez-vous que le Canvas ne comporte pas de contrôle global ni de groupes de contrôle empêchant les envois.