Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

목차

Table of Contents
maxLevel3
exclude\bIndex\b

...

필드

유형

설명

Status
colourRed
title필수
app_id

Integer

매체 앱 아이디

Status
colourRed
title필수
unit_id

Integer

매체 지면 아이디

Status
colourRed
title필수
ifa

String

유저 개인 식별 정보. 어뷰징 필터링 및 CS 처리를 위해 필요합니다.

예제) ab4ade35-1c8a-4405-acda-10ca1ad1abe1

Status
colourRed
title필수
user_id

String

유저의 매체 아이디

Status
colourRed
title필수
client_ip

String

클라이언트 아이피. 어뷰징 필터링을 위해 사용됩니다.

예제) 123.123.123.123

Status
colourGreen
title권장
birthday

String

유저의 생년월일

생년월일 정보가 없을 경우 일부 광고가 할당에서 제외됩니다.

예제) 1993-01-09

Status
colourGreen
title권장
gender

String

성별 타게팅을 위한 정보.

성별 정보가 없을 경우 일부 광고가 할당에서 제외됩니다.

  • M: 남자

  • F: 여자

Status
colourGreen
title권장
carrier

String

통신사 정보.

통신사 정보가 없을 경우 일부 광고가 할당에서 제외됩니다.

  • kt: KT 통신사

  • skt: SKT 통신사

  • lgt: LGT 통신사

Status
colourGreen
title권장
device_name

String

디바이스 모델명

디바이스 모델명이 없을 경우 일부 광고가 할당에서 제외됩니다.

예제) SHV-E250S,SHV-E275K,SM-G928L
예제) SHV-E250S,SHV-E275K,SM-G928L → SHV-E250S 또는 SHV-E275K 또는 SM-G928L 인 유저에게 타게팅

Status
colourGreen
title권장
latitude

Float

위도 와 경도. 지역별 광고 타게팅에 사용됩니다.

정보가 없을 경우 일부 광고가 할당에서 제외됩니다.

Status
colourGreen
title권장
longitude

Float

Status
colourGreen
title권장
user_agent

String

User Agent.

정보가 없을 경우 일부 광고가 할당에서 제외됩니다.

...

필드

유형

설명

title

String

광고 소재 제목

description

String

광고에 대한 상세 설명

click_url

String

광고 클릭 시 호출되는 URL

call_to_action

String

광고의 참여를 유도하는 CTA 버튼의 UI 텍스트

예제) 참여하기

width

Integer

광고 소재의 가로 길이. 값은 1200으로 고정

height

Integer

광고 소재의 세로 길이. 값은 627으로 고정

icon_url

String

광고주 아이콘 이미지

image_url

String

URL 형태로 전달받는 광고 이미지

is_deeplink

Boolean

리다이렉팅된 최종 URL의 Deeplink 여부

...

2. 사용자에게 광고가 노출되면 impression_urls로 전달한 URL을 호출합니다.

3. 사용자가 광고를 클릭하면 click_urlsurl로 전달한 URL을 호출합니다.

4. 사용자가 정상적으로 광고 참여를 완료하면, 버즈빌 서버에서 매체사의 포스트백 URL으로 포인트 적립 요청을 시도합니다. 자세한 내용은 매체사 포인트 적립 포스트백 API 연동 가이드를 참고하세요.

사용자가 액션형 광고에 정상적으로 참여했는지 확인하려면 conversion_check_url로 전달한 URL을 호출하세요.

...

true: 사용자의 광고 참여가 정상적으로 완료되었습니다.

...

.

3) Status code

  • 아래 상태코드는 http status와 별개로, Response parameter 안에 code 라는 필드를 통해 내려갑니다.

...