স্ট্রাকচার সংক্রান্ত অনুরোধ

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

'পারফর্ম্যান্স ম্যাক্স ক্যাম্পেন' তৈরি করুন

Google Ads API-তে, পারফর্ম্যান্স ম্যাক্স ক্যাম্পেন এন্টিটিগুলি একাধিক অনন্য রিসোর্সের সমন্বয় হিসাবে উপস্থাপন করা হয়।

স্ট্যান্ডার্ড পারফর্ম্যান্স ম্যাক্স ক্যাম্পেন

স্ট্যান্ডার্ড পারফর্ম্যান্স ম্যাক্স ক্যাম্পেন দেখানোর জন্য ন্যূনতম রিসোর্স সেট প্রয়োজন।

• ক্যাম্পেনের বাজেট
• ক্যাম্পেন
• ক্যাম্পেন অ্যাসেট (শুধুমাত্র ব্র্যান্ড নির্দেশিকা চালু থাকা ক্যাম্পেনের জন্য)
• অ্যাসেট গ্রুপ
• অ্যাসেট গ্রুপের অ্যাসেট
• অ্যাসেট

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

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

পারফর্ম্যান্স ম্যাক্স ক্যাম্পেন তৈরি করার অনুরোধের স্ট্রাকচার তৈরি করার জন্য বিভিন্ন বিকল্প আছে। কীভাবে অপারেশন গ্রুপ করতে হবে এবং অনুরোধের স্ট্রাকচার তৈরি করতে হবে সেই সিদ্ধান্ত মূলত আপনার উদ্দেশ্য এবং পরিকাঠামোর উপর নির্ভর করে।

• AssetGroup ও AssetGroupAsset রিসোর্স তৈরি করার আগে আলাদা অনুরোধে CampaignBudget, Campaign, Asset ও CampaignAsset রিসোর্স তৈরি করুন। (ব্র্যান্ড গাইডলাইন চালু থাকা ক্যাম্পেনের ক্ষেত্রে, Campaign এবং প্রয়োজনীয় CampaignAsset রিসোর্স একসাথে একটি অনুরোধে অন্তর্ভুক্ত করতে হবে)
• একটি মিউটেট রিকোয়েস্টে এইসব রিসোর্স অন্তর্ভুক্ত করুন।

আপনি আলাদা আলাদা পূর্ববর্তী অনুরোধে CampaignBudget, Campaign, Asset এবং CampaignAsset রিসোর্স তৈরি করতে পারলেও, AssetGroup এবং AssetGroupAsset রিসোর্স তৈরি না করা পর্যন্ত পারফর্ম্যান্স ম্যাক্স ক্যাম্পেন দেখানোর জন্য উপযুক্ত হবে না।

একটি বৈধ পারফর্ম্যান্স ম্যাক্স ক্যাম্পেন দেখানোর জন্য ন্যূনতম প্রয়োজনীয়তা

ডায়াগ্রামে দেখানো অতিরিক্ত রিসোর্স তৈরি করে আপনি পারফর্ম্যান্স ম্যাক্স ক্যাম্পেন আরও কাস্টমাইজ করতে পারবেন।

• অ্যাসেট গ্রুপ সিগন্যাল
• ক্যাম্পেন কনভার্সন সংক্রান্ত লক্ষ্য
• ক্যাম্পেনের মাপকাঠি

আপনি একই অনুরোধে AssetGroupSignal রিসোর্স তৈরি করার জন্য অপারেশন অন্তর্ভুক্ত করতে পারেন যা AssetGroup এবং AssetGroupAsset রিসোর্স তৈরি করে। অন্যথায়, AssetGroup তৈরি করার পরে আলাদা অনুরোধে আপনি AssetGroupSignalটি এন্টিটি তৈরি করতে পারবেন।

অতিরিক্ত বিকল্প সহ পারফর্ম্যান্স ম্যাক্স ক্যাম্পেন

রিটেলের জন্য পারফর্ম্যান্স ম্যাক্স ক্যাম্পেন

রিটেল ক্যাম্পেন অনন্য কারণ এতে অ্যাসেট গ্রুপ তৈরি করার দুটি আলাদা উপায় আছে যার ফলে একটি সঠিক ক্যাম্পেন পরিবেশন করা যায়:

