Method: customers.recommendations.generate

অনুরোধ করা সুপারিশ প্রকারের উপর ভিত্তি করে সুপারিশ তৈরি করে।

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

HTTP অনুরোধ

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

URL gRPC ট্রান্সকোডিং সিনট্যাক্স ব্যবহার করে।

পাথ প্যারামিটার

পরামিতি
customerId

string

প্রয়োজন। প্রস্তাবনা তৈরি করা গ্রাহকের আইডি।

শরীরের অনুরোধ

অনুরোধের অংশে নিম্নলিখিত কাঠামো সহ ডেটা রয়েছে:

JSON প্রতিনিধিত্ব
{
  "recommendationTypes": [
    enum (RecommendationType)
  ],
  "advertisingChannelType": enum (AdvertisingChannelType),
  "adGroupInfo": [
    {
      object (AdGroupInfo)
    }
  ],
  "campaignSitelinkCount": integer,
  "conversionTrackingStatus": enum (ConversionTrackingStatus),
  "biddingInfo": {
    object (BiddingInfo)
  },
  "seedInfo": {
    object (SeedInfo)
  }
}
ক্ষেত্র
recommendationTypes[]

enum ( RecommendationType )

প্রয়োজন। তৈরি করার জন্য যোগ্য সুপারিশের প্রকারের তালিকা। যদি আপলোড করা মানদণ্ড সুপারিশ করার জন্য যথেষ্ট না হয়, বা প্রচারণাটি ইতিমধ্যেই প্রস্তাবিত অবস্থায় থাকে, তাহলে সেই ধরনের জন্য কোনো সুপারিশ ফেরত দেওয়া হবে না। সাধারণত, সেই সুপারিশের প্রকারের জন্য সমস্ত প্রয়োজনীয় ক্ষেত্র আপলোড করা হলে একটি সুপারিশ ফেরত দেওয়া হয়, কিন্তু কিছু ক্ষেত্রে এটি এখনও যথেষ্ট নয়।

নিম্নলিখিত সুপারিশের প্রকারগুলি সুপারিশ তৈরির জন্য সমর্থিত: KEYWORD, MAXIMIZE_CLICKS_OPT_IN, MAXIMIZE_CONVERSIONS_OPT_IN, MAXIMIZE_CONVERSION_VALUE_OPT_IN, SET_TARGET_CPA, SET_TARGETC, SET_TARGET_CPA, SET_TARGETC, T_OPTARGS, T_OPT_ARGET _ROAS_OPT_IN

advertisingChannelType

enum ( AdvertisingChannelType )

প্রয়োজন। প্রচারাভিযানের বিজ্ঞাপন চ্যানেলের ধরন। নিম্নলিখিত বিজ্ঞাপনের চ্যানেলের প্রকারগুলি সুপারিশ তৈরির জন্য সমর্থিত: PERFORMANCE_MAX এবং SEARCH

adGroupInfo[]

object ( AdGroupInfo )

ঐচ্ছিক। বর্তমান অ্যাডগ্রুপ তথ্য। একটি একক AdGroup থেকে তথ্য সমর্থন করে। এই ক্ষেত্রটি নিম্নলিখিত সুপারিশের প্রকারের জন্য ঐচ্ছিক: কীওয়ার্ড

conversionTrackingStatus

enum ( ConversionTrackingStatus )

ঐচ্ছিক। বর্তমান রূপান্তর ট্র্যাকিং অবস্থা. এই ক্ষেত্রটি নিম্নলিখিত ধরণের সুপারিশগুলির জন্য প্রয়োজনীয়: MAXIMIZE_CLICKS_OPT_IN, MAXIMIZE_CONVERSIONS_OPT_IN, MAXIMIZE_CONVERSION_VALUE_OPT_IN, SET_TARGET_CPA, SET_TARGET_ROAS, TARGET_CLICKS_OPT_ARPA, TARGET_TARGET_ROAS

biddingInfo

object ( BiddingInfo )

ঐচ্ছিক। প্রচারণার বর্তমান বিডিং তথ্য। এই ক্ষেত্রটি নিম্নলিখিত ধরণের সুপারিশগুলির জন্য প্রয়োজনীয়: MAXIMIZE_CLICKS_OPT_IN, MAXIMIZE_CONVERSIONS_OPT_IN, MAXIMIZE_CONVERSION_VALUE_OPT_IN, SET_TARGET_CPA, SET_TARGET_ROAS, TARGET_CLICKS_OPT_ARPA, TARGET_TARGET_ROAS

seedInfo

object ( SeedInfo )

ঐচ্ছিক। কীওয়ার্ডের জন্য বীজ তথ্য। এই ক্ষেত্রটি নিম্নলিখিত ধরনের সুপারিশের জন্য প্রয়োজনীয়: KEYWORD

