Talkable

Talkableは、消費者ブランドが満足した顧客をスケーラブルなリファラルチャネルに変えることを支援します。Brazeとの連携により、Talkableリファラルキャンペーンで取得されたマーケティングメールオプトインがリアルタイムでBrazeに流れ込み、新しいアドボケイトやフレンドをウェルカム、セグメント化、エンゲージするために必要な同意、コンテキスト、キャンペーンデータをチームに提供します。

この連携はTalkableによって管理されています。

連携について

Talkableは、Brazeが構築するカスタマージャーニーにアドボケート主導のユーザー獲得を組み込みます。この連携により、Talkableが取得したすべてのリファラルオプトインがリアルタイムで対応するBrazeプロファイルに連携されます。これにより、ウェルカムフロー、リファラルジャーニー、セグメンテーション、ライフサイクルメッセージングを、信頼性のある同意とリファラルコンテキストに基づいて開始できます。手動のリストエクスポートやバッチ同期は不要です。

Talkableは、以下の2つのシナリオでマーケティングオプトインを取得します。

• アドボケートのサインアップ: アドボケートがTalkableのリファラルキャンペーンにサインアップし、マーケティングメールの受信に同意します。
• フレンドのメールゲーティング: フレンドがTalkableのメールゲーティングステップを完了し、マーケティングメールにオプトインします。

いずれの場合も、Talkableは対応するBrazeユーザープロファイルをリアルタイムで作成または更新し、ユーザーのメール購読ステータスをOpted Inに設定します。

デフォルトの動作

TalkableがBrazeにデータを送信するのは、Talkableで明示的に同意したユーザーからの個別のオプトインイベントが発生した場合のみです。対象となるのは、キャンペーンにサインアップしたアドボケート、またはメールゲーティング中にオプトインしたフレンドです。Talkableは、夜間バッチ処理、フル同期、暗黙的なプロファイル更新を実行しません。Talkableは、オプトインしていないプロファイルをBrazeに送信することはありません。

ユースケース

• 推奨者がTalkableの紹介キャンペーンに登録した瞬間に、Brazeのウェルカムキャンバスをトリガーします。
• 紹介された友人がオプトインした直後に、友人専用のキャンバスとパーソナライズされた初回購入オファーでアクティベートします。
• Brazeのカスタム属性として送信される推奨者フラグや友人フラグ、キャンペーンメタデータを使用して、紹介コンテキストでセグメント化します。
• 紹介オプトインを指定されたBrazeの購読グループにルーティングし、コンプライアンスに準拠したニュースレター送信を実現します。

前提条件

始める前に、以下が必要です。

前提条件	説明
Talkableアカウント	このパートナーシップを活用するには、少なくとも1つのキャンペーンが設定されたTalkableサイトが必要です。
Braze REST APIキー	users.track 権限を持つBraze REST APIキー。このキーはBrazeダッシュボードの設定 > APIキーから作成できます。詳細については、REST APIキーの作成を参照してください。
Braze RESTエンドポイント	Braze RESTエンドポイントURL（例：https://rest.iad-01.braze.com）。US（.com）およびEU（.eu）のBrazeクラスターがサポートされています。詳細については、REST APIエンドポイントを参照してください。

連携

ステップ1：TalkableにBrazeアプリをインストールする

1. Talkable管理画面にサインインしてメニューを開き、All Site Settings > App Storeに移動します。
2. Brazeを見つけてInstallを選択します。
3. BrazeのRESTエンドポイントとusers.track権限を持つREST APIキーを入力し、Saveを選択します。

ステップ2：メールオプトインアクションを設定する

1. TalkableのBrazeアプリで、Email opt-inアクションを開きます。
2. （任意）Brazeの購読グループ識別子を入力し、カスタム属性を追加し、ユーザーエイリアスを設定します。詳細については、Talkableのカスタマイズを参照してください。
3. Saveを選択します。ライブのオプトインイベントが同期される前にテストペイロードで設定を確認できるよう、アクションは無効のままにしておきます。

