はじめに
Viber は、安全かつ高速で、すべてのデバイス間で同期されるクロスプラットフォームの VoIP およびインスタントメッセージングアプリケーションです。Viber を通じて、ブランドはユーザーが簡単に操作できるリッチなメッセージングを使用してユーザーとエンゲージできます。MoEngage と Viber
MoEngage と Viber の統合により、高度なセグメンテーション、予測機能、パーソナライズ、トリガー機能を活用して、Viber REST Bot API を通じて Viber Bot でユーザーにメッセージを送信できます。ユースケース
MoEngage との統合は、次のようなユースケースに役立ちます。- パーソナライズされたメッセージング: ユーザーの好みに基づいて、パーソナライズされたメッセージを送信できます。
- リッチメディアコンテンツ: Viber メッセージで画像、動画、ファイルを使用して、メッセージをより視覚的にすることができます。
- 自動化されたキャンペーン: スケジュールされた時刻にメッセージを自動的に送信したり、ユーザーのアクションに基づいてメッセージをトリガーしたりできます。
Viber 統合でメッセージを送信する方法
Viber 統合では、次の方法でメッセージを送信できます。- ネイティブ API: MoEngage キャンペーンを使用して、Viber API でメッセージを送信できます。
- Infobip コネクター: Infobip コネクターを使用して、Viber ユーザーにメッセージを送信できます。
- 8x8 コネクター: 8x8 Chat Apps API を使用して、Viber でユーザーとエンゲージできます。このコネクターを使用すると、テキスト、メディア (画像、動画、ファイル)、Call-to-Action (CTA) ボタン付きのメッセージを MoEngage キャンペーンから直接送信できます。
ネイティブによる統合
前提条件
- Viber ボット: この統合を使用するには、Viber ボットが必要です。Viber メッセージを送信すると、メッセージは Viber ボットの公式アカウントに関連付けられ、ユーザーにはボットの詳細が表示されます。ボットの作成について詳しくは、Viber Partners ポータルを参照してください。
- 有効な認証トークン: ボットをサポートする有効な Viber アカウント (iOS または Android)。アカウント作成時に、その Viber アカウントがアカウント管理者として設定されます。
- アカウント認証トークン: この一意のアカウント識別子により、すべての API リクエストでアカウントが検証されます。アカウントを作成すると、アカウントの情報編集画面に認証トークンが表示されます (管理者のみ)。
- Viber ユーザー ID: 各 Viber ユーザーに関連付けられた一意の ID です。
注: ユーザーが Viber ボットを購読した後、Viber Users API を通じてユーザーの ID にアクセスできます。 - アカウントの Webhook の設定: メッセージの処理を構成するために、アカウントの設定時に Webhook とレスポンスの設定を定義します。
- Viber は Connected Channels アドオンの一部です。アカウントで有効にするには、MoEngage の担当 CSM (カスタマーサクセスマネージャー) にお問い合わせください。
- ユーザーが Viber ボットに最初のメッセージを送信すると、自動的に購読されます。
- パーソナライズされたキャンペーンは、ユーザー識別子 (電話番号) を保持しているユーザーにのみ送信できます。
- Viber ボットは、ユーザーにデフォルトの電話番号を割り当てません。電話番号は次の 2 つの方法で取得できます。
- ユーザーの Viber ID にブロードキャストメッセージを送信して、ユーザーに直接リクエストする必要があります。
- Viber の Business Messages サービスを利用している場合は、電話番号に直接アクセスできます。
ステップ 1: App Marketplace で Viber を接続する
App marketplace で Viber を接続するには、次の手順を実行します。- MoEngage ダッシュボードの左側のナビゲーションメニューで、App marketplace をクリックします。
- App Marketplace ページで Viber を検索します。

- Viber タイルをクリックします。
- Viber ページで、Integrate タブに移動します。
- + Add integration の下矢印キーをクリックし、Send messages (Native) をクリックします。

- 次の詳細を入力します。

