LINE セットアップ
この記事では、ユーザーのセットアップ、ユーザーIDの照合、BrazeでのLINEテストユーザーの作成方法を含む、BrazeでのLINEチャネルのセットアップ方法について説明します。
前提条件
LINE を Braze と統合するには、以下が必要です。
- LINE ビジネスアカウント
- プレミアムアカウントまたは認証済アカウントのステータス (既存の友だちを同期するために必要)
- LINE のアカウントガイドラインを参照してください
- LINE 開発者アカウント
- LINE Messaging API チャネル
Braze から LINE メッセージを送信すると、アカウントのメッセージクレジットまたはアクションクレジットが消費されます。

native_line_id の設定: native_line_id は、Braze にユーザー更新を送信することで設定できます (例: /users/track エンドポイント、CSV インポート、Cloud Data Ingestion)。アプリの SDK に native_line_id 専用のフィールドがない場合は、これらのいずれかの方法を使用して、サーバー側のユーザー更新で送信してください。
LINEアカウントの種類
| アカウントタイプ | 説明 |
|---|---|
| 未認証アカウント | 審査を受けていないアカウントで、誰でも (個人・法人を問わず) 取得できます。このアカウントはグレーのバッジで表示され、LINEアプリ内の検索結果には表示されません。 |
| 認証済アカウント | LINEヤフーの審査を通過したアカウントです。このアカウントは青色のバッジで表示され、LINEアプリ内の検索結果に表示されます。 このアカウントは、日本、台湾、タイ、インドネシアを拠点とするアカウントでのみ利用できます。 |
| プレミアムアカウント | LINEヤフーの審査を通過したアカウントです。このアカウントは緑色のバッジで表示され、LINEアプリ内の検索結果に表示されます。このアカウントタイプは、審査時にLINEの判断により自動的に付与されます。 |
必要なアカウントタイプ
フォロワーをBrazeに同期するには、LINEアカウントが認証済アカウントまたはプレミアムアカウントである必要があります。アカウントを作成した時点では、デフォルトのステータスは未認証です。アカウント認証をリクエストする必要があります。
認証済LINEアカウントの申請

認証済アカウントは、日本、台湾、タイ、インドネシアを拠点とするアカウントでのみ利用できます。
- LINEの公式アカウントページで、設定を選択します。
- 情報公開・認証ステータスで、アカウント認証をリクエストを選択します。
- 必要な情報を入力します。
- 審査結果の通知を待ちます。
LINEの統合
ユーザー更新の一貫性を確保し、既存ユーザーのLINE IDを取り込み、それらすべてをLINEの購読ステータスと同期するには、次の手順を実行します。

各ワークスペースでサポートされるLINEプロバイダーは1つです。1つのLINEプロバイダーの下に複数のLINEアカウントを接続できます。複数のプロバイダーが必要な場合は、プロバイダーごとに別のワークスペースを使用してください。
ステップ 1: 既存の LINE ユーザーをインポートまたは更新する
既存の識別済み LINE ユーザーがいる場合は、このステップが必要です。Braze は後でそのユーザーの購読ステータスを自動的に取得し、正しいユーザープロファイルを更新します。これまでにユーザーと LINE ID を照合していない場合は、このステップをスキップしてください。
ユーザーのインポートまたは更新には、Braze がサポートする任意の方法を使用できます。たとえば、/users/track エンドポイント、CSV インポート、クラウドデータ取り込みなどがあります。
どの方法を使用する場合でも、native_line_id を更新してユーザーの LINE ID を指定します。native_line_id の詳細については、ユーザー設定を参照してください。

購読グループのステータスは指定しないでください。指定しても無視されます。ユーザーの購読ステータスの信頼できる情報源は LINE であり、購読同期ツールまたはイベントの更新を通じて Braze に同期されます。
ステップ 2: LINE チャネルを統合する
統合プロセスが完了すると、Braze はそのチャネルの LINE フォロワーを自動的に Braze に取り込みます。既に Braze ユーザープロファイルに関連付けられている LINE ID については、各プロファイルが「subscribed」ステータスで更新され、残りの LINE ID については匿名ユーザーが生成されます。また、LINE チャネルの新しいフォロワーについては、チャネルをフォローした時点で未識別のユーザープロファイルが作成されます。
ステップ 2.1: Webhook 設定を編集する
- LINE で Messaging API タブに移動し、Webhook settings を編集します。
- Webhook URL を
https://anna.braze.com/line/eventsに設定します。- 統合時に、Braze がダッシュボードのクラスターに基づいてこの URL を別の URL に自動的に変更します。
- Use webhook と Webhook redelivery をオンにします。

