Method: customers.recommendations.apply

Áp dụng những đề xuất nhất định bằng các tham số áp dụng tương ứng.

Danh sách lỗi được gửi: AuthenticationError AuthorizationError DatabaseError FieldError HeaderError InternalError MutateError QuotaError RecommendationError RequestError UrlFieldError

Yêu cầu HTTP

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

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ã khách hàng có đề 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 
{
  "operations": [
    {
      object (ApplyRecommendationOperation)
    }
  ],
  "partialFailure": boolean
}
Các trường
operations[]

object (ApplyRecommendationOperation)

Bắt buộc. Danh sách các thao tác để áp dụng đề xuất. Nếu sectionFailure=false tất cả đề xuất đều phải thuộc cùng loại, thì bạn chỉ được thực hiện tối đa 100 thao tác cho mỗi yêu cầu.
partialFailure

boolean

Nếu đúng, các thao tác thành công sẽ được thực hiện và các thao tác không hợp lệ sẽ trả về lỗi. Nếu giá trị là sai, các thao tác sẽ được thực hiện dưới dạng giao dịch khi và chỉ khi tất cả các thao tác đó đều hợp lệ. Mặc định là sai.

Nội dung phản hồi

Tin nhắn trả lời cho RecommendationService.ApplyRecommendation.

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 
{
  "results": [
    {
      object (ApplyRecommendationResult)
    }
  ],
  "partialFailureError": {
    object (Status)
  }
}
Các trường
results[]

object (ApplyRecommendationResult)

Kết quả của hoạt động để áp dụng các đề xuất.
partialFailureError

object (Status)

Các lỗi liên quan đến lỗi thao tác ở chế độ lỗi một phần. Chỉ trả về khi partialFailure = true và tất cả lỗi đều xảy ra trong thao tác. Nếu có lỗi xảy ra ngoài thao tác (ví dụ: lỗi xác thực), chúng tôi sẽ trả về lỗi ở cấp độ RPC.

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.

ApplyRecommendationOperation

Thông tin về thao tác để áp dụng một đề xuất và mọi tham số để tuỳ chỉnh đề xuất đó.

Biểu diễn dưới dạng JSON 
{
  "resourceName": string,

  // Union field apply_parameters can be only one of the following:
  "campaignBudget": {
    object (CampaignBudgetParameters)
  },
  "textAd": {
    object (TextAdParameters)
  },
  "keyword": {
    object (KeywordParameters)
  },
  "targetCpaOptIn": {
    object (TargetCpaOptInParameters)
  },
  "targetRoasOptIn": {
    object (TargetRoasOptInParameters)
  },
  "calloutExtension": {
    object (CalloutExtensionParameters)
  },
  "callExtension": {
    object (CallExtensionParameters)
  },
  "sitelinkExtension": {
    object (SitelinkExtensionParameters)
  },
  "moveUnusedBudget": {
    object (MoveUnusedBudgetParameters)
  },
  "responsiveSearchAd": {
    object (ResponsiveSearchAdParameters)
  },
  "useBroadMatchKeyword": {
    object (UseBroadMatchKeywordParameters)
  },
  "responsiveSearchAdAsset": {
    object (ResponsiveSearchAdAssetParameters)
  },
  "responsiveSearchAdImproveAdStrength": {
    object (ResponsiveSearchAdImproveAdStrengthParameters)
  },
  "raiseTargetCpaBidTooLow": {
    object (RaiseTargetCpaBidTooLowParameters)
  },
  "forecastingSetTargetRoas": {
    object (ForecastingSetTargetRoasParameters)
  },
  "calloutAsset": {
    object (CalloutAssetParameters)
  },
  "callAsset": {
    object (CallAssetParameters)
  },
  "sitelinkAsset": {
    object (SitelinkAssetParameters)
  },
  "raiseTargetCpa": {
    object (RaiseTargetCpaParameters)
  },
  "lowerTargetRoas": {
    object (LowerTargetRoasParameters)
  }
  // End of list of possible types for union field apply_parameters.
}
Các trường
resourceName

string

Tên tài nguyên của đề xuất sẽ áp dụng.
Trường nhóm apply_parameters. Các tham số cần sử dụng khi áp dụng đề xuất. apply_parameters chỉ có thể là một trong những trạng thái sau đây:
campaignBudget

object (CampaignBudgetParameters)

Các thông số không bắt buộc để sử dụng khi áp dụng đề xuất về ngân sách chiến dịch.
textAd

object (TextAdParameters)

