adjust-icon

피벗 리포트 엔드포인트

피벗 리포트 서비스는 KPI 서비스 지표, KPI 서비스 코호트, SKAdNetwork, 광고 비용과 같은 여러 소스로부터 집계된 데이터 확인을 위해 API를 제공합니다.

리포트 엔드포인트는 여러 서비스로부터의 데이터를 한 리포트에 병합할 수 있도록 해줍니다. 이를 통해 특정 설치수, 매출, 광고 비용과 SKAdNetwork 포스트백을 날짜, 앱, 광고 네트워크별로 분류하여 요청할 수 있습니다.

피봇 보고서 불러오기

엔드포인트
GET https://automate.adjust.com/reports-service/pivot_report

GET 메서드는 리포트 서비스로부터의 필터링된 데이터를 JSON 형식으로 반환합니다.

필터

항목

’항목’을 통해 1개 또는 여러 개의 파라미터를 사용하여 지표를 그룹화할 수 있습니다. 예: 일간, 국가/네트워크별 설치 수.

지표

Adjust를 통해 진행하고 측정하는 캠페인의 퍼포먼스를 평가 및 비교하기 위해 지표가 사용됩니다.

개별 API 요청에는 최소 1개의 지표가 필요합니다. 가장 널리 사용되는 지표는 다음과 같습니다.

  • installs
  • clicks
  • impressions

전체 지표 목록은 Datascape 지표 용어집을 참고하시기 바랍니다.

응답 형식

응답 형식
{
   "rows": [
      {
         "attr_dependency": {},
         "app": "App Name",
         "partner_name": "AppLovin",
         "campaign": "Campaign Name (Campaign ID)",
         "campaign_id_network": "Campaign ID",
         "campaign_network": "Campaign Name",
         "installs": "64",
         "cost": "1000"
      }
   ],
   "totals": {
      "installs": 64,
      "cost": 1000
   },
   "warnings": [],
   "totals_per_dimension": {}
}

응답 코드

본 엔드포인트는 다음의 응답을 반환합니다.

예시

cURL
$ curl \
--header 'Authorization: Bearer <adjust_api_token>' \
-L -X GET 'https://automate.adjust.com/reports-service/pivot_report?cost_mode=network&app_token__in={app_token1},{app_token2}&date_period=2021-05-01:2021-05-02&dimensions=app,partner_name,campaign,campaign_id_network,campaign_network&metrics=installs,network_installs,network_cost,network_ecpi&index=app' \
성공적인 응답
{
   "rows": [
      {
         "Test App": {
            "rows": [
               {
                  "attr_dependency": {
                     "app_network": ["google_play:com.test.app"]
                  },
                  "campaign_id_network": "123",
                  "campaign_network": "Campaign Name",
                  "campaign": "Campaign Name (123)",
                  "partner_name": "MyPartner",
                  "installs": 10,
                  "network_installs": 0,
                  "network_cost": 0,
                  "network_ecpi": 0
               }
            ]
         }
      }
   ],
   "totals": {
      "installs": 10,
      "network_installs": 0,
      "network_cost": 0,
      "network_ecpi": 0
   },
   "totals_per_dimension": {
      "campaign_id_network": {
         "Organic": {
            "installs": 10,
            "network_installs": 0,
            "network_cost": 0,
            "network_ecpi": 0
         }
      },
      "campaign_network": {
         "Organic": {
            "installs": 10,
            "network_installs": 0,
            "network_cost": 0,
            "network_ecpi": 0
         }
      },
      "app": {
         "adjust Demo App": {
            "installs": 10,
            "network_installs": 0,
            "network_cost": 0,
            "network_ecpi": 0
         }
      },
      "campaign": {
         "Organic": {
            "installs": 10,
            "network_installs": 0,
            "network_cost": 0,
            "network_ecpi": 0
         }
      },
      "partner_name": {
         "Organic": {
            "installs": 10,
            "network_installs": 0,
            "network_cost": 0,
            "network_ecpi": 0
         }
      }
   }
}