Web

개요

피드 광고 데이터를 조회해 직접 UI를 구성하여 광고를 송출합니다.

설치

Android Native SDK

override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    setContentView(R.layout.activity_main)
    val webView = findViewById<WebView>(R.id.wvWebView)

    // Web SDK 연동하는 WebView 설정
    webView.settings.apply {
        javaScriptEnabled = true // 자바스크립트 활성화
        domStorageEnabled = true // DOM 스토리지 활성화
    }
    
    // JavaScript Interface 추가
    webView.addJavascriptInterface(
        SPCWebView.SPCWebBridge(context = context, webView = webView),
        SPCWebView.WEB_VIEW_BRIDGE
    )
}
  • WebVieiw 내 Javascript 및 Local storage 활성화

  • Javascript Interface 설정

    • addJavascriptInterface 함수를 이용해 AvatyeWebBridge를 설정합니다.

  • 이후에는 Web SDK 를 확인해 웹 페이지 내에 배너를 지정하여 광고를 송출할 준비를 진행합니다.

iOS Native SDK

  • AvatyeWebSDKController에 rootWebView 객체를 설정 후 생성해줍니다.

  • AvatyeWebSDKController를 생성 후, “AvatyeBridge_SPC” 이름으로 scriptMessageHandler를 등록해줍니다.

  • 기본브라우저에서 랜딩을 처리할 수 있도록 Delegate를 구현합니다.

  • 이후에는 Web SDK 를 확인해 웹 페이지 내에 배너를 지정하여 광고를 송출할 준비를 진행합니다.

Web SDK

  • script 태그를 <body> 태그 내부의 하단에 추가합니다.

  • 대역별로 파일명이 구분됩니다.

    • 상용: pointhome-1.0.5.min.js

    • 테스트: pointhome-1.0.5-test.min.js

피드 광고

Function

Parameter

Require

Description

init() : 세팅 초기화

uniqueID(String)

O

유저 식별자

gender(String)

X

성별 (남자: M, 여자: F)

birthDate(String)

X

출생년도 '1990'

get() : 피드 광고 조회

placementID(String)

O

지면 ID

클릭하고 적립 AOS: d18ab1bc-04a4-4035-b99e-20ee229e5bfb iOS: 743e0a42-0085-4067-bf2c-7e1b2c7765ba

미션하고 적립 AOS: 7a44889f-83e4-478f-9ea2-1843a772623c iOS: 877f2890-9022-45a2-a7a0-768032f6cbbb

targetFill(Number)

X

불러올 광고 갯수

cursor(String)

X

요청할 광고에서 제외할 광고 데이터

impression() : 매출 정산용

impression_urls (String[])

O

광고 하나 당 n개의 impression_urls가 포함되어 있는데 참여 전에 모든 url을 impression 해야 함

  • Response Data의 자세한 타입은 링크을 참조해 주세요.

연동 시 주의사항

impression_urls

items Modelimpression_urls (method: GET)

광고 노출여부를 확인하기 위한 URL입니다.

매 광고마다 광고가 노출되었을 때, 해당 필드에 포함된 URL을 모두 호출해주세요.

호출되지 않을 경우 광고 매출정산이 맞지 않을 수 있습니다.

click_url

creative Modelclick_url

광고 참여 URL입니다.

사용자가 광고를 클릭하는 경우, 해당 URL로 이동시켜주세요.

Error

code

status

message

Description

init_required

-

필수 값이 세팅되지 않았습니다.

init()을 호출하지 않은 경우 발생

required_adid_agree

-

광고 ID 수집 동의가 필요합니다.

기기 설정에 광고ID를 받아오지 않게끔 설정되어 있는 경우

request_adid_failed

-

광고 ID를 가져오는데 실패했습니다.

브릿지 통신에 실패한 경우

invalid_parameter

400

${parameter} is not defined.

필요한 파라미터를 받아오지 못한 경우(SDK 에러)

UNAUTHORIZED

401

인증 정보를 찾을 수 없습니다.\n인증이 필요합니다.

인증에 실패한 경우 발생하며, 자주 발생 시엔 문의 필요

INVALIDPARAMETER

499

입력값이 잘못되었습니다

필요한 파라미터를 받아오지 못한 경우(서버 에러)

err_fail_feed_server_error

499

광고 서버의 응답이 지연되고 있습니다.\n잠시 후 다시 시도해주세요.

광고 서버에서 예기치못한 에러가 발생

err_cannot_get_feed

499

광고를 불러올 수 없습니다.

광고를 조회할 수 없는 경우 (광고 소진 등..)

Exception

-

-

네트워크 연결 불가능 또는 분류되지 않은 에러 발생 시


Pointhome Interface [@types/Pointhome.d.ts]

Last updated