Salesforce Marketing Cloud連携を使うと、登録したすべての人がMarketing Cloudのコンタクトとして作成または更新されます。コンタクトキーにはメールアドレスが使われます。設定には通常、Salesforce管理者の協力が必要です。
必要なもの
- Salesforce Marketing Cloudアカウントと、Setup > Installed Packages にアクセスできるユーザー(通常はMarketing Cloud管理者)。
- すべてのネイティブ連携を利用できるScratcherプラン。ボタンがロックされている場合は、トライアル、プラン、トライアル終了後についてをご覧ください。
ステップ1:Marketing CloudでAPI認証情報を作成する
- Marketing Cloudで Setup を開きます(ユーザー名の下のメニューから)。
- Apps > Installed Packages に移動し、New をクリックします。パッケージに名前(例:「Scratcher」)を付けて保存します。
- Add Component をクリックし、API Integration、続いて Server-to-Server を選択します。
- 下記の権限を設定して保存します。
- コンポーネントを開き、Client Id、Client Secret、Authentication Base URI、REST Base URI をコピーします。
- コンタクトを登録したいビジネスユニットにパッケージがアクセスできることを確認します(パッケージの Access で設定)。
- チームがScratcherのリード用に使用しているデータエクステンションの外部キーを確認します。Contact Builder または Email Studio でデータエクステンションを開き、External Key をコピーします。
パッケージに必要な権限
ScratcherはMarketing Cloudに対して以下のスコープのみを要求するため、コンポーネントでこれらを許可する必要があります。
- Contacts > List and Subscribers:Read と Write。メールアドレスでコンタクトを検索し、作成・更新するために使用します。
- Data > Data Extensions:Write。
その他の権限は不要です。
ステップ2:Scratcherに接続する
- Scratcherで 設定 > 連携 に移動し、Salesforce Marketing Cloud をクリックします。
- 各項目を入力します。
- Auth Base URL:Authentication Base URI(例:
https://xxxx.auth.marketingcloudapis.com)。 - Rest Base URL:REST Base URI(例:
https://xxxx.rest.marketingcloudapis.com)。 - Client ID と Client Secret。
- Data extension id:ステップ1で確認した外部キー。
- Auth Base URL:Authentication Base URI(例:
- 連携をインストール をクリックします。ScratcherがMarketing Cloudにログインして入力内容を確認します。
どちらのURLもMarketing CloudのAPIアドレス(末尾がmarketingcloudapis.com)である必要があります。それ以外のアドレスは受け付けられません。
ステップ3:キャンペーンで有効にする
- エディターで 接続 > 連携 > Salesforce Marketing Cloud に移動し、有効化 をクリックします。
- 複数のアカウントを接続している場合は、アカウントを選択 で使用するアカウントを選びます。
- フィールドマッピング で フィールドマッピングを追加 をクリックし、Scratcherのフィールドを選択して、外部フィールド名 にMarketing Cloudの属性名を入力します。
- 必要に応じて、権限でフィルター(任意) で同意チェックボックスを選択します。
- 保存 をクリックし、続いて テスト をクリックします。
ポイント:リストを選択する手順がないため、有効化 をクリックした時点でScratcherはデータ送信を開始します。キャンペーン公開前に有効化するか、すぐにマッピングを設定してください。
送信される内容
- メールアドレスはコンタクトキーとして使用され、Email Addresses 属性セットにHTMLメール有効の状態で保存されます。
- フォームの名と姓は Email Demographics に保存されます。
- マッピングしたフィールドは、入力した名前で Custom Data という属性セットに保存されます。管理者に依頼して、Contact Builderで同じ属性名を持つこの属性セットを作成してください。
新規登録者は1~2分以内に送信され、キャンペーンの既存リードは有効化した時点で送信されます。
トラブルシューティング
- インストール時に「All or some of the fields are invalid. The integration failed to validate the fields.」と表示される場合:2つのURL、クライアントIDとシークレット、パッケージに上記の権限があるかを確認してください。
- 不明な属性で送信に失敗する場合:外部フィールド名 が Custom Data の属性と一致していません。名前を修正するか、属性を追加してください。
- 「The Salesforce Marketing Cloud urls must be marketingcloudapis.com addresses.」と表示される場合:正しいURLで連携を再インストールしてください。
Sales CloudなどのSalesforceとのより高度な連携が必要ですか?Enterpriseプランでは、お客様と一緒に構築いたします。ミーティングを予約