- درخواست HTTP
- پارامترهای مسیر
- درخواست بدن
- بدن پاسخگو
- محدوده مجوز
- CampaignTo Forecast
- CriterionBidModifier
- Campaign Bidding Strategy
- ManualCpcBiddingStrategy
- MaximizeClicksBiddingStrategy
- MaximizeConversionsBiddingStrategy
- ForecastAdGroup
- BiddableKeyword
- کلید واژه ForecastMetrics
- آن را امتحان کنید!
معیارهای پیشبینی کلمه کلیدی را برای کمپین معین (مانند نمایشها، کلیکها، هزینه کل) برمیگرداند.
لیست خطاهای پرتاب شده: AuthenticationError AuthorizationError CollectionSizeError HeaderError داخلی خطا QuotaError RequestError
درخواست HTTP
POST https://googleads.googleapis.com/v15/customers/{customerId}:generateKeywordForecastMetrics
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای مسیر
مولفه های | |
---|---|
customerId | شناسه مشتری. |
درخواست بدن
بدنه درخواست حاوی داده هایی با ساختار زیر است:
نمایندگی JSON |
---|
{ "forecastPeriod": { object ( |
زمینه های | |
---|---|
forecastPeriod | محدوده تاریخ برای پیش بینی تاریخ شروع باید در آینده باشد و تاریخ پایان باید ظرف 1 سال از امروز باشد. منطقه زمانی مرجع مورد استفاده، یکی از حسابهای Google Ads متعلق به مشتری است. اگر تنظیم نشود، از یک محدوده تاریخ پیشفرض از یکشنبه آینده تا شنبه بعد استفاده میشود. |
campaign | ضروری. کمپین مورد استفاده در پیش بینی |
currencyCode | ارز مورد استفاده برای تبدیل نرخ ارز. به طور پیش فرض، ارز حساب مشتری استفاده می شود. این فیلد را فقط در صورتی تنظیم کنید که ارز با ارز حساب متفاوت باشد. فهرست کدهای ارز معتبر را میتوانید در https://developers.google.com/google-ads/api/data/codes-formats#currency-codes پیدا کنید. |
بدن پاسخگو
پیام پاسخ برای [KeywordPlanIdeaService.GenerateKeywordForecastMetrics].
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:
نمایندگی JSON |
---|
{
"campaignForecastMetrics": {
object ( |
زمینه های | |
---|---|
campaignForecastMetrics | نتایج پیش بینی کمپین |
محدوده مجوز
به محدوده OAuth زیر نیاز دارد:
-
https://www.googleapis.com/auth/adwords
برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.
CampaignTo Forecast
کمپینی برای انجام پیش بینی کمپین کلمه کلیدی.
نمایندگی JSON |
---|
{ "languageConstants": [ string ], "geoModifiers": [ { object ( |
زمینه های | |
---|---|
languageConstants[] | فهرست نام منابع زبان هایی که باید مورد هدف قرار گیرند. نام منبع از قالب "languageConstants/{criterionId}" است. برای مشاهده لیست کدهای معیار زبان به https://developers.google.com/google-ads/api/data/codes-formats#languages مراجعه کنید. |
geoModifiers[] | مکان هایی که باید هدف قرار گیرند. مکان ها باید منحصر به فرد باشند. |
keywordPlanNetwork | ضروری. شبکه ای که برای هدف گیری استفاده می شود. |
negativeKeywords[] | لیستی از کلمات کلیدی منفی که باید در کمپین هنگام انجام پیش بینی استفاده شوند. |
biddingStrategy | ضروری. استراتژی مناقصه برای کمپین. |
adGroups[] | گروه های تبلیغاتی در کمپین جدید پیش بینی می کنند. |
conversionRate | نرخ تبدیل مورد انتظار (تعداد تبدیل تقسیم بر تعداد کل کلیک ها) که توسط کاربر تعریف شده است. این مقدار به عنوان یک مقدار اعشاری بیان می شود، بنابراین نرخ تبدیل مورد انتظار 2٪ باید به عنوان 0.02 وارد شود. اگر خالی بماند، نرخ تبدیل تخمینی استفاده خواهد شد. |
CriterionBidModifier
تغییر دهنده پیشنهاد قیمت معیار مکان.
نمایندگی JSON |
---|
{ "geoTargetConstant": string, "bidModifier": number } |
زمینه های | |
---|---|
geoTargetConstant | نام منبع مکان جغرافیایی مورد نظر. نام منبع از قالب "geoTargetConstants/{criterionId}" است. |
bidModifier | ضریب مرتبط برای criterionId. اگر تنظیم شود، این مقدار نمی تواند 0 باشد. |
Campaign Bidding Strategy
پشتیبانی از استراتژیهای مناقصه برای پیشبینیهای کمپین جدید.
نمایندگی JSON |
---|
{ // Union field |
زمینه های | |
---|---|
bidding_strategy میدان اتحادیه . استراتژی های مناقصه bidding_strategy تنها می تواند یکی از موارد زیر باشد: | |
manualCpcBiddingStrategy | برای پیش بینی از استراتژی پیشنهاد قیمت CPC دستی استفاده کنید. |
maximizeClicksBiddingStrategy | برای پیشبینی از استراتژی پیشنهاد قیمت حداکثر کلیک استفاده کنید. |
maximizeConversionsBiddingStrategy | برای پیش بینی از استراتژی پیشنهاد قیمت تبدیل حداکثر استفاده کنید. |
ManualCpcBiddingStrategy
راهبرد مناقصه CPC دستی.
نمایندگی JSON |
---|
{ "maxCpcBidMicros": string, "dailyBudgetMicros": string } |
زمینه های | |
---|---|
maxCpcBidMicros | ضروری. پیشنهادی در میکرو برای استفاده از گروه های تبلیغاتی در کمپین برای استراتژی پیشنهاد قیمت دستی CPC. |
dailyBudgetMicros | بودجه سطح کمپین در میکرو. در صورت تنظیم، حداقل مقدار برای ارز محلی استفاده شده در کمپین اعمال می شود. اگر این فیلد خیلی کم تنظیم شود، خطایی رخ می دهد که حداقل مقدار را نشان می دهد. |
MaximizeClicksBiddingStrategy
استراتژی پیشنهاد قیمت کلیک ها را به حداکثر برسانید.
نمایندگی JSON |
---|
{ "dailyTargetSpendMicros": string, "maxCpcBidCeilingMicros": string } |
زمینه های | |
---|---|
dailyTargetSpendMicros | ضروری. هزینه هدف روزانه بر حسب میکرو که برای تخمین استفاده می شود. حداقل مقدار برای ارز محلی استفاده شده در کمپین اعمال می شود. اگر این فیلد خیلی کم تنظیم شود، خطایی رخ می دهد که حداقل مقدار را نشان می دهد. |
maxCpcBidCeilingMicros | سقف حداکثر پیشنهادات CPC در میکرو. |
MaximizeConversionsBiddingStrategy
استراتژی پیشنهاد قیمت تبدیل به حداکثر
نمایندگی JSON |
---|
{ "dailyTargetSpendMicros": string } |
زمینه های | |
---|---|
dailyTargetSpendMicros | ضروری. هزینه هدف روزانه بر حسب میکرو که برای تخمین استفاده می شود. این مقدار باید بزرگتر از صفر باشد. |
ForecastAdGroup
یک گروه تبلیغاتی که بخشی از یک کمپین قابل پیش بینی است.
نمایندگی JSON |
---|
{ "biddableKeywords": [ { object ( |
زمینه های | |
---|---|
biddableKeywords[] | ضروری. لیستی از کلمات کلیدی قابل پیشنهاد برای استفاده در گروه تبلیغاتی هنگام انجام پیش بینی. حداقل به یک کلمه کلیدی نیاز دارد. |
negativeKeywords[] | جزئیات کلمه کلیدی شما باید هم متن کلمه کلیدی و هم نوع مطابقت را مشخص کنید. |
maxCpcBidMicros | حداکثر cpc مورد استفاده برای گروه تبلیغات هنگام ایجاد ترافیک پیشبینیشده. این مقدار حداکثر مقدار cpc تنظیم شده در استراتژی مناقصه را لغو می کند. این فیلد را فقط برای استراتژیهای پیشنهادی که حداکثر مقدار cpc را دارند، مشخص کنید. |
BiddableKeyword
یک کلمه کلیدی قابل پیشنهاد بخشی از یک گروه تبلیغاتی.
نمایندگی JSON |
---|
{
"keyword": {
object ( |
زمینه های | |
---|---|
keyword | ضروری. کلمه کلیدی. باید متن و نوع مطابقت داشته باشد. |
maxCpcBidMicros | حداکثر پیشنهاد هزینه بر ارزش افزوده در میکرو که در شبیه سازی پیش بینی، بیشینه پیشنهاد هزینه بر ارزش افزوده سطح گروه آگهی را لغو می کند. این مقدار حداکثر مقدار cpc تنظیم شده در استراتژی مناقصه و گروه تبلیغات را لغو می کند. این فیلد را فقط برای استراتژیهای پیشنهادی که حداکثر مقدار cpc را پشتیبانی میکنند، مشخص کنید. |
کلید واژه ForecastMetrics
معیارهای پیشبینی برای کمپین کلمات کلیدی بدون برنامه
نمایندگی JSON |
---|
{ "impressions": number, "clickThroughRate": number, "averageCpcMicros": string, "clicks": number, "costMicros": string, "conversions": number, "conversionRate": number, "averageCpaMicros": string } |
زمینه های | |
---|---|
impressions | تعداد کل برداشت ها |
clickThroughRate | میانگین نرخ کلیک فقط در صورتی در دسترس است که نمایشها > 0 باشد. |
averageCpcMicros | میانگین cpc. فقط در صورت کلیک > 0 در دسترس است. |
clicks | تعداد کل کلیک ها |
costMicros | کل هزینه. |
conversions | تعداد پیشبینیشده تبدیل: کلیک * نرخ تبدیل. |
conversionRate | نرخ تبدیل پیش بینی شده |
averageCpaMicros | میانگین هزینه به ازای هر اکتساب محاسبه شده به عنوان costMicros / تبدیل. |