아래에서는 광고 요청에 기술된 대로 표준 요청에서 사용 가능한 속성을 간략히 설명합니다. 세 개의 API 호출을 작성해야 합니다. 제품 광고용 1개, 배너 x 광고용 1개, 마지막으로 정적 콘텐츠용 1개입니다.

제품 광고를 요청한 항목

문자열	설명	필수/선택
`catalogId`	웹사이트의 제품 카탈로그 식별자입니다.	필수 입력 항목입니다
`customerId`	고객에게 제공되는 광고의 고유한 식별자입니다.	(선택 사항)
`filterMode`	요청 구조를 정의하는 선택적 방법입니다. 자세한 정보는 광고 생성 필터링 을 참조하십시오.	선택 및 선호 사항입니다.
`maxNumberOfAds`	최대 15개까지 반환할 수 있는 최대 광고 수입니다.	필수 입력 항목입니다
`options`	요청 구조를 정의하는 선택적 방법입니다. 자세한 정보는 광고 생성 필터링 을 참조하십시오.	선택 및 선호 사항입니다.
`placement`	사용자가 요청하는 광고의 고유한 게재위치입니다.	필수 입력 항목입니다
`productFilters`	위치 등 귀하의 요청과 관련된 제품 필터입니다. 추가적으로 다음에 대한 귀하의 브랜드 페이지 필터를 포함해야 합니다: `brandpage:<VALUE>` 해당 값은 브랜드 페이지의 고유한 URL 접미사입니다. 접미사에 대해 구성된 브랜드 페이지가 있는 경우, CitrusAd가 페이로드의 콘텐츠를 전송합니다.	필수 입력 항목입니다.
`sessionId`	고객 세션의 고유 식별자입니다. 표준 통합의 속성에 사용됩니다. 자세한 정보는 통합 워크플로 옵션 을 검토하십시오.	표준 통합 필수 항목

제품 광고가 반환된 항목

문자열	설명	예시 값
`customPayload`	카탈로그 파일에서 광고 생성으로 스레드되어야 하는 사용자 정의 페이로드입니다. 필드에는 바이트 배열로 직렬화된 유효한 JSON 오브젝트와 인코딩된 Base64가 포함되어야 합니다. JSON 오브젝트는 스키마를 준수해야 합니다.	통합별 사용자 정의
`id`	광고의 고유한 ID입니다. 이는 CitrusAd에 대한 각 요청에 대해 고유하며 캐싱할 수 없습니다.	`display_yCaCIy_kKaJnRnzrenBkVSytwr8yNTgxMzM4`
`gtin`	광고의 제품 코드입니다. 이는 제품 카탈로그에서 동기화되는 제품 코드입니다.	`25813383`
`discount`	무시할 수 있는 레거시입니다.	`{ "amount": 0, "minPrice": 0, "maxPerCustomer": 0 }`
`position`	CitrusAd 응답에 있는 광고의 위치입니다. 고정된 테넌시 캠페인이 활용되는 경우 이 위치를 준수해야 합니다.	1

배너 x 요청 항목

문자열	설명	필수/선택
`bannerSlotIds`	요청되는 배너 slotIds의 json 배열입니다.	필수 입력 항목입니다
`catalogId`	웹사이트의 제품 카탈로그 식별자입니다.	필수 입력 항목입니다
`contentStandardId`	웹사이트의 배너 사양 식별자입니다.	필수 입력 항목입니다
`customerId`	고객에게 제공되는 광고의 고유한 식별자입니다.	(선택 사항)
`filterMode`	요청 구조를 정의하는 선택적 방법입니다. 자세한 정보는 광고 생성 필터링 을 참조하십시오.	선택 및 선호 사항입니다.
`maxNumberOfAds`	반환하려는 각 배너 슬롯의 최대 수입니다.	필수 입력 항목입니다
`options`	요청 구조를 정의하는 선택적 방법입니다. 자세한 정보는 광고 생성 필터링 을 참조하십시오.	선택 및 선호 사항입니다.
`placement`	사용자가 요청하는 광고의 고유한 게재위치입니다.	필수 입력 항목입니다
`productFilters`	위치 등 귀하의 요청과 관련된 제품 필터입니다. 추가적으로 다음에 대한 귀하의 브랜드 페이지 필터를 포함해야 합니다: `brandpage:<VALUE>` 해당 값은 브랜드 페이지의 고유한 URL 접미사입니다. 접미사에 대해 구성된 브랜드 페이지가 있는 경우, CitrusAd가 페이로드의 콘텐츠를 전송합니다.	필수 입력 항목입니다.
`sessionId`	고객 세션의 고유 식별자입니다. 표준 통합의 속성에 사용됩니다. 자세한 정보는 통합 워크플로 옵션 을 검토하십시오.	표준 통합 필수 항목
`slotId`	여기에는 컨텍스트에서 요청된 모든 SlotId가 포함됩니다. 하나 또는 여러 개가 있을 수 있습니다.	필수 입력 항목입니다

배너 x 반환 항목

