Serving an ad

POST

app

{tagid}

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>"
}'

{
  "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

tagid

string

required

지면 ID (tagid)

Body

application/json

AdRequest는 광고 요청에 사용됩니다.

AdRequest is used for requesting an ad.

version

string

required

SDK API 버전

device

object | null

광고 요청에 대한 디바이스 객체.

user

object | null

광고 요청에 대한 사용자 객체

Response

200

application/json

광고 송출 성공

version

string

required

Version of the SDK API.

object | null

광고 객체

ad.id

string

required

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.

ad.cat

string[] | null

광고의 콘텐츠 카테고리를 설명하는 배열. cattax에 지정된 분류법을 사용하여 구현자는 데이터 사용 및 공유에 대한 지역 법률 준수를 보장해야 합니다.

ad.cattax

cat 속성에 사용되는 분류법. 분류법 목록: 카테고리 분류법

Available options:

IABTechLabAdProductTaxonomy1_0,

IABTechLabAudienceTaxonomy1_1,

IABTechLabContentCategoryTaxonomy2_1,

IABTechLabContentCategoryTaxonomy2_2,

IABTechLabContentCategoryTaxonomy3_0,

IABTechLabAdProductTaxonomy2_0

ad.display

object | null

이 광고는 디스플레이 광고이며 추가 세부 정보를 제공합니다.

ad.ext

any

A2 확장 정보

ad.iurl

string | null

캐시 비활성화 없이 광고 콘텐츠를 대표하는 이미지의 URL. 광고 품질 검사를 위한 커서 수준 광고 품질 검사에 사용됩니다.

ad.lang

string | null

ISO-639-1-alpha-2 형식의 광고 크리에이티브 언어. 이 객체를 사용하는 업체는 이 객체를 사용하기 전에 대체 표준(예: BCP-47)을 선택할 수 있습니다. 광고에 언어 콘텐츠가 없는 경우(예: 회사 로고만 있는 배너) 비표준 코드 “xx”도 사용할 수 있습니다.

ad.video

null

이 광고는 비디오 광고이며 추가 세부 정보를 제공합니다.

errorcode

string | null

Error code if the request failed.

ext

any

Optional vendor-specific extensions.

이 페이지가 도움이 되었나요?

/app/v0/log광고 최적화 및 분석을 위한 광고 상호작용 이벤트를 기록합니다. 지원되는 이벤트 유형: - 노출(imp): 광고 노출 이벤트 기록 - 클릭(clk): 광고 클릭 이벤트 기록 - 전환(conv): 구매, 설치, 구독 등 노출 후 전환 이벤트 기록 참고: 모든 요청에 대해 200 OK를 반환합니다. 유효하지 않은 스키마는 자동으로 무시됩니다.

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>"
}'

{
  "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"
}

Data Management APIs

Decision APIs

광고 요청 / 광고 제공

Path Parameters

Body

Response