LINE セットアップ

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

前提条件

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

• LINE ビジネスアカウント
• プレミアムまたは認証済みアカウントステータス（既存のフォロワーの同期に必要）
  • LINE のアカウントガイドラインを参照してください
• LINE Developers アカウント
• LINE Messaging API チャネル

Braze から 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 については、各プロファイルが「購読中」ステータスに更新され、残りの LINE ID については匿名ユーザーが生成されます。さらに、LINE チャネルの新しいフォロワーは、チャネルをフォローした際に未識別のユーザープロファイルが作成されます。

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

1. LINE で Messaging API タブに移動し、Webhook 設定を編集します:
   • Webhook URL を https://anna.braze.com/line/events に設定します。
     • Brazeは統合時に、ダッシュボードクラスターに基づいてこれを自動的に別の URL に変更します。
   • Webhookの利用とWebhookの再送をオンにします。
     
     
2. プロバイダータブで以下の情報をメモしてください:

3. 設定ページ > 応答設定に移動し、以下を行います:
   • あいさつメッセージをオフにします。これはBrazeでフォロー時のトリガーで処理できます。
   • 自動応答メッセージをオフにします。すべてのトリガーメッセージングはBrazeを通じて行う必要があります。これにより、LINE コンソールから直接送信することは妨げられません。
   • Webhook をオンにします。

ステップ 2.2: Brazeで LINE サブスクリプショングループを生成する

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

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

2. 接続後、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 を持つ重複したユーザープロファイルが存在することになります。イベント更新による後続のサブスクリプション更新は、すべてのプロファイルを適切に更新します。

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

サブスクリプション同期とイベントロジック

1. サブスクリプション同期ツール: このツールは、LINE チャネルの統合が成功した後に自動的にデプロイされます。既存のプロファイルの更新や新しいプロファイルの作成に使用します。
   
   LINE チャネルをフォローしている native_line_id を持つすべてのBrazeユーザープロファイルは、サブスクリプショングループのステータスが subscribed に更新されます。native_line_id を持つBrazeユーザープロファイルがない LINE チャネルのフォロワーには、以下が適用されます:
   
   - チャネルをフォローしているユーザーの LINE ID に native_line_id が設定された匿名ユーザープロファイルが作成されます
   - チャネルをフォローしているユーザーの LINE ID にユーザーエイリアス line_id が設定されます
   - サブスクリプショングループのステータスが subscribed になります

2. イベント更新: ユーザーのサブスクリプションステータスの更新に使用されます。Brazeが統合された LINE チャネルのユーザーイベント更新を受信し、そのイベントがフォローの場合、ユーザープロファイルのサブスクリプショングループのステータスは subscribed になります。イベントがフォロー解除の場合、ユーザープロファイルのサブスクリプショングループのステータスは unsubscribed になります。
   
   - 一致する native_line_id を持つすべてのBrazeユーザープロファイルが自動的に更新されます。
   - イベントに一致するユーザープロファイルが存在しない場合、Brazeは匿名ユーザーを作成します。

ユースケース

上記のセットアップ手順に従った後、ユーザーがどのように更新されるかのユースケースです。

既存の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は、フォロワーの LINE ID に native_line_id 属性が設定され、フォロワーの LINE ID にユーザーエイリアス line_id が設定された匿名ユーザープロファイルを作成します。プロファイルのサブスクリプションステータスは subscribed です。
3. ユーザー照合を通じて、ユーザーが 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 フォロー前にユーザープロファイルが作成される場合

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 ログイン

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

1. LINE Developer Console に移動し、LINE ログインを通じてアプリにログインするユーザーのメールアドレスを取得する権限をリクエストします。

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

   • Web アプリの手順
   • ネイティブアプリの手順
     
     認証リクエストのスコープ設定に email を含めるようにしてください。

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

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

5. 新しいまたは更新されたユーザー情報を、/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 を作成し、既知のユーザーに関連付けることができます。

1. サブスクリプション状態の変更に基づくアクションベースのCanvasを作成し、ユーザーが LINE チャネルを購読した際にトリガーされるようにします。
   
2. ユーザーに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=

3. クーポンコードを配信するフォローアップメッセージを作成します。
4. （オプション）LINE ユーザーが識別された際にトリガーされるアクションベースのCampaignまたはCanvasを作成し、ユーザーにクーポンコードを送信します。
   

仕組み

ユーザーがログインすると、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」CanvasまたはCampaignを作成して LINE チャネルをテストできます。

1. 特定のトリガーワードでユーザーのBrazeユーザー ID を返すCanvasをセットアップします。
   
   トリガーの例
   
   
   
   メッセージの例
   
   
   
   

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