아래에서는 표준 요청에서 가능한 속성과 광고를 수신하는 경우의 응답을 간략하게 설명합니다.
요청된 항목
| 문자열 | 설명 | 필수/선택 |
|---|---|---|
catalogId | 웹사이트의 제품 카탈로그 식별자입니다. | 필수 입력 항목입니다 |
customerId | 고객에게 제공되는 광고의 고유한 식별자입니다. | 선택 사항 |
filterMode | Optional way of defining the structure of your request. See Ad generation filtering for more information. | 선택 및 선호 사항 |
maxNumberOfAds | 최대 10개까지 반환할 수 있는 최대 광고 수입니다. | 필수 입력 항목입니다 |
options | Optional way of defining the structure of your request. See Ad generation filtering for more information. This is also the object where you can request advertiser information in order to comply with local advertising legislation like Europe’s Digital Services Act. | 선택 및 선호 사항 |
placement | 사용자가 요청하는 광고의 고유한 게재위치입니다. | 필수 입력 항목입니다 |
productFilters | 요청과 관련된 제품 필터입니다. 카테고리, 위치 또는 크기가 있습니다. | 필수 입력 항목입니다 |
sessionId | The unique identifier of the customer's session. Used for attribution in standard integrations. Review Integration workflow options for more information. | 표준 통합 필수 항목 |
memoryToken | Used for pagination. Use a token provided in a previous ad request to ensure Epsilon Retail Media only serves new ads to your customers. If provided, Epsilon Retail Media will exclude previously served ads in the ad response. Review Pagination to learn more. | 선택 사항 |
dtmCookieId | 웹사이트에서 생성 및 저장하는 쿠키로 동일한 도메인에서 사용자 행동을 추적하는 데 사용됩니다. | 선택 사항 |
audience | Specifies specific audience segments that the shopper belongs to. Only relevant is using Audience Targeting Option 3 | 선택 사항 |
반환된 항목
| 문자열 | 설명 | 예시 값 |
|---|---|---|
ads.customPayload | 카탈로그 파일에서 광고 생성으로 스레드되어야 하는 사용자 정의 페이로드입니다. 필드에는 바이트 배열로 직렬화된 유효한 JSON 오브젝트와 인코딩된 Base64가 포함되어야 합니다. JSON 오브젝트는 스키마를 준수해야 합니다. | 통합별 사용자 정의 |
ads.sellerId | 판매자의 고유한 Id입니다. sellerId가 팀에 설정된 경우에만 표시됩니다. sellerIds는 일반적으로 마켓플레이스 판매자를 온보딩하는 경우에 사용됩니다. | 73nns-32sxr-32ss 통합별 사용자 정의 |
ads.id | 광고의 고유한 ID입니다. 이는 Epsilon Retail Media에 대한 각 요청마다 고유하며 캐시될 수 없습니다. | display_yCaCIy_kKaJnRnzrenBkVSytwr8yNTgxMzM4 |
ads.gtin | 광고의 제품 코드입니다. 이는 제품 카탈로그에서 동기화되는 제품 코드입니다. | 25813383 |
ads.discount | 무시할 수 있는 레거시입니다. | { "amount": 0, "minPrice": 0, "maxPerCustomer": 0 } |
ads.position | Epsilon Retail Media 응답 내 광고의 위치입니다. 고정된 테넌시 캠페인이 사용되는 경우 이 위치를 준수해야 합니다. | 1 |
ads.memoryToken | 페이지 매김 및 광고 요청 연결에 사용됩니다. If provided in your next ad request for the same context, Epsilon Retail Media will exclude previously served ads in the ad response. Review Pagination to learn more. | |
ads.metadata | Object containing the advertiser info required to help advertisers comply with local advertising legislation such as the Digital Services Actin Europe.
| "metadata": { "advertiserInfo": { "advertiser": "Bob's advertising agency", "onBehalfOf": "Brand company inc" } ... |
banners | Comprises of banner objects. View the Banner ad (static) reference to learn more. | "banners": [], |
metadata.warnings | 광고 요청에 대한 경고 정보를 포함하는 객체입니다. 현재는 최대 세그먼트 수를 초과한 경우에만 경고가 표시됩니다. | "metadata": { "warnings": [ "Audience Segment IDs exceeded the limit of 100 and were truncated" ] |