• কাস্টম অ্যাসেট ছাড়া অ্যাসেট গ্রুপ (বা শুধুমাত্র HTML5 MEDIA_BUNDLE অ্যাসেট সহ)
• অ্যাসেট গ্রুপ যাতে সব প্রয়োজনীয় অ্যাসেট আছে (পছন্দসই)

আপনি অ্যাসেট গ্রুপ থেকে অ্যাসেট বাদ দেওয়ার বিকল্প বেছে নিলে, Google অটোমেটিক আপনার লিঙ্ক করা Merchant Center অ্যাকাউন্ট-এ দেওয়া অ্যাসেট ব্যবহার করে বিজ্ঞাপন তৈরি করে। তবে, সব ইনভেনটরিতে পৌঁছানোর জন্য আমরা অ্যাসেট প্রদান করার সাজেশন দিই। পারফর্ম্যান্স ম্যাক্স রিটেল ক্যাম্পেন দেখানোর জন্য নিম্নলিখিত রিসোর্সগুলি ন্যূনতম প্রয়োজন:

• CampaignBudget
• Campaign (ShoppingSetting সহ)
• AssetGroup
• AssetGroupListingGroupFilter

রিটেল ক্যাম্পেনে Campaign.shopping_setting ফিল্ড অবশ্যই পূরণ করতে হবে। এছাড়াও, AssetGroup-এ তালিকাভুক্ত যেকোনও final_urls-কে Campaign.shopping_setting-এ উল্লেখ করা Merchant Center অ্যাকাউন্ট আইডির সাথে যুক্ত ওয়েবসাইট ডোমেনের সাথে ম্যাচ করতে হবে। শেষে, প্রতিটি AssetGroup-এর সাথে এক বা একাধিক AssetGroupListingGroupFilter রিসোর্স নিয়ে গঠিত একটি সংশ্লিষ্ট, সঠিক প্রোডাক্ট লিস্টিং গ্রুপ ট্রি থাকতেই হবে। আপনার নির্দিষ্ট করা Merchant Center ফিডে সব প্রোডাক্টের জন্য আপনাকে অন্তত একটি নোড ট্রি তৈরি করতে হবে।

এইসব রিসোর্সের প্রতিটি আলাদাভাবে বা একটি অনুরোধে তৈরি করা যেতে পারে। তবে, এই সব রিসোর্স সঠিকভাবে তৈরি না করা পর্যন্ত ক্যাম্পেনটি দেখানোর জন্য উপযুক্ত হবে না।

সঠিকভাবে কাজ করছে এমন পারফর্ম্যান্স ম্যাক্স রিটেল ক্যাম্পেনের জন্য ন্যূনতম প্রয়োজনীয়তা

পারফর্ম্যান্স ম্যাক্স রিটেল ক্যাম্পেন, স্ট্যান্ডার্ড পারফর্ম্যান্স ম্যাক্স ক্যাম্পেনের জন্য উপলভ্য সব বিকল্প ব্যবহার করতে পারে, যার মধ্যে অ্যাসেট গ্রুপ সিগন্যাল, ক্যাম্পেন কনভার্সন সংক্রান্ত লক্ষ্য এবং ক্যাম্পেনের মাপকাঠি তৈরি করা অন্তর্ভুক্ত। AssetGroup রিসোর্স তৈরি করার সময় আপনি যদি AssetGroup-এ কাস্টম অ্যাসেট (HTML5 MEDIA_BUNDLE অ্যাসেট ছাড়া) যোগ করার সিদ্ধান্ত নেন, তাহলে আপনার অনুরোধকে অবশ্যই অ্যাসেটের ন্যূনতম প্রয়োজনীয়তা (ক্যাম্পেন-লেভেল ব্র্যান্ড অ্যাসেট সহ, যদি ব্র্যান্ড নির্দেশিকা চালু থাকে) পূরণ করতে হবে। অন্যভাবে বলতে গেলে, কোনও কাস্টম অ্যাসেট যোগ করবেন না অথবা সব প্রয়োজনীয় অ্যাসেট যোগ করুন।