- Connect をクリックします。これで Viber 接続が統合されました。
ステップ 1.1: ユーザーの Viber ID を収集する
Viber でメッセージを送信するには、ユーザーを識別して一貫したやり取りを行うために、ユーザーの Viber ID を収集する必要があります。Viber ユーザー ID は Viber によって生成され、Viber API とやり取りする際に使用できます。ステップ 1.2: ユーザーの Viber ID を MoEngage に保存する
Viber ユーザー ID の一覧を取得したら、カスタムのトラッキング対象ユーザー属性またはプロパティである viber_id として MoEngage に追加する必要があります。次のいずれかを実行できます。- User Data API を使用してこのデータを MoEngage に渡す。
- MoEngage 内の User Imports を使用してアップロードする。
ステップ 2: MoEngage で Viber キャンペーンを作成する
MoEngage でキャンペーンを作成するには、次の手順を実行します。- MoEngage ダッシュボードの左側のナビゲーションメニューで Engage をクリックし、Campaigns をクリックします。
- All campaigns ページで、+ Create campaign をクリックします。
- Create campaign ダイアログボックスの Connected Apps で Viber をクリックし、最も適した配信タイプをクリックします。

- Select audience で Filter users by をクリックします。
- User property タブで、Viber_id が存在するユーザーのセグメントを選択します (他のセグメント条件と組み合わせることができます)。
- キャンペーン作成のステップ 2 (Content) で、ネイティブメッセージコネクターを選択し、送信するコンテンツを指定します。
- 次の詳細を入力します。
- 送信する Message type を選択します。サポートされているタイプは Text、Picture、Video です。タイプに応じて、以下のセクションのフィールドに入力します。
- テキストメッセージ
- 画像メッセージ
- 動画メッセージ
Text を選択した場合は、次の詳細を入力します。
- これで、キャンペーンをテストして送信する準備が整いました。Test 機能を使用して、コネクターの設定をテストすることもできます。
テストユーザーがメッセージを正常に受信できれば、セットアップは完了です。 - キャンペーンを公開します。
Infobip による統合
前提条件
- Viber ボット: この統合を使用するには、Viber ボットが必要です。Viber メッセージを送信すると、メッセージは Viber ボットの公式アカウントに関連付けられ、ユーザーにはボットの詳細が表示されます。ボットの作成について詳しくは、こちらを参照してください。
- Infobip API: 接続された Viber ボットとの Viber 接続を確立し、Infobip API にアクセスできるようにします。
ステップ 1: App marketplace で Viber を接続する
App marketplace で Viber を接続するには、次の手順を実行します。- MoEngage ダッシュボードの左側のナビゲーションメニューで、App marketplace をクリックします。
- App Marketplace ページで Viber を検索します。

- Viber タイルをクリックします。
- Viber ページで、Integrate タブに移動します。
- +Add integration ドロップダウンをクリックし、Send messages (Infobip) をクリックします。

- 次の詳細を入力します。
- Connect をクリックします。これで Viber 接続が統合されました。
ステップ 1.1: ユーザーの Viber ID を収集する
Viber でメッセージを送信するには、ユーザーを識別して一貫したやり取りを行うために、ユーザーの Viber ID を収集する必要があります。Viber ユーザー ID は Viber によって生成され、Viber API とやり取りする際に使用できます。ステップ 1.2: ユーザーの Viber ID を MoEngage に保存する
Viber ユーザー ID の一覧を取得したら、カスタムのトラッキング対象ユーザー属性またはプロパティである viber_id として MoEngage に追加する必要があります。次のいずれかを実行できます。- User Data API を使用してこのデータを MoEngage に渡す
- MoEngage 内の User Imports を使用してアップロードする。
ステップ 2: MoEngage で Viber キャンペーンを作成する
- MoEngage ダッシュボードの左側のナビゲーションメニューで Engage をクリックし、Campaigns をクリックします。
- All campaigns ページで、+ Create campaign をクリックします。
- Create campaign ダイアログボックスの Connected Apps で Viber をクリックし、最も適した配信タイプをクリックします。

- Select audience で Filter users by をクリックします。
- User property タブで、viber_id が存在するユーザーのセグメントを選択します (他のセグメント条件と組み合わせることができます)。
- キャンペーン作成のステップ 2 (Content) で、Infobip のメッセージ送信コネクターを選択し、送信するコンテンツを指定します。
- 次の詳細を入力します。

