Talkable

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

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

連携について

Talkableは、Brazeが推進するカスタマージャーニーにアドボケイト主導のアクイジションをもたらします。この連携は、Talkableが取得したすべてのリファラルオプトインを、対応するBrazeプロファイルにリアルタイムで移動させます。これにより、ウェルカムフロー、リファラルジャーニー、セグメンテーション、ライフサイクルメッセージングを、信頼できる同意とリファラルコンテキストから起動できます。手動のリストエクスポートやバッチ同期は不要です。

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

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

いずれの場合も、Talkableは対応するBrazeユーザープロファイルをリアルタイムで作成または更新し、ユーザーのメールサブスクリプション状態をオプトインに設定します。

デフォルトの動作

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

ユースケース

• アドボケイトがTalkableリファラルキャンペーンにサインアップした瞬間に、BrazeウェルカムCanvasをトリガーします。
• フレンドがオプトインした直後に、フレンド専用のCanvasとパーソナライズされた初回購入オファーで紹介されたフレンドをアクティベートします。
• 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で、オーディエンス > ユーザー検索に移動し、テストメールアドレスで検索します。
3. プロファイルが存在し、メール購読がオプトインに設定されていること、および設定したカスタム属性、サブスクリプショングループ登録、またはユーザーエイリアスが期待どおりに表示されていることを確認します。

ステップ 4:ライブトラフィックに対してアクションを有効にする

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

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

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

すべてのオプトインイベントで、Talkableは以下の標準Brazeユーザー属性を使用して、対応するBrazeユーザープロファイルを作成または更新します。空の値は省略されます。

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

Talkableのカスタマイズ

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

オプトインをBrazeサブスクリプショングループに登録する

1. Brazeで、オーディエンス > 購読グループ管理からサブスクリプショングループIDをコピーします。詳細については、ユーザーサブスクリプションの管理を参照してください。
2. TalkableのEmail opt-inアクションで、Subscription group identifierフィールドに貼り付けます。

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が作成または更新したプロファイルを表示します。

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

リファラルSegmentを構築する

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

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

1. アクションベースの配信でCanvasまたはCampaignを構築します。この連携では以下のBrazeトリガータイプが機能します。
   • サブスクリプションステータスの更新（例：メールサブスクリプションがオプトインになった場合）
   • サブスクリプショングループステータスの更新（サブスクリプショングループが設定されている場合）
   • カスタム属性値の変更（送信するTalkableカスタム属性に対して）。
2. プロファイル上のTalkableカスタム属性（キャンペーン名、報酬値、紹介者など）でメッセージをパーソナライズします。

考慮事項

• メールオプトインのみ： 電話番号は標準ユーザー属性として取得されますが、この連携ではSMSサブスクリプション状態は設定されません。TalkableはSMSオプトインを同期しません。
• 電話番号の形式： Brazeは国際（E.164）形式の電話番号を想定しています。
• リアルタイムのイベント駆動型同期： Talkableはオプトインイベントごとに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]までメールしてください。