Data

채널 별 연동된 데이터 정보(통계) 조회

연동 된 데이터의 계정 정보 조회

GET https://rest.indavit.com/data/adAccount

네이버 검색 광고의 경우 권한을 부여 받은 광고 계정의 정보 조회는 추후 지원 예정입니다.

Query Parameters

Name	Type	Description
id*	String	데이터 ID
end*	String	조회 종료일 [YYYY-MM-DD]
start*	String	조회 시작일 [YYYY-MM-DD]
value*	String	켐패인 ID

200: OK 조회 성공

{
  date: string /* 날짜 */
  data:
      {
        <META>
          [
            date: string /* 날짜 */
            total: DataObject
            age: [age: string /* 나이 */, DataObject]
            gender: [gender: string /* 성별 */, DataObject]
            country: [country: string /* 국가 */, DataObject]
            region: [region: string /* 지역 */, DataObject]
            device: [device: string /* 장비 */, DataObject]
            hour: [hour: string /* 시간 */, DataObject]
          ]
        <NAVER_SEARCH_AD>
          [
            date: string /* 날짜 */
            total: DataObject
            age: [age: string /* 나이 */, DataObject]
            gender: [gender: string /* 성별 */, DataObject]
            keyword: [keyword: string /* 국가 */, DataObject]
            region: [region: string /* 지역 */, DataObject]
            device: [device: string /* 장비 */, DataObject]
            hour: [hour: string /* 시간 */, DataObject]
          ]
        <GOOGLE_ADS>
          [
            date: string /* 날짜 */
            total: DataObject
            age: [age: string /* 나이 */, DataObject]
            gender: [gender: string /* 성별 */, DataObject]
            device: [device: string /* 장비 */, DataObject]
            region: [region: string /* 지역 */, DataObject]
            hour: [hour: string /* 시간 */, DataObject]
            keyword: [keyword: string /* 국가 */, DataObject]
          ]
        <KAKAO_KEYWORD>
          [
            date: string /* 날짜 */
            total: DataObject
            device: [device: string /* 장비 */, DataObject]
            hour: [hour: string /* 시간 */, DataObject]
            placement: [placement: string /* 위치 */, DataObject]
            keyword: [keyword: string /* 국가 */, DataObject]
          ]
        <KAKAO_MOMENT>
          [
            date: string /* 날짜 */
            total: DataObject
            device: [device: string /* 장비 */, DataObject]
            placement: [placement: string /* 위치 */, DataObject]
            age: [age: string /* 나이 */, DataObject]
            gender: [gender: string /* 성별 */, DataObject]
            region: [region: string /* 지역 */, DataObject]
            hour: [hour: string /* 시간 */, DataObject]
          ]
        <NAVER_DA>
          [
            date: string /* 날짜 */
            total: DataObject
            age: [age: string /* 나이 */, DataObject]
            gender: [gender: string /* 성별 */, DataObject]
            hour: [hour: string /* 시간 */, DataObject]
            devicePlatform: [devicePlatform: string /* 플랫폼 */, DataObject]
            publisherGroup: [publisherGroup: string /* 퍼블리셔 그룹 */, DataObject]
            placementGroup: [placementGroup: string /* 위치 그룹 */, DataObject]
          ]
      }
}

DataObject

{
      impressions: number /* 노출수 */
      clicks: number /* 노출수 */
      conversions: number /* 전환수 [null: 매체 지원 X] */
      amount: number /* 전환매출액 [null: 매체 지원 X] */
      spend: number /* 광고비 */
      reach: number /* 도달수 [null: 매체 지원 X] */
      ppc: number /* ppc [null: 매체 지원 X] */
      rimp: number /* 실노출수 [null: 매체 지원 X] */
      ctr: number /* ctr */
      cpc: number /* cpc */
      cpm: number /* cpm */
}

400: Bad Request 지원하지 않는 파라미터

401: Unauthorized Access Token 이 없거나 인증 실패

403: Forbidden 조회 한도 초과

422: Unprocessable Entity 필수 정보가 없거나 올바르지 않음

연동 된 데이터의 캠페인 정보 조회

GET https://rest.indavit.com/data/campaign

Query Parameters

Name	Type	Description
id*	String	데이터 ID
start*	String	조회 시작일 [YYYY-MM-DD]
end*	String	조회 종료일 [YYYY-MM-DD]
value*	String	켐패인 ID

200: OK 조회 성공

