Method: customers.generateKeywordForecastMetrics

จะแสดงเมตริก (เช่น การแสดงผล จำนวนคลิก ค่าใช้จ่ายทั้งหมด) ของการคาดการณ์คีย์เวิร์ดสำหรับแคมเปญที่ระบุ

รายการข้อผิดพลาดที่พบ: AuthenticationError AuthorizationError CollectionSizeError HeaderError InternalError QuotaError RequestError

คำขอ HTTP

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

URL ใช้ไวยากรณ์การแปลง gRPC

พารามิเตอร์เส้นทาง

พารามิเตอร์
customerId

string

รหัสของลูกค้า

เนื้อหาของคำขอ

เนื้อหาของคำขอมีข้อมูลที่มีโครงสร้างต่อไปนี้

การแสดง JSON 
{
  "forecastPeriod": {
    object (DateRange)
  },
  "campaign": {
    object (CampaignToForecast)
  },
  "currencyCode": string
}
ช่อง
forecastPeriod

object (DateRange)

ช่วงวันที่สำหรับการคาดการณ์ วันที่เริ่มต้นต้องเป็นวันที่ในอนาคตและวันที่สิ้นสุดต้องอยู่ภายใน 1 ปีนับจากวันนี้ เขตเวลาอ้างอิงที่ใช้คือหนึ่งในบัญชี Google Ads ของลูกค้า หากไม่ได้ตั้งค่า ระบบจะใช้ช่วงวันที่เริ่มต้นตั้งแต่วันอาทิตย์หน้าถึงวันเสาร์ถัดไป
campaign

object (CampaignToForecast)

ต้องระบุ แคมเปญที่ใช้ในการคาดการณ์
currencyCode

string

สกุลเงินที่ใช้สำหรับการแปลงสกุลเงิน โดยค่าเริ่มต้น ระบบจะใช้สกุลเงินในบัญชีของลูกค้า ตั้งค่าช่องนี้เมื่อสกุลเงินแตกต่างจากสกุลเงินของบัญชีเท่านั้น โปรดดูรายการรหัสสกุลเงินที่ถูกต้องที่ https://developers.google.com/google-ads/api/data/codes-formats#currency-codes

เนื้อหาการตอบกลับ

ข้อความตอบกลับสำหรับ [KeywordPlanIdeaService.GenerateKeywordForecastMetrics]

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้

การแสดง JSON 
{
  "campaignForecastMetrics": {
    object (KeywordForecastMetrics)
  }
}
ช่อง
campaignForecastMetrics

object (KeywordForecastMetrics)

ผลลัพธ์ของการคาดการณ์แคมเปญ

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

  • https://www.googleapis.com/auth/adwords

ดูข้อมูลเพิ่มเติมได้ที่ภาพรวมของ OAuth 2.0

CampaignToForecast

แคมเปญที่จะทำการคาดการณ์แคมเปญคีย์เวิร์ด

การแสดง JSON 
{
  "languageConstants": [
    string
  ],
  "geoModifiers": [
    {
      object (CriterionBidModifier)
    }
  ],
  "keywordPlanNetwork": enum (KeywordPlanNetwork),
  "negativeKeywords": [
    {
      object (KeywordInfo)
    }
  ],
  "biddingStrategy": {
    object (CampaignBiddingStrategy)
  },
  "adGroups": [
    {
      object (ForecastAdGroup)
    }
  ],
  "conversionRate": number
}
ช่อง
languageConstants[]

string

รายการชื่อทรัพยากรของภาษาที่จะกำหนดเป้าหมาย ชื่อทรัพยากรจะอยู่ในรูปแบบ "languageConstants/{criterionId}" ดูรายการรหัสเกณฑ์ของภาษาได้ที่ https://developers.google.com/google-ads/api/data/codes-formats#languages
geoModifiers[]

object (CriterionBidModifier)

สถานที่ที่จะกำหนดเป้าหมาย สถานที่ต้องไม่ซ้ำกัน
keywordPlanNetwork

enum (KeywordPlanNetwork)

ต้องระบุ เครือข่ายที่ใช้สำหรับการกำหนดเป้าหมาย
negativeKeywords[]

object (KeywordInfo)

