Marketo 統合のベストプラクティス

Marketo インスタンスの共通API制限に関する統合機能を設計します。 バッチ処理、キャッシュ、保守的なリクエスト率を使用して、スループットと信頼性を向上させます。

API 制限

クイックヒント

バッチ処理

挿入と更新の場合は、レコードを可能な限り少ない数のトランザクションにグループ化します。 データストアからレコードを取得する場合、変更ごとに1つのリクエストを送信するのではなく、送信前にレコードを集計します。

許容可能な待ち時間

統合を設計する際の許容可能な待ち時間（API呼び出しを送信するまでの最大時間）を定義します。 この選択により、ユースケースに適合するMarketoのメソッドとコンフィギュレーションオプションが決まります。

例えば、利用者が体験版を開始したときに営業担当者に通知するリアルタイム統合では、すぐにフォローアップが必要なときに営業担当者に一括送信します。 多くのユースケースでは、呼び出しのキューとバッチ処理によって、より多くの遅延を許容し、より効率的に運用できます。

毎日の制限

API対応の各Marketo インスタンスには、毎日10,000件以上のREST API呼び出しが割り当てられていますが、50,000件以上が一般的です。 各インスタンスには、500 MB以上のバルクエクト容量もあります。 1日の追加容量は、Marketo サブスクリプションの一部として購入できますが、アプリケーションのデザインでは、一般的なサブスクリプション制限を考慮する必要があります。

キャパシティは、インスタンス内のすべてのAPI サービスとユーザーによって共有されます。 冗長な呼び出しとバッチレコードを排除し、できるだけ少ない呼び出しを実現します。

最も通話効率の高い読み込み方法は、Marketoの一括読み込みAPIです。​ リード/ユーザーおよび​ カスタムオブジェクト ​で使用できます。 また、Marketo では、リードとアクティビティの一括抽出も用意しています。

キャッシュ

次の操作の結果は、頻繁に変更されないので、通常はクライアントサイドで 1 日以上キャッシュできます。

リードやアクティビティのデータエンリッチメントなどのユースケースでは、プログラム、メール、フォルダーなどのアセットタイプをキャッシュすることもできます。

レート制限

Marketoの各インスタンスでは、すべてのサードパーティ API サービスで、20秒あたり100回の呼び出しの共有レート制限があります。 呼び出しがこの制限を超える場合、APIは606 エラーコードを返します。

一般的に、複数のAPI統合とユーザーが利用可能な容量を共有できるように、各サードパーティ統合を20秒以下あたり50回の呼び出しに制限します。 場合によっては、最大限の制限が必要な場合もあります。 ただし、バッチ処理を使用してスループットを低下させるアプリケーションは、一般的に応答性と一貫性が高く、待ち時間が少し増加します。

同時実行制限

各 Marketo インスタンスには、同時実行できる REST API 呼び出しの共有制限が 10 個あります。 アプリケーションがこの制限の唯一の消費者であると仮定しないでください。

Marketoでは、処理中で返されていない呼び出しがカウントされます。 呼び出しが返されると、同時実行の制限にカウントされなくなります。

ほとんどの統合では、同時呼び出しのメリットはありません。 同時実行を実装する場合、最初にアプリケーションを5つ以下の同時要求に制限します。 この制限を増やすのは、アプリケーションがより多くの作業を必要としていると判断した場合のみです。

エラー

まれに、API リクエストはHTTP ステータスコード 200を返します。 ビジネスロジックエラーも200を返しますが、応答本文に詳細が含まれます。 詳しくは、​ エラーコード ​を参照してください。

HTTP理由フレーズはオプションであり、変更される可能性があるため、評価しないでください。