> For the complete documentation index, see [llms.txt](https://help.citrusad.com/retail-media-interface/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.citrusad.com/retail-media-interface/integration/ja/data-api/api-overview/reporting-impressions-clicks.md).

# インプレッションとクリックのレポート

インプレッションとクリックを効果的にレポートするには、以下を使用します： `/resource/` エンドポイント。インプレッションは次へと送信する必要があります： `first-i` リソース。一方、クリックは次へとレポートする必要があります： `second-c` リソース。

## 前提条件

インプレッションおよびクリックのレポートを開始する前に、テクニカルアカウントマネージャーからベースURLを取得してください。

## エンドポイント呼び出しの連携

エンドポイント呼び出しは、アプリまたはウェブサイト内で実行する必要があります。 Epsilon Retail Mediaでは、バックエンド間（backend to backend）の連携手法を採用しているため、モバイルアプリとウェブサイトのどちらでも連携プロセスは同様です。この手法により、デスクトッププラットフォームとモバイルプラットフォームの両方で広告リクエストの一貫性が確保されます。ただし、モバイルアプリはJSライブラリをサポートしていないため、クリックおよびインプレッションのエンドポイントに対してバックエンドリクエストを行う必要があります。

## インプレッションのレポート

インプレッションをレポートするには、以下の形式でGETリクエストを送信します：

```
https://$BASE_URL.citrusad.com/v1/resource/first-i/AD_ID
```

以下を置き換えます： `AD_ID` 指定された： `adId` レポート対象の広告に対して提供されたものです。

たとえば、以下のGETリクエストは次のインプレッションをレポートします： `adId`, `display_xw3ybbrymHT_D3VwU3Ic5ThUkbhFNkY4NVNIODU4NEVGRkdT`.

```
https://$BASE_URL.citrusad.com/v1/resource/first-i/display_xw3ybbrymHT_D3VwU3Ic5ThUkbhFNkY4NVNIODU4NEVGRkdT
```

## クリックのレポート

クリックをレポートするには、以下の形式でGETリクエストを送信します：

```
https://$BASE_URL.citrusad.com/v1/resource/second-c/AD_ID
```

以下を置き換えます： `AD_ID` 指定された： `adId` レポート対象の広告に対して提供されたものです。

たとえば、以下のGETリクエストは次のインプレッションをレポートします： `adId`, `display_xw3ybbrymHT_D3VwU3Ic5ThUkbhFNkY4NVNIODU4NEVGRkdT`.

```
https://$BASE_URL.citrusad.com/v1/resource/second-c/display_xw3ybbrymHT_D3VwU3Ic5ThUkbhFNkY4NVNIODU4NEVGRkdT
```

## 実績広告IDに対するAPI検証

APIには、データの正確性を確保しエラーを削減するための広告ID検証機能が含まれています。不適切なエンコードやプレフィックスが付与された広告IDを含むリクエストは、400エラーと詳細なエラーメッセージを返します。

### 主なメリット

* 問題解決の迅速化: 迅速なフィードバックにより、リテールパートナーは問題をより早く修正できます。
* 正確性の向上: エラーが減ることで、より正確なレポートとデータが得られます。

### エラーメッセージの例

「無効な広告IDです。適切にエンコードされ、'display\_'、'banner\_'、または'shotgun\_'のプレフィックスが付与されている必要があります。」


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://help.citrusad.com/retail-media-interface/integration/ja/data-api/api-overview/reporting-impressions-clicks.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.