사용자 수준 수익 API

1. 개요

탭조이는 이제 퍼블리셔가 기존 오퍼월 데이터 콜백 외에도 자신의 오퍼월 사용자 수준 광고 수익 데이터를 액세스할 수 있도록 사용자 수준 광고 수익 API 제공합니다. 이 API를 사용하면 Amazon Web Services(AWS) S3에 저장된 CSV 파일을 통해 모바일 측정 파트너(MMP) 또는 퍼블리셔가 직접 사용자 수준 광고 수익 보고서를 사용할 수 있습니다.

API를 요청 하기 위해서는 해당 탭조이 앱ID(탭조이 LTV 대시보드 > 앱설정에서 확인 가능)와 데이터를 원하는 날짜가 필요합니다.

API를 사용하려면 MMP 또는 퍼블리셔 파트너의 마케팅 API 키로 탭조이 OAuth 엔드포인트에 액세스 토큰을 요청해야 합니다. 이후 사용자는 액세스 토큰을 사용하여 탭조이 리포트 API에 요청하여 AWS S3의 준비된 보고서 링크 URL을 수신합니다. 사전 서명된 URL은 검색 후 5분 동안 보고서에 대한 액세스를 허용합니다. 마지막으로 AWS S3의 보고서 URL에 대한 요청은 사용자 수준 광고 수익 데이터가 포함된 CSV 보고서를 반환합니다.

2. 리포트 API

엔드포인트

https://api.tapjoy.com/api/client/publisher/apps/<app_id>/user_revenue_report

마케팅 API 키로 OAuth를 통해 액세스할 수 있습니다. 필수 파라미터:

• Publisher app ID
• Date in UTC

허용되는 날짜 형식은 mm/dd, mm/dd/yyyy, mm/dd/yy, dd-mm yyyy-mm-dd, yy-mm-dd입니다. 5분 동안 유효한 사전 서명된 인증 토큰과 함께 보고서 파일에 대한 URL 배열을 반환합니다.

요청 예시

GET api/client/publisher/apps/<publisher_app_id>/user_revenue_report?date=<date> 
Host: api.tapjoy.com 
Authorization: Bearer <access_token_string> 
Accept: application/json

응답 예시

성공

{
	"urls": [
	"https://tapjoy.amazon.s3.com/data/report.csv.gz&key=secure"
  	  ]
}

실폐

status 404 
{ 
	“reason”: “No publisher app with id <publisher_app_id> found.” 
}

3. S3 API

데이터 SLA - 01:00 UTC 기준 x+1일까지 준비될 x일의 데이터

보존 SLA - 보고서는 14일(x일 + 15일) 동안 사용할 수 있습니다.

사용자 수준 수익 보고서의 CSV 파일을 반환합니다.

요청 예시

GET /data/report.csv.gz&key=secure
Host: tapjoy.amazon.s3.com 
Accept: application/json

응답 예시

성공

status 200 
{ 
	CSV File
}

실폐

status 401 
{ 
	“error”: “Unauthorized” 
}

status 404 
{ 
	“error”: “Not Found” 
}

5. FAQ

이 보고서에 동영상 수익이 포함되어 있습니까?

아니요, 이 보고서에는 오퍼월 광고 수익만 포함됩니다. 비디오에 대한 사용자 수준 광고 수익 데이터가 필요한 경우 다른 API 또는 미디에이터에게 문의해야 합니다.

최대 조회 기간은?

퍼블리셔 파트너는 14일기간의 리포트를 액세스할 수 있으며 매일 오전 1:00(UTC)에 전날 보고서를 사용할 수 있습니다.

일부 사용자 수준 항목의 노출 열에는 0값이 있지만 수익에는 0이 아닌 값이 있는 이유는 무엇입니까?

MR-CPE 제품의 경우 광고 노출 시점과 컨버전 이벤트가 발생하는 시점 사이에 종종 지연(일 또는 몇 주)이 있습니다.

수익 금액은 어떤 통화로 표시됩니까?

미국 달러(USD)로 표시됩니다.

이 API를 지원하는 MMP는?

Appsflyer.

publisher_user_id 와 geoip_country 칼럼에서 여러개의 결과가 조회되는 이유는 무엇인가요?

사용자가 앱에서 다른 publisher_user_id 혹은 geoip_countries 로 오퍼에 참여하는 것은 가능합니다. 이 ID 는 SDK init 시 퍼블리셔에서 설정하는 것으로 다음과 같은 상황에서 발생할 수 있습니다.

1. 사용자가 publisher_user_id A 로 접속.
2. 사용자가 오퍼 A 를 확인함. publisher_user_id A 로 오퍼 노출이 기록됨.
3. 이후 사용자가 publisher_user_id B 로 접속
4. 사용자가 다시 오퍼 A 를 확인함. publisher_user_id B 로 오퍼 노출이 기록됨.
5. 사용자가 오퍼 참여를 완료함. publisher_user_id B 로 오퍼 참여에 완료한 것으로 기록됨.

동일한 현상이 geoip_countries 에 대해서도 발생할 수 있습니다. 수익이 과장되지 않기 위해서는 이러한 값을 하나의 행으로 결합해야 합니다.