LINE の設定

この記事では、BrazeでLINEチャネルを設定する方法について、ユーザーの設定方法、ユーザーIDの照合方法、BrazeでのLINEテストユーザーの作成方法などを紹介する。

前提条件

LINE と Braze を統合するには、以下が必要です。

• LINE ビジネスアカウント
• プレミアムまたは認証済みアカウントのステータス（既存のフォロワーを同期するために必要である）
  • LINE のアカウントガイドラインを見る
• LINE 開発者アカウント
• LINE メッセージング API チャネル

Braze から LINE メッセージを送信すると、アカウントのメッセージクレジットが消費されます。

LINE アカウントのタイプ

必要なアカウントタイプ

フォロワーを Braze に同期するには、LINE アカウントが認証済みかプレミアムである必要があります。アカウントを作成すると、デフォルトのステータスは「未認証」になります。アカウント認証を申請する必要があります。

認証済みLINEアカウントを申請する

1. LINE の [公式アカウント] ページで [設定] を選択します。
2. [情報の公開] の [認証ステータス]で、[アカウント認証をリクエスト] を選択します。
3. 必要な情報を入力します。
4. 審査結果の通知を待ちます。

LINEを統合する

一貫したユーザー更新を設定するには、既存ユーザーのLINE IDを引き継ぎ、LINEのサブスクリプション状態に同期させる：

1. 既存の既知ユーザーをインポートまたは更新する
2. LINEチャンネルを統合する
3. サブスクリプションステータスの同期をリクエストする
4. ユーザーの更新方法を更新する
5. (省略可) ユーザーをマージする

ステップ 1: 既存のLINEユーザーをインポートまたは更新する

Braze は LINE ユーザーのサブスクリプションステータスを後から自動的に取得して正しいユーザープロファイルを更新するので、すでに存在している識別済みの LINE ユーザーがいる場合には、このステップを行う必要があります。過去にユーザーとLINE IDを照合していない場合は、このステップをスキップする。

エンドポイント、CSVインポート、Cloud Data Ingestionなど、Brazeがサポートするどの方法でもユーザーをインポートまたは更新できる。 /users/trackエンドポイント、CSVインポート、またはCloud Data Ingestionを含む。

どの方法を使用している場合でも、ユーザーの LINE ID を提供するように native_line_id を更新します。native_line_id の詳細については、ユーザー設定を参照のこと。

ステップ2:LINEチャネルを統合する

統合プロセスが完了すると、Brazeは自動的にそのチャネルのLINEフォロワーをBrazeに取り込む。すでにユーザープロファイルに紐付いているLINE IDについては、各プロファイルのステータスが「サブスクライバー」に更新され、残っているLINE IDは匿名ユーザーとなる。さらに、あなたのLINEチャンネルの新しいフォロワーがチャンネルをフォローすると、未確認のユーザープロファイルが作成される。

ステップ 2.1:Webhook設定を編集する