ステップ3：サンプルペイロードでテストする

1. Talkableで、Email opt-inアクションのSend sample payloadを選択し、Brazeにテストリクエストを送信します。
2. Brazeで、Audience > User Searchに移動し、テスト用のメールアドレスで検索します。
3. プロファイルが存在し、Email SubscribeがOpted Inに設定されていること、また設定したカスタム属性、購読グループの登録、ユーザーエイリアスが期待どおりに表示されていることを確認します。

ステップ4：ライブトラフィック用にアクションを有効化する

Brazeでテストプロファイルが正しく表示されていることを確認したら、Talkableに戻り、Email opt-inアクションを有効化します。

この時点から、Talkableのすべてのオプトインイベントがリアルタイムで対応するプロファイルをBrazeに同期します。

Brazeに送信されるデフォルトのユーザー属性

オプトインイベントが発生するたびに、Talkableは対応するBrazeユーザープロファイルを作成または更新し、以下の標準的なBrazeユーザー属性を設定します。空の値は省略されます。

Braze属性	タイプ	注記
email_subscribe	String	すべてのTalkableオプトインイベントでOpted Inに設定されます。
email	String	Brazeプロファイルの照合に使用されるプライマリ識別子です。
phone	String	ユーザー属性としてのみ取得されます。BrazeはE.164形式を想定していますが、Talkableに保存されたままの形式で送信されます。
first_name	String	ユーザーの名です。
last_name	String	ユーザーの姓です。
購読グループへの登録	該当なし	購読グループが設定されている場合、Talkableはユーザーを購読済みとして登録します。
ユーザーエイリアス	該当なし	ユーザーエイリアスが設定されている場合にのみ追加されます。詳細については、Talkableのカスタマイズを参照してください。

Talkableのカスタマイズ

以下のオプションカスタマイズが利用可能です。これらは独立しているため、任意の組み合わせで設定できます。

オプトインをBraze購読グループに登録する

1. Brazeで、オーディエンス > 購読グループ管理から購読グループIDをコピーします。詳細については、ユーザー購読の管理を参照してください。
2. Talkableのメールオプトインアクションで、購読グループ識別子フィールドにペーストします。

Talkableは各オプトインを購読済みとしてその購読グループに登録し、リファラルオプトインをグローバル購読ではなくそのグループにスコープします。Talkableは購読の追加のみを行い、削除することはありません。

カスタム属性を送信する

アクションのペイロードエディターに任意のキーバリューペアを追加します。入力したキーがBrazeユーザープロファイルの属性名になります。

値はLiquidテンプレートに対応しています。以下の変数が利用可能です。

変数	内容
{{ person }}	オプトインした紹介者または友人（email、first_name、last_name、phone_number、username、is_advocate、custom_propertiesなど）。
{{ ip }}	オプトインが行われたIPアドレス。
{{ campaign }}	元のTalkableキャンペーン（name、type、tag_namesなど）。

例：talkable_is_advocate = {{ person.is_advocate }} および talkable_campaign_name = {{ campaign.name }} を追加して、Brazeでリファラルコンテキストによるセグメンテーションを行います。

Brazeユーザーエイリアスでユーザーを識別する

ペイロードエディターで、user_alias.alias_name（例：{{ person.username }}）と user_alias.alias_label（例：username）を追加します。詳細については、ユーザーエイリアスオブジェクトを参照してください。

両方のフィールドが存在する場合、システムはメールに加えてエイリアスでユーザーを識別し、一致するプロファイルが存在しない場合はBrazeが新しいエイリアス付きプロファイルを作成します。

Brazeでのユーザーの検索と作成

