adjust-icon

서버 간(S2S) 광고 매출

광고 매출을 직접 기록하는 경우 해당 데이터를 서버 간(S2S) 공유하여, Adjust가 측정하는 기타 지표와 함께 확인할 수 있습니다. 이를 통해 캠페인 퍼포먼스의 전반적인 개요 확인, 사용자 생애 가치(LTV) 계산, 캠페인의 ROAS 또는 ROI 최적화가 가능합니다.

Adjust의 서버 간(S2S) 광고 매출 데이터 전송을 통해 Adjust의 대시보드 리포트와 코호트에서 함께 확인해보시기 바랍니다.

엔드포인트
https://s2s.adjust.com/ad_revenue

시작에 앞서

시작하기 전에 알아야 할 사항은 다음과 같습니다:

  • 서버 간 전송된 광고 매출은 LTV와 ROAS를 위해 광고 매출 KPI와 코호트 계산에 추가됩니다.

가용성

  • 광고 매출 패키지

S2S 광고 매출 전송

/ad_revenue 엔드포인트는 다음의 S2S 광고 매출 요청을 허용합니다.

  • URL 파라미터를 포함한 GET 방식 요청
  • URL 파라미터를 포함한 POST 방식 요청(본문 제외)
  • Body 파라미터가 Content-Type인 POST application/x-www-form-urlencoded

S2S 보안 설정

S2S 보안을 설정하여 서버 간 광고 매출의 보안을 보장하고, 스푸핑 요청을 방지할 수 있습니다. 이를 위해서는 수신되는 모든 요청에 Adjust 대시보드에서 생성된 토큰이 포함되어야 합니다. 토큰이 포함되어 있지 않거나 올바르지 않은 토큰을 포함한 요청은 Adjust 서버에서 거부됩니다. 설정을 하려면 S2S 보안 페이지에 명시된 단계를 수행하시기 바랍니다.

필수 파라미터

Adjust에 광고 매출을 전송하려면 다음 파라미터를 전달해야 합니다.

파라미터설명예시
idfa; gps_adid플랫폼 의존 기기 ID. 전체 목록 보기
  • idfa=D2CADB5F-410F-4963-AC0C-2A78534BDF1E
  • gps_adid=660e1d86-6796-463a-be86-897993136018
app_token대시보드의 Adjust 앱 토큰app_token=4w565xzmb54d
s2sS2S 파라미터 값을 1로 설정하시기 바랍니다.1
revenue 또는 amount해당 기기에 의한 광고 매출액4.99
currency매출 통화 이벤트 요청이 값이 추가된 {revenue} 또는 {amount} 파라미터를 포함하는 경우 {currency}도 전송해야 합니다.
해당 파라미터가 없다면 Adjust가 해당 요청을 거부합니다.
USD
ad_impressions_count해당 매출과 연관된 노출 수100
source항상 publisher.publisher

다음 파라미터는 권장 사항 이며 필수는 아닙니다.

파라미터설명예시
adidAdjust 기기 ID(모든 플랫폼)18546f6171f67e29d1cb983322ad1329
created_at_unix (권장) 또는 created_at광고 노출이 사용자에게 게시된 정확한 시간(28일 이후이면 안 됨)created_at_unix=1484085154 created_at=2017-01-02T15:04:05.000+0000
environment현 SDK 환경 설정production 또는 sandbox.
파라미터설명예시
callback_params콜백 파라미터를 JSON 객체로서 전달하기 위해 사용
( 이스케이프 처리된 string:string 쌍 형식)
callback_params=%7B%22f0o%22%3A%22bar%22%2C%20%22bar%22%3A%22baz%22%7D
ad_revenue_network광고 매출에 대한 추가 정보ad_revenue_network=Admob
ad_revenue_unit광고 매출에 대한 추가 정보ad_revenue_unit=rewarded_video
ad_revenue_placement광고 매출에 대한 추가 정보ad_revenue_placement=home_screen

예:

Terminal window
curl -X POST \
-H "Authorization: Bearer b9eb9d6228842aeb05d64f30d56b361e" \
"https://s2s.adjust.com/ad_revenue?app_token=abc123abc123&idfa=FAD135C7-C5F8-4DCC-9478-2203956B0870&source=publisher&ad_impressions_count=1&revenue=0.01&currency=USD&s2s=1"