Các tham số không bắt buộc để sử dụng khi áp dụng một đề xuất về quảng cáo dạng văn bản.
keyword

object (KeywordParameters)

Các tham số không bắt buộc dùng khi áp dụng đề xuất về từ khoá.
targetCpaOptIn

object (TargetCpaOptInParameters)

Các thông số không bắt buộc dùng khi áp dụng đề xuất chọn sử dụng CPA mục tiêu.
targetRoasOptIn

object (TargetRoasOptInParameters)

Các thông số không bắt buộc dùng khi áp dụng đề xuất chọn sử dụng lợi tức mục tiêu trên chi tiêu quảng cáo.
calloutExtension

object (CalloutExtensionParameters)

Các thông số cần sử dụng khi áp dụng đề xuất phần mở rộng về chú thích.
callExtension

object (CallExtensionParameters)

Các thông số cần sử dụng khi áp dụng đề xuất phần mở rộng về cuộc gọi.
moveUnusedBudget

object (MoveUnusedBudgetParameters)

Các thông số cần sử dụng khi áp dụng đề xuất chuyển ngân sách chưa sử dụng.
responsiveSearchAd

object (ResponsiveSearchAdParameters)

Các thông số cần sử dụng khi áp dụng một đề xuất về quảng cáo tìm kiếm thích ứng.
useBroadMatchKeyword

object (UseBroadMatchKeywordParameters)

Các thông số nên sử dụng khi áp dụng đề xuất sử dụng từ khoá khớp mở rộng.
responsiveSearchAdAsset

object (ResponsiveSearchAdAssetParameters)

Các thông số cần sử dụng khi áp dụng đề xuất về thành phần của quảng cáo tìm kiếm thích ứng.
responsiveSearchAdImproveAdStrength

object (ResponsiveSearchAdImproveAdStrengthParameters)

Các thông số cần sử dụng khi áp dụng quảng cáo tìm kiếm thích ứng sẽ giúp cải thiện đề xuất về độ mạnh của quảng cáo.
raiseTargetCpaBidTooLow

object (RaiseTargetCpaBidTooLowParameters)

Các thông số cần sử dụng khi áp dụng đề xuất tăng giá thầu CPA mục tiêu quá thấp. Quá trình áp dụng không đồng bộ và có thể mất vài phút tuỳ thuộc vào số lượng nhóm quảng cáo trong chiến dịch có liên quan.
forecastingSetTargetRoas

object (ForecastingSetTargetRoasParameters)

Các thông số sẽ sử dụng khi áp dụng một đề xuất dự báo về lợi tức mục tiêu trên chi tiêu quảng cáo (ROAS mục tiêu).
calloutAsset

object (CalloutAssetParameters)

Các thông số cần sử dụng khi áp dụng đề xuất về thành phần chú thích.
callAsset

object (CallAssetParameters)

Các thông số cần sử dụng khi áp dụng đề xuất về thành phần cuộc gọi.
raiseTargetCpa

object (RaiseTargetCpaParameters)

Các thông số cần sử dụng khi áp dụng đề xuất tăng CPA mục tiêu.
lowerTargetRoas

object (LowerTargetRoasParameters)

Các thông số cần sử dụng khi áp dụng đề xuất thấp hơn về Lợi tức mục tiêu trên chi tiêu quảng cáo.

CampaignBudgetParameters

Các thông số cần sử dụng khi áp dụng đề xuất về ngân sách chiến dịch.

Biểu diễn dưới dạng JSON 
{
  "newBudgetAmountMicros": string
}
Các trường
newBudgetAmountMicros

string (int64 format)

Số tiền ngân sách mới cần đặt cho tài nguyên ngân sách mục tiêu. Đây là trường bắt buộc.

TextAdParameters

Các thông số cần sử dụng khi áp dụng một đề xuất về quảng cáo dạng văn bản.

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

object (Ad)

Quảng cáo mới để thêm vào nhóm quảng cáo được đề xuất. Bạn phải đặt tất cả các trường cần thiết trong thông báo này. Đây là trường bắt buộc.

KeywordParameters

Các tham số cần sử dụng khi áp dụng đề xuất từ khoá.

Biểu diễn dưới dạng JSON 
{
  "matchType": enum (KeywordMatchType),
  "adGroup": string,
  "cpcBidMicros": string
}
Các trường
matchType

enum (KeywordMatchType)

Kiểu khớp của từ khoá. Đây là trường bắt buộc.
adGroup

string

Tài nguyên nhóm quảng cáo để thêm từ khoá. Đây là trường bắt buộc.
cpcBidMicros

