The below outlines the properties possible in a standard request as outlined in Requesting ads for your request, and the response if you receive an ad.
요청된 항목
| 문자열 | 설명 | 필수/선택 |
|---|---|---|
BannerSlotIds | 요청되는 배너 slotIds의 json 배열입니다. | 필수 입력 항목입니다 |
catalogId | 웹사이트의 제품 카탈로그 식별자입니다. | 필수 입력 항목입니다 |
contentStandardId | 웹사이트의 배너 사양 식별자입니다. | 필수 입력 항목입니다 |
customerId | 고객에게 제공되는 광고의 고유한 식별자입니다. | 선택 사항 |
filterMode | Optional way of defining the structure of your request. See Ad generation filtering for more information. | 선택 및 선호 사항 |
maxNumberOfAds | 반환하려는 각 배너 슬롯의 최대 수입니다. | 필수 입력 항목입니다 |
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 | 요청과 관련된 제품 필터입니다. 카테고리, 위치 또는 크기 필터가 있습니다. | 카테고리 게재위치에 필요합니다. |
searchTerm | 고객이 웹 사이트에 입력한 검색어입니다. | 검색 게재위치에 필요합니다. |
sessionId | The unique identifier of the customer's session. Used for attribution in standard integrations. Review Integration workflow optionsfor more information. | 표준 통합 필수 항목 |
slotId | 여기에는 컨텍스트에서 요청된 모든 SlotId가 포함됩니다. 하나 또는 여러 개가 있을 수 있습니다. | 필수 입력 항목입니다 |
dtmCookieId | 웹사이트에서 생성 및 저장하는 쿠키로 동일한 도메인에서 사용자 행동을 추적하는 데 사용됩니다. | 선택 사항 |
audience | Specifies specific audience segments that the shopper belongs to. Only relevant is using Audience Targeting Option 3 | 선택 사항 |
반환된 항목
| 문자열 | 설명 | 예시 값 |
|---|---|---|
ads.backgroundColour | 배너의 배경 색상입니다. HEX 값만 적용됩니다. | 6e6c6c |
ads.backgroundImage | 배너 배경 이미지의 이미지 링크입니다. | [<https://cdn.[server].io/s/9b93e7f9-d747-4c8b-bcba-2357b280a3b3>](https://cdn.[server].io/s/9b93e7f9-d747-4c8b-bcba-2357b280a3b3`) |
ads.backgroundImagePosition | 배경 이미지의 위치 유형을 정의합니다. 값이 없으면 기본 값을 leftaligned(으)로 설정해야 합니다. | leftalignedrightalignedfillrepeating |
ads.bannerText | 배너에 표시되는 텍스트입니다. HTML 태그를 포함할 수 있습니다. | <strong>Double Fudge Ice Cream</strong> |
ads.bannerTextColour | 배너 텍스트 색상 - HEX 값만 가능합니다. Citrus는 #를 전송하지 않습니다. | 1dc711 |
ads.citrusAdId | 광고의 고유한 ID입니다. 이는 Epsilon Retail Media에 대한 각 요청마다 고유하며 캐시될 수 없습니다. | shotgun_wIpZraEXcIu0daC5YMQewPil2S83NzE0MTA3 |
ads.citrusCampaignName | 광고의 캠페인 이름입니다. | Epsilon-Example-Category-Banner-X-Ad-ae536b0d5c3ded28ea624ab4285facd6 |
ads.citrusContentStandardId | 슬롯과 관련된 배너 사양 ID입니다. | 8jsuwnfwe-1435-460b-9d2b-5d838e3dba9c |
ads.citrusExpiry | 광고의 만료일입니다. 클릭 수가 Epsilon Retail Media에 보고될 수 있는 가장 마지막 날짜 및 시간입니다. | 2021-06-01T23:48:16.573967987Z |
ads.citrusSlotId | 요청한 배너에 대한 특정 슬롯의 ID입니다. | Category_Top |
ads.contentStandardId | 슬롯과 관련된 배너 사양 ID입니다. 다음의 중복입니다. citrusContentStandardId | 8jsuwnfwe-1435-460b-9d2b-5d838e3dba9c |
ads.ctaFlag | CTA의 표시 여부를 정의합니다. | truefalse |
ads.ctaLink | CTA에서 전달한 URL(배너의 linkUrl과 비슷한 역할). ctaFlag가 다음에 해당하는 경우에만: true | <https://www.retailer.com/groceries/en-GB/search?query=double-fudge> |
ads.ctaText | CTA 내의 텍스트입니다. | Shop now |
ads.ctaTextAccessibility | 스크린 리더 사용자를 위한 CTA의 내게 필요한 옵션 텍스트입니다. | for Double Fudge Ice Cream |
ads.gtins | 캠페인의 광고 제품에서 선택한 최대 20개의 제품 코드 배열입니다. 소매업체는 이 목록을 사용하여 배너를 클릭할 때 리스터 페이지를 자동화하거나 특정 렌더링 기능(원형 무늬, 가격, 2차 재고 수준 검사)을 자동화할 수 있습니다. | [ "7714107", "7163379", "7733636", "7733657", "7733628" ], |
ads.headingText | 스크린 리더 사용자를 위한 제목 텍스트입니다. | Banner Advertisement for Fudge Double Ice Cream with a product image and shop now button |
ads.heroImageAltText | 간혹 히어로 이미지가 표시되지 않을 때를 위한 대체 텍스트입니다. | Image of double fudge iced cream |
ads.heroImage | 배너의 히어로 이미지의 이미지 링크입니다. | [<https://cdn.[server].io/s/9b93e7f9-d747-4c8b-bcba-2357b280a3b3>](https://cdn.[server].io/s/9b93e7f9-d747-4c8b-bcba-2357b280a3b3`) |
ads.position | Epsilon Retail Media 응답 내 배너광고의 위치입니다. 고정된 테넌시 캠페인이 사용되는 경우 이 위치를 준수해야 합니다. | 1 |
ads.secondaryBackgroundImage | 추가 배경 이미지의 이미지 링크입니다. | [<https://cdn.[server].io/s/9b93e7f9-d747-4c8b-bcba-2357b280a3b3>](https://cdn.[server].io/s/9b93e7f9-d747-4c8b-bcba-2357b280a3b3`) |
ads.secondaryBackgroundImagePosition | 추가 배경 이미지의 위치 유형을 정의합니다. | leftalignedrightaligned |
ads.secondaryHeroImageAltText | 간혹 추가 히어로 이미지가 표시되지 않을 때를 위한 대체 텍스트입니다. | Image of [brand] logo |
ads.secondaryHeroImage | 추가 히어로 이미지의 이미지 링크입니다. | [<https://cdn.[server].io/s/9b93e7f9-d747-4c8b-bcba-2357b280a3b3>](https://cdn.[server].io/s/9b93e7f9-d747-4c8b-bcba-2357b280a3b3`) |
ads.secondaryHeroMode | 이는 보조 히어로 이미지의 표시 모드를 정의합니다. 값이 없으면 기본 값을 block(으)로 설정해야 합니다. | blocklandscape |
ads.slotId | 요청한 배너의 슬롯 ID입니다. 여러 배너를 요청할 때 요청된 ID를 참조하는 데 사용할 수 있습니다. | Category_Top |
ads.tags | 이 필드는 캠페인에서 광고주가 입력한 모든 타사 태그를 반환합니다. API 응답이 포맷되어 있지만 현재 배너 x에 의해 지원되는 대상이 아닙니다. | {} |
ads.sellerId | 판매자의 고유한 Id입니다. sellerId가 팀에 설정된 경우에만 표시됩니다. sellerIds는 일반적으로 마켓플레이스 판매자를 온보딩하는 경우에 사용됩니다. | 73nns-32sxr-32ss 통합별 사용자 정의 |
ads.metadata | Object containing the advertiser info required to help advertisers comply with local advertising legislation such as the Digital Services Act in Europe.
| "metadata": { "advertiserInfo": { "advertiser": "Bob's advertising agency", "onBehalfOf": "Brand company inc" } ... |
ads.adm | VAST 태그를 포함한 동영상 광고 세부 정보를 담고 있는 객체입니다. | "\n<VAST version="4.0">\n <Ad id="1">\n \n \n" |
ads.companionProducts | 연관 제품 세부 정보입니다. | “companionProducts”: [ "Banana14-simfk15" "Oranges5-qgxeb6", "Incaberries20-ppscn21" |
metadata.warnings | 광고 요청에 대한 경고 정보를 포함하는 객체입니다. 현재는 최대 세그먼트 수를 초과한 경우에만 경고가 표시됩니다. | "metadata": { "warnings": [ "Audience Segment IDs exceeded the limit of {maxSegmentIds} and were truncated" ] } |
광고 캠페인의 일부로 구성되지 않은 필드가 있는 경우 광고가 실행되지 않습니다. 즉, 광고주가
heroImage를 구성하지 않은 경우 Epsilon Retail Media는heroImage속성을 제공하지 않습니다.