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

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 est 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égration de LINE

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

1. Importer ou mettre à jour les utilisateurs LINE existants
2. Intégrer le canal LINE
3. Réconcilier les ID utilisateur
4. Modifier les méthodes de mise à jour utilisateur
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 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 état d’abonnement et mettra à jour le profil utilisateur correspondant. Si vous n’avez pas encore réconcilié les utilisateurs avec leur ID LINE, passez cette étape.

Vous pouvez importer ou mettre à jour les utilisateurs en utilisant l’une des méthodes prises en charge par Braze, y compris 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 native_line_id pour fournir l’ID LINE de l’utilisateur. Pour en savoir plus sur le native_line_id, consultez Configuration des utilisateurs.

Remarque

L’état 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 « abonné », et tous 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 suivront le 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 de votre cluster de tableau de bord.
   • Activez Use webhook et Webhook redelivery.
     
     
2. Notez les informations suivantes dans l’onglet Providers :

3. Accédez à votre page Settings > Response settings et procédez comme suit :
   • Désactivez Greeting message. Cela peut être géré dans Braze via un déclencheur lors du suivi.
   • 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 les groupes d’abonnement LINE dans Braze

Remarque

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

1. Accédez à la page Partenaires technologiques de 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 au 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 IP à votre liste d’autorisation.

Important

Lors de l’intégration, assurez-vous de vérifier que votre secret de canal 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 de la section Réconciliation des ID utilisateur.

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

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 utilisateur ou d’autres moyens, vous pouvez cibler un profil utilisateur non identifié potentiel 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, il sera ajouté au profil utilisateur non identifié, le rendant identifié. Si un profil utilisateur existe 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.

Remarque

Les états 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 utilisateur 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 ci-dessus, 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 vérité 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 délivrera pas de messages.

Pour faciliter la gestion, Braze propose des outils et une logique qui prennent en charge une base d’utilisateurs bien intégrée, y compris 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

1. Outil de synchronisation des abonnements : Cet outil est automatiquement déployé après une intégration réussie du canal LINE. Utilisez-le pour mettre à jour les profils existants et créer de nouveaux profils.
   
   Tous les profils utilisateur Braze qui ont un native_line_id suivant le canal LINE seront mis à jour avec un statut de groupe d’abonnement subscribed. Tout abonné du canal LINE qui n’a pas de profil utilisateur Braze avec le native_line_id aura :
   
   - Un profil utilisateur anonyme créé avec native_line_id défini sur l’ID LINE de l’utilisateur suivant le canal
   - Un alias d’utilisateur line_id défini sur l’ID LINE de l’utilisateur suivant le canal
   - Un statut de groupe d’abonnement subscribed

2. Mises à jour d’événements : Elles sont utilisées pour mettre à jour le statut d’abonnement d’un utilisateur. Lorsque Braze reçoit des mises à jour d’événements utilisateur pour le canal LINE intégré et que l’événement est un suivi, le profil utilisateur aura un statut de groupe d’abonnement subscribed. Si l’événement est un désabonnement, le profil utilisateur aura un statut de groupe d’abonnement unsubscribed.
   
   - Tous les profils utilisateur Braze avec un native_line_id correspondant seront automatiquement mis à jour.
   - Si aucun profil utilisateur correspondant n’existe pour un événement, Braze créera un utilisateur anonyme.

Cas d’utilisation

Voici des cas d’utilisation montrant comment les utilisateurs peuvent être mis à jour après avoir suivi les étapes de configuration ci-dessus.

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 des changements de statut d’abonnement surviennent (comme le blocage, la suppression d’ami ou le réabonnement au canal par l’utilisateur), 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 ultérieurement le canal, 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 le suivi LINE

1. Le canal obtient 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 utilisateur.
   • Le profil utilisateur anonyme peut être identifié en utilisant 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 de l’état d’abonnement du profil utilisateur anonyme existant. Notez que cela entraînera l’existence de plusieurs profils partageant le même native_line_id. Ceux-ci peuvent être fusionnés à tout moment en utilisant l’endpoint /users/merge dans le processus décrit à l’étape 5.

La création du profil utilisateur intervient avant le suivi 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 de suivi et crée un profil utilisateur anonyme (profil 2).
4. L’utilisateur est identifié comme possédant l’ID LINE via la réconciliation utilisateur.
5. Vous mettez à jour le profil 1 pour définir l’attribut native_line_id. Ce profil hérite de l’état d’abonnement du profil 2.
   • Il y a maintenant deux profils utilisateur avec le même native_line_id. Ceux-ci peuvent être fusionnés à tout moment en utilisant l’endpoint /users/merge dans 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 flux de travail unique « 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 :

• Connexion LINE (LINE Login)
• Liaison de compte utilisateur

Connexion LINE (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 pour chaque utilisateur, configurez LINE Login sous le même fournisseur que votre compte officiel LINE ou canal 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 demandes de vérification.

3. Utilisez l’appel de vérification du jeton d’ID 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.

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 « suivi ».

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 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 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 de suivi 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 d’état d’abonnement et qui se déclenche 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 campagne 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

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

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 de suivi à Braze.
2. Braze crée un profil utilisateur anonyme avec l’ID LINE, l’alias d’utilisateur line_id et le statut de groupe d’abonnement LINE subscribed.
3. L’utilisateur reçoit un message LINE avec un lien vers votre site web et application et se connecte. Son profil utilisateur est maintenant 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 maintenant 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éation d’utilisateurs test LINE dans Braze

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

1. Configurez un Canvas qui renvoie l’ID utilisateur Braze d’un utilisateur sur 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 dispose pas de contrôle global ou de groupes de contrôle empêchant les envois.