Agillic連携を使うと、登録したすべての人がAgillicの受信者として作成または更新されます。この連携ではAgillicはリストを使用しません。受信者はAgillicのデータに追加され、ターゲットグループはAgillic側で作成します。
必要なもの
- Agillicのヨーロッパプラットフォーム上のAgillicアカウントと、APIキーを作成できるユーザー(通常は管理者)。
ステップ1:AgillicでAPIキーを作成する
- Agillicで Settings を開き、APIキー(API認証情報)を探します。
- 新しいキーを作成し、「Scratcher」など分かりやすい名前を付けます。
- Developer key(APIキーとも呼ばれます)と Secret をコピーします。シークレットは一度しか表示されません。
キーに必要な権限
Scratcherはこのキーを使って、パーソンデータのフィールドの読み取り、メールアドレスによる受信者の検索、受信者の作成と更新を行います。Agillicでキーの権限を制限できる場合は、受信者への読み取り・書き込みアクセスと、パーソンデータへの読み取りアクセスを付与してください。それ以外のアクセスは不要です。
ステップ2:AgillicをScratcherに接続する
- Scratcherで 設定 > 連携 に移動し、Agillic をクリックします。
- Developer key と Secret を貼り付けます。
- 連携をインストール をクリックします。ScratcherがAgillicにログインして認証情報を確認します。
ステップ3:キャンペーンで有効にする
- エディターで 接続 > 連携 > Agillic に移動し、有効化 をクリックします。
- 複数のアカウントを接続している場合は、アカウントを選択 で使用するアカウントを選びます。
- フィールドマッピング で、各 Scratcherフィールド をAgillicのパーソンデータフィールドに対応付けます。
- 一意のメールフィールド で、メールアドレスに使用しているAgillicのフィールドを選択します:「Agillicでメールアドレスに使用しているフィールドを選択してください(Agillic側でも一意であることを確認してください)」。一意のテキストフィールドのみが表示されます。空欄のままにすると、Scratcherは EMAIL フィールドを使用します。
- 権限で絞り込む(任意) でマーケティング同意のチェックボックスを選択すると、同意した人のみが送信されます。
- 保存 をクリックし、続いて テスト をクリックします。
ポイント:Agillicには選択するリストがないため、有効化 をクリックした時点でScratcherは送信を開始します。キャンペーン公開前に有効化するか、すぐに設定を完了してください。
フィールドマッピング
- メールアドレスは常に一意のメールフィールドに送信されます。マッピングする必要はありません。
- フィールド一覧には、Agillicのパーソンデータがそのデータ型とともに表示されます。日付はAgillicの形式(例:31.12.2025)で送信されます。
- オプトイン用のパーソンデータフィールドがある場合は、同意の 承諾済み フィールドをそこにマッピングしてください。
送信される内容とタイミング
Scratcherはメールアドレスで受信者を検索します。存在しない場合は新規作成され、存在する場合は更新されます。新規登録は1〜2分以内に送信され、既存のリードは有効化した時点で送信されます。設定 > 連携 > 配信ステータス で、各リードがAgillicで新規だったか既存だったかを確認できます。
トラブルシューティング
- 「Agillic API request failed with status code ...」:Agillicがリクエストを受け付けませんでした。401または403は、キーが削除されたか権限が不足していることを意味します。新しいキーを接続してください。
- フィールドに関するAgillicのメッセージ:値がフィールドの型に合わないか、必須フィールドが欠けています。マッピングを確認してください。