- HTTP 요청
- 경로 매개변수
- 요청 본문
- 응답 본문
- 승인 범위
- AudienceCompositionSection
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- AudienceCompositionAttribute
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- AudienceCompositionMetrics
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- AudienceCompositionAttributeCluster
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- 실습
관심 있는 잠재고객에 표시되는 속성 모음을 반환하며, 각 속성의 잠재고객 점유율을 기준 잠재고객의 점유율과 비교하는 측정항목과 함께 표시됩니다.
발생한 오류 목록: AudienceInsightsError AuthenticationError AuthorizationError FieldError HeaderError InternalError QuotaError RangeError RequestError
HTTP 요청
POST https://googleads.googleapis.com/v16/customers/{customerId}:generateAudienceCompositionInsights
URL은 gRPC 트랜스코딩 문법을 사용합니다.
경로 매개변수
매개변수 | |
---|---|
customerId |
필수 항목입니다. 고객의 ID입니다. |
요청 본문
요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.
JSON 표현 |
---|
{ "audience": { object ( |
필드 | |
---|---|
audience |
필수 항목입니다. 통계를 요청 중인 관심 잠재고객입니다. |
baselineAudience |
관심 있는 잠재고객을 비교할 기준 잠재고객입니다. |
dataMonth |
통계에 사용할 이전 데이터의 1개월 기간이며 'yyyy-mm' 형식입니다. 설정하지 않으면 지난 30일간의 데이터에 대한 통계가 반환됩니다. |
dimensions[] |
필수 항목입니다. 구성 통계를 반환해야 하는 잠재고객 측정기준입니다. |
customerInsightsGroup |
계획된 고객의 이름입니다. 사용자 정의 값입니다. |
응답 본문
AudienceInsightsService.GenerateAudienceCompositionInsights
의 응답 메시지입니다.
성공할 경우 응답 본문에 다음 구조의 데이터가 포함됩니다.
JSON 표현 |
---|
{
"sections": [
{
object ( |
필드 | |
---|---|
sections[] |
섹션으로 구성된 통계 보고서의 콘텐츠입니다. 각 섹션은 요청의 AudienceInsightsDimension 값 중 하나와 연결됩니다. 측정기준당 2개 이상의 섹션이 있을 수 있습니다. |
승인 범위
다음 OAuth 범위가 필요합니다.
https://www.googleapis.com/auth/adwords
자세한 내용은 OAuth 2.0 개요를 참고하세요.
AudienceCompositionSection
잠재고객 구성 통계 보고서에 있는 동일한 유형의 관련 속성 모음입니다.
JSON 표현 |
---|
{ "dimension": enum ( |
필드 | |
---|---|
dimension |
이 섹션의 속성 유형입니다. |
topAttributes[] |
이 잠재고객과 가장 관련성이 높은 세그먼트입니다. 측정기준이 GENDER, AGE_RANGE 또는 PARENTAL_STATUS인 경우 이 속성 목록은 전체 속성입니다. |
clusteredAttributes[] |
이 잠재고객의 추가 속성으로, 클러스터로 그룹화됩니다. 측정기준이 YOUTUBE_CHANNEL인 경우에만 채워집니다. |
AudienceCompositionAttribute
메타데이터와 측정항목이 포함된 잠재고객 속성입니다.
JSON 표현 |
---|
{ "attributeMetadata": { object ( |
필드 | |
---|---|
attributeMetadata |
메타데이터가 포함된 속성입니다. |
metrics |
속성의 점유율 및 색인 측정항목입니다. |
AudienceCompositionMetrics
잠재고객 구성 통계 보고서의 속성과 연결된 점유율 및 지수 측정항목입니다.
JSON 표현 |
---|
{ "baselineAudienceShare": number, "audienceShare": number, "index": number, "score": number } |
필드 | |
---|---|
baselineAudienceShare |
속성과 일치하는 기준 잠재고객의 비율 (0~1)입니다. |
audienceShare |
속성과 일치하는 특정 잠재고객의 비율 (0~1)입니다. |
index |
baselineAudienceShare에 대한 AudienceShare의 비율입니다. 이 비율이 정의되지 않았거나 의미가 없는 경우 0입니다. |
score |
관련성 점수(0~1)입니다. |
AudienceCompositionAttributeCluster
잠재고객 구성 통계 보고서의 관련 속성 모음(메타데이터 및 측정항목 포함)
JSON 표현 |
---|
{ "clusterDisplayName": string, "clusterMetrics": { object ( |
필드 | |
---|---|
clusterDisplayName |
이 속성 클러스터의 이름입니다. |
clusterMetrics |
이 클러스터와 연결된 측정기준이 YOUTUBE_CHANNEL인 경우 clusterMetrics는 클러스터 전체와 연결된 측정항목입니다. 다른 측정기준의 경우 이 필드가 설정되지 않습니다. |
attributes[] |
메타데이터 및 측정항목과 함께 이 클러스터를 구성하는 개별 속성입니다. |