コンテンツにスキップ

LINE セットアップ

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

前提条件

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

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

LINEアカウントの種類

アカウントタイプ 説明
未認証アカウント 審査を受けていないアカウントで、誰でも (個人・法人を問わず) 取得できます。このアカウントはグレーのバッジで表示され、LINEアプリ内の検索結果には表示されません。
認証済アカウント LINEヤフーの審査を通過したアカウントです。このアカウントは青色のバッジで表示され、LINEアプリ内の検索結果に表示されます。

このアカウントは、日本、台湾、タイ、インドネシアを拠点とするアカウントでのみ利用できます。
プレミアムアカウント LINEヤフーの審査を通過したアカウントです。このアカウントは緑色のバッジで表示され、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 settings を編集します。
    • Webhook URL を https://anna.braze.com/line/events に設定します。
      • 統合時に、Braze がダッシュボードのクラスターに基づいてこの URL を別の URL に自動的に変更します。
    • Use webhook と Webhook redelivery をオンにします。

      Webhook URL の確認または編集、「Use webhook」、「Webhook redelivery」、「Error statistics aggregation」のオン/オフを切り替える Webhook 設定ページ。
  2. Providers タブで次の情報を控えておきます。
情報の種類 場所
プロバイダー ID プロバイダーを選択し、Settings > Basic information に移動します
チャネル ID プロバイダーを選択し、Channels > 対象のチャネル > Basic settings に移動します
チャネルシークレット プロバイダーを選択し、Channels > 対象のチャネル > Basic settings に移動します。
チャネルアクセストークン プロバイダーを選択し、Channels > 対象のチャネル > Messaging API に移動します。チャネルアクセストークンがない場合は、Issue を選択します。
  1. Settings ページ > Response settings に移動し、次の操作を行います。
    • Greeting message をオフにします。これは Braze でフォロー時のトリガーにより処理できます。
    • Auto-response messages をオフにします。トリガーされるメッセージングはすべて Braze 経由で行う必要があります。これにより、LINE コンソールから直接送信できなくなることはありません。
    • Webhooks をオンにします。

アカウントでのチャットの処理方法を切り替えるトグルがある応答設定ページ。

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

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

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

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

LINE 統合セクションがある LINE メッセージング統合ページ。

  1. 接続後、ワークスペースに正常に追加された LINE 統合ごとに、Braze が Braze 購読グループを自動的に生成します。

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

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

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

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

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

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

Braze には、購読ステータスの同期プロセスの一環として、または新しいフォロワーがチャネルをフォローしたときに作成された、native_line_id を持つ未識別のユーザープロファイルが存在する場合があります。

ユーザー照合などの方法でアプリケーション内の LINE ユーザーが識別された場合、/users/identify エンドポイントを使用して、Braze 内の未識別の可能性があるユーザープロファイルをターゲットにできます。native_line_id を持つすべての未識別ユーザープロファイルには、ユーザーエイリアス line_id もあり、これを使用して識別対象のユーザープロファイルをターゲットにできます。

以下は、ユーザーエイリアス line_id によって未識別のユーザープロファイルをターゲットにする /users/identify へのペイロードの例です。

{
   "aliases_to_identify": [
       {
           "external_id": "known_external_id_from_your_application",
           "user_alias": {
               "alias_name": "U89f4a626548ccd48482f529a482f138b",
               "alias_label": "line_id"
           }
       }
   ]
}

指定した external_id に対応する既存のユーザープロファイルが存在しない場合、その external_id は未識別のユーザープロファイルに追加され、そのプロファイルは識別済みになります。external_id に対応するユーザープロファイルが存在する場合は、未識別のユーザープロファイルにのみ存在するすべての属性 (native_line_id やユーザーの購読ステータスを含む) が、既知のユーザープロファイルにコピーされます。

アプリケーションで既知の LINE ユーザーは、外部識別子と native_line_id を渡して /users/track エンドポイントから更新できます。あるユーザーに未識別のユーザープロファイルがすでに存在し、同じ native_line_id が /users/track を通じて別のユーザープロファイルに追加された場合、そのプロファイルは未識別ユーザープロファイルのすべての購読状態を継承します。ただし、同じ native_line_id を持つ重複したユーザープロファイルが存在することになります。以降のイベント更新による購読の更新は、それに応じてすべてのプロファイルを更新します。

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

{
   "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 へのペイロードの例です。

{
 "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チャネルを再統合する

別のBrazeワークスペースでLINEチャネルを使用するには、次の手順に従います。

  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インポート、またはクラウドデータ取り込みを使用) では、この既知の external_id によってユーザーをターゲットにできます。
{
   "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 の照合

ユーザーがチャネルをフォローしたとき、または1回限りの「フォロワーを同期」ワークフローを使用したときに、Braze は LINE ID を自動的に受信します。また、LINE ID は LINE プロバイダーごとに固有であるため、ユーザーが自分の 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 インポート、または Cloud Data Ingestion を使用して、新規または更新されたユーザー情報を 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 をユーザーごとに作成できます。これにより、LINE ID を既知のユーザーに関連付けることができます。

  1. 購読状態の変更に基づき、ユーザーが LINE チャネルを購読したときにトリガーされるアクションベースのキャンバスを作成します。
    ユーザーが LINE チャネルを購読したときにトリガーされるキャンバス。
  2. ユーザーに Web サイトやアプリへのログインを促すメッセージを作成し、ユーザーの LINE ID を (Liquid を使用して) クエリパラメーターとして渡します。例:
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 サイトやアプリ側で変更を加え、ユーザー ID を Braze に送り返して、URL の一部として渡された LINE ID と関連付けます。コード例は次のとおりです。

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 ユーザープロファイルに記録します。

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

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

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

    トリガーの例

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

    メッセージの例

    BrazeユーザーIDを記載したLINEメッセージ。

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

New Stuff!