---
title: "Bloomreachを接続"
description: "Bloomreach EngagementでAPIキーを作成して接続し、同意情報とあわせて顧客を作成・更新します。"
url: https://scratcher.io/ja/help/integrations/bloomreach
language: ja
---

1. [ヘルプセンター](https://scratcher.io/ja/help)
2. [連携](https://scratcher.io/ja/help/integrations)
3. Bloomreachを接続

# Bloomreachを接続

Bloomreach EngagementでAPIキーを作成して接続し、同意情報とあわせて顧客を作成・更新します。

Bloomreachとの連携を利用すると、登録したすべての参加者がメールアドレスで識別され、Bloomreach Engagementプロジェクトの顧客として作成または更新されます。また、Bloomreachの同意を付与して、マーケティング配信を行えるようにすることもできます。

## 必要なもの

- Bloomreach Engagementプロジェクトと、プロジェクト設定でAPIアクセスを管理できるユーザー（通常はプロジェクト管理者）。

## ステップ1：BloomreachでAPIキーを作成する

1. Bloomreach Engagementでプロジェクトを開き、**Project settings** > **Access management** > **API** に移動します。
2. ページに表示されている **Project token** と **API base URL** をコピーします。
3. API groupsで **Private access** の新しいグループを作成し、「Scratcher」などの名前を付けます。
4. グループ内に新しいAPIキーを作成します。**API key ID** と **API secret** をコピーします。シークレットは一度しか表示されません。
5. グループに以下の権限を付与して保存します。

## キーに必要な権限

グループの権限で、次を許可してください。

- **Customer properties**：get と set。顧客の検索、作成・更新、およびフィールドマッピングでの顧客プロパティの表示に使用します。
- **Events**：`consent` イベントの set。Scratcherが同意を記録するために使用します。

それ以外は不要です。set権限がない場合、配信はBloomreach側のアクセスエラーで失敗します。

## ステップ2：BloomreachをScratcherに接続する

1. Scratcherで **設定** > **連携** に移動し、**Bloomreach** をクリックします。
2. API base URL、プロジェクトトークン、API key ID、API secretを該当するフィールドに貼り付けます。
3. **連携をインストール** をクリックします。ScratcherがBloomreachで情報を確認します。

## ステップ3：キャンペーンで有効にする

1. エディターで **接続** > **連携** > **Bloomreach** に移動し、**有効化** をクリックします。
2. 複数のプロジェクトを接続している場合は、**アカウントを選択** で選びます。
3. **フィールドマッピング** で **フィールドマッピングを追加** をクリックし、各 **Scratcherフィールド** をBloomreachの顧客プロパティに対応付けます。例：「リード - 名」を **first\_name** に。
4. 付与する同意カテゴリーを選択します（例：「newsletter」）。不要な場合は「なし」を選びます。
5. **権限でフィルター（任意）** でマーケティング同意のチェックボックスを選択すると、チェックを入れた人だけが送信されます。
6. **保存** をクリックし、続いて **テスト** をクリックします。

> ポイント：Bloomreachにはリストがありません。全員がプロジェクトに登録され、Bloomreachのセグメントでグループ分けします。そのため、**有効化** をクリックした時点でScratcherは送信を開始します。キャンペーン公開前に有効化するか、すぐに設定を完了してください。

## フィールドマッピング

- メールアドレスは常に送信され、顧客の検索に使用されます。マッピングは不要です。
- **送信先フィールド** の一覧には、プロジェクト内の顧客プロパティが表示されます。見つからない場合は、先にBloomreachでプロパティを作成してください。
- 顧客の流入元を記録するには、「Scratcher summer game」などの **カスタム値を使用** を、流入元用のプロパティにマッピングします。

## 同意

同意カテゴリーを選択すると、Scratcherはアクション「accept」、ソースをキャンペーン名とした `consent` イベントを記録します。このカテゴリーはBloomreach（**Project settings** の同意設定）に存在している必要があります。**権限でフィルター** を使えば、マーケティングのチェックボックスにチェックを入れた人だけに同意が付与されます。

## 送信される内容とタイミング

新規登録は1～2分以内に送信されます。連携を有効化すると、キャンペーンの既存のリードも送信されます。同じ人が再度参加すると、顧客情報が更新されます。すべての配信は **設定** > **連携** > **配信ステータス** で確認できます。詳しくは[配信ステータスの確認とリードの再送信](https://scratcher.io/ja/help/integrations/delivery-status)をご覧ください。

## トラブルシューティング

- インストール時に「All or some of the fields are invalid...」と表示される：API base URLとプロジェクトトークンを確認し、キーIDとシークレットをもう一度コピーしてください。
- 配信がアクセスエラーで失敗する：APIグループに上記の権限が不足しています。Bloomreachで編集してください。
- 顧客に同意が表示されない：同意カテゴリーがBloomreachに存在しないか、表記が異なっています。
- APIキーについてはBloomreach独自のガイドがあります。メニューが異なる場合は、Bloomreachのドキュメントで「API access management」を検索してください。

連携

- [連携の仕組み](https://scratcher.io/ja/help/integrations/how-integrations-work)
- [すべての連携](https://scratcher.io/ja/help/integrations/other-integrations)
- [配信ステータスの確認とリードの再送信](https://scratcher.io/ja/help/integrations/delivery-status)
- [HubSpotを連携する](https://scratcher.io/ja/help/integrations/hubspot)
- [Salesforce Marketing Cloudと連携する](https://scratcher.io/ja/help/integrations/salesforce-marketing-cloud)
- [ZapierでMicrosoft Dynamics 365と連携する](https://scratcher.io/ja/help/integrations/microsoft-dynamics-365)
- [Emarsysを連携する](https://scratcher.io/ja/help/integrations/emarsys)
- [Klaviyoを連携する](https://scratcher.io/ja/help/integrations/klaviyo)
- [Mailchimpを連携する](https://scratcher.io/ja/help/integrations/mailchimp)
- [ActiveCampaignと連携する](https://scratcher.io/ja/help/integrations/activecampaign)
- [Apsis Oneを接続する](https://scratcher.io/ja/help/integrations/apsis-one)
- [Dripを連携](https://scratcher.io/ja/help/integrations/drip)
- [HeyLoyaltyと連携する](https://scratcher.io/ja/help/integrations/heyloyalty)
- [Peytzを連携する](https://scratcher.io/ja/help/integrations/peytz)
- [Marketingplatformを連携する](https://scratcher.io/ja/help/integrations/marketingplatform)
- [Campaign MonitorをZapierと連携する](https://scratcher.io/ja/help/integrations/campaign-monitor)
- [ZapierでActiveTrailと連携する](https://scratcher.io/ja/help/integrations/activetrail)
- [Bloomreachを接続](https://scratcher.io/ja/help/integrations/bloomreach)
- [Iterableを連携する](https://scratcher.io/ja/help/integrations/iterable)
- [Mappを連携する](https://scratcher.io/ja/help/integrations/mapp)
- [Agillicを接続](https://scratcher.io/ja/help/integrations/agillic)
- [Orttoと連携する](https://scratcher.io/ja/help/integrations/ortto)
- [Emarketeerを連携する](https://scratcher.io/ja/help/integrations/emarketeer)
- [Shopifyと連携する](https://scratcher.io/ja/help/integrations/shopify)
- [Hello Retailを連携する](https://scratcher.io/ja/help/integrations/hello-retail)
- [Zapierで8,000以上のアプリと連携](https://scratcher.io/ja/help/integrations/zapier)
- [monday.comとZapierを連携する](https://scratcher.io/ja/help/integrations/monday-com)
- [AsanaをZapierで連携する](https://scratcher.io/ja/help/integrations/asana)
- [PodioをZapierと連携する](https://scratcher.io/ja/help/integrations/podio)
- [IntercomをZapierで連携する](https://scratcher.io/ja/help/integrations/intercom)

さらに学ぶ

## 関連記事

- [連携の仕組み](https://scratcher.io/ja/help/integrations/how-integrations-work): メール配信ツールやCRMを一度接続したら、各キャンペーンで有効にし、リストを選んでフィールドをマッピングするだけ。同意した人だけを送信できます。
- [配信ステータスの確認とリードの再送信](https://scratcher.io/ja/help/integrations/delivery-status): リードがどのツールに送信されたかを確認し、エラーメッセージの意味を理解して問題を解決し、再送信しましょう。
- [同意の取得と利用規約の追加](https://scratcher.io/ja/help/forms/consent-and-permissions): ニュースレター配信の同意チェックボックスを追加し、利用規約へのリンクを設定。どのチェックボックスで購読登録するかを選び、同意した人だけをメール配信ツールに送信できます。

お困りですか？

## まだお困りですか？

担当者がサポートします。すでに Scratcher をご利用の場合は、プラットフォーム内のチャットが最も早い方法です。

- **[チャットで相談](https://platform.scratcher.io/ja/login)**

    ログインして右下のチャットボタンをクリックしてください。Rex がすぐに回答し、チームにもワンクリックでつながります。
- **[ミーティングを予約](https://scratcher.io/ja/book-a-meeting)**

    チームとの 30 分の無料ビデオ通話：製品ツアー、キャンペーンのアイデア、設定のサポート。
- **[メールで問い合わせ](mailto:contact@scratcher.io)**

    contact@scratcher.io までご連絡いただければ、折り返しご返信します。
