사용자 레벨 수익 API 알아보기
탭조이 오퍼월의 사용자 레벨 수익 API를 사용하여 사용자별 수익을 트래킹하고 실행 가능한 분석 정보에 따라 앱의 수익화 전략을 조정할 수 있습니다.
읽는 시간 1분최근 업데이트: 3일 전
탭조이를 사용하면 퍼블리셔가 기존의 오퍼 데이터 콜백 외에도 사용자 레벨 광고 수익 API를 통해 오퍼월 사용자 레벨 광고 수익 데이터에 액세스할 수 있습니다. 이 API는 사용자 레벨 광고 수익 리포트를 AWS(Amazon Web Services) S3에 저장된 CSV 파일을 통해 MMP(모바일 측정 파트너)나 퍼블리셔 파트너에게 직접 제공합니다. 요청을 생성하려면 사용자에게 관련 탭조이 앱 ID(탭조이 LTV 대시보드용 앱과 동일한 ID)와 데이터를 원하는 날짜가 있어야 합니다. API를 사용하려면 MMP나 파트너가 리포트 API나 마케팅 API 키를 사용하여 액세스 토큰을 수신하도록 탭조이 OAuth 엔드포인트에 요청해야 합니다. 액세스 토큰을 사용하면 사용자가 탭조이 리포트 API에 AWS S3의 리포트를 가리키는 사전 서명된 URL을 수신하도록 요청합니다. 사전 서명된 URL을 사용하면 검색 후 5분 동안 리포트에 액세스할 수 있습니다. 마지막으로 AWS S3에서 리포트 URL을 요청하면 사용자 레벨 광고 수익 데이터가 포함된 CSV 리포트가 반환됩니다.
리포트 API
엔드포인트:https://api.tapjoy.com/api/client/publisher/apps/<app_id>/user_revenue_report- 퍼블리셔 앱 ID
- UTC 기준 날짜
요청 예시
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
응답 예시
Success
{ "urls": [ "https://tapjoy.amazon.s3.com/data/report.csv.gz&key=secure" ]}
실패
status 404 { “reason”: “<publisher_app_id> ID가 포함된 퍼블리셔 앱을 찾을 수 없습니다.” }
S3 API
데이터 SLA - 01:00(UTC 기준)의 x+1일에 준비될 x일의 데이터 리텐션 SLA - 14일(x일 + 15일) 동안 리포트 제공 사용자 레벨 수익 리포트의 CSV 파일 반환요청 예시
GET /data/report.csv.gz&key=secureHost: tapjoy.amazon.s3.com Accept: application/json
응답 예시
Success
status 200 { CSV File}
필드 개요
다음 표는 리포트의 여러 열이 무엇을 의미하는지 자세히 설명합니다.필드 | 설명 |
|---|---|
| date_id 및 report_date | API 요청의 사용자별 리포트 날짜입니다. 해당 날짜를 기준으로 하는 리포트 지표 |
| partner_id | 탭조이 내부 식별자 |
| app_name, appkey | 앱의 이름과 탭조이 식별자 |
| IDFA/IDFV/GAID | 플랫폼에 따라 이 열에 식별자 값이나 UNKNOWN 값 포함 |
| device_os_version | 연관된 모바일 디바이스의 운영체제 버전 |
| att_status | 디바이스의 iOS 앱 트래킹 투명성 상태(알려진 경우) |
| publisher_user_id | 디바이스와 연관된 퍼블리셔 식별자(해당하는 경우) |
| ad_unit | 항상 오퍼월이며 MMP에서 처리하는 데 사용 |
| placement | 탭조이 플레이스먼트 이름 |
| content_card | 탭조이 콘텐츠 카드 이름 |
| geoip_country | IP 조회에서 사용 가능한 경우 디바이스와 연관된 국가 |
| currency_sale | 값이 1인 경우 연결된 전환이 발생했을 때 재화 세일이 진행 중이었거나, 세일이 발생한 경우 재화 멀티플라이어 값이 될 것임을 나타냄 |
| conversion_rate | 거래에 사용되는 재화 교환율 |
| impressions | 해당 날짜에 이 디바이스 ID와 연관된 누적 노출 수. 사용자가 전환한 당일, 전환된 오퍼를 본 횟수를 나타냄 |
| publisher_amount | 해당 날짜에 이 디바이스 ID와 연관된 누적 수익 |
FAQ
아니요, 이 리포트에는 오퍼월 광고 수익만 포함됩니다. 사용자 레벨 광고 수익 데이터를 원하는 경우 파트너는 해당 API나 리포트에 액세스하려면 관련 미디에이션 담당자에게 문의해야 합니다.
퍼블리셔 파트너는 14일 동안 리포트에 액세스할 수 있으며, 매일 오전 1시(UTC 기준)에 전날의 리포트를 사용할 수 있습니다.
멀티 리워드 CPE 광고 제품의 경우 노출이 표시되는 때와 이벤트 전환이 멀티 리워드 퍼널에서 나중에 발생하는 때 사이에 지연 시간이 종종 발생합니다.
미국 달러(USD)로 표시됩니다.
사용자가 다른 또는 를 사용하여 동일한 퍼블리셔 앱에서 오퍼를 보고 전환할 수 있습니다. 이 ID는 SDK 초기화 시 퍼블리셔가 설정하므로 다음과 같은 일이 발생할 수 있습니다.에도 동일한 일이 발생할 수 있습니다. 수익 인플레이션을 피하려면 이 값을 하나의 행으로 통합해야 합니다.
publisher_user_idsgeoip_countries- 사용자가 와 연결됩니다.
publisher_user_id A - A 오퍼를 확인합니다. 보기 기록에 가 있습니다.
publisher_user_id A - 사용자가 와 연결됩니다.
publisher_user_id B - 다시 A 오퍼를 확인합니다. 보기 기록에 가 있습니다.
publisher_user_id B - 전환합니다. 변환 기록에 가 있습니다.
publisher_user_id B
geoip_countries