string (int64 format)

Không bắt buộc, giá thầu CPC để đặt cho từ khoá. Nếu bạn không đặt chính sách này, từ khoá sẽ sử dụng giá thầu dựa trên chiến lược đặt giá thầu mà nhóm quảng cáo mục tiêu sử dụng.

TargetCpaOptInParameters

Các thông số cần sử dụng khi áp dụng đề xuất về CPA mục tiêu.

Biểu diễn dưới dạng JSON 
{
  "targetCpaMicros": string,
  "newCampaignBudgetAmountMicros": string
}
Các trường
targetCpaMicros

string (int64 format)

CPA trung bình để sử dụng cho chiến lược đặt giá thầu CPA mục tiêu. Đây là trường bắt buộc.
newCampaignBudgetAmountMicros

string (int64 format)

Số tiền ngân sách cần đặt cho chiến dịch (không bắt buộc).

TargetRoasOptInParameters

Các thông số sẽ sử dụng khi áp dụng đề xuất chọn tham gia ROAS mục tiêu.

Biểu diễn dưới dạng JSON 
{
  "targetRoas": number,
  "newCampaignBudgetAmountMicros": string
}
Các trường
targetRoas

number

ROAS trung bình (doanh thu trên mỗi đơn vị chi tiêu) để sử dụng cho chiến lược đặt giá thầu ROAS mục tiêu. Giá trị nằm trong khoảng từ 0,01 đến 1000,0. Đây là trường bắt buộc, trừ khi bạn đặt newCampaignBudgetAmountMicros.
newCampaignBudgetAmountMicros

string (int64 format)

Số tiền ngân sách cần đặt cho chiến dịch (không bắt buộc).

CalloutExtensionParameters

Các thông số cần sử dụng khi áp dụng đề xuất phần mở rộng về chú thích.

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

object (CalloutFeedItem)

Phần mở rộng về chú thích sẽ được thêm vào. Đây là trường bắt buộc.

CallExtensionParameters

Các thông số cần sử dụng khi áp dụng đề xuất phần mở rộng về cuộc gọi.

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

object (CallFeedItem)

Phần mở rộng về cuộc gọi sẽ được thêm vào. Đây là trường bắt buộc.

SitelinkExtensionParameters

Các thông số cần sử dụng khi áp dụng đề xuất về đường liên kết của trang web.

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

MoveUnusedBudgetParameters

Các thông số cần sử dụng khi áp dụng đề xuất chuyển ngân sách chưa sử dụng.

Biểu diễn dưới dạng JSON 
{
  "budgetMicrosToMove": string
}
Các trường
budgetMicrosToMove

string (int64 format)

Số tiền ngân sách cần chuyển từ ngân sách vượt quá sang ngân sách bị ràng buộc. Đây là trường bắt buộc.

ResponsiveSearchAdParameters

Các thông số cần sử dụng khi áp dụng một đề xuất về quảng cáo tìm kiếm thích ứng.

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

object (Ad)

Bắt buộc. Quảng cáo mới để thêm vào nhóm quảng cáo được đề xuất.

UseBroadMatchKeywordParameters

Các thông số nên sử dụng khi áp dụng đề xuất sử dụng từ khoá khớp mở rộng.

Biểu diễn dưới dạng JSON 
{
  "newBudgetAmountMicros": string
}
Các trường
newBudgetAmountMicros

string (int64 format)

Số tiền ngân sách mới cần đặt cho tài nguyên ngân sách mục tiêu.

ResponsiveSearchAdAssetParameters

Các thông số cần sử dụng khi áp dụng đề xuất về thành phần của quảng cáo tìm kiếm thích ứng.

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

object (Ad)

Đã cập nhật quảng cáo. Nội dung của quảng cáo hiện tại sẽ bị thay thế.

ResponsiveSearchAdImproveAdStrengthParameters

Các thông số cần sử dụng khi áp dụng quảng cáo tìm kiếm thích ứng sẽ giúp cải thiện đề xuất về độ mạnh của quảng cáo.

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

object (Ad)

Đã cập nhật quảng cáo. Nội dung của quảng cáo hiện tại sẽ bị thay thế.

RaiseTargetCpaBidTooLowParameters

Các thông số cần sử dụng khi áp dụng đề xuất tăng giá thầu CPA mục tiêu quá thấp. Quy trình áp dụng không đồng bộ và có thể mất vài phút tuỳ thuộc vào số lượng nhóm quảng cáo trong chiến dịch có liên quan.

