Method: customers.recommendations.generate

Tạo Đề xuất dựa trên các loại đề xuất được yêu cầu.

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

Yêu cầu HTTP

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

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 tạo đề xuất.

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
{
  "recommendationTypes": [
    enum (RecommendationType)
  ],
  "advertisingChannelType": enum (AdvertisingChannelType),
  "adGroupInfo": [
    {
      object (AdGroupInfo)
    }
  ],
  "campaignSitelinkCount": integer,
  "conversionTrackingStatus": enum (ConversionTrackingStatus),
  "biddingInfo": {
    object (BiddingInfo)
  },
  "seedInfo": {
    object (SeedInfo)
  }
}
Trường
recommendationTypes[]

enum (RecommendationType)

Bắt buộc. Danh sách các loại đề xuất đủ điều kiện cần tạo. Nếu tiêu chí đã tải lên không đủ để đưa ra đề xuất, hoặc chiến dịch đã ở trạng thái đề xuất, thì hệ thống sẽ không trả về đề xuất cho loại chiến dịch đó. Thông thường, hệ thống sẽ trả về một nội dung đề xuất nếu tất cả các trường bắt buộc cho thuộc tính đề xuất đó được tải lên, nhưng có một số trường hợp thì nội dung đề xuất này vẫn chưa đầy đủ.

Các loại đề xuất sau được hỗ trợ để tạo đề xuất: KEY, MAXIMIZE_CLICKS_OPT_IN, MAXIMIZE_CONVERSION_OPT_IN, MAXIMIZE_CONVERSION_VALUE_OPT_IN, SET_TARGET_CPA, SET_TARGET_ROAS, SITELINK_ASSET, TARGET_CPA_OPT_IN, TARGET_ROAS_OPT_IN

advertisingChannelType

enum (AdvertisingChannelType)

Bắt buộc. Loại kênh quảng cáo của chiến dịch. Các loại AdvertisingChannelTypes sau được hỗ trợ để tạo đề xuất: PERFORMANCE_MAX và SEARCH

adGroupInfo[]

object (AdGroupInfo)

Không bắt buộc. Thông tin về nhóm quảng cáo hiện tại. Hỗ trợ thông tin từ một Nhóm quảng cáo. Đây là trường không bắt buộc đối với các loại đề xuất sau: KEY

conversionTrackingStatus

enum (ConversionTrackingStatus)

Không bắt buộc. Trạng thái theo dõi lượt chuyển đổi hiện tại. Trường này cần thiết cho các loại đề xuất sau: MAXIMIZE_CLICKS_OPT_IN, MAXIMIZE_CONVERSION_OPT_IN, MAXIMIZE_CONVERSION_VALUE_OPT_IN, SET_TARGET_CPA, SET_TARGET_ROAS, TARGET_CPA_OPT_IN, TARGET_ROAS_OPT_IN

biddingInfo

object (BiddingInfo)

Không bắt buộc. Thông tin đặt giá thầu hiện tại của chiến dịch. Trường này cần thiết cho các loại đề xuất sau: MAXIMIZE_CLICKS_OPT_IN, MAXIMIZE_CONVERSION_OPT_IN, MAXIMIZE_CONVERSION_VALUE_OPT_IN, SET_TARGET_CPA, SET_TARGET_ROAS, TARGET_CPA_OPT_IN, TARGET_ROAS_OPT_IN

seedInfo

object (SeedInfo)

Không bắt buộc. Thông tin gốc cho Từ khoá. Trường này cần thiết cho các loại đề xuất sau: KEY

Nội dung phản hồi

Tin nhắn phản hồi cho RecommendationService.GenerateRecommendations.

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
{
  "recommendations": [
    {
      object (Recommendation)
    }
  ]
}
Trường
recommendations[]

object (Recommendation)

Danh sách các đề xuất được tạo từ tập hợp các loại đề xuất được yêu cầu đã chuyển. Nếu không có đủ dữ liệu để tạo đề xuất cho các loại đề xuất đã yêu cầu, tập hợp kết quả sẽ không chứa đề xuất cho loại đó.

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.

BiddingInfo

Thông tin đặt giá thầu hiện tại của chiến dịch. Cung cấp một trình bao bọc cho các tín hiệu liên quan đến việc đặt giá thầu để hỗ trợ cho các đề xuất.

Biểu diễn dưới dạng JSON
{
  "biddingStrategyType": enum (BiddingStrategyType),

  // Union field bidding_strategy_target_info can be only one of the following:
  "targetCpaMicros": string,
  "targetRoas": number
  // End of list of possible types for union field bidding_strategy_target_info.
}
Trường
biddingStrategyType

enum (BiddingStrategyType)

Chiến lược đặt giá thầu hiện tại. Trường này cần thiết cho các loại đề xuất sau: MAXIMIZE_CLICKS_OPT_IN, MAXIMIZE_CONVERSION_OPT_IN, MAXIMIZE_CONVERSION_VALUE_OPT_IN, SET_TARGET_CPA, SET_TARGET_ROAS, TARGET_CPA_OPT_IN, TARGET_ROAS_OPT_IN

Trường hợp bidding_strategy_target_info. Thông tin chi tiết không bắt buộc liên quan đến campaign_strategy_type. bidding_strategy_target_info chỉ có thể là một trong những trạng thái sau:
targetCpaMicros

string (int64 format)

Cpa mục tiêu hiện tại tính theo micrô giây. Thông tin này có thể được điền sẵn cho chiến dịch sử dụng loại chiến lược đặt giá thầu TARGET_CPA hoặc MAXIMIZE_CONVERSION.

targetRoas

number

Lợi tức mục tiêu trên chi tiêu quảng cáo hiện tại. Thông tin này có thể được điền sẵn cho chiến dịch có loại chiến lược đặt giá thầu TARGET_ROAS hoặc MAXIMIZE_CONVERSION_VALUE.

AdGroupInfo

Thông tin về Nhóm quảng cáo Hiện tại của chiến dịch.

Biểu diễn dưới dạng JSON
{
  "keywords": [
    {
      object (KeywordInfo)
    }
  ],
  "adGroupType": enum (AdGroupType)
}
Trường
keywords[]

object (KeywordInfo)

Không bắt buộc. Từ khóa hiện tại. Trường này là không bắt buộc đối với các loại đề xuất sau nếu bạn đặt adGroupInfo: KEY

adGroupType

enum (AdGroupType)

Không bắt buộc. Loại Nhóm quảng cáo của Nhóm quảng cáo. Trường này cần thiết cho các loại đề xuất sau nếu bạn đặt adGroupInfo: KEY

SeedInfo

Nguồn gốc từ khoá và URL cụ thể để tạo từ khoá.

Biểu diễn dưới dạng JSON
{
  "keywordSeeds": [
    string
  ],
  "urlSeed": string
}
Trường
keywordSeeds[]

string

Không bắt buộc. Các từ khoá hoặc cụm từ để tạo ý tưởng, ví dụ: ô tô hoặc "đại lý ô tô gần tôi".

urlSeed

string

Một URL cụ thể để tạo ý tưởng, ví dụ: www.example.com/cars.