{
  date: string /* 날짜 */
  data:
      {
        <META>
          [
            date: string /* 날짜 */
            total: DataObject
            age: [age: string /* 나이 */, DataObject]
            gender: [gender: string /* 성별 */, DataObject]
            country: [country: string /* 국가 */, DataObject]
            region: [region: string /* 지역 */, DataObject]
            device: [device: string /* 장비 */, DataObject]
            hour: [hour: string /* 시간 */, DataObject]
          ]
        <NAVER_SEARCH_AD>
          [
            date: string /* 날짜 */
            total: DataObject
            age: [age: string /* 나이 */, DataObject]
            gender: [gender: string /* 성별 */, DataObject]
            keyword: [keyword: string /* 국가 */, DataObject]
            region: [region: string /* 지역 */, DataObject]
            device: [device: string /* 장비 */, DataObject]
            hour: [hour: string /* 시간 */, DataObject]
          ]
        <GOOGLE_ADS>
          [
            date: string /* 날짜 */
            total: DataObject
            age: [age: string /* 나이 */, DataObject]
            gender: [gender: string /* 성별 */, DataObject]
            device: [device: string /* 장비 */, DataObject]
            region: [region: string /* 지역 */, DataObject]
            hour: [hour: string /* 시간 */, DataObject]
            keyword: [keyword: string /* 국가 */, DataObject]
          ]
        <KAKAO_KEYWORD>
          [
            date: string /* 날짜 */
            total: DataObject
            device: [device: string /* 장비 */, DataObject]
            hour: [hour: string /* 시간 */, DataObject]
            placement: [placement: string /* 위치 */, DataObject]
            keyword: [keyword: string /* 국가 */, DataObject]
          ]
        <KAKAO_MOMENT>
          [
            date: string /* 날짜 */
            total: DataObject
            device: [device: string /* 장비 */, DataObject]
            placement: [placement: string /* 위치 */, DataObject]
            age: [age: string /* 나이 */, DataObject]
            gender: [gender: string /* 성별 */, DataObject]
            region: [region: string /* 지역 */, DataObject]
            hour: [hour: string /* 시간 */, DataObject]
          ]
        <NAVER_DA>
          [
            date: string /* 날짜 */
            total: DataObject
            age: [age: string /* 나이 */, DataObject]
            gender: [gender: string /* 성별 */, DataObject]
            hour: [hour: string /* 시간 */, DataObject]
            devicePlatform: [devicePlatform: string /* 플랫폼 */, DataObject]
            publisherGroup: [publisherGroup: string /* 퍼블리셔 그룹 */, DataObject]
            placementGroup: [placementGroup: string /* 위치 그룹 */, DataObject]
          ]
      }
}

DataObject

{
      impressions: number /* 노출수 */
      clicks: number /* 노출수 */
      conversions: number /* 전환수 [null: 매체 지원 X] */
      amount: number /* 전환매출액 [null: 매체 지원 X] */
      spend: number /* 광고비 */
      reach: number /* 도달수 [null: 매체 지원 X] */
      ppc: number /* ppc [null: 매체 지원 X] */
      rimp: number /* 실노출수 [null: 매체 지원 X] */
      ctr: number /* ctr */
      cpc: number /* cpc */
      cpm: number /* cpm */
}

400: Bad Request 지원하지 않는 파라미터

401: Unauthorized Access Token 이 없거나 인증 실패

403: Forbidden 조회 한도 초과

422: Unprocessable Entity 필수 정보가 없거나 올바르지 않음

연동 된 데이터의 그룹 정보 조회

GET https://rest.indavit.com/data/adGroup

Query Parameters

Name	Type	Description
id*	String	데이터 ID
start*	String	조회 시작일 [YYYY-MM-DD]
end*	String	조회 종료일 [YYYY-MM-DD]
value*	String	광고 그룹 ID

200: OK 조회 성공

{
    date: string /* 날짜 */
    data:
      {
        <META>
          [
            date: string /* 날짜 */
            total: DataObject
            age: [age: string /* 나이 */, DataObject]
            gender: [gender: string /* 성별 */, DataObject]
            country: [country: string /* 국가 */, DataObject]
            region: [region: string /* 지역 */, DataObject]
            device: [device: string /* 장비 */, DataObject]
            hour: [hour: string /* 시간 */, DataObject]
          ]
        <NAVER_SEARCH_AD>
          [
            date: string /* 날짜 */
            total: DataObject
            age: [age: string /* 나이 */, DataObject]
            gender: [gender: string /* 성별 */, DataObject]
            keyword: [keyword: string /* 국가 */, DataObject]
            region: [region: string /* 지역 */, DataObject]
            device: [device: string /* 장비 */, DataObject]
            hour: [hour: string /* 시간 */, DataObject]
          ]
        <GOOGLE_ADS>
          [
            date: string /* 날짜 */
            total: DataObject
            age: [age: string /* 나이 */, DataObject]
            gender: [gender: string /* 성별 */, DataObject]
            device: [device: string /* 장비 */, DataObject]
            region: [region: string /* 지역 */, DataObject]
            hour: [hour: string /* 시간 */, DataObject]
            keyword: [keyword: string /* 국가 */, DataObject]
          ]
        <KAKAO_KEYWORD>
          [
            date: string /* 날짜 */
            total: DataObject
            device: [device: string /* 장비 */, DataObject]
            hour: [hour: string /* 시간 */, DataObject]
            placement: [placement: string /* 위치 */, DataObject]
            keyword: [keyword: string /* 국가 */, DataObject]
          ]
        <KAKAO_MOMENT>
          [
            date: string /* 날짜 */
            total: DataObject
            device: [device: string /* 장비 */, DataObject]
            placement: [placement: string /* 위치 */, DataObject]
            age: [age: string /* 나이 */, DataObject]
            gender: [gender: string /* 성별 */, DataObject]
            region: [region: string /* 지역 */, DataObject]
            hour: [hour: string /* 시간 */, DataObject]
          ]
        <NAVER_DA>
          [
            date: string /* 날짜 */
            total: DataObject
            age: [age: string /* 나이 */, DataObject]
            gender: [gender: string /* 성별 */, DataObject]
            hour: [hour: string /* 시간 */, DataObject]
            devicePlatform: [devicePlatform: string /* 플랫폼 */, DataObject]
            publisherGroup: [publisherGroup: string /* 퍼블리셔 그룹 */, DataObject]
            placementGroup: [placementGroup: string /* 위치 그룹 */, DataObject]
          ]
      }
}