- Message type として Text、Image、Video、File のいずれかを選択します。タイプに応じて、以下のセクションのフィールドに入力します。
- テキストメッセージ
- 画像メッセージ
- 動画メッセージ
- ファイルメッセージ
Text を選択した場合は、次のフィールドに入力します。
- これで、キャンペーンをテストして送信する準備が整いました。Test 機能を使用して、コネクターの設定をテストすることもできます。
テストユーザーがメッセージを正常に受信できれば、セットアップは完了です。 - キャンペーンを公開します。
8x8 コネクターによる統合
前提条件このコネクターを設定する前に、次のものが揃っていることを確認してください。
- 8x8 Connect アカウント: 有効な 8x8 Connect ポータルアカウントが必要です。
- Viber チャネルの有効化: 8x8 のサブアカウントで Viber がプロビジョニングされている必要があります。Viber チャネルのプロビジョニングについては、8x8 のアカウントマネージャーまたは 8x8 サポートにお問い合わせください。
- 8x8 API アクセス: 8x8 Connect ポータル内で API キーを生成し、サブアカウント ID を確認できるアクセス権が必要です。
ステップ 1: App Marketplace で Viber を接続する
App marketplace で 8x8 コネクターを接続するには、次の手順を実行します。- MoEngage UI の左側のナビゲーションメニューで、App marketplace をクリックします。
- App Marketplace ページで Viber を検索します。
- Viber タイルをクリックします。
- Viber ページで、Integrate タブに移動します。
- Add integration の下矢印キーをクリックし、Send messages (8x8) をクリックします。

- 次の詳細を入力します。
- フィールドに入力したら、Connect をクリックしてコネクターの設定を完了します。

ステップ 2: MoEngage で 8x8 コネクターキャンペーンを作成する
MoEngage でキャンペーンを作成するには、次の手順を実行します。- MoEngage UI の左側のナビゲーションメニューで Engage をクリックし、Campaigns をクリックします。
- All campaigns ページで、+ Create campaign をクリックします。
- Create campaign ダイアログボックスの Connected Apps で Viber をクリックし、最も適した配信タイプをクリックします。

- Select audience で Filter users by をクリックします。
- User property タブで、viber_id が存在するユーザーのセグメントを選択します (他のセグメント条件と組み合わせることができます)。
- キャンペーン作成のステップ 2 (Content) で、8x8 Viber コネクターを選択し、送信するコンテンツを指定します。
- 次の詳細を入力します。

- テキストメッセージ
- 画像メッセージ
- 動画メッセージ
- ファイルメッセージ
Text を選択した場合は、次のフィールドに入力します。
メッセージの組み合わせ
このコネクターは、さまざまなコンテンツの組み合わせをインテリジェントに処理します。- テキスト + ボタン: CTA ボタン付きのテキストメッセージを送信します。
- 画像 + ボタン: 画像と CTA ボタンを含むメッセージを送信します。
- 動画 + ボタン: CTA ボタンも含む動画またはファイルのメッセージを送信します。
- メディアのみ: Image、Video、File のみを含むメッセージを送信するには、Content Type を選択し、Media URL (および該当する場合は Video Content Details) を指定します。
分析と配信の追跡
8x8 コネクターは、キャンペーンの配信ステータスを自動的に追跡します。8x8 からの API レスポンスに基づいて、次の MoEngage イベントが作成されます。- Connected App Campaign Sent: このイベントは、8x8 API がメッセージリクエストを正常に受け付けた (200 OK レスポンスを受信した) ときにトリガーされます。
- Connected App Campaign Failed: このイベントは、8x8 API が何らかのエラー (200 以外のレスポンスコード) を返した場合にトリガーされ、メッセージを送信できなかったことを示します。
チャネルまたはグループに Viber メッセージを送信する
- チャネルまたはグループにメッセージを送信するために、MoEngage で新しいユーザーを作成します。ここでの Viber ID がチャネル ID またはグループ ID であることを確認してください。
- そのユーザー用のセグメントを作成してユーザーを選択します。セグメントには 1 人のユーザーのみが含まれるようにしてください。キャンペーンに複数のユーザーが選択されていると、メッセージがチャネルまたはグループに何度も送信されます。
- Create Campaign のステップ 2 で、チャネルまたはグループの Viber ID を入力します。ここではパーソナライズも使用できます。
キャンペーン分析
MoEngage のキャンペーンでは、キャンペーンのパフォーマンスを分析できる強力な分析機能を提供しています。MoEngage の各チャネルには、キャンペーン目標を定量化するのに役立つ詳細な指標が用意されています。MoEngage の分析機能の詳細については、キャンペーン分析を参照してください。 Viber キャンペーンでは、デフォルトで次の指標が提供されます。- Attempted: フリークエンシーキャップ (FC) を超過したユーザーを除外した後、Attempted は Viber キャンペーンの対象となり、メッセージの送信を試みたユーザーの数として計算されます。
- Failed: Viber がメッセージを送信しなかったユーザー、またはキャンペーンで使用されたユーザー属性やイベント属性に対する値が見つからなかったユーザーの数です。
