Method: customers.generateInsightsFinderReport

Insights Finder 도구에서 볼 수 있는 저장된 보고서를 만듭니다.

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

HTTP 요청

POST https://googleads.googleapis.com/v14/customers/{customerId}:generateInsightsFinderReport

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

경로 매개변수

매개변수
customerId

string

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

요청 본문

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

JSON 표현 
{
  "baselineAudience": {
    object (BasicInsightsAudience)
  },
  "specificAudience": {
    object (BasicInsightsAudience)
  },
  "customerInsightsGroup": string
}
필드
baselineAudience

object (BasicInsightsAudience)

필수 항목입니다. 이 보고서의 기준 잠재고객으로, 일반적으로 한 지역의 모든 사용자입니다.
specificAudience

object (BasicInsightsAudience)

필수 항목입니다. 이 보고서에 관심 있는 특정 잠재고객입니다. 보고서의 통계는 보고서의 기준 잠재고객보다 이 잠재고객에 더 많이 존재하는 속성을 기반으로 합니다.
customerInsightsGroup

string

계획된 고객의 이름입니다. 사용자 정의 값입니다.

응답 본문

보고서의 공유 가능한 URL이 포함된 AudienceInsightsService.GenerateInsightsFinderReport의 응답 메시지입니다.

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

JSON 표현 
{
  "savedReportUrl": string
}
필드
savedReportUrl

string

요청에 따라 보고서 입력이 채워진 Insights Finder UI에 딥 링크를 제공하는 HTTPS URL입니다.

승인 범위

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

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

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

BasicInsightsAudience

통계를 요청하는 데 사용되는 잠재고객에 대한 설명입니다.

JSON 표현 
{
  "countryLocation": [
    {
      object (LocationInfo)
    }
  ],
  "subCountryLocations": [
    {
      object (LocationInfo)
    }
  ],
  "gender": {
    object (GenderInfo)
  },
  "ageRanges": [
    {
      object (AgeRangeInfo)
    }
  ],
  "userInterests": [
    {
      object (UserInterestInfo)
    }
  ],
  "topics": [
    {
      object (AudienceInsightsTopic)
    }
  ]
}
필드
countryLocation[]

object (LocationInfo)

필수 항목입니다. 이 잠재고객의 국가입니다.
subCountryLocations[]

object (LocationInfo)

국가 내 지리적 위치 속성입니다. 있는 경우 이러한 각 항목은 이 잠재고객에 포함된 국가 중 하나에 포함되어야 합니다.
gender

object (GenderInfo)

잠재고객의 성별입니다. 이 항목이 없으면 잠재고객이 성별로 제한되지 않습니다.
ageRanges[]

object (AgeRangeInfo)

잠재고객의 연령대입니다. 표시되지 않는 경우 잠재고객은 다른 속성과 일치하는 만 18세 이상의 모든 사용자를 나타냅니다.
userInterests[]

object (UserInterestInfo)

이 잠재고객을 정의하는 사용자 관심분야입니다. 관심분야 및 구매 의도 잠재고객이 지원됩니다.
topics[]

object (AudienceInsightsTopic)

이 잠재고객이 관심을 가지고 있는 지식 그래프 항목 또는 제품 및 서비스 카테고리로 표시되는 주제입니다.

AudienceInsightsTopic

잠재고객을 정의하는 주제를 나타내는 항목 또는 카테고리입니다.

JSON 표현 
{

  // Union field topic can be only one of the following:
  "entity": {
    object (AudienceInsightsEntity)
  },
  "category": {
    object (AudienceInsightsCategory)
  }
  // End of list of possible types for union field topic.
}
필드
통합 필드 topic. 항목 또는 카테고리 속성입니다. topic은 다음 중 하나여야 합니다.
entity

object (AudienceInsightsEntity)

지식 그래프 항목
category

object (AudienceInsightsCategory)

제품 및 서비스 카테고리