প্রতিক্রিয়া শরীর

RecommendationService.GenerateRecommendations এর জন্য প্রতিক্রিয়া বার্তা।

সফল হলে, প্রতিক্রিয়া বডিতে নিম্নলিখিত কাঠামোর সাথে ডেটা থাকে:

JSON প্রতিনিধিত্ব
{
  "recommendations": [
    {
      object (Recommendation)
    }
  ]
}
ক্ষেত্র
recommendations[]

object ( Recommendation )

অনুরোধকৃত সুপারিশ প্রকারের সেটে পাস করা থেকে জেনারেট করা সুপারিশের তালিকা। অনুরোধ করা সুপারিশের প্রকারের জন্য সুপারিশ তৈরি করার জন্য পর্যাপ্ত ডেটা না থাকলে, ফলাফল সেটে সেই ধরনের সুপারিশ থাকবে না।

অনুমোদনের সুযোগ

নিম্নলিখিত OAuth সুযোগ প্রয়োজন:

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

আরও তথ্যের জন্য, OAuth 2.0 ওভারভিউ দেখুন।

বিডিং ইনফো

প্রচারণার বর্তমান বিডিং তথ্য। বিডিং-সম্পর্কিত সংকেতগুলির জন্য একটি মোড়ক প্রদান করে যা সুপারিশগুলি জানায়৷

JSON প্রতিনিধিত্ব
{
  "biddingStrategyType": enum (BiddingStrategyType),

  // Union field bidding_strategy_target_info can be only one of the following:
  "targetCpaMicros": string,
  "targetRoas": number
  // End of list of possible types for union field bidding_strategy_target_info.
}
ক্ষেত্র
biddingStrategyType

enum ( BiddingStrategyType )

বর্তমান বিডিং কৌশল। এই ক্ষেত্রটি নিম্নলিখিত ধরণের সুপারিশগুলির জন্য প্রয়োজনীয়: MAXIMIZE_CLICKS_OPT_IN, MAXIMIZE_CONVERSIONS_OPT_IN, MAXIMIZE_CONVERSION_VALUE_OPT_IN, SET_TARGET_CPA, SET_TARGET_ROAS, TARGET_CLICKS_OPT_ARPA, TARGET_TARGET_ROAS

ইউনিয়ন ফিল্ড bidding_strategy_target_info । বিডিং_স্ট্র্যাটেজি_টাইপ সম্পর্কিত ঐচ্ছিক বিবরণ। bidding_strategy_target_info নিম্নলিখিতগুলির মধ্যে একটি হতে পারে:
targetCpaMicros

string ( int64 format)

মাইক্রোতে বর্তমান টার্গেটসিপিএ। এটি TARGET_CPA বা MAXIMIZE_CONVERSIONS ধরনের বিডিং কৌশল সহ প্রচারাভিযানের জন্য পপুলেট করা যেতে পারে৷

targetRoas

number

বর্তমান লক্ষ্য Roas. এটি TARGET_ROAS বা MAXIMIZE_CONVERSION_VALUE এর একটি বিডিং কৌশল সহ প্রচারাভিযানের জন্য পপুলেট করা যেতে পারে৷

AdGroupInfo

প্রচারণার বর্তমান অ্যাডগ্রুপ তথ্য।

JSON প্রতিনিধিত্ব
{
  "keywords": [
    {
      object (KeywordInfo)
    }
  ],
  "adGroupType": enum (AdGroupType)
}
ক্ষেত্র
keywords[]

object ( KeywordInfo )

ঐচ্ছিক। বর্তমান কীওয়ার্ড। adGroupInfo সেট করা থাকলে এই ক্ষেত্রটি নিম্নলিখিত সুপারিশের প্রকারের জন্য ঐচ্ছিক: KEYWORD

adGroupType

enum ( AdGroupType )

ঐচ্ছিক। AdGroup এর AdGroup প্রকার। adGroupInfo সেট করা থাকলে নিম্নলিখিত সুপারিশের প্রকারের জন্য এই ক্ষেত্রটি প্রয়োজনীয়: KEYWORD

SeedInfo

একটি কীওয়ার্ড বীজ এবং একটি নির্দিষ্ট url থেকে কীওয়ার্ড তৈরি করতে হবে।

JSON প্রতিনিধিত্ব
{
  "keywordSeeds": [
    string
  ],
  "urlSeed": string
}
ক্ষেত্র
keywordSeeds[]

string

ঐচ্ছিক। মূলশব্দ বা বাক্যাংশ থেকে ধারণা তৈরি করতে, যেমন: গাড়ি বা "আমার কাছাকাছি গাড়ির ডিলারশিপ"।

urlSeed

string

একটি নির্দিষ্ট url থেকে ধারণা তৈরি করা যায়, উদাহরণস্বরূপ: www.example.com/cars।