- Webhook URL を
- Providers タブで次の情報を控えておきます。
| 情報の種類 | 場所 |
|---|---|
| プロバイダー ID | プロバイダーを選択し、Settings > Basic information に移動します |
| チャネル ID | プロバイダーを選択し、Channels > 対象のチャネル > Basic settings に移動します |
| チャネルシークレット | プロバイダーを選択し、Channels > 対象のチャネル > Basic settings に移動します。 |
| チャネルアクセストークン | プロバイダーを選択し、Channels > 対象のチャネル > Messaging API に移動します。チャネルアクセストークンがない場合は、Issue を選択します。 |

既に統合済みの LINE チャネルのチャネルシークレットとチャネルアクセストークンは、パートナー連携 > テクノロジーパートナー > LINE に移動して統合を選択することで、更新またはローテーションできます。
- Settings ページ > Response settings に移動し、次の操作を行います。
- Greeting message をオフにします。これは Braze でフォロー時のトリガーにより処理できます。
- Auto-response messages をオフにします。トリガーされるメッセージングはすべて Braze 経由で行う必要があります。これにより、LINE コンソールから直接送信できなくなることはありません。
- Webhooks をオンにします。

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

1つのワークスペースにつき、最大450の購読グループを追加できます。
- LINE の Braze テクノロジーパートナーページに移動し、LINE の Providers タブで控えた情報を入力します。
- プロバイダー ID
- チャネル ID
- チャネルシークレット
- チャネルアクセストークン
LINE アカウントで IP ホワイトリストを追加する場合は、IP 許可リストに記載されている、お使いのクラスターのすべての IP アドレスを許可リストに追加してください。

統合時には、チャネルシークレットが正しいことを必ず確認してください。正しくない場合、購読ステータスに不整合が生じる可能性があります。

- 接続後、ワークスペースに正常に追加された LINE 統合ごとに、Braze が Braze 購読グループを自動的に生成します。
フォロワーリストの変更 (新しいフォロワーやフォロー解除など) は、自動的に Braze に反映されます。

ステップ 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 を持つ重複したユーザープロファイルが存在することになります。以降のイベント更新による購読の更新は、それに応じてすべてのプロファイルを更新します。

LINE の購読状態は external_id ではなく native_line_id によって追跡されます。たとえば、ユーザー B のユーザープロファイルがユーザー A と同じ native_line_id で作成され、external_id が異なる場合、ユーザー B はユーザー A の LINE 購読ステータスを継承します。
以下は、外部ユーザー 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チャネルを使用するには、次の手順に従います。
- 元のワークスペースで、そのチャネルの購読グループをアーカイブします。
- 移行先のワークスペースで、ステップ2: LINEチャネルを統合するの手順に従ってチャネルを統合します。
両方のワークスペースで購読グループを管理権限があることを確認してください。両方のワークスペースで権限がない場合、チャネルがすでに接続されていることを示すエラーが表示され、統合は失敗します。
アーカイブが購読グループに与える影響については、LINE購読グループを参照してください。
ユースケース
以下は、設定手順に従った後にユーザーがどのように更新されるかを示すユースケースです。
既存のBrazeユーザープロファイルがすでにLINEチャネルをフォローしている場合
- Brazeユーザープロファイルが
native_line_id属性で更新されます。デフォルトの購読ステータスはunsubscribedです。 - 購読同期ツールが実行され、ユーザーがLINEチャネルをフォローしていることを検出すると、ユーザープロファイルの購読ステータスを
subscribedに更新します。 - 購読ステータスに変更が発生した場合 (ユーザーがチャネルをブロック、友だち削除、または再フォローした場合など)、BrazeはLINEから更新を受け取り、
native_line_idを持つユーザープロファイルをそれに応じて更新します。
既存のユーザープロファイルがLINEチャネルをブロック、友だち削除、またはフォロー解除している場合
- Brazeユーザープロファイルが
native_line_id属性で更新されます。デフォルトの購読ステータスはunsubscribedです。 - 購読同期ツールは、ユーザーがLINEチャネルをフォローしていることを検出せず、ユーザーの購読ステータスは
unsubscribedのままになります。 - ユーザーが後でチャネルをフォローすると、BrazeはLINEから更新を受け取り、ユーザープロファイルの購読ステータスを
subscribedに更新します。
LINEのフォロー後にユーザープロファイルが作成される場合
- チャネルに新しいLINEフォロワーが追加されます。
- Brazeは、
native_line_id属性にフォロワーのLINE IDを設定し、line_idのユーザーエイリアスにフォロワーのLINE IDを設定した匿名ユーザープロファイルを作成します。このプロファイルの購読ステータスはsubscribedです。 - ユーザーの照合を通じて、ユーザーが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のフォロー前にユーザープロファイルが作成される場合
- 新しいユーザーを獲得し、その情報をBrazeに送信します。新しいユーザープロファイルが作成されます (プロファイル1)。
- ユーザーがLINEアカウントをフォローします。
- Brazeはフォローイベントを受け取り、匿名ユーザープロファイルを作成します (プロファイル2)。
- ユーザーの照合を通じて、ユーザーがLINE IDを持っていることが識別されます。
- プロファイル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 ログインを使用してユーザーアカウントを作成するか、ログインするかを選択できます。