1. LINE の [メッセージング API] タブで、[Webhook の設定] を編集します。
   • [Webhook URL] を [https://anna.braze.com/line/events] に設定します。
     • これは、Braze により、ダッシュボードのクラスターに基づいて、統合時に別の URL に自動的に変更されます。
   • [Webhook を使用] と [Webhook の再配信] をオンにします。
     
     
2. [プロバイダー] タブに表示される以下の情報をメモしておきます。

3.[設定] ページ > [応答設定]の順に進み、以下を実行します。

• [グリーティングメッセージ]をオフにする。これは、Braze では、トリガーオンフォロー (trigger on follow) で処理できます。
• [自動応答メッセージ] をオフにする。トリガーメッセージはすべて Braze 経由で送信されます。これにより、LINE コンソールから直接送信できなくなることはありません。
• [Webhook] をオンにする。

ステップ 2.2:BrazeでLINEサブスクリプショングループを作成する

1. LINE の Braze テクノロジーパートナーページにアクセスし、LINE の [プロバイダー] タブからメモした情報を入力します。
   • プロバイダー ID
   • チャネル ID
   • チャネルシークレット
   • チャネルアクセストークン

2.接続後、Brazeによって、ワークスペースに正常に追加された LINE 統合ごとに Braze サブスクリプショングループが自動的に生成されます。

フォロワーリストの変更 (新しいフォロワーやフォロー解除など) は、自動的に Braze にプッシュされます。

ステップ 3:ユーザーIDを照合する

ユーザー ID の照合の手順に従って、ユーザーの LINE ID と既存の Braze ユーザープロファイルを組み合わせます。

ステップ4:ユーザーの更新方法を変更する

Braze にユーザー更新を提供する方法がすでに確立されている場合、その方法を更新して新しいフィールド native_line_id を含める必要があります。これにより、Braze にその後送信されるユーザー更新にはそのフィールドが含まれるようになります。

サブスクリプションステータスの同期プロセスの一環として、または新しいフォロワーがあなたのチャネルをフォローしたときに作成された、native_line_id を持つ未確認のユーザープロファイルがBrazeに存在する可能性がある。

アプリケーションで、ユーザー照合などの方法で LINE ユーザーが識別される場合は、/users/identify エンドポイントを使用して、Braze で未確認ユーザープロファイルをターゲットに設定できます。native_line_id が含まれるすべての未確認ユーザープロファイルには、ユーザーエイリアスline_id も含まれています。このユーザーエイリアスを使用して、ユーザープロファイルを識別対象として設定できます。

以下に、ユーザーエイリアス line_id を使用して未確認ユーザープロファイルをターゲットに設定する /users/identify のペイロードの例を示します。

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

指定された external_id に対応する既存のユーザープロファイルが存在しない場合、これは未確認ユーザープロファイルに追加され、これにより識別されるようになります。external_id に対応するユーザープロファイルが存在する場合、未確認ユーザープロファイルにのみ存在するすべての属性は、既知のユーザープロファイルにコピーされます (native_line_id およびユーザーのサブスクリプションステータスを含む)。

アプリケーションで既知の LINE ユーザーを /users/track エンドポイントから更新するには、それらのユーザーの外部 ID と native_line_id を渡します。あるユーザーに対して未確認ユーザープロファイルがすでに存在し、同じnative_line_id が/users/track を通じて別のユーザープロファイルに追加された場合、そのユーザーは未確認ユーザープロファイルのすべてのサブスクリプション状態を継承する。ただし、同じ native_line_id に対してユーザープロファイルが重複して存在することになります。イベント更新からの後続のサブスクリプション更新によって、すべてのプロファイルが更新されます。

以下に、native_line_id を追加するために外部ユーザー ID でユーザープロファイルを更新する /users/track のペイロードの例を示します。

1
2
3
4
5
6
7
8
9
{
   "attributes": [
       {
           "external_id": "known_external_id_from_your_application",
           "native_line_id": "U89f4a626548ccd48482f529a482f138b",
           "other": "attribute"
       }
   ]
}

ステップ 5: プロファイルをマージする (省略可）

前述したように、同じ native_line_id を持つユーザープロファイルが複数存在する可能性があります。更新方法によって重複するユーザープロファイルが作成される場合は、/user/merge エンドポイントを使用して、未確認ユーザープロファイルを識別されているユーザープロファイルにマージできます。

以下に、ユーザーエイリアス line_id により未確認ユーザープロファイルをターゲットに設定する /users/merge のペイロードの例を示します。

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

ユーザー設定

LINEは、ユーザーのサブスクリプション状態の真実の情報源である。ユーザーのLINE ID (native_line_id) を持っていても、そのユーザーが送信元のLINEチャネルをフォローしていなければ、LINEはそのユーザーにメッセージを配信しない。

これを管理するために、Brazeは、サブスクリプションの同期やLINEのフォロー・アンフォローのイベント更新など、うまく統合されたユーザー群をサポートするツールとロジックを提供している。

サブスクリプションの同期とイベントロジック

1. サブスクリプション同期ツール：このツールは、LINEチャネル統合が成功すると自動的に導入される。既存のプロファイルの更新や新規プロファイルの作成に使用する。
   
   LINEチャネルをフォローするnative_line_id を持つすべてのBrazeユーザープロファイルは、サブスクリプショングループのステータスがsubscribed に更新される。LINE チャネルのフォロワーのうち、native_line_id を持つ Braze ユーザープロファイルがないフォロワーには、次のものが提供されます。
   
   - native_line_id を、チャネルをフォローしているユーザー LINE ID に設定して作成された匿名ユーザープロファイル
   - ユーザーエイリアスline_id チャンネルに続くユーザーLINE IDに設定される。
   - サブスクリプショングループステータス subscribed

2.イベントの更新:これらはユーザーのサブスクリプションステータスを更新するために使用される。Brazeが統合LINEチャネルのユーザーイベント更新を受信し、そのイベントがフォローである場合、ユーザープロファイルのサブスクリプショングループステータスはsubscribed 。イベントがフォロー解除の場合、ユーザープロファイルのサブスクリプショングループのステータスはunsubscribed となる。

-native_line_id が一致するすべてのBrazeユーザープロファイルが自動的に更新される。
- イベントに一致するユーザープロファイルが存在しない場合、Brazeは匿名ユーザーを作成する。

ユースケース

これらは、上記のセットアップステップに従った後、ユーザーがどのように更新されるかのユースケースである。

既存のBrazeユーザープロファイルがすでにLINEチャネルをフォローしている

1. Brazeユーザープロファイルがnative_line_id 属性で更新される。デフォルトのサブスクリプションステータスは unsubscribed です。
2. サブスクリプション同期ツールが実行され、ユーザーが LINE チャネルをフォローしていることが確認され、ユーザープロファイルがサブスクリプションステータス subscribed で更新されます。
3. サブスクリプションのステータスが変更された場合（ユーザーがチャンネルをブロック、友だち解除、リフォローなど）、BrazeはLINEから更新情報を受信し、それに応じてユーザープロファイルを更新する（native_line_id ）。

既存のユーザープロファイルがLINEチャネルをブロック、友だち解除、フォロー解除している

1. Brazeユーザープロファイルがnative_line_id 属性で更新される。デフォルトのサブスクリプションステータスは unsubscribed です。
2. サブスクリプション同期ツールは、ユーザーがLINEチャネルをフォローしていることを検出せず、ユーザーのサブスクリプションステータスはunsubscribed のままである。
3. その後、ユーザーがチャンネルをフォローすると、BrazeはLINEからの更新を受信し、ユーザープロファイルにサブスクリプションステータスsubscribed を更新する。

ユーザープロファイル作成はLINEフォロー後に行われる

1. チャネルに新しいLINEフォロワーが増える。
2. Brazeは、native_line_id 属性をフォロワーのLINE ID に設定し、line_id のユーザーエイリアスをフォロワーのLINE ID に設定した匿名ユーザープロファイルを作成する。プロファイルのサブスクリプションステータスは subscribed です。
3. ユーザーの照合により、ユーザーに LINE ID があることが確認されます。
   • 匿名ユーザープロファイルは、/users/identify エンドポイントを使用して識別できます。このユーザープロファイルに対する (/users/track エンドポイント、CSV インポート、またはクラウドデータ取り込みによる) その後の更新では、この既知の external_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"
           }
       }
   ]
}