• デフォルトでは、Brazeはメールアドレスでプロファイルを照合します。一致するプロファイルが存在しない場合、Brazeは新しいプロファイルを作成します。
• ユーザーエイリアスが設定されている場合、Brazeはそのエイリアスでも照合を行い、一致するものがなければ新しいエイリアス付きプロファイルを作成します。
• external IDはこの連携では使用されません。Talkableのオプトインを既存の外部識別済みプロファイルに紐付けるには、そのプロファイルの既知のエイリアスと一致するラベルを持つユーザーエイリアスを設定してください。

Braze で Talkable を使用する

同期されたユーザーを見つける

オーディエンス > ユーザー検索 に移動し、メールで検索して Talkable が作成または更新したプロファイルを表示します。

標準フィールド（メール、電話番号、名、姓）および設定したカスタム属性がプロファイルに表示されます。Email Subscribe には Opted In と表示されます。

リファーラルセグメントを作成する

1. Email Subscribe が Opted In でフィルタリングしたセグメントを作成します。
2. Talkable が送信するカスタム属性で絞り込みます。たとえば、talkable_is_advocate が true に等しい場合はアドボケイトをターゲットにし、talkable_campaign_name がキャンペーン名に等しい場合は特定のリファーラルプログラムをターゲットにします。

ライフサイクルメッセージングをトリガーする

1. アクションベース配信のキャンバスまたはキャンペーンを作成します。この連携では以下の Braze トリガータイプが機能します。
   • Update Subscription Status（たとえば、メール購読が Opted In に変わった場合）
   • Update Subscription Group Status（購読グループが設定されている場合）
   • Change Custom Attribute Value（送信する Talkable カスタム属性に対して）
2. プロファイル上の Talkable カスタム属性（キャンペーン名、リワード値、紹介者など）を使用してメッセージをパーソナライズします。

考慮事項

• メールオプトインのみ: 電話番号は標準のユーザー属性として取得されますが、このインテグレーションではSMS購読ステータスは設定されません。TalkableはSMSオプトインを同期しません。
• 電話番号の形式: Brazeでは電話番号を国際（E.164）形式で入力する必要があります。
• リアルタイムのイベント駆動型同期: Talkableはオプトインイベントごとに1つのリクエストを送信します（1リクエストにつき1ユーザー）。バッチ処理や定期的なフル同期はなく、ボリュームはリファーラルオプトインのボリュームに連動します。
• 信頼性の高い配信: Brazeが一時的にエラーを返した場合、Talkableは自動的にリトライします。持続的な障害が発生した場合は、サイト管理者にメールアラートが送信されます。

トラブルシューティング

エラー	考えられる原因	修正方法
401 Unauthorized	REST APIキーに users.track 権限がない、またはエンドポイントが誤ったクラスターを指しています。	users.track 権限を持つキーを再発行し、RESTエンドポイントがお使いのBrazeクラスターと一致していることを確認してください。
インストール時にRESTエンドポイントが拒否される	URLがBraze RESTエンドポイントではありません。	クラスターのRESTエンドポイントを使用してください（例：https://rest.iad-01.braze.com）。ダッシュボードのURLでは機能しません。
プロファイルが作成されたが購読グループに含まれていない	購読グループIDが設定されていません。	Email opt-in アクションに購読グループIDを入力してください。
ユーザーエイリアスが適用されない	2つのエイリアスフィールド（名前またはラベル）のうち1つしか入力されていません。	アクションの両方のフィールド（エイリアス名とエイリアスラベル）を入力してください。
プロファイルが表示されない	サンプルリクエストがまだ送信されていない、またはアクションが無効になっています。	Talkableで Send sample payload を選択し、Email opt-in アクションが有効になっていることを確認してください。
キーのローテーション後にリクエストの送信が停止した	保存されたAPIキーがBrazeで失効または置き換えられました。	Talkableの App Store でBrazeアプリを開き、新しいREST APIキーを貼り付けて Save を選択してください。Send sample payload で再テストしてください。

Talkable連携の詳細については、Talkable Braze連携ドキュメントを参照してください。Talkableサポートへの問い合わせは、[email protected] までメールしてください。