Method: customers.generateSuggestedTargetingInsights

요청된 잠재고객과 관련된 타겟팅 통계 (예: 타겟팅 가능한 잠재고객) 모음을 반환합니다.

발생한 오류 목록: AudienceInsightsError AuthenticationError AuthorizationError FieldError HeaderError InternalError QuotaError RangeError RequestError

HTTP 요청

POST https://googleads.googleapis.com/v16/customers/{customerId}:generateSuggestedTargetingInsights

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

경로 매개변수

매개변수
customerId

string

필수 항목입니다. 고객의 ID입니다.

요청 본문

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

JSON 표현 
{
  "audience": {
    object (InsightsAudience)
  },
  "baselineAudience": {
    object (InsightsAudience)
  },
  "dataMonth": string,
  "customerInsightsGroup": string
}
입력란
audience

object (InsightsAudience)

필수 항목입니다. 통계를 요청하는 관심 대상입니다.
baselineAudience

object (InsightsAudience)

선택사항입니다. 기준 잠재고객 지정되지 않은 경우 기본값은 관심 잠재고객과 동일한 국가에 거주하는 모든 사용자입니다.
dataMonth

string

선택사항입니다. 통계에 사용할 이전 데이터의 1개월 범위이며 'yyyy-mm' 형식입니다. 설정하지 않으면 지난 30일간의 데이터에 대한 통계가 반환됩니다.
customerInsightsGroup

string

선택사항입니다. 계획 중인 고객의 이름입니다. 사용자 정의 값입니다.

응답 본문

AudienceInsightsService.GenerateSuggestedTargetingInsights의 응답 메시지입니다.

성공할 경우 응답 본문에 다음 구조의 데이터가 포함됩니다.

JSON 표현 
{
  "suggestions": [
    {
      object (TargetingSuggestionMetrics)
    }
  ]
}
입력란
suggestions[]

object (TargetingSuggestionMetrics)

타겟팅 가능한 잠재고객에 대한 추천 통계입니다.

승인 범위

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

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

자세한 내용은 OAuth 2.0 개요를 참고하세요.

TargetingSuggestionMetrics

요청된 잠재고객과 관련된 타겟팅 가능한 추천 잠재고객입니다.

JSON 표현 
{
  "locations": [
    {
      object (AudienceInsightsAttributeMetadata)
    }
  ],
  "ageRanges": [
    {
      object (AgeRangeInfo)
    }
  ],
  "gender": {
    object (GenderInfo)
  },
  "userInterests": [
    {
      object (AudienceInsightsAttributeMetadata)
    }
  ],
  "coverage": number,
  "index": number,
  "potentialYoutubeReach": string
}
입력란
locations[]

object (AudienceInsightsAttributeMetadata)

추천 위치 타겟팅 이러한 속성에는 모두 GEO_TARGET_COUNTRY 또는 SUB_COUNTRY_LOCATION 측정기준이 있습니다.
ageRanges[]

object (AgeRangeInfo)

추천 연령 타겟팅입니다. 비어 있을 경우 연령 타겟팅이 없음을 의미할 수 있습니다.
gender

object (GenderInfo)

추천 성별 타겟팅입니다. 있는 경우 이 속성에는 GENDER 측정기준이 있습니다.
userInterests[]

object (AudienceInsightsAttributeMetadata)

타겟팅할 추천 잠재고객 세그먼트입니다. 이러한 속성은 모두 측정기준 AFFINITY_USER_INTEREST 또는 IN_MARKET_USER_INTEREST를 사용합니다.
coverage

number

추천 타겟팅을 사용하여 도달할 수 있는 요청된 잠재고객의 비율 (0~1)입니다.
index

number

기준 잠재고객의 노출 범위에 대한 노출 범위의 비율입니다. 이 비율이 정의되지 않았거나 의미가 없는 경우에는 0입니다.
potentialYoutubeReach

string (int64 format)

이 타겟팅을 사용하여 YouTube에서 도달할 수 있는 대략적인 예상 사용자 수입니다.