Emarsys連携を使うと、登録したすべての人がEmarsysのコンタクトとして作成または更新され、指定したコンタクトリストに追加されます。
必要なもの
- Emarsysアカウントと、API認証情報を管理できるユーザー(Management > Security Settings)。
ステップ1:EmarsysでAPI認証情報を作成する
- Emarsysで Management > Security Settings > API Credentials に移動します。
- Create API Credentials をクリックし、必ず OpenID Connect を選択してください。
- Permissions で、次の4つを有効にします:
contact.create、contact.update、contactlist.list、field.list。 - 保存し、Client ID と Client Secret をコピーします。どちらもScratcherで必要になります。
認証情報に必要な権限
contact.createとcontact.update:新しいコンタクトの作成と既存コンタクトの更新に使用します。contactlist.list:キャンペーン内でコンタクトリストを表示するために使用します。field.list:フィールドマッピングでEmarsysのフィールドを表示するために使用します。
その他の権限は必要ありません。
ステップ2:EmarsysをScratcherに接続する
- Scratcherで 設定 > 連携 に移動し、Emarsys をクリックします。ダイアログ内の セットアップガイド にも上記の手順が記載されています。
- Client ID と Client secret を貼り付けます。
- 連携をインストール をクリックします。Scratcherがコンタクトリストを読み取れるかを確認します。
ステップ3:キャンペーンで有効にする
- エディターで 接続 > 連携 > Emarsys に移動し、有効化 をクリックします。
- 複数のアカウントを接続している場合は、アカウントを選択 でアカウントを選びます。
- 外部リスト でコンタクトリストを選択します。
- フィールドマッピング で、少なくとも「Lead - Email」をEmarsysの Email フィールドにマッピングし、続いて First Name や Last Name などその他のフィールドをマッピングします。Emarsysのフィールドは名前で一覧表示されます。
- 権限でフィルター(任意) で、マーケティング同意のチェックボックスを選択します。
- 保存 をクリックし、続いて テスト をクリックします。
フィールドマッピング
- メールアドレスは必ずご自身でマッピングしてください。Emarsysはメールアドレスで既存のコンタクトを照合するため、これがないコンタクトは照合できません。
- 送信されるのはマッピングしたフィールドのみです。
- オプトイン、登録日、ニュースレターなど一部のEmarsysシステムフィールドは、Emarsys側で自動設定されるため選択肢に表示されません。
同意
Scratcherは、送信するすべてのコンタクトについてEmarsysのオプトインフィールドを「true」に設定します。そのため、フォームでマーケティング同意が任意になっている場合は、必ず 権限でフィルター(任意) でマーケティング同意のチェックボックスを指定してください。
送信される内容とタイミング
新規登録は1~2分以内に送信され、キャンペーンの既存のリードは有効化した時点で送信されます。コンタクトがすでに存在する場合は、更新されたうえでリストに追加されます。
トラブルシューティング
- インストール時に「All or some of the fields are invalid...」と表示される:クライアントIDまたはシークレットが間違っているか、認証情報がOpenID Connectを使用していません。
- 送信が失敗する、またはリストやフィールドのドロップダウンが空になる:認証情報に4つの権限のいずれかが不足しています。Emarsysで認証情報を編集してください。
- コンタクトが重複して作成される:「Lead - Email」が Email フィールドにマッピングされていません。