circle-nodes전환 측정 API 연동

이 문서는 광고 전환 이벤트를 타 플랫폼과 S2S 방식으로 연동하기 위한 API 프로토콜 정의를 제공합니다.

circle-info

도메인 및 Token은 별도로 제공됩니다.

기본 정보

API 연동 정보

환경
URL
메서드

개발

별도 제공

POST

상용

별도 제공

POST

전환 이벤트

이벤트명
설명
발생 조건
필수

signup

회원가입

사용자가 계정을 생성한 경우

N

view

상품 조회

상품 상세 페이지에서 상품을 본 경우

Y

purchase

상품 구매

상품 결제까지 완료한 경우

Y

install

앱 설치

사용자가 앱스토어에서 앱을 다운로드하고 설치한 경우

N

open

앱 실행

설치 후 앱을 처음 실행한 경우

N

cart

장바구니 담기

상품 상세 페이지에서 ‘장바구니 담기’ 버튼 클릭 시

Y

like

상품 찜하기

상품 상세 페이지에서 ‘찜(하트)’ 버튼 클릭 시

N

cancel

주문 취소

상품 구매 후 해당 건을 취소한 경우

Y

요청

파라미터
설명
예시
필수

Authorization

전달받은 토큰을 헤더에 삽입

Authorization: Bearer {TOKEN}

Y

쿼리

파라미터
설명
예시
필수

sub_campaign

클릭시 플랫폼으로 전달한 값을 그대로 반환

splus2_tracking%5E1504%5E31778%5E805378%5E3%5E23191%5E11973%5E27169%5E27167%5E%5E%5E%5E%5E-%5E-%5E-1%5E-%5E14%5E1%5Esamsung%5E1%5ESM-G991N%5E778e5ef6-f063-4a37-87c2-61bd6b407112%5E0b6eeafc-47dc-4f7f-b3b4-ecc73f8b123d%241237396897%24ESFSVVWN%5E%5E%5E1%5E-%5Ecom.cjmezzomedia

Y

google_aid

GAID 디바이스 식별자

7c19df6e-81ba-45f0-bee9-719a2d95236

Y

ios_ifa

IDFA 디바이스 식별자

AEBE52E7-03EE-455A-B3C4-E57283966239

Y

language

사용자 기기 언어 설정

KO

N

os_version

사용자 기기의 OS 버전

15

N

device_carrier

사용자 기기의 통신사

SKTelecom

N

device_brand

사용자 기기의 제조사

samsung

N

device_model

사용자 기기의 모델명

SM-G991N

N

device_ip

사용자 기기의 IP 주소

127.0.0.1

N

country_code

사용자 국가 코드

KR

N

package_name

앱 패키지명

com.cjmezzomedia

Y

click_timestamp

클릭 발생 시각 (UTC)

1234567890

Y

event_name

전환 이벤트명

purchase

Y

event_timestamp

전환 발생 시각 (UTC)

1234567890

Y

item_info

상품 정보 (JSON body)

아래 상품 정보 참조

Y

currency

통화 단위

KRW

N

is_reattributed

기존 설치 사용자의 재유입 여부

0(false), 1(true)

N

is_reengagement

기존 사용자의 이벤트 재참여 여부

0(false), 1(true)

N

is_retargeting

리타겟팅 캠페인을 통한 전환 여부

0(false), 1(true)

N

google_ad_tracking

광고 추적 제한 여부 (Google)

0(false), 1(true)

N

ios_ad_tracking

광고 추적 제한 여부 (iOS)

0(false), 1(true)

N

conversion_user_agent

전환 발생 user agent

Mozilla/5.0 (Linux; Android 13; SM-G981B) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/134.0.0.0 Mobile Safari/537.36

N

본문

파라미터
설명
필수

item_info

상품 정보

상품과 관련된 이벤트 : 필수

( 구매, 장바구니, 상품보기, 취소 등 )

응답

코드
설명

200

SUCCESS

408

ERROR_TIMEOUT

501

ERROR_INVALID_TOKEN

502

ERROR_INVALID_PARAMETER

999

ERROR_SYSTEM

Last updated