Method: customers.recommendations.generate

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

Danh sách lỗi được 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

Thông 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 recommendationTypes đủ điều kiệ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 được đề xuất, thì sẽ không có đề xuất nào được trả về cho loại đó. Thông thường, hệ thống sẽ trả về một đề xuất nếu bạn tải tất cả các trường bắt buộc cho recommendationType đó lên, nhưng có một số trường hợp vẫn chưa đủ.

Các loại đề xuất sau đây được hỗ trợ để tạo đề xuất: KEYWORD, MAXIMIZE_CLICKS_OPT_IN, MAXIMIZE_CONVERSIONS_OPT_IN, MAXIMIZE_CONVERSION_VALUE_OPT_IN, SET_TARGET_CPA, SET_TARGET_ROAS, TRALINK_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 advertisingChannelTypes sau đây được hỗ trợ để tạo đề xuất: PERFORMANCE_MAX và SEARCH
adGroupInfo[]

object (AdGroupInfo)

Không bắt buộc. Thông tin nhóm quảng cáo hiện tại. Hỗ trợ thông tin từ một Nhóm quảng cáo. Trường này không bắt buộc đối với các recommendationTypes sau: KEYWORD
conversionTrackingStatus

enum (ConversionTrackingStatus)

Không bắt buộc. Trạng thái hiện tại của tính năng theo dõi lượt chuyển đổi. Trường này là cần thiết cho các recommendationTypes sau: MAXIMIZE_CLICKS_OPT_IN, MAXIMIZE_CONVERSIONS_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 là cần thiết cho các recommendationTypes sau: MAXIMIZE_CLICKS_OPT_IN, MAXIMIZE_CONVERSIONS_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 là cần thiết cho các đề xuất sau đây: KEYWORD

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ừ một nhóm đề xuất đã yêu cầu đã được chuyển. Nếu không có đủ dữ liệu để tạo đề xuất cho recommendationTypes được yêu cầu, thì 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 bài viết 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 để cung cấp thông tin cho nội dung đề 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. Đây là trường cần thiết cho các loại đề xuất sau: MAXIMIZE_CLICKS_OPT_IN, MAXIMIZE_CONVERSIONS_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 hợp nhất bidding_strategy_target_info. Thông tin chi tiết không bắt buộc liên quan đến thuộc tính chiến lược giá thầu. bidding_strategy_target_info chỉ có thể là một trong những loại sau:
targetCpaMicros

string (int64 format)

Cpa mục tiêu hiện tại tính bằng phần triệu. Bạn có thể điền thông tin này cho các chiến dịch có loại chiến lược đặt giá thầu là TARGET_CPA hoặc MAXIMIZE_CONVERSIONS.
targetRoas

number

Lợi tức mục tiêu trên chi tiêu quảng cáo hiện tại. Bạn có thể điền giá trị này cho những chiến dịch có loại chiến lược giá thầu là 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 recommendationTypes sau đây nếu bạn đặt adGroupInfo: TỪ KHÓA
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. Đây là trường cần cho các đề xuất sau đây nếu adGroupInfo được đặt: KEYWORD

SeedInfo

Một từ khoá gốc và một 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. 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

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