Serving an ad
광고 요청 / 광고 제공
지면 태그(tagid)와 요청 페이로드(AdRequest)를 기반으로 광고를 제공합니다. 캠페인, 크리에이티브, 입찰 전략 데이터를 사용하여 가장 적합한 광고를 선택합니다. DSP 응답과 내부 중재 로직을 통해 결정된 최종 광고를 반환합니다.
curl --request POST \
--url https://your_a2_service/app/v0/ad/{tagid} \
--header 'Content-Type: application/json' \
--data '
{
"version": "<string>",
"device": {
"ext": "<unknown>",
"geo": {
"accuracy": 123,
"city": "<string>",
"country": "<string>",
"ext": "<unknown>",
"ipservice": 1,
"lastfix": 1,
"lat": 123,
"lon": 123,
"metro": "<string>",
"region": "<string>",
"regionfips104": "<string>",
"type": 1,
"utcoffset": 123,
"zip": "<string>"
},
"ip": "<string>",
"ua": "<string>"
},
"user": {
"buyeruid": "<string>",
"ext": "<unknown>",
"gender": "M",
"geo": {
"accuracy": 123,
"city": "<string>",
"country": "<string>",
"ext": "<unknown>",
"ipservice": 1,
"lastfix": 1,
"lat": 123,
"lon": 123,
"metro": "<string>",
"region": "<string>",
"regionfips104": "<string>",
"type": 1,
"utcoffset": 123,
"zip": "<string>"
},
"id": "<string>",
"keywords": "<string>",
"yob": 1
}
}
'{
"ad": {
"display": {
"banner": {
"img": "https://example.com/image.jpg"
},
"h": 1024,
"w": 768
},
"id": "b56dc3bf-935d-4ee6-b1ed-f31bfc02be91"
},
"ext": {
"ad_log": "YTU2ZDY2ZjctNDM4ZS00OTVjLWJiYTAtMjI4Mzk2MjQ0ZWVkfDA2NDI4NjYwLWY2NDMtNGVmNS05MzgzLTZjZmE1OGYxOGI2OXxjNTZkYzNiZi05MzVkLTRlZTYtYjFlZC1mMzFiZmMwMmJlOTF8NGJlMmQ4ZTYtYThhMS00NzI2LWEzMjAtNjkyNTYzMDkwZTQyfDllZjY2ZGM4LTBlMmMtNDlmMS05NDU3LWFmYmUwZGQ2ZjU3M3w1NTgxNmIzOTcxMWY5YjVhY2YzYjkwZTMxM2VkMjllNTE2NjU2MjNm",
"message": "success"
},
"version": "0.1.0"
}Path Parameters
지면 ID (tagid)
Body
AdRequest는 광고 요청에 사용됩니다.
AdRequest is used for requesting an ad.
SDK API 버전
광고 요청에 대한 디바이스 객체.
표시 하위 속성
표시 하위 속성
광고 시스템별 확장을 위한 예약 필드
사용자의 현재 위치로 간주되는 기기의 위치 정보. Geo 객체로 정의됨.
표시 하위 속성
표시 하위 속성
1, 2, 3, 4 x >= 01, 2, 3 기기와 가장 가까운 IPv4 주소.
브라우저 User-Agent 문자열. 이 필드는 브라우저의 원본 UA 문자열을 나타냄. 하위 호환성을 위해 User-Agent Client-Hints가 사용 가능하더라도 UA 문자열을 항상 포함하는 것을 권장. 추정되거나 근사된 UA는 허용되지 않음. Client-Hints가 지원되고 'sua' 필드가 있는 경우, 입찰자는 기기 유형, 브라우저 유형 및 버전 감지를 위해 'sua'를 사용하고 'ua'는 무시하는 것을 권장.
광고 요청에 대한 사용자 객체
표시 하위 속성
표시 하위 속성
Buyer-specific ID for the user as mapped by the exchange for the buyer.
Placeholder for exchange-specific extensions to OpenRTB.
Gender, where “M” = male, “F” = female, “O” = known to be other (i.e., omitted is unknown).
M, F, O Location of the user’s home base defined by a Geo object (Section 3.2.19). This is not necessarily their current location.
표시 하위 속성
표시 하위 속성
1, 2, 3, 4 x >= 01, 2, 3 Exchange-specific ID for the user.
Comma separated list of keywords, interests, or intent. Only one of ‘keywords’ or ‘kwarray’ may be present.
Year of birth as a 4-digit integer.
x >= 0Response
광고 송출 성공
Version of the SDK API.
광고 객체
표시 하위 속성
표시 하위 속성
ID of the creative; unique at least throughout the scope of a vendor (e.g., an exchange or buying platform). Note that multiple instances of the same ad when used in transactions must have the same ID.
광고의 콘텐츠 카테고리를 설명하는 배열. cattax에 지정된 분류법을 사용하여 구현자는 데이터 사용 및 공유에 대한 지역 법률 준수를 보장해야 합니다.
cat 속성에 사용되는 분류법. 분류법 목록: 카테고리 분류법
IABTechLabAdProductTaxonomy1_0, IABTechLabAudienceTaxonomy1_1, IABTechLabContentCategoryTaxonomy2_1, IABTechLabContentCategoryTaxonomy2_2, IABTechLabContentCategoryTaxonomy3_0, IABTechLabAdProductTaxonomy2_0 이 광고는 디스플레이 광고이며 추가 세부 정보를 제공합니다.
표시 하위 속성
표시 하위 속성
VPAID1_0, VPAID2_0, MRAID1_0, ORMMA, MRAID2_0, MRAID3_0, OMID1_0, SIMID1_0, SIMID1_1 배너 소재에 대한 배너 이미지 객체.
표시 하위 속성
표시 하위 속성
This object identifies the native asset as a link asset and is used to define navigation for call-to-action or other activations (i.e., clicks). A link asset can be independent or associated with the overall native ad (i.e., a default for all assets).
HTML, AMPHTML, StructuredImageObject, StructuredNativeObject 표시 하위 속성
표시 하위 속성
1, 2 1, 2, 3, 4, 5 VPAID1_0, VPAID2_0, MRAID1_0, ORMMA, MRAID2_0, MRAID3_0, OMID1_0, SIMID1_0, SIMID1_1 A2 확장 정보
절대 높이, 픽셀(DIPS) .
x >= 0x >= 0광고의 MIME 유형(예: “image/jpeg”).
네이티브 광고에 대한 네이티브 객체.
표시 하위 속성
표시 하위 속성
표시 하위 속성
표시 하위 속성
This object identifies the native asset as a data asset. A data asset is used for all miscellaneous elements such as brand name, ratings, stars, review count, downloads, price, counts, etc. It is purposefully generic to support native elements not currently contemplated by this specification.
This object identifies the native asset as a image asset. Image assets are use for such elements as the actual creative images and icons.
표시 하위 속성
표시 하위 속성
This object identifies the native asset as a link asset and is used to define navigation for call-to-action or other activations (i.e., clicks). A link asset can be independent or associated with the overall native ad (i.e., a default for all assets).
0, 1 This object identifies the native asset as a link asset and is used to define navigation for call-to-action or other activations (i.e., clicks). A link asset can be independent or associated with the overall native ad (i.e., a default for all assets).
절대 너비, 픽셀(DIPS).
x >= 0x >= 0A2 확장 정보
캐시 비활성화 없이 광고 콘텐츠를 대표하는 이미지의 URL. 광고 품질 검사를 위한 커서 수준 광고 품질 검사에 사용됩니다.
ISO-639-1-alpha-2 형식의 광고 크리에이티브 언어. 이 객체를 사용하는 업체는 이 객체를 사용하기 전에 대체 표준(예: BCP-47)을 선택할 수 있습니다. 광고에 언어 콘텐츠가 없는 경우(예: 회사 로고만 있는 배너) 비표준 코드 “xx”도 사용할 수 있습니다.
이 광고는 비디오 광고이며 추가 세부 정보를 제공합니다.
표시 하위 속성
표시 하위 속성
VPAID1_0, VPAID2_0, MRAID1_0, ORMMA, MRAID2_0, MRAID3_0, OMID1_0, SIMID1_0, SIMID1_1 VAST1_0, VAST2_0, VAST3_0, VAST1_0Wrapper, VAST2_0Wrapper, VAST3_0Wrapper, VAST4_0, VAST4_0Wrapper, DAAST1_0, DAAST1_0Wrapper, VAST4_1, VAST4_1Wrapper, VAST4_2, VAST4_2Wrapper x >= 0Error code if the request failed.
Optional vendor-specific extensions.
이 페이지가 도움이 되었나요?
curl --request POST \
--url https://your_a2_service/app/v0/ad/{tagid} \
--header 'Content-Type: application/json' \
--data '
{
"version": "<string>",
"device": {
"ext": "<unknown>",
"geo": {
"accuracy": 123,
"city": "<string>",
"country": "<string>",
"ext": "<unknown>",
"ipservice": 1,
"lastfix": 1,
"lat": 123,
"lon": 123,
"metro": "<string>",
"region": "<string>",
"regionfips104": "<string>",
"type": 1,
"utcoffset": 123,
"zip": "<string>"
},
"ip": "<string>",
"ua": "<string>"
},
"user": {
"buyeruid": "<string>",
"ext": "<unknown>",
"gender": "M",
"geo": {
"accuracy": 123,
"city": "<string>",
"country": "<string>",
"ext": "<unknown>",
"ipservice": 1,
"lastfix": 1,
"lat": 123,
"lon": 123,
"metro": "<string>",
"region": "<string>",
"regionfips104": "<string>",
"type": 1,
"utcoffset": 123,
"zip": "<string>"
},
"id": "<string>",
"keywords": "<string>",
"yob": 1
}
}
'{
"ad": {
"display": {
"banner": {
"img": "https://example.com/image.jpg"
},
"h": 1024,
"w": 768
},
"id": "b56dc3bf-935d-4ee6-b1ed-f31bfc02be91"
},
"ext": {
"ad_log": "YTU2ZDY2ZjctNDM4ZS00OTVjLWJiYTAtMjI4Mzk2MjQ0ZWVkfDA2NDI4NjYwLWY2NDMtNGVmNS05MzgzLTZjZmE1OGYxOGI2OXxjNTZkYzNiZi05MzVkLTRlZTYtYjFlZC1mMzFiZmMwMmJlOTF8NGJlMmQ4ZTYtYThhMS00NzI2LWEzMjAtNjkyNTYzMDkwZTQyfDllZjY2ZGM4LTBlMmMtNDlmMS05NDU3LWFmYmUwZGQ2ZjU3M3w1NTgxNmIzOTcxMWY5YjVhY2YzYjkwZTMxM2VkMjllNTE2NjU2MjNm",
"message": "success"
},
"version": "0.1.0"
}