LINE セットアップ
この記事では、ユーザーのセットアップ、ユーザーIDの照合、BrazeでのLINEテストユーザーの作成方法を含む、BrazeでのLINEチャネルのセットアップ方法について説明します。
前提条件
LINEをBrazeと統合するには、以下が必要です。
- LINEビジネスアカウント
- プレミアムまたは認証済みアカウントステータス（既存のフォロワーの同期に必要）
- LINEのアカウントガイドラインを参照してください
- LINE Developersアカウント
- LINE Messaging APIチャネル
BrazeからLINEメッセージを送信すると、アカウントのメッセージクレジットまたはアクションクレジットが消費されます。
native_line_idの設定: Brazeにユーザー更新を送信することでnative_line_idを設定できます（例：/users/trackエンドポイント、CSVインポート、またはクラウドデータ取り込みを使用）。クライアント側のSDKにnative_line_id専用のフィールドがない場合は、これらの方法のいずれかを使用してサーバー側のユーザー更新で送信してください。
LINEアカウントの種類
| アカウントの種類 | 説明 |
|---|---|
| 未認証アカウント | 誰でも（個人または法人）取得できる未審査のアカウントです。このアカウントはグレーのバッジで表示され、LINEアプリ内の検索結果には表示されません。 |
| 認証済みアカウント | LINE Yahooの審査に合格したアカウントです。このアカウントはブルーのバッジで表示され、LINEアプリ内の検索結果に表示されます。 このアカウントは、日本、台湾、タイ、インドネシアに拠点を置くアカウントのみ利用可能です。 |
| プレミアムアカウント | LINE Yahooの審査に合格したアカウントです。このアカウントはグリーンのバッジで表示され、LINEアプリ内の検索結果に表示されます。このアカウントの種類は、LINEの裁量により審査中に自動的に付与されます。 |
必要なアカウントの種類
フォロワーをBrazeに同期するには、LINEアカウントが認証済みまたはプレミアムである必要があります。アカウントを作成すると、デフォルトのステータスは未認証になります。アカウントの認証をリクエストする必要があります。
認証済みLINEアカウントの申請
認証済みアカウントは、日本、台湾、タイ、インドネシアに拠点を置くアカウントのみ利用可能です。
- LINEの公式アカウントページで、設定を選択します。
- 情報公開認証ステータスの下で、アカウント認証をリクエストを選択します。
- 必要な情報を入力します。
- 審査結果の通知を待ちます。
LINEの統合
一貫したユーザー更新をセットアップし、既存ユーザーのLINE IDを取り込み、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については、各プロファイルが「購読中」ステータスに更新され、残りのLINE IDについては匿名ユーザーが生成されます。さらに、LINEチャネルの新しいフォロワーは、チャネルをフォローした際に未識別のユーザープロファイルが作成されます。
ステップ2.1:Webhook設定を編集する
- LINEでMessaging APIタブに移動し、Webhook設定を編集します：
- Webhook URLを
https://anna.braze.com/line/eventsに設定します。- Brazeは統合時に、ダッシュボードクラスターに基づいてこれを自動的に別のURLに変更します。
- Webhookの利用とWebhookの再送をオンにします。
- Webhook URLを
- プロバイダータブで以下の情報をメモしてください：
| 情報の種類 | 場所 |
|---|---|
| プロバイダーID | プロバイダーを選択し、設定 > 基本情報に移動します |
| チャネルID | プロバイダーを選択し、チャネル > 対象のチャネル > 基本設定に移動します |
| チャネルシークレット | プロバイダーを選択し、チャネル > 対象のチャネル > 基本設定に移動します |
| チャネルアクセストークン | プロバイダーを選択し、チャネル > 対象のチャネル > Messaging APIに移動します。チャネルアクセストークンがない場合は、発行を選択します。 |
- 設定ページ > 応答設定に移動し、以下を行います：
- あいさつメッセージをオフにします。これはBrazeでフォロー時のトリガーで処理できます。
- 自動応答メッセージをオフにします。すべてのトリガーメッセージングはBrazeを通じて行う必要があります。これにより、LINEコンソールから直接送信することは妨げられません。
- Webhookをオンにします。
ステップ2.2:BrazeでLINE購読グループを生成する
1つのワークスペースにつき、最大350のサブスクリプショングループを追加できます。
- BrazeのテクノロジーパートナーページでLINEに移動し、LINEのプロバイダータブからメモした情報を入力します：
- プロバイダーID
- チャネルID
- チャネルシークレット
- チャネルアクセストークン
LINEアカウントにIPホワイトリストを追加する場合は、IP許可リストに記載されているクラスターのすべてのIPアドレスを許可リストに追加してください。
統合時に、チャネルシークレットが正しいことを必ず確認してください。正しくない場合、購読ステータスに不整合が生じる可能性があります。
- 接続後、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エンドポイントを通じて、外部識別子とnative_line_idを渡すことで更新できます。ユーザーに対して未識別のユーザープロファイルがすでに存在し、同じ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へのペイロードの例です：
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チャネルの統合が成功した後に自動的にデプロイされます。既存のプロファイルの更新や新しいプロファイルの作成に使用します。
LINEチャネルをフォローしているnative_line_idを持つすべてのBrazeユーザープロファイルは、購読グループのステータスがsubscribedに更新されます。native_line_idを持つBrazeユーザープロファイルがないLINEチャネルのフォロワーには、以下が適用されます：
- チャネルをフォローしているユーザーのLINE IDにnative_line_idが設定された匿名ユーザープロファイルが作成されます
- チャネルをフォローしているユーザーのLINE IDにユーザーエイリアスline_idが設定されます
- 購読グループのステータスがsubscribedになります
- イベント更新: ユーザーの購読ステータスの更新に使用されます。Brazeが統合されたLINEチャネルのユーザーイベント更新を受信し、そのイベントがフォローの場合、ユーザープロファイルの購読グループのステータスは
subscribedになります。イベントがフォロー解除の場合、ユーザープロファイルの購読グループのステータスはunsubscribedになります。
- 一致するnative_line_idを持つすべてのBrazeユーザープロファイルが自動的に更新されます。
- イベントに一致するユーザープロファイルが存在しない場合、Brazeは匿名ユーザーを作成します。
別のワークスペースでLINEチャネルを再統合する
LINEチャネルを別のBrazeワークスペースで使用するには：
- 元のワークスペースで、そのチャネルの購読グループをアーカイブします。
- ターゲットのワークスペースで、ステップ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は、フォロワーのLINE IDに
native_line_id属性が設定され、フォロワーのLINE IDにユーザーエイリアスline_idが設定された匿名ユーザープロファイルを作成します。プロファイルの購読ステータスはsubscribedです。 - ユーザー照合を通じて、ユーザーが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フォロー前にユーザープロファイルが作成される場合
- 新しいユーザーを獲得し、情報をBrazeに送信します。新しいユーザープロファイルが作成されます（プロファイル1）。
- ユーザーがLINEアカウントをフォローします。
- Brazeはフォローイベントを受信し、匿名ユーザープロファイルを作成します（プロファイル2）。
- ユーザー照合を通じて、ユーザーがLINE IDを持っていることが識別されます。
- プロファイル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ログインを使用してユーザーアカウントを作成するか、ログインするオプションが提供されます。
各ユーザーの正しいLINE IDを取得するには、Brazeと統合されたLINE公式アカウントまたはチャネルと同じプロバイダーの下でLINEログインをセットアップしてください。
-
LINE Developer Consoleに移動し、LINEログインを通じてアプリにログインするユーザーのメールアドレスを取得する権限をリクエストします。
-
LINEが提供する適切な手順に従ってLINEログインを実装します：
- Webアプリの手順
- ネイティブアプリの手順
認証リクエストのスコープ設定にemailを含めるようにしてください。
-
IDトークンの検証呼び出しを使用して、ユーザーのメールアドレスを取得します。
-
ユーザーのLINE ID（
native_line_id）を、データベース内の一致するメールアドレスを持つユーザーのプロファイルに保存するか、ユーザーのメールアドレスとLINE IDで新しいユーザープロファイルを作成します。 -
新しいまたは更新されたユーザー情報を、
/user/trackエンドポイント、CSVインポート、またはクラウドデータ取り込みを使用して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チャネルを購読した際にトリガーされるようにします。
- ユーザーにWebサイトやアプリへのログインを促すメッセージを作成し、ユーザーのLINE IDをクエリパラメーターとして（Liquidを通じて）渡します。例：
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=
- クーポンコードを配信するフォローアップメッセージを作成します。
- （オプション）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でチャネルをフォローします。
- LINEがBrazeにフォローイベントを送信します。
- BrazeはLINE ID、
line_idユーザーエイリアス、およびLINE購読グループのステータスsubscribedを持つ匿名ユーザープロファイルを作成します。 - ユーザーがWebサイトやアプリへのリンクを含むLINEメッセージを受信し、ログインします。ユーザープロファイルが既知になります。
- 作成された匿名ユーザープロファイルが識別され、/users/identifyエンドポイントを通じてユーザーの既知のユーザープロファイルにマージされます。既知のユーザープロファイルにLINE IDが含まれ、購読ステータスが
subscribedになります。 - （オプション）ユーザーがクーポンコードを含むLINEメッセージを受信し、BrazeがBrazeユーザープロファイルに送信を記録します。
BrazeでのLINEテストユーザーの作成
ユーザー照合をセットアップする前に、「Who am I」キャンバスまたはキャンペーンを作成してLINEチャネルをテストできます。
-
特定のトリガーワードでユーザーのBrazeユーザーIDを返すキャンバスをセットアップします。
トリガーの例
メッセージの例
-
Brazeで、Braze IDを使用して特定のユーザーを検索し、必要に応じて変更できます。
キャンバスにグローバルコントロールやコントロールグループが送信を妨げていないことを確認してください。