Method: customers.generateAudienceCompositionInsights

Trả về tập hợp các thuộc tính được thể hiện trong một đối tượng được quan tâm, 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ệ của đối tượng cơ sở.

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

Yêu cầu HTTP

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

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

Tham số đường dẫn

Các tham số
customerId

string

Bắt buộc. Mã nhận dạng 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
}
Các trường
audience

object (InsightsAudience)

Bắt buộc. Đối tượng mà bạn quan tâm và đang được yêu cầu thông tin chi tiết.
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 để khai thác 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 của 30 ngày qua.
dimensions[]

enum (AudienceInsightsDimension)

Bắt buộc. Cá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 trả lờ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)
    }
  ]
}
Các 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 đều đượ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 mục 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.

InsightsAudience

Một nhóm người dùng, được xác định theo nhiều đặc điểm, cần có thông tin chi tiết trong AudienceInsightsService.

Biểu diễn dưới dạng JSON 
{
  "countryLocations": [
    {
      object (LocationInfo)
    }
  ],
  "subCountryLocations": [
    {
      object (LocationInfo)
    }
  ],
  "gender": {
    object (GenderInfo)
  },
  "ageRanges": [
    {
      object (AgeRangeInfo)
    }
  ],
  "parentalStatus": {
    object (ParentalStatusInfo)
  },
  "incomeRanges": [
    {
      object (IncomeRangeInfo)
    }
  ],
  "dynamicLineups": [
    {
      object (AudienceInsightsDynamicLineup)
    }
  ],
  "topicAudienceCombinations": [
    {
      object (InsightsAudienceAttributeGroup)
    }
  ]
}
Các trường
countryLocations[]

object (LocationInfo)

Bắt buộc. Quốc gia cho đối tượng.
subCountryLocations[]

object (LocationInfo)

Thuộc tính vị trí địa lý của quốc gia phụ. Nếu có, từng đối tượng trong số này phải thuộc một trong những quốc gia thuộc đối tượng này. Nếu không có lựa chọn này, đối tượng sẽ được cung cấp theo khu vực địa lý đến vị trí quốc gia đó chứ không ở xa hơn.
gender

object (GenderInfo)

Giới tính của đối tượng. Nếu không tham gia, khán giả sẽ không giới hạn theo giới tính.
ageRanges[]

object (AgeRangeInfo)

Độ tuổi của đối tượng. Nếu không có thuộc tính này, thì đối tượng đại diện cho tất cả những người trên 18 tuổi phù hợp với các thuộc tính khác.
parentalStatus

object (ParentalStatusInfo)

Tình trạng con cái của đối tượng. Nếu không có lựa chọn này, khán giả sẽ không giới hạn theo tình trạng con cái.
incomeRanges[]

object (IncomeRangeInfo)

Phạm vi phần trăm thu nhập hộ gia đình cho đối tượng đó. Nếu không có tham gia, thì đối tượng sẽ không được giới hạn theo phạm vi thu nhập hộ gia đình.
dynamicLineups[]

object (AudienceInsightsDynamicLineup)

Nhóm động đại diện cho nội dung trên YouTube mà đối tượng đã xem.
topicAudienceCombinations[]

object (InsightsAudienceAttributeGroup)

Sự kết hợp giữa các thuộc tính thực thể, danh mục và mối quan tâm của người dùng để xác định đối tượng. Tổ hợp này có cấu trúc logic AND của OR: Các thuộc tính trong mỗi InsightsAudience AttributesGroup được kết hợp với OR, và bản thân các tổ hợp này được kết hợp với AND. Ví dụ: bạn có thể tạo biểu thức (Thực thể HOẶC đối tượng chung sở thích) VÀ (Đối tượng đang cân nhắc mua hàng HOẶC danh mục) bằng cách sử dụng hai InsightsAudienceAttributeGroups với hai Thuộc tính cho mỗi thuộc tính.

InsightsAudienceAttributeGroup

Danh sách AudienceInsightsAttributes.

Biểu diễn dưới dạng JSON 
{
  "attributes": [
    {
      object (AudienceInsightsAttribute)
    }
  ]
}
Các trường
attributes[]

object (AudienceInsightsAttribute)

Bắt buộc. Một tập hợp các thuộc tính đối tượng cần được kết hợp với logic OR. Tất cả các thuộc tính không cần phải có cùng một phương diện. Chỉ các thực thể Sơ đồ tri thức, Danh mục sản phẩm và dịch vụ cũng như Đối tượng chung sở thích và Đối tượng đang cân nhắc mua hàng mới được hỗ trợ trong ngữ cảnh này.

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)
    }
  ]
}
Các trường
dimension

enum (AudienceInsightsDimension)

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

object (AudienceCompositionAttribute)

Những phân khúc phù hợp nhất cho đối tượng này. Nếu kích thước là GENDER, AGE_RANGE hoặc PARENTAL_STATUS, thì danh sách thuộc tính này là đầ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 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)
  }
}
Các trường
attributeMetadata

object (AudienceInsightsAttributeMetadata)

Thuộc tính kèm siêu dữ liệu.
metrics

object (AudienceCompositionMetrics)

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

AudienceCompositionMetrics

Các chỉ số về 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
}
Các trường
baselineAudienceShare

number

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

number

Phần (từ 0 đến 1) của đối tượng cụ thể phù hợp với thuộc tính này.
index

number

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

number

Điểm mức độ phù hợp 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)
    }
  ]
}
Các 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 liên kết với cụm này là YOUTUBE_CHANNEL, thì cụmMetrics là các chỉ số liên kết với toàn bộ cụm. Đố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, với siêu dữ liệu và chỉ số.