Method: customers.generateKeywordForecastMetrics

প্রদত্ত প্রচারাভিযানের জন্য একটি কীওয়ার্ড পূর্বাভাসের মেট্রিক্স (যেমন ইমপ্রেশন, ক্লিক, মোট খরচ) প্রদান করে।

নিক্ষিপ্ত ত্রুটির তালিকা: প্রমাণীকরণ ত্রুটি অনুমোদন ত্রুটি সংগ্রহ সাইজ ত্রুটি হেডার ত্রুটি অভ্যন্তরীণ ত্রুটি কোটা ত্রুটি অনুরোধ ত্রুটি

HTTP অনুরোধ

POST https://googleads.googleapis.com/v16/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 ওভারভিউ দেখুন।

প্রচারণার পূর্বাভাস

একটি কিওয়ার্ড প্রচারাভিযান পূর্বাভাস করতে একটি প্রচারাভিযান.

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 হিসাবে প্রবেশ করা উচিত। খালি থাকলে, একটি আনুমানিক রূপান্তর হার ব্যবহার করা হবে।

মানদণ্ড বিডমোডিফায়ার

অবস্থানের মানদণ্ড বিড সংশোধক।

JSON প্রতিনিধিত্ব
{
  "geoTargetConstant": string,
  "bidModifier": number
}
ক্ষেত্র
geoTargetConstant

string

লক্ষ্য করার জন্য জিও অবস্থানের সম্পদের নাম। সম্পদের নাম "geoTargetConstants/{criterionId}" ফরম্যাটের।

bidModifier

number

criterionId-এর জন্য সংশ্লিষ্ট গুণক। সেট করা হলে, এই মান 0 হতে পারে না।

প্রচারাভিযান বিডিং কৌশল

নতুন প্রচারাভিযানের পূর্বাভাসের জন্য সমর্থিত বিডিং কৌশল।

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 )

পূর্বাভাসের জন্য সর্বাধিক রূপান্তর বিডিং কৌশল ব্যবহার করুন।

ManualCpcBidding Strategy

ম্যানুয়াল CPC বিডিং কৌশল।

JSON প্রতিনিধিত্ব
{
  "maxCpcBidMicros": string,
  "dailyBudgetMicros": string
}
ক্ষেত্র
maxCpcBidMicros

string ( int64 format)

প্রয়োজন। একটি ম্যানুয়াল CPC বিডিং কৌশলের জন্য প্রচারাভিযানের মধ্যে বিজ্ঞাপন গোষ্ঠীগুলিতে প্রয়োগ করতে মাইক্রোতে একটি বিড।

dailyBudgetMicros

string ( int64 format)

মাইক্রোতে প্রচারাভিযানের স্তরের বাজেট। সেট করা হলে, প্রচারে ব্যবহৃত স্থানীয় মুদ্রার জন্য একটি ন্যূনতম মান প্রয়োগ করা হয়। এই ক্ষেত্রটি খুব কম সেট করা থাকলে ন্যূনতম মান দেখানো একটি ত্রুটি ঘটবে৷

MaximizeClicksBidding Strategy

সর্বাধিক ক্লিক বিডিং কৌশল.

JSON প্রতিনিধিত্ব
{
  "dailyTargetSpendMicros": string,
  "maxCpcBidCeilingMicros": string
}
ক্ষেত্র
dailyTargetSpendMicros

string ( int64 format)

প্রয়োজন। অনুমানের জন্য ব্যবহার করা মাইক্রোতে দৈনিক লক্ষ্য ব্যয়। প্রচারাভিযানে ব্যবহৃত স্থানীয় মুদ্রার জন্য একটি ন্যূনতম মান প্রয়োগ করা হয়। এই ক্ষেত্রটি খুব কম সেট করা থাকলে ন্যূনতম মান দেখানো একটি ত্রুটি ঘটবে৷

maxCpcBidCeilingMicros

string ( int64 format)

মাইক্রোতে সর্বোচ্চ CPC বিডের সর্বোচ্চ সীমা।

Maximize ConversionsBidding Strategy

সর্বাধিক রূপান্তর বিডিং কৌশল।

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 মান বিডিং কৌশলগুলির জন্য শুধুমাত্র এই ক্ষেত্রটি নির্দিষ্ট করুন৷

বিডযোগ্য কীওয়ার্ড

একটি বিজ্ঞাপন গোষ্ঠীর একটি বিডযোগ্য কীওয়ার্ড অংশ।

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

রূপান্তরের পূর্বাভাসিত সংখ্যা: ক্লিক * রূপান্তর হার।

conversionRate

number

পূর্বাভাসিত রূপান্তর হার।

averageCpaMicros

string ( int64 format)

প্রতি অধিগ্রহণের গড় খরচ CostMicros / রূপান্তর হিসাবে গণনা করা হয়।