Contents
MarketoとSalesforceのAPI連携手順【中小企業向けステップバイステップガイド】
MarketoとSalesforceを連携させることで、リード情報の双方向共有やマーケティング自動化が可能になります。特に中小企業ではコスト効率と導入時期の選定が重要です。本記事では、エンジニア知識不要で実現できる具体的な手順を解説します。
導入準備と目的理解
MarketoとSalesforceの連携は、マーケティング活動とCRMデータの統合を可能にし、業務効率化を図ります。たとえばリード情報の自動同期により、営業担当者が最新情報を即座に確認できるようになります。
MarketoとSalesforce連携の意義
- リード情報のリアルタイム共有で営業とマーケティングの連携強化
- ダブルデータ入力の削減による人件費節約（中小企業では年間数百万円規模の効果が期待される可能性あり）
- マーケティング活動の成果測定を正確に実施可能
対象企業規模別のポイント
| 企業規模 | 考慮点 |
|---|---|
| 小規模企業（10〜50人） | Salesforce Light版対応と導入コストの最適化が重要 |
| 中堅企業（100〜300人） | カスタムフィールドの設計やAPI制限管理が必要 |
注意：財務基準の確認は「基本契約費用」ではなく、「Salesforceプランの月額費用上限」で検討することを推奨します（詳細は公式サポートにご確認ください）。
OAuth認証設定の流れ
OAuth認証は、MarketoとSalesforceのセキュアな接続を実現するための必須ステップです。画面操作で完了可能で、エンジニアの支援なしでも導入可能です。
認証フロー概要
- Salesforce側からAPIアプリ登録
- Marketo側でのクライアントID/シークレット設定
- ユーザー認証画面での承諾取得
注意：OAuthトークンは72時間有効であり、MarketoとSalesforce双方で同様の仕様が採用されているため、定期的な刷新が必要です。
Salesforce側アプリ登録手順
- Salesforceログイン後、「設定」→「API」→「アプリケーションの作成」へアクセス
- アプリ名を入力し、権限を「リードデータ読み書き」「カスタムフィールド操作」に限定
- クライアントIDとシークレットをメモ（Marketo側設定用）
リードデータ同期のポイント
リード情報の同期では、マッピング設定やバッチ処理のタイミングが重要です。誤った設定はデータ整合性に悪影響を与えます。
フィールドマッピングのベストプラクティス
- Marketo側の「Last Name」をSalesforceの「LastName」と一致させる
- タイムゾーンはUTC+9（日本標準時）で統一
- データ型ミスマッチ防止のために、テキストフィールドと数値フィールドの区別を厳守
バッチ処理設定
| 項目 | 推奨設定 |
|---|---|
| 実行頻度 | 毎日1回（営業時間外実行推奨） |
| 同期レコード上限 | SalesforceのAPI制限（通常50,000件/日）以内で設定 |
| エラー対応 | 不整合データを「待機キュー」として保留 |
エラーログ確認方法
連携中に発生するエラーは、ログの確認で特定可能です。代表的なエラーコードと解決策を以下にまとめます。
Marketoログの読み取り方
- Marketo管理画面 → 「API」→「監視」タブ
- エラーレベル（INFO/WARN/ERROR）で絞り込み
- 「エラー詳細」ボタンを押すと具体的な原因が表示
Salesforceの監査トレース
| エラー例 | 原因 | 解決策 |
|---|---|---|
| INVALID_SESSION_ID | トークン有効期限切れ | OAuth認証を再度実施 |
| FIELD_INTEGRITY_EXCEPTION | フィールドデータ型不一致 | Marketo側マッピング修正 |
| API_LIMIT_EXCEEDED | 日量API呼び出し上限到達 | 処理頻度の再設定またはSalesforceアップグレード |
セキュリティ設定の注意点
API連携に伴うセキュリティリスクを最小限に抑えるため、以下の対策が必須です。
IPホワイトリストの設定
- MarketoサーバーのIPアドレス（例：
13.14.5.7）をSalesforceで登録 - テスト環境では動的IPを許容する設定が必要。ただし、セキュリティリスクがあるため、本番環境では静的IPの利用が推奨されます。
API呼び出し制限
| Salesforceプラン | 日量API上限 |
|---|---|
| Essentials | 50,000 |
| Professional | 100,000 |
| Enterprise | 250,000 |
重要：月間利用が上限に達した場合、Salesforce側で連携が一時停止される可能性があります。事前に計画的な利用を検討してください。
Salesforce側カスタムフィールド対応
マーケティング担当者が自力で設定可能な手順を以下に示します。事前準備が不十分だとデータ同期に障害が出ます。
事前準備チェックリスト
- カスタムフィールドのAPI名とUI表示名を一致させる（例：
Custom_Field__c） - データ型（テキスト/数値/日付）がマッチするか確認
- 必須項目に設定されていないことを確認
API名とUIラベルの関係
| UI表示名 | API名 | 対応マーケティング活動 |
|---|---|---|
| 顧客ランク | Customer_Rank__c | リードスコアリング |
| 最終更新日 | Last_Update__c | データ品質管理 |
導入検討中の無料トライアル活用法
無料トライアルは、本番環境への移行前に行うべきテストの核となるツールです。手順に従えばリスクを最小限に抑えられます。
テスト環境構築ガイド
- MarketoとSalesforceのサンドボックス環境で実施
- 一部リードデータのみを同期対象とする（テスト用データ限定）
- ログ確認時に「エミュレーションモード」で動作検証
本番移行前の確認項目
- IPホワイトリスト設定の再確認
- Salesforc側カスタムフィールドのAPI名一覧を出力しておく
- リードデータのサンプル同期テスト実施（10件程度でOK）
まとめ
- OAuth認証は画面操作で完了可能で、セキュリティと連携の基盤となる
- フィールドマッピングではデータ型とタイムゾーンを一致させるのがポイント
- エラーログの確認は、MarketoとSalesforce両方の監視機能を使用する
- セキュリティ対策としてIPホワイトリストとAPI制限を厳守
- カスタムフィールドは事前にAPI名とUI表示名を一致させる必要あり
- 無料トライアルで実環境動作テストが必須（導入検討中の方は活用推奨）