전면형/보상형 광고 sdk 호출하는 흐름이 궁금합니다

개발
,
1

이 글의 성격은 무엇인가요?

질문 / 문제 해결

내용을 설명해주세요

안녕하세요, 앱인토스 광고 리워드 및 포인트 지급 구조에 대해 질문드립니다.

보상형 광고 시청 완료 시 showFullScreenAd의 onEvent에서 userEarnedReward 이벤트를 수신하는 구조로 이해했고, 실제 리워드 종류/수량은 콘솔에서 등록한 값으로 결정되는 것으로 파악했습니다.

질문 1. 보상형 광고 리워드 지급 — 클라이언트 이벤트 기반 외에 방법이 있는지

문서에서는 showFullSreenAdd의 onEvent의 이벤트명에 따라 리워드가 지급 가능한 구조인 것으로 보입니다.
그리고 리워드 지급은 콘솔에서 등록한 것으로 지급이 되는 구조로 보여요.

자체서버를 통해 토스 api로 주는 구조가 아니라,
클라이언트 이벤트를 믿고 보내는 리워드 지급하는 방법밖에 없는지 궁금합니다.

질문 2. 앱 내 재화 → 토스 포인트 전환 구조

  • 보상형 광고 시청 완료 → 앱 내 재화 지급 (클라이언트 이벤트 기반)
  • 앱 내 재화 → 토스 포인트 전환 시 → /api-partner/v1/apps-in-toss/promotion/execute-promotion API 호출

이때 프로모션 지급 API는 자체 서버 ↔ 토스 서버 간 서버-투-서버 통신으로 처리하는 구조가 맞는지 확인 부탁드립니다.

2

안녕하세요 :slight_smile:

  1. 현재는 showFullSreenAd 호출시 클라이언트측에 내려드린 이벤트를 기준으로 직접 보상 지급하는 방법이 유일해요
  2. 프로모션 지급은 서버를 통한 지급 방식,서버 없이 지급하는 방식 두가지 방식을 지원하고 있어요. 관련 가이드를 전달드려요.
1개의 좋아요
4

보상형 광고 리워드 저장 구조에 대해 한가지 더 질문드립니다.

showFullScreenAd의 userEarnedReward 이벤트 예제에서 grantReward라는 임의의 함수로 리워드 지급을 처리하고 있는데요.

저희는 토스 API(/api-partner/v1/apps-in-toss/user/oauth2/login-me 등)에서 사용자의 현재 리워드 잔액을 확인할 수 있는 방법을 찾지 못했습니다.

이런 경우, userEarnedReward 이벤트 수신 시 자체 서버 API를 호출하여 리워드를 적립/저장하는 구조가 맞는 건가요?
즉, 예제의 grantReward 함수가 실제로는 자체 서버에 리워드를 업데이트하는 API 호출로 구현되어야 하는 것인지 확인 부탁드립니다.

showFullScreenAd는 광고 노출/시청 이벤트를 파트너사가 감지하고 후속 처리를 할 수 있도록 토스가 제공하는 API라고 이해하면 될까요?

5

사용자의 현재 리워드 잔액을 확인하시려는 이유를 알 수 있을까요 ?
광고보고 프로모션 포인트 받기를 구현중이신거라면, 광고 이후 자체 서버를 호출하여 포인트를 적립해주시는게 맞습니다.
(서버 없이 지급하는 방법도 있습니다.)

showFullScreenAd 는 광고를 보여주는 API로, 광고 노출 / 시청 이벤트를 콜백으로 내려주는 함수가 맞습니다.

6

showFullScreenAd의 리워드로 앱 내 재화를 지급하고, 추후 앱 내 재화를 토스 포인트로 전환하는 기능을 구현하려고 합니다.

그 과정에서 userEarnedReward로 지급된 리워드 잔액을 토스 측에서 확인할 수 있는 API가 있는지, 아니면 파트너사 자체 서버에서 직접 관리해야 하는지가 궁금했습니다.

토스 로그인 기반으로 자체 서버를 구축할 예정입니다.

7

지급된 잔액을 조회하는 기능은 제공하고 있지 않습니다 :cry:
필요하시다면 파트너사 자체 서버에서 관리가 필요합니다.

8

빠른 답변 감사합니다!