Klaviyo連携を使うと、登録したすべての人がKlaviyoのプロフィールとして作成または更新され、選択したリストに追加され、メールマーケティングの購読者として登録されます。
必要なもの
- Klaviyoアカウント(無料プランでも利用できます)。
- プライベートAPIキーを作成できるKlaviyoユーザー(Klaviyoでは通常、Owner、Admin、Managerのいずれか)。
ステップ1:KlaviyoでプライベートAPIキーを作成する
- Scratcherで設定 > 連携に移動し、Klaviyoをクリックしてセットアップガイドを確認します:「プライベートAPIキーを作成してください。適切な権限があらかじめ選択されています。」
- プライベートAPIキーを作成のリンクをクリックします。適切なスコープが選択された状態でKlaviyoが開きます。求められた場合はKlaviyoにログインしてください。
- キーに分かりやすい名前を付けます(例:「Scratcher」)。
- スコープを確認し(下記のリストを参照)、キーを作成します。
- キーをコピーします。キーは「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に連携する
- ScratcherのKlaviyoダイアログで、プライベートAPIキーにキーを貼り付けます。アクセス権限の欄には、Scratcherが実行できる内容が表示されます:「連絡先とリストへの読み取り・書き込みアクセス」および「キャンペーン参加者の自動バックグラウンド同期」。
- 連携をインストールをクリックします。Scratcherがキーでリストを読み取れるかを確認します。
ステップ3:キャンペーンで有効にする
- エディターで接続 > 連携 > Klaviyoに移動し、有効化をクリックします。
- 複数のKlaviyoアカウントを連携している場合は、アカウントを選択でアカウントを選びます。
- 外部リストで、Klaviyoのリストを選択します。
- フィールドマッピングで、プロフィールに追加したいデータを設定します。ここではKlaviyoのプロパティ名をご自身で入力します(外部フィールド名)。例:「favourite_product」や「Campaign」。
- **権限でフィルター(任意)**で、マーケティング同意のチェックボックスを選択します。
- 保存をクリックし、続いてテストをクリックします。
フィールドマッピング
- メールアドレス、電話番号、名、姓は、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でプロフィールを統合または修正してから、再送信してください。
- 電話番号が拒否される:番号に国番号がありません。フォームの電話番号フィールドに国選択を追加してください。
- インストール後に何も届かない:キャンペーンの外部リストでリストが選択されていること、そして保存をクリックしたことを確認してください。