• native_line_id を設定して、新しいユーザープロファイルを (/users/track エンドポイント、CSV インポート、またはクラウドデータ取り込みにより) 作成できます。この新しいプロファイルは、既存の匿名ユーザープロファイルのサブスクリプションステータスの状態を継承する。この場合、複数のプロファイルが同じnative_line_id を共有することになる。これらはいつでもマージできます。マージするには、ステップ5で説明したプロセスで /users/merge エンドポイントを使用します。

ユーザープロファイルの作成はLINEのフォローより先に行われる

1. 新しいユーザーを獲得し、その情報をBrazeに送信する。新しいユーザープロファイルが作成される（プロファイル1）。
2. ユーザーはあなたのLINEアカウントをフォローしている。
3. Brazeはフォローイベントを受信し、匿名ユーザープロファイル（プロファイル2）を作成する。
4. ユーザーの照合により、ユーザーに LINE ID があることが確認されます。
5. プロファイル1を更新し、native_line_id 属性を設定する。このプロファイルは、プロファイル2のサブスクリプションステータスを継承します。
   • これで、同じnative_line_id を持つ2つのユーザープロファイルが存在することになる。これらはいつでもマージできます。マージするには、ステップ5で説明したプロセスで /users/merge エンドポイントを使用します。

ユーザーIDの照合

LINE IDは、ユーザーがあなたのチャネルをフォローしたとき、または1回限りの「フォロワー同期」ワークフローを使用したときに、Brazeが自動的に受信する。また、LINE IDはユーザーがフォローしているチャネルに固有のものであるため、ユーザーがLINE IDを提供できる可能性は低い。

LINE IDと既存のBrazeユーザープロファイルを組み合わせるには、2つの方法がある：

• LINE ログイン
• ユーザーアカウントのリンク

LINEログイン

この方法では、ソーシャルメディアのログインを利用して照合を行う。ユーザーがアプリにログインする際、LINEログインを使ってユーザーアカウントを作成するか、ログインするかの選択肢が与えられる。

1. LINE Developer Consoleにアクセスし、LINEログインでアプリにログインしたユーザーのメールアドレスを取得する権限を申請する。

