統合ワークフローでは、よく使われる3つの統合オプションが用意されており、個々のニーズに合わせて細かな違いに対応できます。なお、CitrusAdは小売業者のバックエンドを経由して統合されていることに注意してください。

標準的な統合

CitrusAdの標準的な統合では、顧客のブラウザに結果が迅速に提供されるため、エンドユーザーにとって非常に使いやすいものとなっています。

📘

リスティングは、マージされるまでエンドユーザーには表示されません。

ワークフロー

広告の配信前：

• 商品カタログを、API経由または日次ファイル同期でCitrusAdと同期します
• （任意）顧客データを、API経由または日次ファイル同期でCitrusAdと同期します。

広告配信時：

• 顧客がウェブサイトを読み込むと、CitrusAdが組み込まれたページにナビゲートされます
• ウェブサイトがページの内部データに沿って、バックエンドサーバーからデータをリクエストします。この場合、カテゴリページ（customerId、 sessionId、 productFilters）に当たります。
• バックエンドサーバーがCitrusAd APIを呼び出し、顧客のページと広告のプレースメントの「コンテキスト」に対応した広告をリクエストします
• CitrusAdはそのリクエストに最も関連性の高い広告を、商品コードとバナー広告のURLの形式でバックエンドに返します
• バックエンドでは、CitrusAdのレスポンスとオーガニックコンテンツとがマージされます
• 1回のレスポンスで、サーバーが広告のオーガニックコンテンツをウェブサイトに送信します
• ウェブサイトでは、すべてのコンテンツが一度に顧客に表示されます

広告配信後：

• 顧客がブラウザのビューポートで広告を表示すると、1インプレッションが個々のでCitrusAdにレポートされます。 adId
• 顧客が広告をクリックすると、1クリックが個々のでCitrusAdにレポートされます。 adId
• 顧客が注文を精算すると、注文した商品、価格、数量、および顧客の次のものを含め、その注文がCitrusAdにレポートされます： customerId と sessionId.

バリエーション1：個々のブラウザのリクエスト

このバリエーションでは、オーガニック商品に対しバックエンドサーバーを個別に呼び出し、新しいバックエンドサービスを実装して、ブラウザで結果をマージする前にCitrusAdサーバーにクエリを実行します。これにより、CitrusAdリクエストが確実に分離されるため、既存のリクエストへの変更が少なくなり、開発リソースを減らすことができます。

📘

リスティングはマージされるまでエンドユーザーに表示されません。これは、マージ前に2つの別の呼び出しがバックエンドサーバーおよびCitrusAdに行われた場合も同様です。

この場合も、CitrusAdレスポンスで返された商品コードに関連するすべての商品情報を取得する必要があります。

ワークフローバリエーション（1）

広告配信時：

• 既存のバックエンドサービスがCitrusAdにリクエストを行う代わりに、関連するプレースメント情報を使用してCitrusAdにバックエンドコールを行う新しい小売業者サービスに新しいリクエストを行います
• ブラウザはオーガニックリスティングとCitrusAdをマージし、コンテンツを顧客に配信します

バリエーション2：顧客への表示後にマージする

このバリエーションのワークフローはバリエーション1と同様ですが、オーガニック商品結果が利用可能になった時点で、これを顧客に配信します。そのうえで、CitrusAdからコンテンツを受け取った後に、結果をマージして並び替えます。この統合方法は、必要な開発リソースを最小限に抑えられるため、統合にかかる時間が最も短くなると考えられます。

📘

オーガニックリスティングは、商品広告がマージおよび並び替えられる前に、エンドユーザーに断続的に表示されます。

この場合も、CitrusAdレスポンスで返された商品コードに関連するすべての商品情報を取得する必要があります。

ワークフローバリエーション（2）

広告配信時：

• オーガニックリスティングが表示されます。CitrusAdレスポンスは、ブラウザで受信された後にマージされます。