স্মার্ট ক্যাম্পেনকে 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 করুন।