- HTTP 요청
- 경로 매개변수
- 요청 본문
- 응답 본문
- 승인 범위
- AudienceCompositionSection
- AudienceCompositionAttribute
- AudienceCompositionMetrics
- AudienceCompositionAttributeCluster
- 실습
관심 있는 잠재고객에 표시되는 속성의 모음을 반환하며, 잠재고객의 각 속성에 대한 점유율을 기준 잠재고객의 해당 점유율과 비교하는 측정항목을 사용합니다.
발생한 오류 목록: 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[] |
메타데이터 및 측정항목과 함께 이 클러스터를 구성하는 개별 속성입니다. |