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 các lỗi đã gửi: AuthenticationError AuthorizationError CollectionSizeError HeaderError InternalError QuotaError RequestError

Yêu cầu HTTP

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

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

Tham số đường dẫn

Tham số
customerId

string

Mã 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
}
Trường
forecastPeriod

object (DateRange)

Phạm vi ngày cho thông tin dự đoán. Ngày bắt đầu phải là ngày 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ờ của 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, thì phạm vi ngày mặc định từ Chủ Nhật tới đến thứ Bảy tuần sau sẽ được sử dụng.
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)
  }
}
Trường
campaignForecastMetrics

object (KeywordForecastMetrics)

Kết quả dự đoán 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

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
}
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í được nhắm mục tiêu. Vị trí phải là duy nhất.
keywordPlanNetwork

enum (KeywordPlanNetwork)

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

object (KeywordInfo)

Danh sách từ khoá phủ định sẽ dùng trong chiến dịch khi thực hiện 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 giá trị 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

Công cụ sửa đổi giá thầu Tiêu chí vị trí.

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

string

Tên tài nguyên của vị trí địa lý để 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 mới về chiến dịch.

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.
}
Trường
Trường hợp 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:
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
}
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 trong phần cực nhỏ. Nếu bạn đặt giá trị tối thiểu, hệ thống sẽ thực thi giá trị tối thiểu cho nội tệ được dùng trong chiến dịch. Sẽ xảy ra lỗi 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
}
Trường
dailyTargetSpendMicros

string (int64 format)

Bắt buộc. Mức chi tiêu mục tiêu hằng ngày tính theo phần triệu được sử dụng để ước tính. Hệ thống sẽ áp dụng giá trị tối thiểu cho nội tệ được sử dụng trong chiến dịch. Sẽ xảy ra lỗi 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 cho 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
}
Trường
dailyTargetSpendMicros

string (int64 format)

Bắt buộc. Mức chi tiêu mục tiêu hằng ngày tính theo phần triệu được sử dụng để ước tính. Giá trị này phải lớn hơn 0.

ForecastAdGroup

Nhóm quảng cáo là một phần của chiến dịch được dự đoán.

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

object (BiddableKeyword)

Bắt buộc. Danh sách từ khoá có thể đặt giá thầu sẽ được 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)

Thông tin 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 từ khoá có thể đặt giá thầu trong nhóm quảng cáo.

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

object (KeywordInfo)

Bắt buộc. Từ khoá. Phải có văn bản và kiểu khớp.
maxCpcBidMicros

string (int64 format)

Giá thầu cpc tối đa tính bằng micros 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 các chiến lược đặt giá thầu hỗ trợ giá trị cpc tối đa.

KeywordForecastMetrics

Chỉ số dự báo cho chiến dịch từ khoá không có 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
}
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í Micro nhỏ / số lượt chuyển đổi.