অতিরিক্ত বিকল্প সহ পারফর্ম্যান্স ম্যাক্স রিটেল ক্যাম্পেন

ভুল স্ট্যাটাস বনাম ভুল অনুরোধ

Google Ads API-তে পারফর্ম্যান্স ম্যাক্স ক্যাম্পেন নিয়ে কাজ করার সময়, ভুল স্টেট ও ভুল অনুরোধের মধ্যে গুরুত্বপূর্ণ পার্থক্য রয়েছে।

অবৈধ রাজ্য

ক্যাম্পেনটি যেভাবে কনফিগার করা হয়েছে তার কারণে এটি দেখানোর জন্য উপযুক্ত নয়। যেমন, আপনি PERFORMANCE_MAX-এর advertising_channel_type সহ একটি স্বতন্ত্র Campaign রিসোর্স তৈরি করতে পারেন। ক্যাম্পেন তৈরি করার অনুরোধ সফল হলেও, ক্যাম্পেনে অন্তত একটি AssetGroup যোগ না করা পর্যন্ত এটি দেখানোর জন্য উপযুক্ত হবে না। আপনার অনুরোধ সফল হলেও, আপনার ক্যাম্পেন বা অ্যাসেট গ্রুপ কাজ না করলে, আপনি CampaignPrimaryStatus, CampaignPrimaryStatusReason, AssetGroupPrimaryStatus এবং AssetGroupPrimaryStatusReason ব্যবহার করে কারণ নির্ধারণ করতে পারেন, যেমনটি সমস্যার সমাধানকরণ গাইডে বিস্তারিতভাবে বলা আছে।

অবৈধ অনুরোধ

এমন একটি অনুরোধ যা সফল হবে না কারণ এটি ক্যাম্পেন বা রিসোর্সকে একটি ভুল অবস্থায় রাখবে। যেমন, আপনি যদি ন্যূনতম প্রয়োজনীয় অ্যাসেট অন্তর্ভুক্ত না করে রিটেল নয় এমন ক্যাম্পেনের (স্থানীয় পরিষেবা পারফর্ম্যান্স ম্যাক্স ক্যাম্পেন ছাড়া) জন্য AssetGroup তৈরি করার চেষ্টা করেন, তাহলে Google Ads API একটি সমস্যার মেসেজ দেখায়। এই কারণে আপনাকে একই অনুরোধে একটি AssetGroup এবং তার AssetGroupAsset রিসোর্স অন্তর্ভুক্ত করতে হবে। এর অর্থ হল, সম্পূর্ণ অনুরোধ যাতে ব্যর্থ না হয়, তার জন্য আপনার সব AssetGroupAsset রিসোর্সকে প্রদত্ত field_type-এর জন্য সঠিক স্পেসিফিকেশন পূরণ করতে হবে।

মিউটেট রিকোয়েস্টের মাধ্যমে গ্রুপ অপারেশন

পারফর্ম্যান্স ম্যাক্স ক্যাম্পেন একাধিক রিসোর্স নিয়ে গঠিত এবং আপনার কাছে অনন্য অনুরোধে বা একটি বাল্ক মিউটেট রিকোয়েস্টে এইসব আলাদা আলাদা রিসোর্স তৈরি করার বিকল্প আছে। তবে, স্ট্যান্ডার্ড পারফর্ম্যান্স ম্যাক্স ক্যাম্পেনে AssetGroups এবং সংশ্লিষ্ট AssetGroupAssets অবশ্যই আগে উল্লেখ করা একটি অ্যাটমিক অনুরোধে তৈরি করতে হবে।

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

কাজগুলির ক্রম

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

আপনি যদি একই বাল্ক মিউটেট রিকোয়েস্টে অ্যাসেট রিসোর্স তৈরি করতে চান, যা AssetGroup এবং এর AssetGroupAsset রিসোর্স তৈরি করে, তাহলে সব AssetOperations, সব AssetGroupAssetOperations-এর আগে আসতে হবে, যেমনটি ডায়াগ্রামে দেখানো হয়েছে।

