> 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/ko/data-api/api-overview/reporting-impressions-clicks.md).

# 노출 및 클릭 보고

노출 및 클릭수를 효과적으로 보고하려면 다음을 사용하세요. `/resource/` 엔드포인트. 노출은 다음으로 전달되어야 합니다. `first-i` 리소스로 전달되어야 하는 반면, 클릭수는 다음으로 보고되어야 합니다. `second-c` 리소스.

## 사전 요구 사항

노출 및 클릭수를 보고하기 전에 담당 기술 계정 관리자(Technical Account Manager)로부터 기본 URL을 받으세요.

## 엔드포인트 호출 통합

엔드포인트 호출은 앱 또는 웹사이트 내에서 실행되어야 합니다. Epsilon Retail Media에서 통합 프로세스는 '백엔드 대 백엔드' 통합 방식 덕분에 모바일 앱과 웹사이트 모두 유사합니다. 이 방식을 통해 데스크톱 및 모바일 플랫폼 모두에서 광고 요청이 일관되게 유지됩니다. 그러나 모바일 앱은 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/ko/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.