Method: customers.generateKeywordForecastMetrics

Trả về các chỉ số (chẳng hạn như số lượt hiển thị, số lượt nhấp, tổng chi phí) của thông tin dự đoán về từ khoá cho một chiến dịch nhất định.

Danh sách lỗi được tạo ra: AuthenticationError AuthorizationError CollectionSizeError HeaderError InternalError QuotaError RequestError

Yêu cầu HTTP

POST https://googleads.googleapis.com/v15/customers/{customerId}:generateKeywordForecastMetrics

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số đường dẫn

Các tham số
customerId

string

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 
{
  "forecastPeriod": {
    object (DateRange)
  },
  "campaign": {
    object (CampaignToForecast)
  },
  "currencyCode": string
}
Các trường
forecastPeriod

object (DateRange)

Phạm vi ngày cho thông tin dự đoán. Ngày bắt đầu phải trong tương lai và ngày kết thúc phải trong vòng 1 năm tính từ hôm nay. Múi giờ tham chiếu được sử dụng là múi giờ trong tài khoản Google Ads của khách hàng. Nếu bạn không đặt chính sách này, hệ thống sẽ sử dụng phạm vi ngày mặc định từ Chủ Nhật tới đến thứ Bảy tuần sau.
campaign

object (CampaignToForecast)

Bắt buộc. Chiến dịch được dùng trong thông tin dự đoán.
currencyCode

string

Đơn vị tiền tệ dùng để quy đổi tỷ giá hối đoái. Theo mặc định, đơn vị tiền tệ trong tài khoản của khách hàng sẽ được sử dụng. Chỉ thiết lập trường này nếu đơn vị tiền tệ khác với đơn vị tiền tệ của tài khoản. Bạn có thể tìm thấy danh sách mã đơn vị tiền tệ hợp lệ tại https://developers.google.com/google-ads/api/data/codes-formats#currency-codes.

Nội dung phản hồi

Thông báo phản hồi cho [KeywordPlanIdeaService.GenerateKeywordForecastMetrics].

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 
{
  "campaignForecastMetrics": {
    object (KeywordForecastMetrics)
  }
}
Các trường
campaignForecastMetrics

object (KeywordForecastMetrics)

Kết quả dự đoán về chiến dịch.

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.

CampaignToForecast

Một chiến dịch để dự đoán chiến dịch từ khoá.

Biểu diễn dưới dạng JSON 
{
  "languageConstants": [
    string
  ],
  "geoModifiers": [
    {
      object (CriterionBidModifier)
    }
  ],
  "keywordPlanNetwork": enum (KeywordPlanNetwork),
  "negativeKeywords": [
    {
      object (KeywordInfo)
    }
  ],
  "biddingStrategy": {
    object (CampaignBiddingStrategy)
  },
  "adGroups": [
    {
      object (ForecastAdGroup)
    }
  ],
  "conversionRate": number
}
Các trường
languageConstants[]

string

Danh sách tên tài nguyên của các ngôn ngữ sẽ được nhắm mục tiêu. Tên tài nguyên có định dạng "languageConstants/{criterionId}". Hãy truy cập vào https://developers.google.com/google-ads/api/data/codes-formats#languages để xem danh sách mã tiêu chí ngôn ngữ.
geoModifiers[]

object (CriterionBidModifier)

Vị trí sẽ được nhắm mục tiêu. Các vị trí phải là duy nhất.
keywordPlanNetwork

enum (KeywordPlanNetwork)

Bắt buộc. Mạng dùng để nhắm mục tiêu.
negativeKeywords[]

object (KeywordInfo)

Danh sách từ khoá phủ định dùng trong chiến dịch khi dự đoán.
biddingStrategy

object (CampaignBiddingStrategy)

Bắt buộc. Chiến lược đặt giá thầu cho chiến dịch.
adGroups[]

object (ForecastAdGroup)

Các nhóm quảng cáo trong chiến dịch mới cần dự đoán.
conversionRate

number

Tỷ lệ chuyển đổi dự kiến (số chuyển đổi chia cho tổng số lượt nhấp) do người dùng xác định. Giá trị này được biểu thị bằng số thập phân.Do đó, bạn nên nhập tỷ lệ chuyển đổi dự kiến là 2% là 0,02. Nếu để trống, hệ thống sẽ sử dụng tỷ lệ chuyển đổi ước tính.

CriterionBidModifier

Hệ số sửa đổi giá thầu của Tiêu chí vị trí.

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

string

Tên tài nguyên của vị trí địa lý cần nhắm mục tiêu. Tên tài nguyên có định dạng "geoTargetConstants/{criterionId}".
bidModifier

number

Hệ số được liên kết cho mã tiêu chí. Nếu được đặt, giá trị này không được bằng 0.

CampaignBiddingStrategy

Các chiến lược đặt giá thầu được hỗ trợ cho thông tin dự đoán về chiến dịch mới.

Biểu diễn dưới dạng JSON 
{

  // Union field bidding_strategy can be only one of the following:
  "manualCpcBiddingStrategy": {
    object (ManualCpcBiddingStrategy)
  },
  "maximizeClicksBiddingStrategy": {
    object (MaximizeClicksBiddingStrategy)
  },
  "maximizeConversionsBiddingStrategy": {
    object (MaximizeConversionsBiddingStrategy)
  }
  // End of list of possible types for union field bidding_strategy.
}
Các trường
Trường nhóm bidding_strategy. Chiến lược đặt giá thầu. bidding_strategy chỉ có thể là một trong những trạng thái sau đây:
manualCpcBiddingStrategy

