স্মার্ট ক্যাম্পেনকে PMax ক্যাম্পেনে কনভার্ট করা

v25 এবং তার পরবর্তী ভার্সনে, আপনি SmartCampaignSettingService.GeneratePMaxDraftCampaign পদ্ধতি ব্যবহার করে স্মার্ট ক্যাম্পেনকে পারফর্ম্যান্স ম্যাক্স ক্যাম্পেনে পরিবর্তন করতে পারবেন। এই পদ্ধতি v24 এবং তার আগের ভার্সনে উপলভ্য নয়।

কনভার্সন কীভাবে কাজ করে

আপনি SmartCampaignSettingService.GeneratePMaxDraftCampaign কল করলে, API অনুরোধে দেওয়া স্মার্ট ক্যাম্পেনের কনফিগারেশনের উপর ভিত্তি করে, একটি ড্রাফ্ট পারফর্ম্যান্স ম্যাক্স ক্যাম্পেন, বাজেট, অ্যাসেট গ্রুপ ও অ্যাসেট তৈরি করে। তৈরি হয়ে গেলে, বিজ্ঞাপন দেখানোর জন্য ক্যাম্পেন চালু করার আগে, নতুন রিসোর্সগুলি আপনার চেক, পরিবর্তন ও উন্নত করা উচিত।

তৈরি করা পারফর্ম্যান্স ম্যাক্স ড্রাফ্ট ক্যাম্পেন নিম্নলিখিত স্ট্যাটাস ভ্যালু সহ শুরু করা হয়েছে:

  • status-এর মান PAUSED-এ সেট করা আছে।
  • এটি দেখানোর উপযুক্ত কিনা তা primary_status-এ দেখানো হয়।
  • contains_eu_political_advertising ডিফল্ট হিসেবে DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING সেট করা থাকে (যদি না স্মার্ট ক্যাম্পেনে আগে থেকেই নির্দিষ্ট করা থাকে)। আপনার ক্যাম্পেনে EU রাজনৈতিক বিজ্ঞাপন থাকলে, এই ফিল্ড যাচাই ও আপডেট করুন।

এটি আপনাকে বিজ্ঞাপন দেখানোর জন্য ক্যাম্পেন চালু করার আগে তৈরি করা পারফর্ম্যান্স ম্যাক্স ক্যাম্পেন, বাজেট, অ্যাসেট গ্রুপ এবং অ্যাসেট পরীক্ষা, পরিবর্তন এবং উন্নত করতে দেয়।

ড্রাফ্ট অ্যাসেট

নতুন ক্যাম্পেনের সাথে প্লেসহোল্ডার ইমেজের একটি গ্রুপ থাকে যা নতুন ক্যাম্পেন চালু করার আগে পরিবর্তন করতে হয়। অনুরোধে image_enabled ফিল্ড কাজ করলে এবং true-এ সেট করা থাকলে, API অটোমেটিক প্লেসহোল্ডার ইমেজ ব্যবহার করার পরিবর্তে ছবি তৈরি করে। আপনি উত্তরের assets ফিল্ডে নতুন অ্যাসেটগুলি পরীক্ষা করতে পারেন এবং এই ধাপগুলি অনুসরণ করে সেগুলি পরিবর্তন করতে পারেন:

  1. অ্যাসেট সংক্রান্ত প্রয়োজনীয়তার নির্দেশিকা পর্যালোচনা করুন।
  2. ছবি অ্যাসেট আপলোড করুন উদাহরণ অনুসরণ করে নতুন ছবি আপলোড করুন।
  3. ড্রাফ্ট ক্যাম্পেনের অ্যাসেট গ্রুপে নতুন অ্যাসেট লিঙ্ক করুন এবং তারপরে অ্যাসেট গাইডে অ্যাসেট গ্রুপ লিঙ্ক করুন নির্দেশিকা অনুসরণ করে প্লেসহোল্ডার ইমেজের জন্য AssetGroupAsset লিঙ্কগুলি সরান (একই অ্যাটমিক মিউটেট রিকোয়েস্টে বা নতুন অ্যাসেট লিঙ্ক করার পরে যাতে ন্যূনতম অ্যাসেটের প্রয়োজনীয়তা পূরণ হয়)।

অনুরোধের প্যারামিটার

