PAR PunchhでSMS同意を同期する方法

このページで学べること

PAR PunchhからKlaviyoにSMS購読のオプトインを同期し、確認済みの購読をPunchhに送り返す方法をご覧ください。

まだの方は、この記事を読み進める前に、まず連携手順を段階的に説明した PAR Punchh のスタートガイドをお読みください。

始める前に

• PAR Punchh がすでに Klaviyo と連携されていることを確認してください。PAR Punchh のスタートガイドでご確認ください。
• KlaviyoでSMSを設定し、ダブルオプトインに設定されたSMSリストがあることを確認してください。ダブルオプトインのプロセスについて詳細はこちらをご覧ください。
• PunchhダッシュボードのWhitelabelセクションとGuestsセクションへのアクセスを含め、PAR Punchhアカウントで管理者権限またはそれに準ずるアクセス権限を持っていることを確認してください。これらのセクションが表示されない場合は、Punchhの担当者までお問い合わせください。
• Punchh の登録体験で、SMS の同意をメールの同意とは別に収集し、収集時点で準拠した SMS 開示文言を表示するようにしてください。SMS 同意の収集とSMS 開示文言の設定の詳細をご覧ください。

Punchh で SMS 同意の同期を設定する

Punchhで設定することは2つあります：

1. Klaviyo が Punchh に確認済みの同意を書き戻すために使用するクライアント ID とシークレットを提供する OAuth アプリ。
2. Punchhで各ゲストのSMSマーケティングのSMS購読のオプトインを保存するゲストプロファイルフィールドです。

OAuthアプリを作成し、認証情報を取得してください

1. PAR Punchh の管理画面にログインします。
2. [Whitelabel] > [OAuth Apps] > [New Application] に移動します。詳しくはPunchh のヘルプセンターの記事をご覧ください。
3. アプリケーションを作成します。コールバック URL と SSO 設定はこの外部連携では使用されないため、デフォルトのままにしておけます。
4. Client Id と Secret をコピーし、安全な場所に保存してください。両方を Klaviyo に入力します。
5. Punchh の担当者に POS ビジネスキー をリクエストし、安全な場所に保存してください。これは Klaviyo にも入力します。

プロファイルフィールドを設定してください

Punchhは、各ゲストのSMSマーケティングのオプトインを、カスタムゲストプロファイルフィールドに保存します。Klaviyoは、すべてのゲストWebhookでこのフィールドを名前で検索するため、以下の説明どおりに正確に設定しないと同期は機能しません。

1. PAR Punchh 管理画面で Guests > Profile Field Settings に移動します。
2. 次の値を使用して新しいプロファイルフィールドを作成してください：
   • コード： klaviyo_sms_consent_flag
   • タイプ：複数選択-単一回答
   • サイズ：5
   • 必須： はい
   • 更新可能：はい
   • 値：True|False
3. プロファイルフィールドを保存してください。
4. サインアップフォーム（iFrameまたはモバイルアプリ）にあるSMSマーケティング同意チェックボックスが、このプロファイルフィールドに書き込まれていることを確認してください。

Klaviyo で SMS 同意の同期を設定する

クライアントID、シークレット、ビジネスキーを取得したら、Klaviyoで同期を有効にしてください。

1. Klaviyo で、[外部連携] タブを選択します。
2. Punchh を選択します。
3. PunchhのSMS購読者をKlaviyoに同期を確認してください。
4. ドロップダウンから、メインのSMSリスト（または必要に応じて別のリスト）を選択します。リストはダブルオプトインを使用する必要があります。
5. 次の認証情報を入力してください：
   • クライアント ID：Punchh の OAuth アプリにあるクライアント ID。
   • Secret：PunchhのOAuthアプリのSecret。
   • ビジネスキー：POSのビジネスキー。Punchhの担当者に依頼して取得できます。
6. [保存] をクリックします。

Punchh SMS 同意の同期の仕組み

両側の設定が完了すると、以下の手順は、テキストで確認した新規SMS購読者に適用されます：

1. ゲストがPunchhでSMSの受信に同意します。サインアップ時（または後でプロファイルを更新するとき）にSMSマーケティングの同意チェックボックスをオンにすると、Punchhはklaviyo_sms_consent_flagプロファイルフィールドをtrueに設定し、ゲストのWebhookをKlaviyoに送信します。
2. Klaviyo がダブルオプトインのプロセスを開始します。Klaviyo が、プロファイルフィールドが true で電話番号が存在する Webhook を受信すると、その電話番号を Punchh の外部連携設定で選択した SMS リストに購読します。そのリストはダブルオプトインに設定されているため、Klaviyo はゲストに確認テキストを自動的に送信します。
3. ゲストが確認します。ゲストがダブルオプトインのテキストに返信して、購読を確認します。返信するまではリストのメンバーではなく、SMSマーケティングメッセージは受信しません。
4. ゲストがリストに追加されます。確認後、ゲストは Punchh 外部連携設定で指定したSMSリストに追加され、Klaviyoプロファイルには同意ソースがPunchhのSMSマーケティング同意が記録されます。
5. KlaviyoがPunchhに確認結果を返します。ゲストが選択したリストに登録すると、KlaviyoはSMSマーケティングの同意が引き続きあることを確認し、確認済みの購読をPunchhに返送します。これにより、Punchhはゲストのネイティブsms_subscriptionフィールドをtrueに設定します。

Klaviyoで既にSMSマーケティングの同意があるゲストは、別途ダブルオプトインのテキストを送信せずに、選択したリストに追加できます。

達成できること

これで、PAR PunchhとKlaviyo間のSMS同意同期の設定が完了しました。SMSの購読を確認した新規ゲストは、選択したKlaviyo SMSリストに追加され、Klaviyoは確認済みの購読情報をPunchhに送り返します。

その他のリソース