Skip to content

LINE セットアップ

この記事では、ユーザーのセットアップ、ユーザーIDの照合、BrazeでのLINEテストユーザーの作成方法を含む、BrazeでのLINEチャネルのセットアップ方法について説明します。

前提条件

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

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

LINE アカウントの種類

アカウントの種類 説明
未認証アカウント 誰でも（個人・法人問わず）取得できる未審査のアカウントです。灰色のバッジで表示され、LINE アプリ内の検索結果には表示されません。
認証済みアカウント LINE Yahoo の審査に合格したアカウントです。青色のバッジで表示され、LINE アプリ内の検索結果に表示されます。

このアカウントは、日本、台湾、タイ、インドネシアに拠点を置くアカウントのみ利用可能です。
プレミアムアカウント LINE Yahoo の審査に合格したアカウントです。緑色のバッジで表示され、LINE アプリ内の検索結果に表示されます。このアカウントタイプは、LINE の判断により審査時に自動的に付与されます。

必要なアカウントの種類

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

認証済み LINE アカウントの申請

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

LINEの連携

一貫したユーザー更新を設定し、既存ユーザーのLINE IDを取り込み、すべてをLINEの購読ステータスと同期するには、以下の手順を実行します。

  1. 既存の既知のユーザーをインポートまたは更新する
  2. LINEチャネルを連携する
  3. ユーザーIDを照合する
  4. ユーザー更新方法を変更する
  5. (オプション) ユーザープロファイルを統合する

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

このステップは、既存の識別済みLINEユーザーがいる場合に必要です。Brazeは後で自動的に購読状態を取得し、正しいユーザープロファイルを更新します。以前にユーザーとLINE IDを紐付けたことがない場合は、このステップをスキップしてください。

Brazeがサポートする任意の方法を使用してユーザーをインポートまたは更新できます。/users/trackエンドポイント、CSVインポート、またはクラウドデータインジェスションが利用可能です。

使用する方法にかかわらず、native_line_idを更新してユーザーのLINE IDを指定してください。native_line_idの詳細については、ユーザー設定を参照してください。

ステップ2: LINEチャネルを連携する

連携プロセスが完了すると、BrazeはそのチャネルのLINEフォロワーを自動的にBrazeに取り込みます。すでにBrazeユーザープロファイルに関連付けられているLINE IDについては、各プロファイルが「subscribed」ステータスに更新され、残りのLINE IDについては匿名ユーザーが生成されます。さらに、LINEチャネルの新しいフォロワーがチャネルをフォローすると、未識別のユーザープロファイルが作成されます。

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

  1. LINEでMessaging APIタブに移動し、Webhook設定を編集します。
    • Webhook URLをhttps://anna.braze.com/line/eventsに設定します。
      • 連携時、Brazeはダッシュボードクラスターに基づいて自動的にこのURLを別のURLに変更します。
    • Webhookの利用とWebhookの再送をオンにします。

      Webhook URLの確認や編集、「Webhookの利用」「Webhookの再送」「エラー統計の集計」のオン・オフを切り替えるWebhook設定ページ。
  2. プロバイダータブで以下の情報を確認します。
情報の種類 場所
プロバイダーID プロバイダーを選択し、設定 > 基本情報に移動します
チャネルID プロバイダーを選択し、チャネル > 対象のチャネル > 基本設定に移動します
チャネルシークレット プロバイダーを選択し、チャネル > 対象のチャネル > 基本設定に移動します
チャネルアクセストークン プロバイダーを選択し、チャネル > 対象のチャネル > Messaging APIに移動します。チャネルアクセストークンがない場合は、発行を選択します。
  1. 設定ページ > 応答設定に移動し、以下を行います。
    • あいさつメッセージをオフにします。この機能は、Brazeでフォロー時にトリガーすることで対応できます。
    • 自動応答メッセージをオフにします。トリガーによるメッセージングはすべてBrazeを通じて行います。これにより、LINEコンソールから直接送信できなくなるわけではありません。
    • Webhookをオンにします。

アカウントがチャットをどのように処理するかのトグルが表示された応答設定ページ。

ステップ2.2: BrazeでLINE購読グループを生成する

Brazeは連携する各LINEチャネルごとに購読グループを作成します。LINE購読グループの仕組みについては、LINE購読グループを参照してください。

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

LINEアカウントでIPホワイトリストを追加する場合は、IP許可リストに記載されているクラスターのすべてのIPアドレスを許可リストに追加してください。

LINE連携セクションが表示されたLINEメッセージング連携ページ。

  1. 接続後、Brazeはワークスペースに正常に追加された各LINE連携に対して、Braze購読グループを自動的に生成します。

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

「LINE」チャネルの購読グループが1つ表示されたLINE購読グループセクション。

