Method: customers.generateSuggestedTargetingInsights

Trả về tập hợp thông tin chi tiết về tiêu chí nhắm mục tiêu (ví dụ: đối tượng có thể nhắm mục tiêu) phù hợp với đối tượng được yêu cầu.

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/v15/customers/{customerId}:generateSuggestedTargetingInsights

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,
  "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)

Không bắt buộc. Đối tượng cơ sở. Theo mặc định, nếu không chỉ định, thì tất cả mọi người ở cùng một quốc gia với đối tượng mà bạn quan tâm.
dataMonth

string

Không bắt buộc. 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.
customerInsightsGroup

string

Không bắt buộc. 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.GenerateSuggestedTargetingInsights.

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 
{
  "suggestions": [
    {
      object (TargetingSuggestionMetrics)
    }
  ]
}
Các trường
suggestions[]

object (TargetingSuggestionMetrics)

Thông tin chi tiết đề xuất cho đối tượng có thể nhắm mục tiêu.

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.

TargetingSuggestionMetrics

Đối tượng có thể nhắm mục tiêu được đề xuất có liên quan đến đối tượng được yêu cầu.

Biểu diễn dưới dạng JSON 
{
  "locations": [
    {
      object (AudienceInsightsAttributeMetadata)
    }
  ],
  "ageRanges": [
    {
      object (AgeRangeInfo)
    }
  ],
  "gender": {
    object (GenderInfo)
  },
  "userInterests": [
    {
      object (AudienceInsightsAttributeMetadata)
    }
  ],
  "coverage": number,
  "index": number,
  "potentialYoutubeReach": string
}
Các trường
locations[]

object (AudienceInsightsAttributeMetadata)

Tiêu chí nhắm mục tiêu theo vị trí đề xuất. Tất cả các thuộc tính này đều có phương diện GEO_TARGET_COUNTRY hoặc SUB_COUNTRY_LOCATION
ageRanges[]

object (AgeRangeInfo)

Nhắm mục tiêu theo độ tuổi được đề xuất; có thể để trống để cho biết không có tiêu chí nhắm mục tiêu theo độ tuổi.
gender

object (GenderInfo)

Nhắm mục tiêu theo giới tính được đề xuất. Thuộc tính này sẽ có phương diện GENDER (nếu có).
userInterests[]

object (AudienceInsightsAttributeMetadata)

Phân khúc đối tượng được đề xuất để nhắm mục tiêu. Tất cả các thuộc tính này đều có phương diện AFFINITY_USER_interest hoặc IN_MARKET_USER_ sút
coverage

number

Phần (từ 0 đến 1) của đối tượng được yêu cầu có thể tiếp cận được bằng cách sử dụng nhắm mục tiêu được đề xuất.
index

number

Tỷ lệ mức độ phù hợp so với mức độ phù hợp của đối tượng cơ sở hoặc bằng 0 nếu tỷ lệ này không xác định hoặc không có ý nghĩa.
potentialYoutubeReach

string (int64 format)

Số người ước tính gần đúng có thể tiếp cận được trên YouTube bằng cách sử dụng nhắm mục tiêu này.