Data Management APIs
- Allocation
- Activity Log
- Audience
- Audience Attribute
- Audience Segment
- Auth and User
- Campaign
- Catalog
- Creative
- Analytic
- Billing
- System
- License
- Media Library
- Placement Catalog
- Placement
Decision APIs
- Cache Management
- Configuration
- Ad Serving
- Ad Log
- Activity Log
Ad Serving
Serving an ad
광고 요청 / 광고 제공
지면 태그(tagid
)와 요청 페이로드(AdRequest
)를 기반으로 광고를 제공합니다. 캠페인, 크리에이티브, 입찰 전략 데이터를 사용하여 가장 적합한 광고를 선택합니다. DSP 응답과 내부 중재 로직을 통해 결정된 최종 광고를 반환합니다.
POST
/
app
/
v0
/
ad
/
{tagid}
Copy
curl --request POST \
--url https://your_a2_service/app/v0/ad/{tagid} \
--header 'Content-Type: application/json' \
--data '{
"device": {
"ext": "<any>",
"geo": {
"accuracy": 123,
"city": "<string>",
"country": "<string>",
"ext": "<any>",
"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": "<any>",
"gender": "M",
"geo": {
"accuracy": 123,
"city": "<string>",
"country": "<string>",
"ext": "<any>",
"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
},
"version": "<string>"
}'
Copy
{
"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
application/json
AdRequest는 광고 요청에 사용됩니다.
AdRequest is used for requesting an ad.
Response
200
application/json
광고 송출 성공
The response is of type object
.
Copy
curl --request POST \
--url https://your_a2_service/app/v0/ad/{tagid} \
--header 'Content-Type: application/json' \
--data '{
"device": {
"ext": "<any>",
"geo": {
"accuracy": 123,
"city": "<string>",
"country": "<string>",
"ext": "<any>",
"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": "<any>",
"gender": "M",
"geo": {
"accuracy": 123,
"city": "<string>",
"country": "<string>",
"ext": "<any>",
"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
},
"version": "<string>"
}'
Copy
{
"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"
}
어시스턴트
Responses are generated using AI and may contain mistakes.