Salesforce キャンペーンにデータを送信する

Looker の Salesforce キャンペーン統合を使用して Salesforce でキャンペーンを作成し、Looker Explore または Look からリードや連絡先とともにキャンペーン メンバーを入力できます。Looker では、新しいキャンペーンを作成することも、既存のキャンペーンにユーザーを追加することもできます。

設定要件

  • Salesforce API v42.0 以降（2018 年春リリース）
  • キャンペーン オブジェクトに対する [作成] と [編集] 権限（デフォルトでは「マーケティング ユーザー」のプロフィールに関連付けられます）と、ユーザー プロフィールで [マーケティング ユーザー] のチェックボックスをオンにします。
    • 十分な権限がない場合、entity type cannot be inserted... というエラー メッセージが表示されることがあります。

設定の手順

  1. アクションへのアクセスを制御するユーザー属性を作成し、Salesforce ドメインを指定します。[管理] メニューの [ユーザー] セクションにある [ユーザー属性] ページで、[ユーザー属性を作成] をクリックします。新しいユーザー属性を定義します。

    • 名前: salesforce_campaigns_action_domain
    • ラベル: Salesforce Campaigns Action Domain
    • データ型: 文字列
    • ユーザー アクセス: 表示
    • Hide Values: No
    • デフォルト値はありません。

    [保存] を選択します。

  2. ユーザー属性を定義したら、アクション使用する個々のユーザーおよびユーザー グループに Salesforce ドメイン（例: 「https://MyDomainName.my.salesforce.com」）を値として割り当てることができます。ユーザー属性ページの上部にあるユーザー値タブとグループ値タブを選択し、個々のユーザーとユーザー グループにそれぞれ値を割り当てます。

    • さまざまなユーザーがさまざまなドメイン（ステージング、開発 Salesforce インスタンスなど）をターゲットにでき、いつでもドメイン値を更新できます。
    • 値が割り当てられていないユーザーには、アクションがリンク先オプションとして表示されません。

  3. 次に、アクションを有効にします。管理メニューのプラットフォームセクションにあるアクションページへ行き、Salesforce キャンペーンのアクション ドメインアクションの横にある有効にするを選択します。Salesforce キャンペーンのアクション ドメインページで、有効切り替えを有効にして、Salesforce ドメインフィールドのSalesforce キャンペーンのアクション ドメインユーザー属性を選択します。保存をクリックします。

  4. 必要に応じて、連絡先フィールドと見込み顧客フィールドにそれぞれ LookML タグ sfdc_contact_id と sfdc_lead_id を設定します。または、フィールドラベルを正規表現で /contact id/i と /lead id/i と照合します（大文字と小文字は区別されません）。

Salesforce キャンペーン アクションを使用する

Salesforce キャンペーン アクションが構成されると、Looker スケジューラで使用できます。

  1. Look または Explore で、スケジュールを作成するか、1 回限りの配信を送信するオプションを選択します。
  2. [このデータをどこに配信しますか？] で、[Salesforce キャンペーン] アクションを選択します。
  3. このアクションを初めて使用するときに、Salesforce へのログインを求められます。[Log in] をクリックします。
  4. OAuth 同意画面で[許可]をクリックし、Looker スケジューラ ウィンドウに戻ります。

  5. [認証情報の確認]を選択します。Looker スケジューラで Salesforce にログインしたら、Salesforce キャンペーン アクション フォームに入力して、Look または Explore の配信の詳細を構成します。

    1. 作成または追加: [作成] を選択して新しいキャンペーンを作成するか、[追加] を選択して既存のキャンペーンを変更します。
    2. キャンペーン名: 新しいキャンペーンの名前を入力するか、既存のキャンペーンを選択します。
    3. メンバーのステータス: キャンペーン メンバーのステータスを選択します。このリストには、Salesforce インスタンスで使用可能なステータスが表示されます。
    4. Looker で Salesforce エラーを表示: キャンペーン メンバーの設定に関する Salesforce エラーを Looker のスケジュールされたジョブのステータスの詳細に表示するには、この設定を [はい] に設定します。これにより、[管理者] メニューの [スケジュール履歴] ページに、Looker のスケジュールされたジョブのステータスのエラーが記録されます。これはメンバーのエラーのトラブルシューティングに役立ちます。キャンペーン メンバーに関連するすべてのエラーを無視するには、この値を [いいえ] に設定します（デフォルト）。これにより、キャンペーン メンバーの設定時に発生したエラーに関係なく、[完了] ステータスが記録されます。

  6. 配信に必要なその他のオプションを指定します。

  7. [送信] を選択します。

Salesforce キャンペーン アクションの削除

接続されている Salesforce インスタンスを切り替える場合や、Looker アクションを Salesforce インスタンスから切断する場合は、Salesforce アカウント内から Looker アプリケーションへの接続を取り消すことができます。

制限事項

  • このアクションは最大 5,000 行に制限されています。すべての結果を送信する機能は現在開発中です。
  • 各 Salesforce エディションには、24 時間あたりに許可される API 呼び出し回数に上限があります。インスタンスの API の上限については、Salesforce API リクエストの上限と割り当てのドキュメントをご覧ください。このアクションは、sObject コレクションを使用した POST リクエストを利用して、1 つのリクエストで複数のレコード（API 呼び出しごとに 200 レコード）を実行します。