รายการคีย์เวิร์ดเชิงลบที่จะใช้ในแคมเปญเมื่อคาดการณ์
biddingStrategy

object (CampaignBiddingStrategy)

ต้องระบุ กลยุทธ์การเสนอราคาของแคมเปญ
adGroups[]

object (ForecastAdGroup)

กลุ่มโฆษณาในแคมเปญใหม่ที่จะคาดการณ์
conversionRate

number

อัตรา Conversion ที่คาดหวัง (จำนวน Conversion หารด้วยจำนวนคลิกทั้งหมด) ตามที่ผู้ใช้กำหนด ค่านี้จะแสดงเป็นค่าทศนิยม ดังนั้นควรป้อนอัตรา Conversion ที่คาดไว้ 2% เป็น 0.02 หากเว้นว่างไว้ ระบบจะใช้อัตรา Conversion โดยประมาณ

CriterionBidModifier

ตัวปรับราคาเสนอที่เป็นเกณฑ์สถานที่ตั้ง

การแสดง JSON 
{
  "geoTargetConstant": string,
  "bidModifier": number
}
ช่อง
geoTargetConstant

string

ชื่อทรัพยากรของตำแหน่งทางภูมิศาสตร์ที่จะกำหนดเป้าหมาย โดยชื่อทรัพยากรจะอยู่ในรูปแบบ "geoTargetConstants/{criterionId}"
bidModifier

number

ตัวคูณที่เกี่ยวข้องสำหรับ criterionId หากมีการตั้งค่า ค่านี้จะเป็น 0 ไม่ได้

CampaignBiddingStrategy

กลยุทธ์การเสนอราคาที่รองรับสำหรับการคาดการณ์แคมเปญใหม่

การแสดง 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.
}
ช่อง
ฟิลด์การรวม bidding_strategy กลยุทธ์การเสนอราคา bidding_strategy ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
manualCpcBiddingStrategy

object (ManualCpcBiddingStrategy)

ใช้กลยุทธ์การเสนอราคา CPC ด้วยตนเองสำหรับการคาดการณ์
maximizeClicksBiddingStrategy

object (MaximizeClicksBiddingStrategy)

ใช้กลยุทธ์การเสนอราคาแบบเพิ่มจำนวนคลิกสูงสุดในการคาดการณ์
maximizeConversionsBiddingStrategy

object (MaximizeConversionsBiddingStrategy)

ใช้กลยุทธ์การเสนอราคาแบบเพิ่มจำนวน Conversion สูงสุดสำหรับการคาดการณ์

ManualCpcBiddingStrategy

กลยุทธ์การเสนอราคา CPC ด้วยตนเอง

การแสดง JSON 
{
  "maxCpcBidMicros": string,
  "dailyBudgetMicros": string
}
ช่อง
maxCpcBidMicros

string (int64 format)

ต้องระบุ ราคาเสนอในหน่วยไมโครที่จะใช้กับกลุ่มโฆษณาภายในแคมเปญสำหรับกลยุทธ์การเสนอราคา CPC ด้วยตนเอง
dailyBudgetMicros

string (int64 format)

งบประมาณระดับแคมเปญในระดับไมโคร หากมีการตั้งค่า ระบบจะบังคับใช้ค่าต่ำสุดสำหรับสกุลเงินท้องถิ่นที่ใช้ในแคมเปญ เกิดข้อผิดพลาดขณะแสดงค่าต่ำสุดหากตั้งค่าช่องนี้ต่ำเกินไป

MaximizeClicksBiddingStrategy

กลยุทธ์การเสนอราคาแบบเพิ่มจำนวนคลิกสูงสุด

การแสดง JSON 
{
  "dailyTargetSpendMicros": string,
  "maxCpcBidCeilingMicros": string
}
ช่อง
dailyTargetSpendMicros

string (int64 format)

ต้องระบุ การใช้จ่ายเป้าหมายรายวันในระดับไมโครที่จะใช้ในการประมาณ ระบบจะบังคับใช้ค่าต่ำสุดสำหรับสกุลเงินท้องถิ่นที่ใช้ในแคมเปญ เกิดข้อผิดพลาดขณะแสดงค่าต่ำสุดหากตั้งค่าช่องนี้ต่ำเกินไป
maxCpcBidCeilingMicros

string (int64 format)

