LINE セットアップ
この記事では、ユーザーのセットアップ、ユーザーIDの照合、BrazeでのLINEテストユーザーの作成方法を含む、BrazeでのLINEチャネルのセットアップ方法について説明します。
前提条件
LINEをBrazeと連携するには、以下が必要です。
- LINEビジネスアカウント
- プレミアムまたは認証済みアカウントステータス（既存のフォロワーを同期するために必要）
- LINEのアカウントガイドラインを参照してください
- LINE Developersアカウント
- 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 Yahoo の審査に合格したアカウントです。青色のバッジで表示され、LINE アプリ内の検索結果に表示されます。 このアカウントは、日本、台湾、タイ、インドネシアに拠点を置くアカウントのみ利用可能です。 |
| プレミアムアカウント | LINE Yahoo の審査に合格したアカウントです。緑色のバッジで表示され、LINE アプリ内の検索結果に表示されます。このアカウントの種類は、LINE の裁量により審査時に自動的に付与されます。 |
必要なアカウントの種類
フォロワーを Braze に同期するには、LINE アカウントが認証済みまたはプレミアムである必要があります。アカウントを作成すると、デフォルトのステータスは未認証になります。アカウントの認証をリクエストする必要があります。
認証済み LINE アカウントの申請
認証済みアカウントは、日本、台湾、タイ、インドネシアに拠点を置くアカウントのみ利用可能です。
- LINE の Official Account ページで、設定 を選択します。
- 情報公開認証ステータス の下にある アカウント認証をリクエスト を選択します。
- 必要な情報を入力します。
- 審査結果の通知を待ちます。
LINEの連携
一貫したユーザー更新を設定し、既存ユーザーのLINE IDを取り込み、LINEの購読ステータスと同期するには、以下の手順に従います。
1つのワークスペースで使用できるLINEアカウントは1つのみです。複数のLINEアカウントをお持ちの場合は、それぞれ異なるワークスペースで使用することをお勧めします。
ステップ1：既存のLINEユーザーをインポートまたは更新する
このステップは、既存の識別済みLINEユーザーがいる場合に必要です。Brazeは後で自動的にそのユーザーの購読状態を取得し、正しいユーザープロファイルを更新します。以前にユーザーとLINE IDを紐付けたことがない場合は、このステップをスキップしてください。
Brazeがサポートする任意の方法を使用してユーザーをインポートまたは更新できます。/users/trackエンドポイント、CSVインポート、またはCloud Data Ingestionが利用可能です。
使用する方法に関係なく、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設定を編集します。
- Webhook URLを
https://anna.braze.com/line/eventsに設定します。- Brazeは連携時にダッシュボードクラスターに基づいて、自動的にこのURLを別のURLに変更します。
- Webhookの利用とWebhookの再送をオンにします。
- Webhook URLを
- プロバイダータブで以下の情報を確認します。
| 情報の種類 | 場所 |
|---|---|
| プロバイダーID | プロバイダーを選択し、設定 > 基本情報に移動します |
| チャネルID | プロバイダーを選択し、チャネル > 対象のチャネル > 基本設定に移動します |
| チャネルシークレット | プロバイダーを選択し、チャネル > 対象のチャネル > 基本設定に移動します |
| チャネルアクセストークン | プロバイダーを選択し、チャネル > 対象のチャネル > Messaging APIに移動します。チャネルアクセストークンがない場合は、発行を選択します。 |
すでに連携済みのLINEチャネルのチャネルシークレットとチャネルアクセストークンは、パートナー連携 > テクノロジーパートナー > LINEに移動し、連携を選択することで更新またはローテーションできます。
- 設定ページ > 応答設定に移動し、以下を行います。
- あいさつメッセージをオフにします。これはBrazeでフォロー時にトリガーすることで対応できます。
- 自動応答メッセージをオフにします。トリガーされるメッセージングはすべてBrazeを通じて行う必要があります。これにより、LINEコンソールから直接送信することが妨げられるわけではありません。
- Webhookをオンにします。
ステップ2.2: BrazeでLINE購読グループを生成する
1つのワークスペースにつき、最大450の購読グループを追加できます。
- 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エンドポイントを通じて、external IDと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 の購読ステータスを 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は
native_line_id属性にフォロワーのLINE IDを設定し、line_idのユーザーエイリアスにフォロワーのLINE IDを設定した匿名ユーザープロファイルを作成します。このプロファイルの購読ステータスはsubscribedです。 - ユーザー照合を通じて、ユーザーがその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フォロー前にユーザープロファイルが作成される場合
- 新しいユーザーを獲得し、その情報をBrazeに送信します。新しいユーザープロファイルが作成されます（プロファイル1）。
- ユーザーがLINEアカウントをフォローします。
- Brazeはフォローイベントを受信し、匿名ユーザープロファイルを作成します（プロファイル2）。
- ユーザー照合を通じて、ユーザーがそのLINE IDを持っていることが特定されます。
- プロファイル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 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サイトまたはアプリ側で変更が行われ、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でチャネルをフォローします。
- 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を使用して特定のユーザーを検索し、必要に応じて変更できます。
キャンバスにグローバルコントロールやコントロールグループが設定されていて送信が妨げられることがないようにしてください。