2. LINEが提供する適切なステップに従って、LINEログインを実施する：
   
   

   • Web アプリの手順
   • ネイティブアプリの手順
     
     検証依頼のために設定したスコープには、必ずemail 。

3.ID トークン検証呼び出しを使用して、ユーザーのメールを取得します。

1. ユーザーのLINE ID (native_line_id)を、データベースにあるメールと一致するユーザープロファイルに保存するか、ユーザーのメールとLINE IDで新しいユーザープロファイルを作成する。

2. /user/track エンドポイント、CSV インポート、またはクラウドデータ取り込みを使用して、新しいユーザー情報または更新されたユーザー情報を Braze に送信します。

ワークフロー

既存フォロワーがLINEログインを利用する

シナリオ:最初のサブスクライバー同期または「follow」イベントによる統合の後に、匿名ユーザーが作成されました。

1. ユーザーはLINEログインを使ってアプリにログインする。
2. LINEはユーザーのメールを提供する。
3. Brazeに更新ユーザー（LINE IDを追加するためにそのメールを既存のユーザープロファイルに送る）、または匿名ユーザーにそのメールを更新する。

新規フォロワーが LINE ログインを使用する

シナリオ:ユーザーの LINE ID のユーザープロファイルが Braze に存在していません。

1. ユーザーはLINEログインを使ってアプリにログインする。
2. LINEはユーザーのメールを提供する。
3. 次のいずれかを行います。
   • 既存のユーザープロファイルを更新し、そのメールのユーザーIDをLINE IDとして登録する。
   • メールとLINE IDで新しいユーザープロファイルを作成する。
4. ユーザーがLINE公式アカウントをフォローすると、Brazeはフォローイベントを受信し、ユーザーのサブスクリプションステータスをsubscribed に更新する。

ユーザーアカウントのリンク

この方法によって、ユーザーはLINEアカウントとアプリのユーザーアカウントをリンクさせることができる。その後、Braze で {{line_id}} などの Liquid を使用して、ユーザーの LINE ID を Web サイトまたはアプリに渡すユーザーのためにパーソナライズされた URL を作成します。渡された LINE ID は、既知のユーザーに関連付けることができます。

1. サブスクリプションの状態変化に基づき、ユーザーがLINEチャネルにサブスクライブしたときにトリガーされるアクションベースのキャンバスを作成する。
   
2. (Liquid を使用して) ユーザーの LINE ID をクエリパラメーターとして渡し、Web サイトやアプリへのログインを促す次のようなメッセージを作成します。

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.クーポンコードを配信するフォローアップメッセージを作成する。

1. (オプション) LINEユーザーが識別子されたときにトリガーして、ユーザーにクーポンコードを送信するアクションベースのキャンペーンまたはキャンバスを作成する。
   

仕組み

ユーザーのログイン後に、Web サイトまたはアプリに対して変更が行われます。この変更により、ユーザー ID が Braze に再び送信され、URL の一部として渡された LINE ID に関連付けられます。次にコードの例を示します。

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

ワークフロー

既存ユーザーがあなたのLINEチャネルをフォローしている

シナリオ:Brazeの既存ユーザーがLINEであなたのチャネルをフォローしている。

1. LINEはBrazeにフォローイベントを送る。
2. Braze により、LINE ID、line_id ユーザーエイリアス、および LINE サブスクリプショングループステータス subscribed を持つ匿名ユーザープロファイルが作成されます。
3. ユーザーは、あなたのWebサイトやアプリへのリンクが記載されたLINEメッセージを受け取り、ログインする。これでユーザープロファイルが既知になりました。
4. 作成された匿名ユーザープロファイルが識別され、/users/identify エンドポイントによってユーザーの既知のユーザープロファイルにマージされます。既知のユーザープロファイルにはLINE IDが含まれ、サブスクリプションのステータスはsubscribed となっている。
5. (省略可) クーポンコードが含まれている LINE メッセージをユーザーが受信し、Braze がその送信を Braze ユーザープロファイルに記録します。

BrazeでLINEテストユーザーを作成する

ユーザー照合を設定する前に、「私は誰」キャンバスやキャンペーンを作成することで、LINEチャネルをテストすることができる。

1. 特定のトリガーワードでユーザーの Braze ユーザー ID を返すキャンバスを設定します。
   
   トリガーの例
   
   
   
   メッセージの例
   
   
   
   

2. Braze で、Braze ID を使用して特定のユーザーを検索し、必要に応じて変更します。