문자열	설명	예시 값
`backgroundColour`	배너의 배경 색상입니다. HEX 값만 적용됩니다.	`6e6c6c`
`backgroundImage`	배너 배경 이미지의 이미지 링크입니다.	`https://cdn.[server].io/s/9b93e7f9-d747-4c8b-bcba-2357b280a3b3`
`backgroundImagePosition`	배경 이미지의 위치 유형을 정의합니다. 값이 없는 경우 기본 값을 다음으로 설정해야 합니다: `leftaligned` .	`leftaligned` `rightaligned` `fill` `repeating`
`bannerText`	배너에 표시되는 텍스트입니다. HTML 태그를 포함할 수 있습니다.	`<strong>Double Fudge Ice Cream</strong>`
`bannerTextColour`	배너 텍스트 색상 - HEX 값만 가능합니다. Citrus는 다음을 전송하지 않습니다: `#`.	`1dc711`
`citrusAdId`	광고의 고유한 ID입니다. 이는 CitrusAd에 대한 각 요청에 대해 고유하며 캐싱할 수 없습니다.	`shotgun_wIpZraEXcIu0daC5YMQewPil2S83NzE0MTA3`
`citrusCampaignName`	광고의 캠페인 이름입니다.	`CitrusAd-Example-Category-Banner-X-Ad-ae536b0d5c3ded28ea624ab4285facd6`
`citrusContentStandardId`	슬롯과 관련된 배너 사양 ID입니다.	`8jsuwnfwe-1435-460b-9d2b-5d838e3dba9c`
`citrusExpiry`	광고의 만료일입니다. 클릭 수가 CitrusAd에 보고될 수 있는 가장 최근의 지점입니다.	`2021-06-01T23:48:16.573967987Z`
`citrusSlotId`	요청한 배너에 대한 특정 슬롯의 ID입니다.	`Category_Top`
`contentStandardId`	슬롯과 관련된 배너 사양 ID입니다. 다음의 중복입니다. `citrusContentStandardId`	`8jsuwnfwe-1435-460b-9d2b-5d838e3dba9c`
`ctaFlag`	CTA의 표시 여부를 정의합니다.	`true` `false`
`ctaLink`	CTA에서 전달한 URL(배너의 linkUrl과 비슷한 역할). ctaFlag가 다음에 해당하는 경우에만: `true`	`https://www.retailer.com/groceries/en-GB/search?query=double-fudge`
`ctaText`	CTA 내의 텍스트입니다.	`Shop now`
`ctaTextAccessibility	스크린 리더 사용자를 위한 CTA의 내게 필요한 옵션 텍스트입니다.	`for Double Fudge Ice Cream`
`gtins`	캠페인의 광고 제품에서 선택한 제품 코드 최대 20개의 배열입니다. 소매업체는 이 목록을 사용하여 배너 클릭 시 리스터 페이지를 자동화하거나 특정 렌더링 기능(라운델, 가격 책정, 2차 재고 수준 점검)을 자동화할 수 있습니다.	`"gtins": [ "7714107", "7163379", "7733636", "7733657", "7733628" ],`
`headingText`	스크린 리더 사용자를 위한 제목 텍스트입니다.	`Banner Advertisement for Fudge Double Ice Cream with a product image and shop now button`
`heroImageAltText`	간혹 히어로 이미지가 표시되지 않을 때를 위한 대체 텍스트입니다.	`Image of double fudge iced cream`
`heroImage`	배너의 히어로 이미지의 이미지 링크입니다.	`https://cdn.[server].io/s/9b93e7f9-d747-4c8b-bcba-2357b280a3b3`
`position`	CitrusAd 응답에 있는 배너의 위치입니다. 고정된 테넌시 캠페인이 활용되는 경우 이 위치를 준수해야 합니다.	1
`secondaryBackgroundImage`	추가 배경 이미지의 이미지 링크입니다.	`https://cdn.[server].io/s/9b93e7f9-d747-4c8b-bcba-2357b280a3b3`
`secondaryBackgroundImagePosition`	추가 배경 이미지의 위치 유형을 정의합니다.	`leftaligned` `rightaligned`
`secondaryHeroImageAltText`	간혹 추가 히어로 이미지가 표시되지 않을 때를 위한 대체 텍스트입니다.	`Image of [brand] logo`
`secondaryHeroImage`	추가 히어로 이미지의 이미지 링크입니다.	`https://cdn.[server].io/s/9b93e7f9-d747-4c8b-bcba-2357b280a3b3`
`secondaryHeroMode`	추가 히어로 이미지의 표시 모드를 정의합니다. 값이 없는 경우 기본 값을 다음으로 설정해야 합니다: `block` .	`block` `landscape`
`slotId`	요청한 배너의 슬롯 ID입니다. 여러 배너를 요청할 때 요청된 ID를 참조하는 데 사용할 수 있습니다.	`Category_Top`
`tags`	이 필드는 캠페인에서 광고주가 입력한 모든 타사 태그를 반환합니다. API 응답이 포맷되어 있지만 현재 배너 x에 의해 지원되는 대상이 아닙니다.	`{}`

브랜드 페이지 요청 항목

문자열	설명	필수/선택
`catalogId`	웹사이트의 제품 카탈로그 식별자입니다.	필수 입력 항목입니다
`placement`	사용자가 요청하는 광고의 고유한 게재위치입니다.	필수 입력 항목입니다
`brandPageId`	브랜드 페이지의 고유 ID. 해당 값은 브랜드 페이지의 고유한 URL 접미사입니다.	필수 입력 항목입니다.

제품 광고가 반환된 항목

문자열	설명	예시 값
`pageContentText`	광고주가 입력한 페이지 콘텐츠입니다. 일반적으로 브랜드 페이지의 콘텐츠를 광고하는 하나 혹은 두 개 단락입니다.	밀크 초콜릿 베이스에 쿠키 조각을 올리고 화이트 초콜릿을 감싼 밀크 초코 청크, 쿠키를 사랑한다면 지나칠 수 없는 맛입니다. 170g 블록, 45g 바가 출시되어 있습니다.
`pageHeaderText`	브랜드 페이지 제목	새로운 초콜릿 쿠키

📘
광고 캠페인의 일부로 구성되지 않은 필드가 있는 경우 해당 필드가 제공되지 않습니다. 즉, 광고주가 heroImage를 구성하지 않은 경우에는 CitrusAd는 heroImage 속성을 실행하지 않습니다.