ステップ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エンドポイントを通じて、外部識別子と native_line_id を渡すことで更新できます。あるユーザーに対して未識別ユーザープロファイルがすでに存在し、同じ native_line_id が /users/track を通じて別のユーザープロファイルに追加された場合、その未識別ユーザープロファイルのすべての購読ステータスが引き継がれます。ただし、同じ native_line_id を持つ重複したユーザープロファイルが存在することになります。イベント更新による後続の購読更新は、すべてのプロファイルをそれに応じて更新します。

以下は、外部ユーザーIDによってユーザープロファイルを更新し、native_line_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 のフォロー・フォロー解除に対するイベント更新など、適切に連携されたユーザー群をサポートするツールとロジックを提供しています。

購読の同期とイベントロジック

購読同期ツールとフォロー・フォロー解除のイベント更新が LINE の購読ステータスを Braze と整合させる仕組みについては、購読ステータスを参照してください。

LINEチャネルを別のワークスペースに再統合する

LINEチャネルを別のBrazeワークスペースで使用するには:

  1. 元のワークスペースで、そのチャネルの購読グループをアーカイブします。
  2. 対象のワークスペースで、ステップ2: LINEチャネルを統合するを使用してチャネルを統合します。

両方のワークスペースで購読グループの管理権限があることを確認してください。両方のワークスペースでの権限がないと、チャネルがすでに接続されていることを示すエラーで統合が失敗します。

アーカイブが購読グループに与える影響については、LINE購読グループを参照してください。

ユースケース

以下は、設定ステップを完了した後にユーザーを更新する方法のユースケースです。

既存の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インポート、またはCloud Data Ingestionを通じて）では、この既知の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インポート、またはCloud Data Ingestionを通じて）作成できます。この新しいプロファイルは、既存の匿名ユーザープロファイルの購読ステータスの状態を継承します。これにより、同じ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は、ユーザーがチャネルをフォローしたとき、またはワンタイムの「フォロワー同期」ワークフローを使用したときに、Brazeが自動的に受信します。LINE IDはユーザーがフォローしたチャネルに固有であるため、ユーザーが自分のLINE IDを提供することは通常ありません。

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

LINEログイン

この方法では、ソーシャルメディアログインを使用して照合を行います。ユーザーがアプリにログインすると、LINEログインを使用してユーザーアカウントを作成したりログインしたりするオプションが表示されます。

  1. LINE Developers コンソールに移動し、LINEログインを通じてアプリにログインするユーザーのメールアドレスの取得許可を申請します。

  2. LINEが提供する適切な手順に従って、LINEログインを実装します。

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

  2. ユーザーのLINE ID (native_line_id) を、データベース内の一致するメールアドレスを持つユーザーのプロファイルに保存するか、ユーザーのメールアドレスとLINE IDで新しいユーザープロファイルを作成します。

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

ワークフロー

既存のフォロワーがLINEログインを使用する場合

シナリオ: 初回のサブスクライバー同期時、またはフォローイベントによる連携後に、匿名ユーザーが作成されています。

  1. ユーザーがLINEログインを使用してアプリにログインします。
  2. LINEがユーザーのメールアドレスを提供します。
  3. 更新されたユーザー（そのメールアドレスを持つ既存のユーザープロファイルにLINE IDを追加）をBrazeに送信するか、匿名ユーザーをメールアドレスで更新します。
新しいフォロワーがLINEログインを使用する場合

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

  1. ユーザーがLINEログインを使用してアプリにログインします。
  2. LINEがユーザーのメールアドレスを提供します。
  3. 以下のいずれかを行います。
    • そのメールアドレスを持つ既存のユーザープロファイルを更新し、ユーザーのLINE IDも持たせます。
    • メールアドレスとLINE IDで新しいユーザープロファイルを作成します。
  4. ユーザーがLINE公式アカウントをフォローすると、Brazeがフォローイベントを受信し、ユーザーの購読ステータスをsubscribedに更新します。

ユーザーアカウントの連携

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

  1. 購読状態の変更に基づいてトリガーされ、ユーザーがLINEチャネルに購読したときに発動するアクションベースのキャンバスを作成します。
    ユーザーが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=
  1. クーポンコードを配信するフォローアップメッセージを作成します。
  2. （オプション）LINEユーザーが特定されたときにトリガーされるアクションベースのキャンペーンまたはキャンバスを作成し、ユーザーにクーポンコードを送信します。
    LINEユーザーが特定されたときにトリガーされるアクションベースのキャンペーン。

仕組み

ユーザーがログインした後、Webサイトまたはアプリ側で変更が行われ、URLの一部として渡されたLINE IDにユーザーIDを関連付けるためにBrazeに送信されます。以下はコード例です。

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テストユーザーの作成

ユーザー照合を設定する前に、「Who am I」キャンバスまたはキャンペーンを作成してLINEチャネルをテストできます。

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

    トリガーの例

    特定の購読グループへのインバウンドLINEを送信したユーザーにキャンペーンを送信するトリガー。

    メッセージの例

    BrazeユーザーIDを表示するLINEメッセージ。

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