object (ManualCpcBiddingStrategy)

Sử dụng chiến lược đặt giá thầu CPC thủ công để dự đoán.
maximizeClicksBiddingStrategy

object (MaximizeClicksBiddingStrategy)

Sử dụng chiến lược đặt giá thầu tối đa hoá số lượt nhấp để dự đoán.
maximizeConversionsBiddingStrategy

object (MaximizeConversionsBiddingStrategy)

Sử dụng chiến lược đặt giá thầu tối đa hoá lượt chuyển đổi để dự đoán.

ManualCpcBiddingStrategy

Chiến lược đặt giá thầu CPC thủ công.

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

string (int64 format)

Bắt buộc. Giá thầu cực nhỏ được áp dụng cho các nhóm quảng cáo trong chiến dịch cho chiến lược đặt giá thầu CPC thủ công.
dailyBudgetMicros

string (int64 format)

Ngân sách cấp chiến dịch cực nhỏ. Nếu bạn đặt giá trị này, hệ thống sẽ thực thi một giá trị tối thiểu cho nội tệ dùng trong chiến dịch. Lỗi sẽ xảy ra khi hiển thị giá trị tối thiểu nếu bạn đặt trường này quá thấp.

MaximizeClicksBiddingStrategy

Chiến lược đặt giá thầu tối đa hoá số lượt nhấp.

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

string (int64 format)

Bắt buộc. Mức chi tiêu mục tiêu hằng ngày cực nhỏ dùng để ước tính. Bạn phải đặt một giá trị tối thiểu cho nội tệ dùng trong chiến dịch. Lỗi sẽ xảy ra khi hiển thị giá trị tối thiểu nếu bạn đặt trường này quá thấp.
maxCpcBidCeilingMicros

string (int64 format)

Giá trần trên giá thầu CPC tối đa tính bằng micrô giây.

MaximizeConversionsBiddingStrategy

Chiến lược đặt giá thầu tối đa hoá lượt chuyển đổi.

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

string (int64 format)

Bắt buộc. Mức chi tiêu mục tiêu hằng ngày cực nhỏ dùng để ước tính. Giá trị này phải lớn hơn 0.

ForecastAdGroup

Nhóm quảng cáo thuộc một chiến dịch cần được dự đoán.

Biểu diễn dưới dạng JSON 
{
  "biddableKeywords": [
    {
      object (BiddableKeyword)
    }
  ],
  "negativeKeywords": [
    {
      object (KeywordInfo)
    }
  ],
  "maxCpcBidMicros": string
}
Các trường
biddableKeywords[]

object (BiddableKeyword)

Bắt buộc. Danh sách từ khoá có thể đặt giá thầu được sử dụng trong nhóm quảng cáo khi thực hiện dự đoán. Yêu cầu ít nhất một từ khóa.
negativeKeywords[]

object (KeywordInfo)

Chi tiết về từ khoá. Bạn nên chỉ định cả văn bản từ khoá và kiểu khớp.
maxCpcBidMicros

string (int64 format)

Cpc tối đa để sử dụng cho nhóm quảng cáo khi tạo lưu lượng truy cập dự báo. Giá trị này sẽ ghi đè giá trị cpc tối đa được đặt trong chiến lược đặt giá thầu. Chỉ chỉ định trường này cho những chiến lược đặt giá thầu có giá trị cpc tối đa.

BiddableKeyword

Một phần của từ khoá có thể đặt giá thầu trong một nhóm quảng cáo.

Biểu diễn dưới dạng JSON 
{
  "keyword": {
    object (KeywordInfo)
  },
  "maxCpcBidMicros": string
}
Các trường
keyword

object (KeywordInfo)

Bắt buộc. Từ khoá. Phải có văn bản và loại đối sánh.
maxCpcBidMicros

string (int64 format)

Giá thầu cpc tối đa cực nhỏ sẽ ghi đè giá thầu cpc tối đa cấp nhóm quảng cáo trong mô phỏng dự báo. Giá trị này sẽ ghi đè giá trị cpc tối đa được đặt trong chiến lược đặt giá thầu và nhóm quảng cáo. Chỉ chỉ định trường này cho những chiến lược đặt giá thầu hỗ trợ giá trị cpc tối đa.

KeywordForecastMetrics

Các chỉ số dự báo cho chiến dịch từ khoá không kế hoạch.

Biểu diễn dưới dạng JSON 
{
  "impressions": number,
  "clickThroughRate": number,
  "averageCpcMicros": string,
  "clicks": number,
  "costMicros": string,
  "conversions": number,
  "conversionRate": number,
  "averageCpaMicros": string
}
Các trường
impressions

number

Tổng số lượt hiển thị.
clickThroughRate

number

Tỷ lệ nhấp trung bình. Chỉ có sẵn nếu số lượt hiển thị > 0.
averageCpcMicros

string (int64 format)

Cpc trung bình. Chỉ có sẵn nếu số lượt nhấp > 0.
clicks

number

Tổng số lượt nhấp.
costMicros

string (int64 format)

Tổng chi phí.
conversions

number

Số lượt chuyển đổi dự kiến: số lượt nhấp * tỷ lệ chuyển đổi.
conversionRate

number

Tỷ lệ chuyển đổi dự kiến.
averageCpaMicros

string (int64 format)

Chi phí thu nạp khách hàng trung bình được tính bằng chi phí siêu nhỏ / lượt chuyển đổi.