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アカウントの種類

必要なアカウントの種類

フォロワーをBrazeに同期するには、LINEアカウントが認証済またはプレミアムである必要があります。アカウントを作成した時点のデフォルトのステータスは未認証です。アカウント認証をリクエストする必要があります。

認証済LINEアカウントの申請

重要

認証済アカウントは、日本、台湾、タイ、インドネシアを拠点とするアカウントでのみ利用できます。

1. LINEの公式アカウントページで、設定を選択します。
2. 情報公開の認証ステータスで、アカウント認証をリクエストを選択します。
3. 必要な情報を入力します。
4. 審査結果の通知を待ちます。

LINE の統合

ユーザーの更新を一貫して行えるように設定し、既存ユーザーの LINE ID を移行して、それらすべてを LINE の購読ステータスと同期するには、次の手順に従います。

1. 既存の既知ユーザーをインポートまたは更新する
2. LINE チャネルを統合する
3. ユーザー ID を照合する
4. ユーザーの更新方法を変更する
5. (オプション) ユーザープロファイルをマージする

注

各ワークスペースがサポートする 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 設定を編集する

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

注

すでに統合済みの LINE チャネルのチャネルシークレットとチャネルアクセストークンは、パートナー連携 > テクノロジーパートナー > LINE に移動し、対象の統合を選択することで更新またはローテーションできます。

3. 設定ページ > 応答設定に移動し、次の操作を行います。
   • あいさつメッセージをオフにします。これは、フォローをトリガーにすることで Braze で処理できます。
   • 応答メッセージをオフにします。トリガーされるメッセージングはすべて Braze を経由する必要があります。この設定をしても、LINE コンソールから直接送信することは引き続き可能です。
   • Webhook をオンにします。

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

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

注

1つのワークスペースにつき、最大450の購読グループを追加できます。

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 は未識別のユーザープロファイルに追加され、そのプロファイルは識別済みになります。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 へのペイロードの例です。

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"
     }
   }
 ]
}

ヒント

Braze での重複ユーザーの管理について詳しくは、重複ユーザーを参照してください。

ユーザー設定

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 インポート、または 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 のフォロー前にユーザープロファイルが作成される場合

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 は、ユーザーがチャネルをフォローしたとき、または1回限りの「フォロワーの同期」ワークフローを使用したときに、Braze が自動的に受信します。また、LINE ID はユーザーがフォローするチャネルごとに固有であるため、ユーザー自身が LINE ID を提供できる可能性は低いです。

LINE ID を既存の Braze ユーザープロファイルと組み合わせる方法は2つあります。

• LINE ログイン
• ユーザーアカウントの連携

LINE ログイン

この方法では、ソーシャルメディアのログインを使用して照合します。ユーザーがアプリにログインする際に、LINE ログインを使用してユーザーアカウントを作成するか、ログインするかを選択できます。

注

各ユーザーの正しい LINE ID を取得するには、Braze と連携している LINE 公式アカウントまたはチャネルと同じプロバイダーの下で LINE ログインを設定してください。

1. LINE Developers コンソールに移動し、LINE ログインを通じてアプリにログインするユーザーのメールアドレスを取得する権限を申請します。

2. LINE が提供する該当の手順に従って、LINE ログインを実装します。
   
   

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

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

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

5. /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 チャネルを購読したときにトリガーされるアクションベースのキャンバスを作成します。
   
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 ユーザーが識別されたときにトリガーされ、ユーザーにクーポンコードを送信するアクションベースのキャンペーンまたはキャンバスを作成します。
   

仕組み

ユーザーがログインすると、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 でチャネルをフォローします。

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」キャンバスまたはキャンペーンを作成して、LINEチャネルをテストできます。

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

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

重要

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