GeneratePMaxDraftCampaignRequest মেসেজ নিম্নলিখিত ফিল্ড গ্রহণ করে:

  • resource_name (প্রয়োজনীয়): আপনি যে স্মার্ট ক্যাম্পেন কনভার্ট করতে চান, তার জন্য SmartCampaignSetting আবার তৈরি করতে রিসোর্সের নাম, নিম্নলিখিত ফর্ম্যাটে:

    customers/customer_id/smartCampaignSettings/campaign_id
    
  • validate_only (ঐচ্ছিক): true হলে, অনুরোধ যাচাই করা হয় কিন্তু কার্যকর করা হয় না। ড্রাফ্ট এন্টিটি তৈরি না করেই উত্তরের validated_info ফিল্ডে শুধুমাত্র যাচাইকরণ সম্পর্কিত সমস্যা, সতর্কতা বা কনভার্সন সংক্রান্ত সম্ভাব্য সমস্যা ফেরত পাঠানো হয়।

  • gbp_enabled (কাজ করে না): ঐচ্ছিক। পারফর্ম্যান্স ম্যাক্স ক্যাম্পেনের সাথে লিঙ্ক করা Google Business Profile (GBP) লোকেশন কনভার্ট করা হবে কিনা। এই ফিল্ডটি সেট না করে বা false হিসেবে ছেড়ে দিন; এটি true হিসেবে সেট করা কাজ করে না এবং SmartCampaignError.GBP_ENABLED_GENERATE_PMAX_NOT_SUPPORTED সমস্যা দেখায়।

  • image_enabled (কাজ করে না): ঐচ্ছিক। প্রয়োজনীয় পারফর্ম্যান্স ম্যাক্স ক্যাম্পেন ছবি (যেমন, অনুভূমিক, বর্গাকার ও লোগো ছবির ধরন) জেনারেট করা হবে কিনা। এই ফিল্ড সেট না করে রেখে দিন অথবা false; এটি true-এ সেট করা যাবে না এবং এটি করলে SmartCampaignError.IMAGE_ENABLED_GENERATE_PMAX_NOT_SUPPORTED সমস্যা হবে।

উত্তরের বিবরণ

GeneratePMaxDraftCampaignResponse মেসেজ তৈরি করা পারফর্ম্যান্স ম্যাক্স ড্রাফ্ট ক্যাম্পেন এবং এর সাথে সম্পর্কিত এন্টিটির রিসোর্সের নাম রিটার্ন করে:

  • pmax_campaign: তৈরি করা ড্রাফ্ট পারফর্ম্যান্স ম্যাক্স ক্যাম্পেনের Campaign রিসোর্সের নাম।
  • campaign_budget: তৈরি করা পারফর্ম্যান্স ম্যাক্স ক্যাম্পেনের সাথে লিঙ্ক করা CampaignBudget রিসোর্সের নাম।
  • asset_group: তৈরি করা পারফর্ম্যান্স ম্যাক্স ক্যাম্পেনের সাথে লিঙ্ক করা AssetGroup রিসোর্সের নাম।
  • assets: তৈরি করা পারফর্ম্যান্স ম্যাক্স ক্যাম্পেনের সাথে লিঙ্ক করা Asset রিসোর্সের নামের তালিকা।
  • validated_info: কনভার্সন চেক করার মাধ্যমে রিটার্ন করা যাচাইকরণ সংক্রান্ত তথ্য বা সম্ভাব্য কনভার্সন সংক্রান্ত সমস্যা (validate_only-কে true-এ সেট করা হলে এবং validate_only-কে false-এ সেট করা হলে, জেনারেট করা এন্টিটি রিসোর্সের নামের পাশাপাশি দুটি ক্ষেত্রেই পপুলেট করা হয়)।

স্মার্ট ক্যাম্পেন কনভার্ট করতে, নিম্নলিখিত ওয়ার্কফ্লো ব্যবহার করুন:

  1. ড্রাফ্ট ক্যাম্পেন জেনারেট করুন: শুধুমাত্র প্রয়োজনীয় resource_name সেট করে SmartCampaignSettingService.GeneratePMaxDraftCampaign কল করুন (gbp_enabled এবং image_enabled সেট না করে বা false-এ সেট করে ছেড়ে দিন)। ফেরত পাওয়া pmax_campaign, campaign_budget, asset_group এবং assets রিসোর্সের নাম সেভ করুন।
  2. ক্যাম্পেন পর্যালোচনা ও কাস্টমাইজ করুন: যেহেতু ড্রাফ্ট পারফর্ম্যান্স ম্যাক্স ক্যাম্পেন status = PAUSED এবং creation_status = INCOMPLETE-এর মাধ্যমে তৈরি করা হয়েছে, তাই এর বাজেট, অ্যাসেট গ্রুপ ও অ্যাসেট ভাল করে দেখে নিয়ে কনফিগার করুন।
  3. ক্যাম্পেন চালু করুন এবং আসলটি পজ করুন: আপনি বিজ্ঞাপন দেখানোর জন্য প্রস্তুত হলে, পারফর্ম্যান্স ম্যাক্স ক্যাম্পেনের status আপডেট করে ENABLED করুন, তারপর ডুপ্লিকেট দেখানো আটকাতে আসল স্মার্ট ক্যাম্পেনের status আপডেট করে PAUSED করুন।