DataObject

{
      impressions: number /* 노출수 */
      clicks: number /* 노출수 */
      conversions: number /* 전환수 [null: 매체 지원 X] */
      amount: number /* 전환매출액 [null: 매체 지원 X] */
      spend: number /* 광고비 */
      reach: number /* 도달수 [null: 매체 지원 X] */
      ppc: number /* ppc [null: 매체 지원 X] */
      rimp: number /* 실노출수 [null: 매체 지원 X] */
      ctr: number /* ctr */
      cpc: number /* cpc */
      cpm: number /* cpm */
}

400: Bad Request 지원하지 않는 파라미터

401: Unauthorized Access Token 이 없거나 인증 실패

403: Forbidden 조회 한도 초과

422: Unprocessable Entity 필수 정보가 없거나 올바르지 않음

연동 된 각 채널의 데이터 정보 조회

GET https://rest.indavit.com/data/ads

Query Parameters

Name	Type	Description
id*	String	데이터 ID
start*	String	조회 시작일 [YYYY-MM-DD]
end*	String	조회 종료일 [YYYY-MM-DD]
value*	String	광고 ID

200: OK 조회 성공

{
    date: string /* 날짜 */
    data: DataObject
}

DataObject

{
      impressions: number /* 노출수 */
      clicks: number /* 노출수 */
      conversions: number /* 전환수 [null: 매체 지원 X] */
      amount: number /* 전환매출액 [null: 매체 지원 X] */
      spend: number /* 광고비 */
      reach: number /* 도달수 [null: 매체 지원 X] */
      ppc: number /* ppc [null: 매체 지원 X] */
      rimp: number /* 실노출수 [null: 매체 지원 X] */
      ctr: number /* ctr */
      cpc: number /* cpc */
      cpm: number /* cpm */
}

400: Bad Request 지원하지 않는 파라미터

401: Unauthorized Access Token 이 없거나 인증 실패

403: Forbidden 조회 한도 초과

422: Unprocessable Entity 필수 정보가 없거나 올바르지 않음

연동 된 네이버 블로그 정보 조회

GET https://rest.indavit.com/data/blog-naver

Query Parameters

Name	Type	Description
id*	String	데이터 ID
start*	String	조회 시작일 [YYYY-MM-DD]
end*	String	조회 종료일 [YYYY-MM-DD]

200: OK 조회 성공

{
  date: string /* 날짜 */
  data:
      {
        visit_pv_cnt: number /* 조회수 */
        uv_cnt: number /* 순방문자수 */
        visit_cnt: number /* 방문 횟수 */
        referer: /* 유입분석 */
          [
            title: string /* 제목 */
            percent: string /* 퍼센트 */
            detail: object /* 상세 */
              [
                title: string /* 제목 */
                percent: string /* 퍼센트 */
              ]
          ]
        rank_pv: /* 조회수 순위 */
          [
            rank: number /* 순위 */
            title: string /* 제목 */
            views: number /* 조회수 */
            type: string /* 게시물 타입 */
            date: string /* 작성일 */
          ]
        average_duration: number /* 평균 사용 시간 (초) */
        relation_dist: /* 이웃 방문 현황 */
          {
            both_way_neighborhood: number /* 서로 이웃 */
            one_way_neighborhood: number /* 피이웃 */
            other: number /* 기타 */
          }
      }
}

400: Bad Request 지원하지 않는 파라미터

401: Unauthorized Access Token 이 없거나 인증 실패

403: Forbidden 조회 한도 초과

422: Unprocessable Entity 필수 정보가 없거나 올바르지 않음