Bloomreachとの連携を利用すると、登録したすべての参加者がメールアドレスで識別され、Bloomreach Engagementプロジェクトの顧客として作成または更新されます。また、Bloomreachの同意を付与して、マーケティング配信を行えるようにすることもできます。
必要なもの
- Bloomreach Engagementプロジェクトと、プロジェクト設定でAPIアクセスを管理できるユーザー(通常はプロジェクト管理者)。
ステップ1:BloomreachでAPIキーを作成する
- Bloomreach Engagementでプロジェクトを開き、Project settings > Access management > API に移動します。
- ページに表示されている Project token と API base URL をコピーします。
- API groupsで Private access の新しいグループを作成し、「Scratcher」などの名前を付けます。
- グループ内に新しいAPIキーを作成します。API key ID と API secret をコピーします。シークレットは一度しか表示されません。
- グループに以下の権限を付与して保存します。
キーに必要な権限
グループの権限で、次を許可してください。
- Customer properties:get と set。顧客の検索、作成・更新、およびフィールドマッピングでの顧客プロパティの表示に使用します。
- Events:
consentイベントの set。Scratcherが同意を記録するために使用します。
それ以外は不要です。set権限がない場合、配信はBloomreach側のアクセスエラーで失敗します。
ステップ2:BloomreachをScratcherに接続する
- Scratcherで 設定 > 連携 に移動し、Bloomreach をクリックします。
- API base URL、プロジェクトトークン、API key ID、API secretを該当するフィールドに貼り付けます。
- 連携をインストール をクリックします。ScratcherがBloomreachで情報を確認します。
ステップ3:キャンペーンで有効にする
- エディターで 接続 > 連携 > Bloomreach に移動し、有効化 をクリックします。
- 複数のプロジェクトを接続している場合は、アカウントを選択 で選びます。
- フィールドマッピング で フィールドマッピングを追加 をクリックし、各 Scratcherフィールド をBloomreachの顧客プロパティに対応付けます。例:「リード - 名」を first_name に。
- 付与する同意カテゴリーを選択します(例:「newsletter」)。不要な場合は「なし」を選びます。
- 権限でフィルター(任意) でマーケティング同意のチェックボックスを選択すると、チェックを入れた人だけが送信されます。
- 保存 をクリックし、続いて テスト をクリックします。
ポイント:Bloomreachにはリストがありません。全員がプロジェクトに登録され、Bloomreachのセグメントでグループ分けします。そのため、有効化 をクリックした時点でScratcherは送信を開始します。キャンペーン公開前に有効化するか、すぐに設定を完了してください。
フィールドマッピング
- メールアドレスは常に送信され、顧客の検索に使用されます。マッピングは不要です。
- 送信先フィールド の一覧には、プロジェクト内の顧客プロパティが表示されます。見つからない場合は、先にBloomreachでプロパティを作成してください。
- 顧客の流入元を記録するには、「Scratcher summer game」などの カスタム値を使用 を、流入元用のプロパティにマッピングします。
同意
同意カテゴリーを選択すると、Scratcherはアクション「accept」、ソースをキャンペーン名とした consent イベントを記録します。このカテゴリーはBloomreach(Project settings の同意設定)に存在している必要があります。権限でフィルター を使えば、マーケティングのチェックボックスにチェックを入れた人だけに同意が付与されます。
送信される内容とタイミング
新規登録は1~2分以内に送信されます。連携を有効化すると、キャンペーンの既存のリードも送信されます。同じ人が再度参加すると、顧客情報が更新されます。すべての配信は 設定 > 連携 > 配信ステータス で確認できます。詳しくは配信ステータスの確認とリードの再送信をご覧ください。
トラブルシューティング
- インストール時に「All or some of the fields are invalid...」と表示される:API base URLとプロジェクトトークンを確認し、キーIDとシークレットをもう一度コピーしてください。
- 配信がアクセスエラーで失敗する:APIグループに上記の権限が不足しています。Bloomreachで編集してください。
- 顧客に同意が表示されない:同意カテゴリーがBloomreachに存在しないか、表記が異なっています。
- APIキーについてはBloomreach独自のガイドがあります。メニューが異なる場合は、Bloomreachのドキュメントで「API access management」を検索してください。