- Yêu cầu HTTP
- Tham số đường dẫn
- Nội dung yêu cầu
- Nội dung phản hồi
- Phạm vi uỷ quyền
- BiddingInfo
- AdGroupInfo
- SeedInfo
- Hãy làm thử!
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 |
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 ( |
Trường | |
---|---|
recommendationTypes[] |
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 |
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[] |
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 |
campaignSitelinkCount |
Không bắt buộc. Số đường liên kết của trang web trong chiến dịch. Trường này cần thiết cho các loại đề xuất sau: SITELINK_ASSET |
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 |
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 |
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 ( |
Trường | |
---|---|
recommendations[] |
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 ( |
Trường | |
---|---|
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 |
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 |
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 ( |
Trường | |
---|---|
keywords[] |
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 |
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[] |
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 |
Một URL cụ thể để tạo ý tưởng, ví dụ: www.example.com/cars. |