Page Comparison

필드	유형	설명
`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 여부

...

Code Block

language	json

{
  ...
  "extra": {
    "custom": {"YOUR_KEY": "YOUR_VALUE"}
  },
  ...
}

FAQ

Expand

title	퍼블리셔 노출형 광고 S2S API 에 작성되어 있는 API 는 list 로 반환하고 있는데, 저희는 하나의 광고만을 받고 싶은 API 가 필요합니다(ads X / ad O). 혹 다른 방법이 있을까요?

퍼블리셔 노출형 광고 S2S API는 광고 할당 수를 조정하는 size() 설정 방법이 존재하지 않습니다. 다만, 버즈빌 담당자에게 요청해주시기 바랍니다. 버즈빌 어드민에서 Unit 별 targetfill을 설정하여 광고 할당 수를 조정할 수 있습니다.

Expand

title	impression_urls 메커니즘이 궁금합니다.

광고가 보이는 시점에 impression_urls을 호출합니다. 원칙적으로 광고 id 당 하나의 impression_urls가 반환됩니다. Impression_urls에는 Unit id, User ID, 그 외 포인트 적립에 필요한 parameters가 포함되어 있습니다. 따라서 impression_urls를 호출해주시면 유저가 어느 지면에서 어떤 광고에 참여했는지 등이 버즈빌 서버로 전달됩니다. (별도 파라미터를 추가하여 호출할 필요가 없습니다)

Expand

title	광고 당 n 개가 반환 되는 것으로 보입니다. 전부 요청하면 되는 걸까요?

응답 중 impression_urls key로 반환되는 값의 타입은 string list 인 것이 맞습니다. 다만 대부분 list의 길이가 1입니다. 반대로 말씀드리면 항상 1인 것은 아니라서, 해당 list 내의 모든 url을 호출해주시는 방식으로 구현을 부탁드립니다.

Expand

title	노출형 광고 S2S API 에서 Click API 호출 방식 은 a tag 의 href 를 이용하면 될까요?

click_url은 사용자가 해당 주소로 이동하는데 그 목적이 있습니다. 따라서 HTML에서 a tag의 href를 사용해도 되고, javascript에서 location.href를 사용해도 됩니다. 현재 click_url의 구체적 호출 방법에 대해 별도 제약 사항은 없습니다. HTTP Request method 중 GET 방식으로만 호출해주시면 됩니다.
click_url 에도 유저의 광고 참여 정보가 담겨 암호화된 상태입니다. 반환 url 전체를 유저가 클릭하는 시점에 호출해주시면 됩니다.

가이드 변경 이력

Expand

title	가이드 변경 이력

Editor	Date	Note
Kaila	20.10.21	1.0
Kaila	20.11.10	1.1 url 수정, types
Kaila	20.11.25	1.1.1 response field 에서 type 수정
George	21.07.02	2.0 리뉴얼
George	21.11.22	3.0 리뉴얼
Olivia	21.01.04	3.1 4) Custom parameter 추가
Jua	22.02.03	3.2 수정 `click_urls`→ `click_url` 삭제 노출형 S2S API에 부적합 사용자가 액션형 광고에 정상적으로 참여했는지 확인하려면 `conversion_check_url`로 전달한 URL을 호출하세요. `true`: 사용자의 광고 참여가 정상적으로 완료되었습니다. `false`: 사용자가 광고 참여를 완료하지 않았거나 광고 참여에 실패했습니다.

Versions Compared

Old Version 18

New Version 19

Key

목차

FAQ

가이드 변경 이력