Biểu diễn dưới dạng JSON 
{
  "targetMultiplier": number
}
Các trường
targetMultiplier

number

Bắt buộc. Một số lớn hơn 1,0 cho biết yếu tố làm tăng CPA mục tiêu. Đây là trường bắt buộc.

ForecastingSetTargetRoasParameters

Các thông số sẽ sử dụng khi áp dụng một đề xuất về lợi tức mục tiêu trên chi tiêu quảng cáo đã đặt theo mục tiêu dự báo.

Biểu diễn dưới dạng JSON 
{
  "targetRoas": number,
  "campaignBudgetAmountMicros": string
}
Các trường
targetRoas

number

ROAS mục tiêu mới (doanh thu trên mỗi đơn vị chi tiêu) để đặt cho một tài nguyên chiến dịch. Giá trị nằm trong khoảng từ 0,01 đến 1000,0.
campaignBudgetAmountMicros

string (int64 format)

Số tiền ngân sách mới của chiến dịch cần đặt cho một tài nguyên chiến dịch.

CalloutAssetParameters

Các thông số cần sử dụng khi áp dụng các đề xuất về thành phần chú thích.

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

object (AdAssetApplyParameters)

Bắt buộc. Thành phần chú thích cần được thêm. Đây là trường bắt buộc.

AdAssetApplyParameters

Các thông số thường dùng khi áp dụng các đề xuất về thành phần quảng cáo.

Biểu diễn dưới dạng JSON 
{
  "newAssets": [
    {
      object (Asset)
    }
  ],
  "existingAssets": [
    string
  ],
  "scope": enum (ApplyScope)
}
Các trường
newAssets[]

object (Asset)

Những thành phần cần tạo và đính kèm vào một phạm vi. Tài sản này có thể được kết hợp với tài sản hiện tại trong cùng một lệnh gọi.
existingAssets[]

string

Tên tài nguyên của những thành phần hiện có cần đính kèm vào một phạm vi. Tài sản này có thể được kết hợp với tài sản mới trong cùng một lệnh gọi.
scope

enum (ApplyScope)

Bắt buộc. Phạm vi áp dụng các thành phần. Các thành phần ở cấp phạm vi chiến dịch sẽ được áp dụng cho chiến dịch được liên kết với đề xuất. Các thành phần ở phạm vi khách hàng sẽ áp dụng cho toàn bộ tài khoản. Các thành phần ở phạm vi chiến dịch sẽ thay thế mọi thành phần được đính kèm ở phạm vi khách hàng.

ApplyScope

Phạm vi áp dụng các thành phần.

Enum
UNSPECIFIED Phạm vi áp dụng chưa được chỉ định.
UNKNOWN Không xác định.
CUSTOMER Áp dụng ở phạm vi khách hàng.
CAMPAIGN Hãy áp dụng ở phạm vi chiến dịch.

CallAssetParameters

Các thông số cần sử dụng khi áp dụng đề xuất về thành phần cuộc gọi.

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

object (AdAssetApplyParameters)

Bắt buộc. Những thành phần cuộc gọi cần được thêm vào. Đây là trường bắt buộc.

SitelinkAssetParameters

Các thông số cần sử dụng khi áp dụng đề xuất về thành phần đường liên kết của trang web.

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

object (AdAssetApplyParameters)

Bắt buộc. Thành phần đường liên kết của trang web sẽ được thêm vào. Đây là trường bắt buộc.

RaiseTargetCpaParameters

Các thông số cần sử dụng khi áp dụng đề xuất tăng CPA mục tiêu.

Biểu diễn dưới dạng JSON 
{
  "targetCpaMultiplier": number
}
Các trường
targetCpaMultiplier

number

Bắt buộc. Mục tiêu để đặt hệ số CPA. Đây là trường bắt buộc.

LowerTargetRoasParameters

Các thông số cần sử dụng khi áp dụng các đề xuất thấp hơn về lợi tức mục tiêu trên chi tiêu quảng cáo.

Biểu diễn dưới dạng JSON 
{
  "targetRoasMultiplier": number
}
Các trường
targetRoasMultiplier

number

Bắt buộc. Mục tiêu để đặt hệ số Lợi tức trên chi tiêu quảng cáo. Đây là trường bắt buộc.

ApplyRecommendationResult

Kết quả của việc áp dụng một đề xuất.

Biểu diễn dưới dạng JSON 
{
  "resourceName": string
}
Các trường
resourceName

string

Giá trị trả về nếu thành công sẽ được áp dụng.