업그레이드

1. 인사이트 API 업그레이드

인사이트 API 는 REST API로 이를 통해 오퍼와 관련된 리포트를 받을 수 있습니다. 인사이트 API 를 업그레이드 하기 위해서는 기존의 엔드포인트 https://api.tapjoy.com/v1/ad_groups/<id>/insights 애서 https://api.tapjoy.com/graphql 로 교체해야 합니다. 인증관련 프로세스는 기존과 동일합니다.

id 필드 변경사항

기존에 사용하였던 id 필드는 인사이트 API를 통해 주 / 보조 오퍼를 트랙킹하기 위한 용도로 사용되었습니다. 마케팅 API 에서는 주 / 보조 오퍼가 하나의 AdSet 으로 통합되었습니다. 이제 오퍼 id 를 통해 AdSet 데이터를 받을 수 있습니다.

아래의 예시의 경우 인사이트 API 의 id 가 마케팅 API 에서는 어떻게 변화하는지 보여줍니다.

Insights API

Marketing API

GET /v1/ad_groups/00000000-0000-0000-0000-000000000000/insights
Host: api.tapjoy.com
Authorization: Bearer <OAuth Token>

측정 항목의 변화

이제 주 / 보조 트랙킹 오퍼가 하나의 AdSet 으로 통합됨에 따라, 마케팅 API 에서 제공되는 측정 항목들은 컨버전 펀넬을 보여줄 수 있도록 디자인되었습니다.

아래 예시는 인사이트 API 의 요청 / 응답 내용입니다.

Request

Response

GET /v1/ad_groups/00000000-0000-0000-0000-000000000000/insights?start_time=2018-03-06T00:00:00Z&end_time=2018-03-07T00:00:00Z&time_increment=daily
Host: api.tapjoy.com
Authorization: Bearer <OAuth Token>

...위 항목을 마케팅 API 를 통해 요청 / 응답 은 아래와 같습니다.

Query

Marketing API

query {
  adSet(id: "00000000-0000-0000-0000-000000000000") {
    insights(timeRange: {from: "2018-03-06T00:00:00Z", until: "2018-03-07T00:00:00Z", timeIncrement: DAILY}) {
      timestamps
      reports {
        country
        impressions
        mediaP100WatchedActions
        callToActionClicks
        conversions
        spend
      }
    }
  }
}

보시다시피, 전체 전환 퍼널을 보시고자 하신다면 레거시 Insights API에서 보조 오퍼에 대한 데이터를 요청해야 했습니다. 마케팅 API에서는 모든 측정항목이 AdSet 과 통합되었습니다. 아래의 항목은 기존 항목이 어떻게 표현되는지 보여줍니다.

Marketing API	Insights API
Impressions	global_renders / paid_clicks (Primary)
Media P100 Watched Actions	global_conversions (Primary), global_renders / paid_clicks (Secondary)
Call-to-action Clicks	n/a
Conversions	global_conversions (Secondary)
Spend	installs_spend (Primary / Secondary)

업그레이드
1. 인사이트 API 업그레이드

업그레이드

1. 인사이트 API 업그레이드

id 필드 변경사항

측정 항목의 변화

Contents