各ユーザーの正しい LINE ID を取得するには、Braze と連携している LINE 公式アカウントまたはチャネルと同じプロバイダーで LINE ログインを設定してください。
-
LINE Developers コンソールに移動し、LINE ログインでアプリにログインするユーザーのメールアドレスを取得する権限を申請します。
-
LINE が提供する該当の手順に従って、LINE ログインを実装します。
- Web アプリの手順
- ネイティブアプリの手順
認証リクエストのスコープ設定に必ずemailを含めてください。
-
ID トークンの検証呼び出しを使用して、ユーザーのメールアドレスを取得します。
-
データベース内でメールアドレスが一致するユーザーのプロファイルにユーザーの LINE ID (
native_line_id) を保存するか、ユーザーのメールアドレスと LINE ID を使用して新しいユーザープロファイルを作成します。 -
/user/trackエンドポイント、CSV インポート、または Cloud Data Ingestion を使用して、新規または更新されたユーザー情報を Braze に送信します。
ワークフロー
既存のフォロワーが LINE ログインを使用する場合
シナリオ: 最初の購読者同期時、または連携後の「フォロー」イベントによって匿名ユーザーが作成されています。
- ユーザーが LINE ログインを使用してアプリにログインします。
- LINE がユーザーのメールアドレスを提供します。
- 更新されたユーザー (そのメールアドレスを持つ既存のユーザープロファイルに LINE ID を追加したもの) を Braze に送信するか、匿名ユーザーをメールアドレスで更新します。
新しいフォロワーが LINE ログインを使用する場合
シナリオ: ユーザーの LINE ID を持つユーザープロファイルが Braze に存在しません。
- ユーザーが LINE ログインを使用してアプリにログインします。
- LINE がユーザーのメールアドレスを提供します。
- 次のいずれかを行います。
- そのメールアドレスを持つ既存のユーザープロファイルを更新し、ユーザーの LINE ID も追加します。
- メールアドレスと LINE ID を使用して新しいユーザープロファイルを作成します。
- ユーザーが LINE 公式アカウントをフォローすると、Braze はフォローイベントを受信し、ユーザーの購読ステータスを
subscribedに更新します。
ユーザーアカウントのリンク
この方法では、ユーザーが自分の LINE アカウントをアプリのユーザーアカウントにリンクできます。その後、Braze で {{line_id}} などの Liquid を使用して、ユーザーの LINE ID を Web サイトやアプリに渡すパーソナライズされた URL をユーザーごとに作成できます。これにより、LINE ID を既知のユーザーに関連付けることができます。
- 購読状態の変更に基づき、ユーザーが LINE チャネルを購読したときにトリガーされるアクションベースのキャンバスを作成します。

- ユーザーに 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=
- クーポンコードを配信するフォローアップメッセージを作成します。
- (オプション) 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 でチャネルをフォローします。
- LINE が Braze にフォローイベントを送信します。
- Braze は、LINE ID、
line_idユーザーエイリアス、およびsubscribedの LINE 購読グループステータスを持つ匿名ユーザープロファイルを作成します。 - ユーザーは Web サイトとアプリへのリンクを含む LINE メッセージを受信し、ログインします。これでユーザープロファイルが既知になります。
- 作成された匿名ユーザープロファイルが識別され、/users/identify エンドポイントを通じてユーザーの既知のユーザープロファイルにマージされます。既知のユーザープロファイルには LINE ID が含まれ、購読ステータスは
subscribedになります。 - (オプション) ユーザーはクーポンコードを含む LINE メッセージを受信し、Braze はその送信を Braze ユーザープロファイルに記録します。
BrazeでLINEテストユーザーを作成する
ユーザーの照合を設定する前に、「Who am I」キャンバスまたはキャンペーンを作成して、LINEチャネルをテストできます。
-
特定のトリガーワードに対してユーザーのBrazeユーザー IDを返すキャンバスを設定します。
トリガーの例
メッセージの例
-
Brazeでは、Braze IDを使用して特定のユーザーを検索し、必要に応じて変更できます。

キャンバスに、送信を妨げるグローバルコントロールグループやコントロールグループがないことを確認してください。