Versions Compared

Key

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

...

Field

Type

Description

id

Integer

광고 아이디 (식별값)

title

String

광고 제목

description

String

광고 설명

action_description

String

광고 적립방법 설명

icon

String

아이콘 이미지 주소

revenue

String

매체사 단가

revenue_type

String

광고 타입. 추후 새로운 타입이 추가될 수 있으므로 연동시 이를 고려해야 합니다.

  • cpi: 앱 설치형

  • cpe: 앱 실행형 또는 앱 실행후 액션형

  • cpa: 액션형

  • cpl: 페이스북 좋아요

  • cpinsta: 인스타그램 팔로우

  • cps: 쇼핑 적립형 광고

  • cpyoutube: 유튜브 광고

  • cpq: 퀴즈형

  • cpk: 카카오톡 채널 참여하기

  • cpylike: 유튜브 구독 + 영상 좋아요 광고

package_name

String

안드로이드 package_name

url_scheme

String

아이폰 url scheme

platform

String

광고가 지원되는 플랫폼

  • A: 안드로이드

  • I: 아이폰

  • W: 안드로이드/아이폰 둘 다 지원

Info

해당 파라미터는 광고운영단에서 세팅되는 값이며 W로 내려가는 값을 매체사 측에서 다시 필터링 하여 내리는 경우 올바른 유닛에 광고가 내려가지 않을 수 있음

age_from

Integer

나이 하한 타게팅. 타게팅이 없는 경우 null

age_to

Integer

나이 상한 타게팅. 타게팅이 없는 경우 null

age_ranges

JSON

다 구간 나이 타게팅. age_ranges를 사용하는 경우 age_from, age_to 값은 무시해도 된다.

  • 타게팅이 없는 경우

[]

  • 타게팅이 있는 경우

[{"from":10, "to":20}, {"from":30, "to":40}]

sex

String

성별 타게팅. 타게팅이 없는 경우 null

  • M: 남자

  • F: 여자

relationship

String

결혼 유무 타게팅. 타게팅이 없는 경우 null

  • S: 미혼

  • M: 기혼

carrier

String

통신사 타게팅. 타게팅이 없는 경우 null

  • kt: KT 통신사

  • skt: SKT 통신사

  • lgt: LGT 통신사

udid_required

Bool

  • true: 광고 참여/참여완료 요청시 udid 파라미터 필수

  • false: 광고 참여/참여완료 요청시 udid 파라미터 필수 아님

device_name

String

디바이스 모델 타게팅

  • 콤마(,)로 구분된 디바이스 모델명

  • OR 조건

  • ex) SHV-E250S,SHV-E275K,SM-G928LSHV-E250S 또는 SHV-E275K 또는 SM-G928L 인 유저에게 타게팅

target_app

String

앱 타게팅 (안드로이드만 지원)

  • 콤마(,)로 구분된 패키지 네임으로, 해당 앱이 설치된 유저에게 타게팅

  • 패키지 네임 앞에 ‘-’ 기호가 있는 경우 설치되지 않은 유저에게 타게팅

  • OR 조건

  • ex1) Pl.idreams.skyforcehd,com.imangi.templerun2Pl.idreams.skyforcehd 또는 com.imangi.templerun2 가 설치된 유저에게 타게팅

  • ex2) com.thinkreals.couponmoa,-com.supercell.clashofclanscom.thinkreals.couponmoa가 설치되어 있거나 com.supercell.clashofclans가 설치되어 있지 않은 유저에게 타게팅

region

String

지역 타게팅

  • 콤마로 구분된 지역: 도/시 단위로 타게팅 가능

  • OR 조건

  • ex) 서울특별시 강남구,경상남도 → 서울특별시 강남구 또는 경상남도에 거주중인 유저에게 타게팅

creative

list

creative 목록

  • 자세한 아이템은 아래 'creative 세부 항목' 표 참고

...

Expand
title가이드 변경 이력

버전

변경일자

변경내용

담당자

  1. 0

2014/11/03

서주은

  1. 1

2014/11/10

list api, complete api 추가

서주은

  1. 2

2014/11/13

list api 응답에 platform, age_from, age_to, sex, relationship, carrier 필드 추가

서주은

  1. 3

2014/12/29

buzzad.io 로 도메인 변경

서주은

  1. 4

2015/03/17

앱 설치 트래킹 부록 추가

서주은

  1. 5

2015/03/23

custom parameter max-length 명시

서주은

  1. 6

2015/04/06

list api에 udid_required 응답 추가

서주은

  1. 7

2015/04/09

list api에 revenue_type 설명 수정

서주은

  1. 8

2015/06/11

API endpoint http → https로 변경

participate/complete api에 udid 파라미터 추가

서주은

  1. 9

2015/07/09

리워드 적립 postback에 transaction_id 파라미터 추가

서주은

  1. 10

2015/11/30

에러코드 추가

서주은

  1. 11

2016/03/18

list api에 device_name, target_app, region 추가

서주은

  1. 12

2016/11/11

광고 참여 요청 API에 파라미터 추가

  • udid

  • android_id

  • udid_sha256

  • android_id_sha256

  • user_id

  • sub_publisher_id

  • sub_publisher_user_id

서주은

  1. 13

2016/11/30

광고 참여 요청 API 파라미터 변경 및 추가

  • udid_sha256 → udid_sha1

  • android_id_sha256 → android_id_sha1

  • device_name

  • carrier

  • google_account_sha1

서주은

  1. 14

2016/11/30

API 주소 변경

api.buzzad.ioad.buzzvil.com

서주은

  1. 15

2016/12/01

Google account 가져오기 예제 추가

서주은

  1. 16

2017/02/07

cpy 유튜브 시청 → 동영상 시청

서주은

  1. 17

2018/05/16

FAQ #1 추가

윤진

  1. 18

2018/07/11

“3. 부록의 (1) 처리 결과 코드” 에 9004 에러 추가

윤진

  1. 19

2019/01/04

“2-(1) 광고 목록 조회” 하단에 “타게팅 값이 있는 광고를 받는 절차” 설명 추가

윤진

1. 20

2020/05/26

  • 광고목록 조회 - Response Fields - ads - Creative 추가

    • 기존에 가이드 문서에 명시되지 않았던 부분 추가

  • 광고목록 조회 - Response Fields - ads - revenue_type 수정

    • CPY = 동영상 광고 → 삭제
      CPS = 유튜브 광고 → 결제형 광고로 수정
      CPYOUTUBE → 유튜브 광고

공지연

1.21

2020/08/18

CPS = 결제형 광고 → 쇼핑 적립형 광고 로 수정

공지연

1.22

2020/10/13

IDFA 트래킹 허용 받지 못한 경우 가이드 추가

이태규

1.22

2021/11/03

age_ranges targeting 추가

서주은