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 IDを照合していない場合は、このステップをスキップする。

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

どの方法を使うにせよ、native_line_id 、ユーザーの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ユーザーが識別子として登録された場合、Brazeで未登録の可能性があるユーザープロファイルをターゲットにすることができる。 /users/identifyエンドポイントを使用する。native_line_id を持つすべての未確認ユーザープロファイルは、ユーザーエイリアスline_id も持っており、これを使用してユーザープロファイルを特定することができる。

以下は、/users/identify に対するペイロードの例である。このペイロードは、ユーザーエイリアス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"
           }
       }
   ]
}

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

アプリケーションで既知のLINEユーザーを更新するには、そのユーザーの外部識別子をエンドポイントに渡す。 /users/tracknative_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チャンネルのフォロワーで、Brazeのユーザープロファイルを持っていない人は、native_line_id ：
   
   -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エンドポイントを使う。その後の更新（エンドポイント、CSVインポート、またはクラウド・データ・インジェストを通じて）は、この既知の。 /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"
           }
       }
   ]
}

• 新しいユーザープロファイルは、 を設定することで（エンドポイント、CSVインポート、またはクラウドデータ・インジェストを通じて）作成できる。 /users/trackエンドポイント、CSV インポート、またはクラウド・データ・インジェストによって)、新しいユーザー・プロファイルを作成するには、native_line_id を設定する。この新しいプロファイルは、既存の匿名ユーザープロファイルのサブスクリプションステータスの状態を継承する。この場合、複数のプロファイルが同じ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ログインを実施する：
   
   

   • ウェブアプリの方向性
   • ネイティブアプリの案内
     
     検証依頼のために設定したスコープには、必ずemail 。

3.Verify IDトークン・コールを使用して、ユーザーのメールを取得する。

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

2. /user/track エンドポイント、CSVインポート、またはクラウドデータインジェストを使用して、新規または更新ユーザー情報をBrazeに送信する。

ワークフロー

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

シナリオはこうだ：匿名ユーザーは、最初のサブスクライバー同期中、または統合後に “フォロー “イベントを通じて作成された。

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

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

シナリオはこうだ：ユーザーIDのユーザープロファイルがBrazeに存在しない。

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

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

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

1. サブスクリプションの状態変化に基づき、ユーザーがLINEチャネルにサブスクライブしたときにトリガーされるアクションベースのキャンバスを作成する。
   
2. ユーザーのLINE IDをクエリーパラメーターとして（Liquidを通して）渡し、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 ユーザーエイリアス、subscribed のLINEサブスクリプショングループステータスを持つ匿名ユーザープロファイルを作成する。
3. ユーザーは、あなたのWebサイトやアプリへのリンクが記載されたLINEメッセージを受け取り、ログインする。ユーザープロファイルが判明した。
4. 作成された匿名ユーザープロファイルは識別され、/users/identifyエンドポイントを通じてユーザーの既知のユーザープロファイルにマージされる。既知のユーザープロファイルにはLINE IDが含まれ、サブスクリプションのステータスはsubscribed となっている。
5. (オプション) ユーザーはクーポンコードのLINEメッセージを受信し、Brazeはユーザープロファイルに送信をメッセージングする。

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

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

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

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