コンテンツへスキップ
AI アシスタントの Rex:面倒な作業はおまかせ、アイデアはあなたのもの 👉 Rex のご紹介

Klaviyoを連携する

Klaviyoで適切なスコープを持つプライベートAPIキーを作成して連携し、新規登録者をKlaviyoのリストに登録しましょう。

Klaviyo連携を使うと、登録したすべての人がKlaviyoのプロフィールとして作成または更新され、選択したリストに追加され、メールマーケティングの購読者として登録されます。

必要なもの

  • Klaviyoアカウント(無料プランでも利用できます)。
  • プライベートAPIキーを作成できるKlaviyoユーザー(Klaviyoでは通常、Owner、Admin、Managerのいずれか)。

ステップ1:KlaviyoでプライベートAPIキーを作成する

  1. Scratcherで設定 > 連携に移動し、Klaviyoをクリックしてセットアップガイドを確認します:「プライベートAPIキーを作成してください。適切な権限があらかじめ選択されています。」
  2. プライベートAPIキーを作成のリンクをクリックします。適切なスコープが選択された状態でKlaviyoが開きます。求められた場合はKlaviyoにログインしてください。
  3. キーに分かりやすい名前を付けます(例:「Scratcher」)。
  4. スコープを確認し(下記のリストを参照)、キーを作成します。
  5. キーをコピーします。キーは「pk_」で始まります。Klaviyoではキー全体が一度しか表示されないため、貼り付けが完了するまでタブを開いたままにしてください。

キーをご自身で作成する場合は、Klaviyoでアカウント名の下にあるメニューを開き、Settings > API keysに移動してCreate Private API Keyをクリックします。Custom Keyを選択し、以下のスコープを設定してください。

キーに必要なスコープ

キーには次のスコープが正確に必要です(Scratcherのヘルプテキスト:「APIキーには『Lists』と『Profiles』の読み取り/書き込み権限、および『Subscriptions』の書き込み権限が必要です」)。

  • Lists:読み取りと書き込み。リストを表示し、そこに人を追加するために使用します。
  • Profiles:読み取りと書き込み。プロフィールの作成と更新に使用します。
  • Subscriptions:書き込み。メールマーケティングへの購読登録に使用します。

その他のスコープはすべてNo Accessのままで構いません。

ステップ2:KlaviyoをScratcherに連携する

  1. ScratcherのKlaviyoダイアログで、プライベートAPIキーにキーを貼り付けます。アクセス権限の欄には、Scratcherが実行できる内容が表示されます:「連絡先とリストへの読み取り・書き込みアクセス」および「キャンペーン参加者の自動バックグラウンド同期」。
  2. 連携をインストールをクリックします。Scratcherがキーでリストを読み取れるかを確認します。

ステップ3:キャンペーンで有効にする

  1. エディターで接続 > 連携 > Klaviyoに移動し、有効化をクリックします。
  2. 複数のKlaviyoアカウントを連携している場合は、アカウントを選択でアカウントを選びます。
  3. 外部リストで、Klaviyoのリストを選択します。
  4. フィールドマッピングで、プロフィールに追加したいデータを設定します。ここではKlaviyoのプロパティ名をご自身で入力します(外部フィールド名)。例:「favourite_product」や「Campaign」。
  5. **権限でフィルター(任意)**で、マーケティング同意のチェックボックスを選択します。
  6. 保存をクリックし、続いてテストをクリックします。

フィールドマッピング

  • メールアドレス、電話番号、名、姓は、Klaviyo標準のプロフィールフィールドに自動的に送信されます。マッピングは不要です。
  • マッピングした項目はすべて、入力した名前でプロフィールのカスタムプロパティとして保存されます。プロパティがまだ存在しない場合は、Klaviyoが自動的に作成します。
  • Klaviyoは「+」と国番号付きの電話番号のみ受け付けます。フォームの電話番号フィールドに国番号が含まれるようにしてください。

同意

Scratcherは、送信するすべての人をKlaviyoのメールマーケティングに購読登録し、ソースは「Scratcher」となります。そのため、同意フィルターが重要です。フォームでマーケティングのチェックボックスが任意の場合は、**権限でフィルター(任意)**でそのチェックボックスを選択してください。

Klaviyoのリストでダブルオプトインを使用している場合、Klaviyoが独自の確認メールを送信し、受信者が確認した時点で購読登録されます。その後、リストに追加された人を対象にKlaviyoでウェルカムフローを開始できます。

送信内容とタイミング

新規登録は1〜2分以内に送信されます。連携を有効化すると、キャンペーンの既存のリードも送信されます。同じ人が再度参加した場合は、そのプロフィールが更新されます。

トラブルシューティング

送信に失敗したデータは、設定 > 連携 > 配信ステータスに表示されます。

  • 「The API key used does not have the correct API Scopes.」:キーに上記のスコープのいずれかが不足しています。Klaviyoでキーを編集するか、セットアップリンクから新しいキーを作成し、新しいアカウントを追加で連携してください。
  • 「Conflict: Duplicate profile detected.」:Klaviyoで一致するプロフィールが2つ見つかりました(例:メールアドレスが一致するものと、同じ電話番号を持つ別のもの)。Klaviyoでプロフィールを統合または修正してから、再送信してください。
  • 電話番号が拒否される:番号に国番号がありません。フォームの電話番号フィールドに国選択を追加してください。
  • インストール後に何も届かない:キャンペーンの外部リストでリストが選択されていること、そして保存をクリックしたことを確認してください。
お困りですか?

まだお困りですか?

担当者がサポートします。すでに Scratcher をご利用の場合は、プラットフォーム内のチャットが最も早い方法です。

  • チャットで相談

    ログインして右下のチャットボタンをクリックしてください。Rex がすぐに回答し、チームにもワンクリックでつながります。

  • ミーティングを予約

    チームとの 30 分の無料ビデオ通話:製品ツアー、キャンペーンのアイデア、設定のサポート。

  • メールで問い合わせ

    contact@scratcher.io までご連絡いただければ、折り返しご返信します。