Method: customers.generateAudienceCompositionInsights

Trả về một tập hợp các thuộc tính được thể hiện trong một đối tượng quan tâm, cùng với các chỉ số so sánh tỷ lệ đối tượng của mỗi thuộc tính với tỷ lệ phần đối tượng cơ sở.

Danh sách các lỗi đã gửi: AudienceInsightsError AuthenticationError AuthorizationError FieldError HeaderError InternalError QuotaError RangeError RequestError

Yêu cầu HTTP

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

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số đường dẫn

Tham số
customerId

string

Bắt buộc. Mã của khách hàng.

Nội dung yêu cầu

Nội dung yêu cầu chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng JSON 
{
  "audience": {
    object (InsightsAudience)
  },
  "baselineAudience": {
    object (InsightsAudience)
  },
  "dataMonth": string,
  "dimensions": [
    enum (AudienceInsightsDimension)
  ],
  "customerInsightsGroup": string
}
Trường
audience

object (InsightsAudience)

Bắt buộc. Đối tượng quan tâm mà thông tin chi tiết đang được yêu cầu.
baselineAudience

object (InsightsAudience)

Đối tượng cơ sở mà đối tượng được quan tâm đang được so sánh.
dataMonth

string

Phạm vi dữ liệu trong quá khứ trong một tháng được dùng để xác định thông tin chi tiết, theo định dạng "yyyy-mm". Nếu bạn không đặt chính sách này, hệ thống sẽ trả về thông tin chi tiết cho dữ liệu trong 30 ngày qua.
dimensions[]

enum (AudienceInsightsDimension)

Bắt buộc. Phương diện đối tượng mà thông tin chi tiết về thành phần sẽ được trả về.
customerInsightsGroup

string

Tên của khách hàng cần được lập kế hoạch. Đây là giá trị do người dùng xác định.

Nội dung phản hồi

Tin nhắn phản hồi cho AudienceInsightsService.GenerateAudienceCompositionInsights.

Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng JSON 
{
  "sections": [
    {
      object (AudienceCompositionSection)
    }
  ]
}
Trường
sections[]

object (AudienceCompositionSection)

Nội dung của báo cáo thông tin chi tiết được sắp xếp thành các mục. Mỗi phần được liên kết với một trong các giá trị AudienceInsightsDimension trong yêu cầu. Có thể có nhiều phần cho mỗi phương diện.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

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

Để biết thêm thông tin, hãy xem Tổng quan về OAuth 2.0.

AudienceCompositionSection

Tập hợp các thuộc tính có liên quan cùng loại trong báo cáo thông tin chi tiết về thành phần đối tượng.

Biểu diễn dưới dạng JSON 
{
  "dimension": enum (AudienceInsightsDimension),
  "topAttributes": [
    {
      object (AudienceCompositionAttribute)
    }
  ],
  "clusteredAttributes": [
    {
      object (AudienceCompositionAttributeCluster)
    }
  ]
}
Trường
dimension

enum (AudienceInsightsDimension)

Loại thuộc tính trong phần này.
topAttributes[]

object (AudienceCompositionAttribute)

Các phân khúc phù hợp nhất cho đối tượng này. Nếu phương diện là GENDER, AGE_RANGE hoặc PARENTAL_STATUS, thì đây là danh sách đầy đủ.
clusteredAttributes[]

object (AudienceCompositionAttributeCluster)

Các thuộc tính bổ sung cho đối tượng này, được nhóm thành các cụm. Chỉ được điền sẵn nếu phương diện là YOUTUBE_CHANNEL.

AudienceCompositionAttribute

Thuộc tính đối tượng có siêu dữ liệu và chỉ số.

Biểu diễn dưới dạng JSON 
{
  "attributeMetadata": {
    object (AudienceInsightsAttributeMetadata)
  },
  "metrics": {
    object (AudienceCompositionMetrics)
  }
}
Trường
attributeMetadata

object (AudienceInsightsAttributeMetadata)

Thuộc tính cùng với siêu dữ liệu.
metrics

object (AudienceCompositionMetrics)

Chia sẻ và lập chỉ mục chỉ số cho thuộc tính.

AudienceCompositionMetrics

Các chỉ số tỷ lệ và chỉ mục được liên kết với một thuộc tính trong báo cáo thông tin chi tiết về thành phần đối tượng.

Biểu diễn dưới dạng JSON 
{
  "baselineAudienceShare": number,
  "audienceShare": number,
  "index": number,
  "score": number
}
Trường
baselineAudienceShare

number

Phân số (từ 0 đến 1) của đối tượng cơ sở khớp với thuộc tính.
audienceShare

number

Phân số (từ 0 đến 1) của đối tượng cụ thể khớp với thuộc tính.
index

number

Tỷ lệ AudienceShare với BaselineAudienceShare hoặc bằng 0 nếu tỷ lệ này không xác định hoặc không có ý nghĩa.
score

number

Mức điểm về mức độ liên quan từ 0 đến 1.

AudienceCompositionAttributeCluster

Tập hợp các thuộc tính có liên quan cùng với siêu dữ liệu và chỉ số trong báo cáo thông tin chi tiết về thành phần đối tượng.

Biểu diễn dưới dạng JSON 
{
  "clusterDisplayName": string,
  "clusterMetrics": {
    object (AudienceCompositionMetrics)
  },
  "attributes": [
    {
      object (AudienceCompositionAttribute)
    }
  ]
}
Trường
clusterDisplayName

string

Tên của cụm thuộc tính này
clusterMetrics

object (AudienceCompositionMetrics)

Nếu phương diện được liên kết với cụm này là YOUTUBE_CHANNEL, thì clusterMetrics là các chỉ số được liên kết với cụm nói chung. Đối với các phương diện khác, trường này chưa được đặt.
attributes[]

object (AudienceCompositionAttribute)

Các thuộc tính riêng lẻ tạo nên cụm này, kèm theo siêu dữ liệu và chỉ số.