เพดานราคาเสนอ CPC สูงสุดในระดับไมโคร

MaximizeConversionsBiddingStrategy

กลยุทธ์การเสนอราคาแบบเพิ่มจำนวน Conversion สูงสุด

การแสดง JSON 
{
  "dailyTargetSpendMicros": string
}
ช่อง
dailyTargetSpendMicros

string (int64 format)

ต้องระบุ การใช้จ่ายเป้าหมายรายวันในระดับไมโครที่จะใช้ในการประมาณ ค่านี้ต้องมากกว่า 0

ForecastAdGroup

กลุ่มโฆษณาที่เป็นส่วนหนึ่งของแคมเปญที่จะคาดการณ์

การแสดง JSON 
{
  "biddableKeywords": [
    {
      object (BiddableKeyword)
    }
  ],
  "negativeKeywords": [
    {
      object (KeywordInfo)
    }
  ],
  "maxCpcBidMicros": string
}
ช่อง
biddableKeywords[]

object (BiddableKeyword)

ต้องระบุ รายการคีย์เวิร์ดที่เสนอราคาได้ซึ่งจะใช้ในกลุ่มโฆษณาเมื่อคาดการณ์ ต้องใช้คีย์เวิร์ดอย่างน้อย 1 คำ
negativeKeywords[]

object (KeywordInfo)

รายละเอียดคีย์เวิร์ด คุณควรระบุทั้งข้อความคีย์เวิร์ดและประเภทการทำงานของคีย์เวิร์ด
maxCpcBidMicros

string (int64 format)

CPC สูงสุดที่จะใช้สำหรับกลุ่มโฆษณาเมื่อสร้างการเข้าชมที่คาดการณ์ ค่านี้จะลบล้างค่า CPC สูงสุดที่กำหนดไว้ในกลยุทธ์การเสนอราคา ระบุช่องนี้สำหรับกลยุทธ์การเสนอราคาที่มีมูลค่า CPC สูงสุดเท่านั้น

BiddableKeyword

ส่วนคีย์เวิร์ดที่เสนอราคาได้ของกลุ่มโฆษณา

การแสดง JSON 
{
  "keyword": {
    object (KeywordInfo)
  },
  "maxCpcBidMicros": string
}
ช่อง
keyword

object (KeywordInfo)

ต้องระบุ คีย์เวิร์ด ต้องมีข้อความและประเภทการทำงาน
maxCpcBidMicros

string (int64 format)

ราคาเสนอ CPC สูงสุดในระดับไมโครที่ลบล้างราคาเสนอ CPC สูงสุดระดับกลุ่มโฆษณาในการจำลองการคาดการณ์ ค่านี้จะลบล้างค่า CPC สูงสุดที่ตั้งค่าไว้ในกลยุทธ์การเสนอราคาและกลุ่มโฆษณา ระบุช่องนี้สำหรับกลยุทธ์การเสนอราคาที่รองรับมูลค่า CPC สูงสุดเท่านั้น

KeywordForecastMetrics

เมตริกการคาดการณ์สำหรับแคมเปญคีย์เวิร์ดที่ไม่มีแผน

การแสดง JSON 
{
  "impressions": number,
  "clickThroughRate": number,
  "averageCpcMicros": string,
  "clicks": number,
  "costMicros": string,
  "conversions": number,
  "conversionRate": number,
  "averageCpaMicros": string
}
ช่อง
impressions

number

จำนวนการแสดงผลทั้งหมด
clickThroughRate

number

อัตราการคลิกผ่านโดยเฉลี่ย ใช้ได้เมื่อการแสดงผล > 0 เท่านั้น
averageCpcMicros

string (int64 format)

CPC เฉลี่ย ใช้ได้เฉพาะเมื่อคลิก > 0
clicks

number

จำนวนคลิกทั้งหมด
costMicros

string (int64 format)

ค่าใช้จ่ายทั้งหมด
conversions

number

จำนวน Conversion ที่คาดการณ์: การคลิก * อัตรา Conversion
conversionRate

number

อัตรา Conversion ที่คาดการณ์
averageCpaMicros

string (int64 format)

ต้นทุนต่อการกระทำหนึ่งครั้งโดยเฉลี่ยที่คํานวณเป็น CostMicros / Conversion