Method: customers.generateKeywordForecastMetrics

معیارهای پیش‌بینی کلمه کلیدی را برای کمپین معین (مانند نمایش‌ها، کلیک‌ها، هزینه کل) برمی‌گرداند.

لیست خطاهای پرتاب شده: AuthenticationError AuthorizationError CollectionSizeError HeaderError داخلی خطا QuotaError RequestError

درخواست HTTP

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

URL از دستور GRPC Transcoding استفاده می کند.

پارامترهای مسیر

مولفه های
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 مراجعه کنید.

CampaignTo Forecast

کمپینی برای انجام پیش بینی کمپین کلمه کلیدی.

نمایندگی 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

نرخ تبدیل مورد انتظار (تعداد تبدیل تقسیم بر تعداد کل کلیک ها) که توسط کاربر تعریف شده است. این مقدار به عنوان یک مقدار اعشاری بیان می شود، بنابراین نرخ تبدیل مورد انتظار 2٪ باید به عنوان 0.02 وارد شود. اگر خالی بماند، نرخ تبدیل تخمینی استفاده خواهد شد.

CriterionBidModifier

تغییر دهنده پیشنهاد قیمت معیار مکان.

نمایندگی JSON
{
  "geoTargetConstant": string,
  "bidModifier": number
}
زمینه های
geoTargetConstant

string

نام منبع مکان جغرافیایی مورد نظر. نام منبع از قالب "geoTargetConstants/{criterionId}" است.

bidModifier

number

ضریب مرتبط برای criterionId. اگر تنظیم شود، این مقدار نمی تواند 0 باشد.

Campaign Bidding Strategy

پشتیبانی از استراتژی‌های مناقصه برای پیش‌بینی‌های کمپین جدید.

نمایندگی 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 )

برای پیش بینی از استراتژی پیشنهاد قیمت تبدیل حداکثر استفاده کنید.

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

استراتژی پیشنهاد قیمت تبدیل به حداکثر

نمایندگی JSON
{
  "dailyTargetSpendMicros": string
}
زمینه های
dailyTargetSpendMicros

string ( int64 format)

ضروری. هزینه هدف روزانه بر حسب میکرو که برای تخمین استفاده می شود. این مقدار باید بزرگتر از صفر باشد.

ForecastAdGroup

یک گروه تبلیغاتی که بخشی از یک کمپین قابل پیش بینی است.

نمایندگی JSON
{
  "biddableKeywords": [
    {
      object (BiddableKeyword)
    }
  ],
  "negativeKeywords": [
    {
      object (KeywordInfo)
    }
  ],
  "maxCpcBidMicros": string
}
زمینه های
biddableKeywords[]

object ( BiddableKeyword )

ضروری. لیستی از کلمات کلیدی قابل پیشنهاد برای استفاده در گروه تبلیغاتی هنگام انجام پیش بینی. حداقل به یک کلمه کلیدی نیاز دارد.

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 را پشتیبانی می‌کنند، مشخص کنید.

کلید واژه ForecastMetrics

معیارهای پیش‌بینی برای کمپین کلمات کلیدی بدون برنامه

نمایندگی 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

تعداد پیش‌بینی‌شده تبدیل: کلیک * نرخ تبدیل.

conversionRate

number

نرخ تبدیل پیش بینی شده

averageCpaMicros

string ( int64 format)

میانگین هزینه به ازای هر اکتساب محاسبه شده به عنوان costMicros / تبدیل.