Eloqua を API 化する: 初心者ガイド、パート 1
API-fy Your Eloqua: A Beginner's Guide, Part 1
Eloqua のユーザー インターフェイスを使用すると、マーケティング担当者は複雑なプロセス、統合、カスタム レポートを構成できるため、デジタル キャンペーンにとって価値のあるツールになります。しかし、これがこれらのメカニズムにアクセスする唯一の方法ではありません。
Eloqua のオープン API は、まったく新しいレベルのマーケティング自動化機能を解放し、複雑なタスクを実行し、他のアプリケーションとシームレスに統合できるようにします。新しいリードをキャンペーンに自動的に追加したり、顧客データに基づいてメールをパーソナライズしたり、キャンペーン活動を外部ダッシュボードに同期したりすることを想像してみてください。これらすべてが手動介入なしで行われます。
API を初めて使用する場合は、この記事で基本的な概念と、それが Eloqua にどのように適用されるかを詳しく説明します。これらの API 原則は、他の多くのツールにも適用できます。
APIとは何ですか?
API (アプリケーション プログラミング インターフェイス) は、アプリケーション間の仲介者として機能します。レストランのメニューと似ています。 API はメニューとして機能し、利用可能なオプションとその注文方法 (データ エンドポイントと関数) をリストします。 API を使用して注文を送信し、Eloqua 内でデータをリクエストしたりアクションを実行したりします。
ここで、Eloqua でメインコースを注文し、それを別のシステムのサイドと組み合わせたいとします。この状況では、API はプラットフォーム間のメッセンジャーとして機能します。この通信が行われる主な方法は 2 つあります。
- API 呼び出しはリクエストに依存して双方向通信を促進します。アプリケーションはデータを要求することができ (サーバーからメニューを取得するなど)、場合によってはデータを変更することができます (注文するなど)。返信（あなたの注文）はレスポンスとして返ってきます。
- Webhook はイベント駆動型で、主に一方向です。アプリケーションはデータ (注文の準備ができたという通知など) を送信しますが、応答は期待しません。
API で何ができるのでしょうか?
Eloqua では、API 呼び出しと Webhook の両方で、REST (REpresentational State Transfer) と呼ばれる基盤となるアーキテクチャが使用されます。 REST は、アプリケーションが HTTP リクエスト (GET、POST、PUT、DELETE など) とレスポンスを使用して通信するためのルールを定義します。これらのリクエストは、質問したり、指示を与えたりするものです。 CRUD (Create、Read、Update、および Delete の略) について聞いたことがあるかもしれません。
これらは、新しい連絡先レコードの追加や既存の連絡先レコードの編集など、データに対して実行できる基本的なアクションです。 REST API は多くの場合、CRUD アクションごとに特定の HTTP メソッド (読み取りの場合は GET、作成の場合は POST、更新の場合は PUT、削除の場合は DELETE) を使用した CRUD 操作を使用します。 REST は CRUD だけに限定されないことに注意してください。より複雑なタスクを処理できるようになります。私たちの目的のために、私たちはこれらの HTTP メソッドに固執します。
Eloqua の API の可能性を探る
Oracle は、Eloqua 機能を拡張するために次の API を提供しています。
- アプリケーションAPI
- バルクAPI
- レポートAPI
どの API を使用する必要がありますか?どの API を活用するのが最適かを決定する重要な機能がいくつかあり、複数の API を使用するのが一般的です。各 API が特定のニーズにどのように対応できるかを見てみましょう。
アプリケーションAPI
アプリケーション API (または REST API) は、個々のレコードに対する CRUD 操作のための汎用インターフェイスです。小規模なデータ転送やリアルタイムのやり取りに最適です。
REST API 関数の良い例は、Eloqua フォーム送信アプリです。連絡先レコードがキャンバス上のアプリ ステップに到達すると、POST リクエストが起動され、マップされた値がフォーム データの特定のエンドポイントに送信されます。次に、Eloqua は応答 (フォーム送信データ) をアプリに送り返すことで、フォーム データの作成を確認します。
REST API は基礎となるアーキテクチャであるため、Bulk API および Reporting API の基盤でもあります。
バルクAPI
Bulk API (または REST 内の一括操作) は、REST API を使用して、操作するレコードのリストを含む単一のリクエストを送信する手法です。これは、大量のデータに対するアクションを効率的に実行するのに理想的です。 Salesforce 統合アプリケーションは、Bulk API を使用して、Eloqua で連絡先レコードを作成および更新します。この同期を維持するために、Eloqua は定期的に Salesforce データのバッチを自動的に取得します。 Eloqua はバッチごとに、変更されたレコードのデータセットを含む GET リクエストを実行します。
レポートAPI
Reporting API (または REST 上の OData) は、データのクエリ、フィルター、操作の標準化された方法を定義するプロトコルです。この API は Eloqua Insight へのブリッジとして機能し、Insight データ ウェアハウスから直接データを取得できるようにします。この API を使用すると、Insight サブジェクト領域からメトリクスと属性を、Tableau、Power BI、Oracle Analytics などの好みのビジネス インテリジェンス ツールに取り込むことができます。