Apsis Oneとの連携を使うと、登録したすべての人が、選択したセクション内のApsis Oneプロフィールとして作成または更新され、Apsis Oneのサブスクリプションのいずれかにオプトインさせることもできます。
必要なもの
- Apsis Oneのアカウントと、APIキーを管理できるユーザー(通常は管理者)。
- ご利用のApsis OneアカウントがEuropeとAsiaのどちらのリージョンにあるか。ほとんどのアカウントはEuropeです。
ステップ1:Apsis OneでAPIキーを作成する
- Apsis OneでAccount settingsを開き、(連携の下にある)API keysに移動します。
- 新しいAPIキーを作成します。「Scratcher」など、わかりやすい名前を付けてください。
- Scratcherからプロフィールを送信したいセクションへのアクセス権を、下記の権限とともにキーに付与します。
- 保存して、Client IDとClient secretをコピーします。シークレットは一度しか表示されません。
この手順については、Apsis独自のステップごとのガイドがあります。Scratcherのインストールダイアログ内のセットアップガイド(「連携をインストールするには、こちらのガイドに従ってください」)からリンクされています。
キーに必要な権限
Scratcherはこのキーを使って次の操作を行います。
- セクションと、その中の属性、サブスクリプション(同意トピック)、イベントを読み取り、キャンペーン内で選択できるようにする
- プロフィールを作成し、その属性を更新する
- プロフィールに同意(オプトイン)を追加する
- プロフィールにイベントを追加する
そのため、キーには、使用するセクションに対して、セクションの読み取り権限と、プロフィール・同意・イベントの書き込み権限が必要です。書き込み権限がない場合、送信はApsis One独自のエラーメッセージとともに失敗します。
ステップ2:Apsis OneをScratcherに接続する
- Scratcherで設定 > 連携に移動し、Apsis Oneをクリックします。
- APIリージョンとしてEuropeまたはAsiaを選択します。
- Client IDとClient secretを貼り付けます。
- 連携をインストールをクリックします。Scratcherが Apsis Oneにログインして情報を確認します。
ステップ3:キャンペーンで有効にする
- エディターで接続 > 連携 > Apsis Oneに移動し、有効化をクリックします。
- 複数のApsis Oneアカウントを接続している場合は、アカウントを選択で使用するアカウントを選びます。
- Apsisセクションで、セクションを選択します(セクションを選択)。
- フィールドマッピングで、各フィールドについてフィールドマッピングを追加をクリックし、Scratcherフィールドを送信先フィールドのApsis One属性に対応付けます。リストには、独自の属性を含め、選択したセクションの属性が表示されます。
- **サブスクリプション(同意)**で、参加者をオプトインさせるサブスクリプションを選択するか、なしを選びます。「参加者をオプトインさせるサブスクリプションを選択してください。」
- **権限で絞り込む(任意)**で、マーケティング同意のチェックボックスを選択すると、チェックを入れた人だけが送信されます。
- 保存をクリックし、次にテストをクリックしてテスト用プロフィールを送信します。
フィールドマッピング
- メールアドレスは常に送信され、プロフィールの識別に使用されます。マッピングする必要はありません。
- 電話番号は、形式の設定を使って、属性が想定する形式で送信してください。
- はい/いいえ型の属性にはtrueまたはfalseが送られるため、同意の承諾済みフィールドははい/いいえ型の属性にマッピングしてください。
同意
サブスクリプションを選択すると、各参加者は「Subscribed via」とキャンペーン名を理由として、ソース「Scratcher」でオプトインされます。すでにオプトイン済みの場合は何も変わりません。マーケティングのチェックボックスにチェックを入れた人だけがオプトインされるよう、権限で絞り込むを使用してください。
セクションにApsis Oneの同意フォームイベントがある場合、Scratcherは登録をキャンペーンのアドレスとともにプロフィール上のイベントとしても記録します。
送信される内容とタイミング
新規登録は1~2分以内に送信されます。連携を有効にすると、キャンペーンの既存のリードも送信されます。同じ人が再度参加した場合は、そのプロフィールが更新されます。すべての送信状況は設定 > 連携 > 送信ステータスで確認できます。プロフィールが新規か既存かも表示されます。詳しくは送信ステータスの確認とリードの再送信をご覧ください。
トラブルシューティング
- インストール時に「All or some of the fields are invalid...」と表示される:リージョンを確認し、Client IDとシークレットをもう一度コピーしてください。
- Apsis Oneからのアクセスエラーで送信が失敗する:キーにセクションへのアクセス権がないか、書き込み権限が不足しています。Apsis Oneでキーを編集してください。
- **サブスクリプション(同意)**が空になっている:セクションにまだサブスクリプションがありません。Apsis Oneでサブスクリプションを作成し、連携をもう一度開いてください。