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

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

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

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 রিসোর্স তৈরি না করা পর্যন্ত পারফর্ম্যান্স ম্যাক্স ক্যাম্পেন দেখানোর জন্য উপযুক্ত হবে না।

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

ছবি

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

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

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

ছবি

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

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

  • কোনও অ্যাসেট ছাড়াই অ্যাসেট গ্রুপ
  • সব প্রয়োজনীয় অ্যাসেট আছে এমন অ্যাসেট গ্রুপ (পছন্দসই)

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

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

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

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

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

ছবি

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

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

ছবি

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

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

অবৈধ রাজ্য
ক্যাম্পেনটি যেভাবে কনফিগার করা হয়েছে তার জন্য এটি বিজ্ঞাপন দেখানোর উপযুক্ত নয়। যেমন, আপনি Campaign সহ একটি স্বতন্ত্র রিসোর্স তৈরি করতে পারেন advertising_channel_type PERFORMANCE_MAX-এর। ক্যাম্পেন তৈরি করার অনুরোধ সফল হলেও, ক্যাম্পেনে অন্তত একটি 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 সরানোর যেকোনও অনুরোধের ক্ষেত্রে একটি সমস্যা দেখা দেবে।

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

পূর্ববর্তী
ক্যাম্পেন সংক্রান্ত মাপকাঠি রিপোর্টিং
পরবর্তী
ব্যাচ প্রসেসিং