Google Ads সার্ভার পরপর AssetGroupAssetOperations একসাথে ব্যাচ করে এবং সেই গ্রুপের শেষ অপারেশনের পরে AssetGroup ন্যূনতম অ্যাসেট সংক্রান্ত প্রয়োজনীয়তা পূরণ করে কিনা তা মূল্যায়ন করে। আপনি যদি অনুরোধে AssetOperations এবং AssetGroupAssetOperations-এর মধ্যে অদলবদল করেন, তাহলে API সার্ভার প্রথম AssetGroupAssetOperation-এর পরে ন্যূনতম অ্যাসেট সংক্রান্ত প্রয়োজনীয়তা মূল্যায়ন করবে এবং অনুরোধে বাকি অপারেশনগুলি চালিয়ে না গিয়ে একটি ত্রুটি রিটার্ন করবে। এর ফলে, অনুরোধে উল্লেখ করা কোনও অ্যাসেটই আপনার Google Ads অ্যাকাউন্টে যোগ করা হবে না। এছাড়াও, AssetGroup বা এর সাথে যুক্ত কোনও AssetGroupAsset রিসোর্স তৈরি করা হবে না।

অ্যাসেট গ্রুপ আপডেট করুন

আপনি একটি সঠিক AssetGroup তৈরি করার পরে, পরবর্তী অনুরোধগুলি ইস্যু করতে পারবেন না যা অ্যাসেট গ্রুপকে ন্যূনতম অ্যাসেটের প্রয়োজনীয়তার নিচে রেখে দেবে। এই ধরনের যেকোনও অনুরোধের ক্ষেত্রে সমস্যা দেখা যায়। যেমন, আপনি যদি একটিমাত্র MARKETING_IMAGE (ন্যূনতম প্রয়োজনীয়তা) দিয়ে একটি AssetGroup তৈরি করেন, তাহলে শুধু সেই MARKETING_IMAGE AssetGroupAsset সরানোর অনুরোধ করলে একটি সমস্যা দেখা দেয়। তবে, পারফর্ম্যান্স ম্যাক্স রিটেল ক্যাম্পেনে, আপনি একটি অনুরোধেই সব কাস্টম AssetGroupAsset লিঙ্ক সরিয়ে দিয়ে Google Merchant Center-এর অটোমেটিক জেনারেট করা অ্যাসেটের উপর নির্ভর করার AssetGroup-এ ফিরে যেতে পারবেন।

পারফর্ম্যান্স ম্যাক্স রিটেল ক্যাম্পেনে কোনও কাস্টম অ্যাসেট ছাড়াই তৈরি করা অ্যাসেট গ্রুপের ক্ষেত্রে, কাস্টম অ্যাসেট (HTML5 MEDIA_BUNDLE অ্যাসেট ছাড়া) লিঙ্ক করার পরবর্তী অনুরোধে, অন্তত একটি final_urls, AssetGroup-এ সেট করা আছে কিনা তা নিশ্চিত করতে হবে (প্রথমে বাদ দেওয়া হলে এটি প্রথমে পূরণ করতে হবে) এবং একটি একক অ্যাটমিক অনুরোধে সমস্ত ন্যূনতম প্রয়োজনীয় অ্যাসেট (ব্র্যান্ড নির্দেশিকা চালু থাকলে ক্যাম্পেন-লেভেল ব্র্যান্ড অ্যাসেট সহ) প্রদান করতে হবে। শুধু YOUTUBE_VIDEO-এর মতো ঐচ্ছিক অ্যাসেট লিঙ্ক করবেন না বা আলাদা আলাদা অনুরোধে অ্যাসেট ইনক্রিমেন্টাল হিসেবে যোগ করবেন না। শুধুমাত্র ঐচ্ছিক কাস্টম অ্যাসেট লিঙ্ক করলে, অ্যাসেট গ্রুপ এমন একটি অসমর্থিত অবস্থায় চলে যায় যা Google Ads UI-তে এডিট করা ব্লক করে দেয়। বিস্তারিত জানতে, পারফর্ম্যান্স ম্যাক্স রিটেল ক্যাম্পেনে অ্যাসেটের সাথে অ্যাসেট গ্রুপ লিঙ্ক করা নিবন্ধটি দেখুন।