Method: insights.retrieveInsights

지정된 대상의 마케팅 데이터 통계를 가져옵니다.

HTTP 요청

POST https://datamanager.googleapis.com/v1/insights:retrieveInsights

URL은 gRPC 트랜스코딩 구문을 사용합니다.

요청 본문

요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.

JSON 표현 
{
  "destination": {
    object (Destination)
  },
  "baseline": {
    object (Baseline)
  }
}
필드
destination

object (Destination)

필수 항목입니다. 통계를 가져올 대상입니다.
baseline

object (Baseline)

필수 항목입니다. 요청된 통계의 기준입니다.

응답 본문

DM API MarketingDataInsightsService.RetrieveInsights의 응답 메시지

성공한 경우 응답 본문은 다음과 같은 구조의 데이터를 포함합니다.

JSON 표현 
{
  "marketingDataInsights": [
    {
      object (MarketingDataInsight)
    }
  ]
}
필드
marketingDataInsights[]

object (MarketingDataInsight)

마케팅 데이터의 통계를 포함합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/datamanager

기준

통계가 비교되는 기준선 기준입니다.

JSON 표현 
{

  // Union field baseline can be only one of the following:
  "baselineLocation": {
    object (Location)
  },
  "locationAutoDetectionEnabled": boolean
  // End of list of possible types for union field baseline.
}
필드
통합 필드 baseline. 통계를 비교할 기준 위치입니다. baseline은 다음 중 하나여야 합니다.
baselineLocation

object (Location)

요청의 기준 위치입니다. 기준 위치는 요청된 지역의 OR 목록입니다.
locationAutoDetectionEnabled

boolean

true로 설정하면 서비스에서 통계의 기준 위치를 자동으로 감지하려고 시도합니다.

위치

요청의 기준 위치입니다. 기준 위치는 요청된 지역의 ISO 3166-1 alpha-2 지역 코드의 OR 목록에 있습니다.

JSON 표현 
{
  "regionCodes": [
    string
  ]
}
필드
regionCodes[]

string

ISO 3166-1 alpha-2 지역 코드 목록입니다.

MarketingDataInsight

마케팅 데이터에 대한 통계입니다.

JSON 표현 
{
  "dimension": enum (AudienceInsightsDimension),
  "attributes": [
    {
      object (MarketingDataInsightsAttribute)
    }
  ]
}
필드
dimension

enum (AudienceInsightsDimension)

통계가 속한 측정기준입니다.
attributes[]

object (MarketingDataInsightsAttribute)

지정된 측정기준의 값에 대한 통계입니다.

AudienceInsightsDimension

인사이트 생성에 사용할 수 있는 측정기준입니다.

열거형
AUDIENCE_INSIGHTS_DIMENSION_UNSPECIFIED 지정되지 않음
AUDIENCE_INSIGHTS_DIMENSION_UNKNOWN 이 버전에서는 값을 알 수 없습니다.
AFFINITY_USER_INTEREST 관심분야 사용자입니다.
IN_MARKET_USER_INTEREST 구매 의도 UserInterest입니다.
AGE_RANGE 연령대입니다.
GENDER 성별입니다.

MarketingDataInsightsAttribute

동일한 측정기준의 관련 속성 모음에 대한 통계입니다.

JSON 표현 
{
  "userInterestId": string,
  "lift": number,
  "ageRange": enum (AgeRange),
  "gender": enum (Gender)
}
필드
userInterestId

string (int64 format)

사용자 관심분야 ID입니다.
lift

number

기준과 비교하여 잠재고객이 속성 값에 대해 갖는 효과의 측정값입니다. 범위 [0~1]
ageRange

enum (AgeRange)

광고효과가 제공되는 잠재고객의 연령대입니다.
gender

enum (Gender)

효과가 제공되는 잠재고객의 성별입니다.

연령

인구통계 연령대

열거형
AGE_RANGE_UNSPECIFIED 지정되지 않음
AGE_RANGE_UNKNOWN 알 수 없음
AGE_RANGE_18_24 만 18~24세
AGE_RANGE_25_34 만 25~34세
AGE_RANGE_35_44 만 35~44세
AGE_RANGE_45_54 만 45~54세
AGE_RANGE_55_64 만 55~64세
AGE_RANGE_65_UP 65세 이상

성별

인구통계 성별 유형 (예: 여성)입니다.

열거형
GENDER_UNSPECIFIED 지정되지 않음
GENDER_UNKNOWN 알 수 없음
GENDER_MALE 남성
GENDER_FEMALE 여성