AdsApp ব্যবহার করে পারফরম্যান্স সর্বোচ্চ প্রচারণা

Google বিজ্ঞাপন স্ক্রিপ্টগুলি আপনার পারফরম্যান্স ম্যাক্স প্রচারাভিযানের কিছু পরিচালনার জন্য প্রদান করে। আপনি পারফরম্যান্স ম্যাক্স প্রচারাভিযান পুনরুদ্ধার করতে, সম্পদ গোষ্ঠীগুলি পরিচালনা করতে এবং প্রতিবেদনগুলি চালানোর জন্য স্ক্রিপ্ট ব্যবহার করতে পারেন; যাইহোক, আপনি পারফরমেন্স ম্যাক্স ক্যাম্পেইন তৈরি করতে স্ক্রিপ্ট ব্যবহার করতে পারবেন না। আরও উন্নত ক্রিয়াকলাপগুলি করতে, এই নির্দেশিকাটির অবশিষ্টাংশ দেখুন, যা mutate ব্যবহার করে আরও সাধারণ পদ্ধতির প্রদর্শন করে।

পারফরম্যান্স সর্বোচ্চ প্রচারণার পুনরুদ্ধার

একটি AdsApp অবজেক্টের performanceMaxCampaigns সংগ্রহের মাধ্যমে পারফরম্যান্সের সর্বোচ্চ প্রচারাভিযান পাওয়া যায়। আপনি যথারীতি সেগুলি পুনরুদ্ধার করতে পারেন:

const campaignName = "My Performance Max campaign";

const campaignIterator = AdsApp.performanceMaxCampaigns()
    .withCondition(`campaign.name = "${campaignName}"`)
    .get();

for (const campaign of campaignIterator) {
  ...
}

অন্য কিছু প্রচারাভিযানের ধরন থেকে ভিন্ন, পারফরম্যান্স ম্যাক্স ক্যাম্পেইনে বিজ্ঞাপন গোষ্ঠী বা বিজ্ঞাপন বস্তু নেই যা আপনি দেখতে পারেন; অন্যান্য প্রচারাভিযানের জন্য এই ধারণাগুলির সাথে সম্পর্কিত সবকিছুই আপনার সেট করা সম্পদ গোষ্ঠীর উপর ভিত্তি করে আপনার জন্য স্বয়ংক্রিয়ভাবে পরিচালনা করা হয়।

সম্পদ এবং সম্পদ গ্রুপ

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

পারফরম্যান্স ম্যাক্স প্রচারাভিযানের জন্য সম্পদগুলিকে একটি সম্পদ গোষ্ঠীতে একত্রিত করা হয় এবং প্রতিটি পারফরম্যান্স সর্বোচ্চ প্রচারাভিযানে কমপক্ষে একটি সম্পদ গোষ্ঠী থাকতে হবে। আপনি সরাসরি স্ক্রিপ্টগুলিতে এই সম্পদ গোষ্ঠীগুলি তৈরি করতে পারবেন না, তবে আপনি বিদ্যমান সম্পদ গোষ্ঠী থেকে সম্পদ যোগ করতে এবং সরাতে পারেন।

সম্পদ গ্রুপে সম্পদ যোগ করুন

প্রথমে, সম্পদ তৈরি করুন:

const imageUrl = "http://www.example.com/example.png";
const imageBlob = UrlFetchApp.fetch(imageUrl).getBlob();
const assetOperation = AdsApp.adAssets().newImageAssetBuilder()
   .withName("new asset name")
   .withData(imageBlob)
   .build();
const imageAsset = assetOperation.getResult();

তারপর, আপনি এইমাত্র তৈরি করা সম্পদ ব্যবহার করে, এটি একটি বিদ্যমান সম্পদ গোষ্ঠীতে যোগ করুন:

// First, fetch the Performance Max campaign we want to operate on.
const campaignIterator = AdsApp.performanceMaxCampaigns()
   .withCondition(`campaign.name = '${campaignName}'`)
   .get();
let campaign;
if (campaignIterator.hasNext()) {
   campaign = campaignIterator.next();
} else {
   throw `No campaign found with name ${campaignName}.`
}

// Then, get that campaign's asset groups.
const assetGroupIterator = campaign.assetGroups().get();

// The campaign must have at least one asset group, so we can just assume so here.
const assetGroup = assetGroupIterator.next();

// Add the asset from the previous step.
assetGroup.addAsset(imageAsset, 'MARKETING_IMAGE');

শেষ ধাপে আপনাকে কীভাবে সম্পদের ধরন উল্লেখ করতে হবে তা নোট করুন। আপনি Google Ads API ডকুমেন্টেশনে সম্পদের প্রকারের একটি সম্পূর্ণ তালিকা খুঁজে পেতে পারেন

একটি বিদ্যমান সম্পদ ব্যবহার করতে, প্রথমে একটি সম্পদ নির্বাচক তৈরি করুন:

const assetSelector = AdsApp.adAssets().assets();

তারপরে আপনি যে সম্পদগুলি পরিচালনা করতে চান তা সংকুচিত করতে একটি withCondition ফিল্টার ব্যবহার করুন৷ ফিল্টার বিকল্পগুলির সম্পূর্ণ তালিকার জন্য AssetSelector রেফারেন্স ডকুমেন্টেশন দেখুন।

অবশেষে, পুনরাবৃত্তিকারী আনুন এবং অন্যান্য সত্তার মতো পুনরাবৃত্তি করুন:

const assetIterator = assetSelector.get();

for (const asset of assetIterator) {
   ...
}

পাঠ্য সম্পদ

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

উদাহরণস্বরূপ, এখানে একটি শিরোনাম সম্পদ তৈরি করার পদ্ধতি রয়েছে:

assetGroup.addAsset('asset text here', 'HEADLINE');

সম্পদ গ্রুপ থেকে সম্পদ সরান

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

পূর্ববর্তী উদাহরণে যোগ করা সম্পদটি কীভাবে সরানো যায় তা এখানে রয়েছে:

assetGroup.removeAsset(imageAsset, 'MARKETING_IMAGE');

আপনি search ফাংশন সহ একটি প্রদত্ত সম্পদ গোষ্ঠীতে সম্পদের একটি তালিকাও পেতে পারেন:

// The resource name is a unique identifier for this asset group.
const assetGroupName = assetGroup.getResourceName();
results = AdsApp.search(
   `SELECT asset.resource_name, asset_group_asset.field_type
    FROM asset_group_asset
    WHERE asset_group.resource_name = '${assetGroupName}'`
);

এটি তার অনন্য শনাক্তকারী হিসাবে সম্পদের সম্পদের নাম নির্বাচন করে। ফলাফলগুলি আরও পরিমার্জিত করতে আপনি অন্যান্য ক্ষেত্রগুলিও নির্বাচন করতে পারেন, যেমন asset.type বা asset.text_asset.text ৷ আপনার নিজের ক্যোয়ারী তৈরি করতে এই প্রতিবেদনের প্রকারের জন্য ক্যোয়ারী নির্মাতা ব্যবহার করুন।

একবার আপনার কাছে টার্গেট অ্যাসেট হয়ে গেলে, অ্যাসেট গ্রুপ থেকে অ্যাসেট অপসারণ করতে অ্যাসেট গ্রুপে remove কল করুন:

// Let's assume at least one asset is returned. We'll just remove the first
// asset, whatever it is. In your code, customize this to choose the right asset.
const row_info = results.next().asset;
assetGroup.remove(row_info.asset.resource_name, row_info.asset_group_asset.field_type);