বিজ্ঞাপন এক্সটেনশন

গুগল অ্যাডস স্ক্রিপ্ট নিম্নলিখিত বিজ্ঞাপন এক্সটেনশনগুলিকে সমর্থন করে:

• মোবাইল অ্যাপস
• ফোন নম্বর
• কলআউট
• দাম
• খণ্ডাংশ
• সাইটলিঙ্ক

বিজ্ঞাপন এক্সটেনশন সম্পর্কে আরও জানতে, সহায়তা কেন্দ্র দেখুন।

গুগল অ্যাডস স্ক্রিপ্ট আপনাকে আপনার অ্যাকাউন্টে সমর্থিত বিজ্ঞাপন এক্সটেনশনগুলো অ্যাক্সেস করার সুযোগ দেয়। উদাহরণস্বরূপ, নিম্নলিখিত কোড স্নিপেটটি সাইটলিঙ্কগুলো অ্যাক্সেস করে:

const sitelinkIterator = AdsApp.extensions().sitelinks().get();
for (const sitelink of sitelinkIterator) {
  // Do something with each sitelink
}

আপনি একইভাবে তাদের নিজ নিজ ইটারেটর ব্যবহার করে অন্যান্য সমর্থিত বিজ্ঞাপন এক্সটেনশনগুলো পুনরুদ্ধার করতে পারেন।

সৃষ্টি

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

const phoneNumberBuilder = AdsApp.extensions().newPhoneNumberBuilder();
const newPhoneNumber = phoneNumberBuilder
  .withCountry("US")
  .withPhoneNumber("6502530000")
  .withCallOnly(false)
  .build()
  .getResult();

যখন build() কল করা হয়, তখন অ্যাকাউন্টে ফোন নম্বরটি তৈরি হয়, কিন্তু এটি এখনই কোনো বিজ্ঞাপনের সাথে দেখানো হবে না। আপনাকে প্রথমে এটিকে একটি ক্যাম্পেইন বা অ্যাড গ্রুপে যুক্ত করতে হবে:

// Add a phone number to a campaign.
campaign.addPhoneNumber(newPhoneNumber);

// Add a phone number to an ad group.
adGroup.addPhoneNumber(newPhoneNumber);

অন্যান্য সমর্থিত বিজ্ঞাপন এক্সটেনশনগুলোও তাদের নিজ নিজ বিল্ডার ব্যবহার করে একইভাবে তৈরি করা যায় এবং ক্যাম্পেইন বা বিজ্ঞাপন গ্রুপের সাথে যুক্ত করা যায়।

পরিসংখ্যান পান

গুগল অ্যাডস স্ক্রিপ্ট আপনাকে অ্যাকাউন্ট, ক্যাম্পেইন বা অ্যাড গ্রুপ পর্যায়ে সমর্থিত অ্যাড এক্সটেনশনগুলির পরিসংখ্যান দেখার সুযোগ দেয়।

উদাহরণস্বরূপ, সাইটলিংক পরিসংখ্যান পেতে:

// Account-level stats
// Get a sitelink in the account.
const sitelinkIterator = AdsApp.extensions().sitelinks().get();
const sitelink = sitelinkIterator.next();
const sitelinkStats = sitelink.getStatsFor("LAST_30_DAYS");
console.log(sitelinkStats.getClicks());

// Campaign-level stats.
// Get a sitelink in a campaign.
const campaignSitelinkIterator = campaign.extensions().sitelinks().get();
const campaignSitelink = campaignSitelinkIterator.next();
const campaignSitelinkStats = campaignSitelink.getStatsFor("LAST_30_DAYS");
console.log(campaignSitelinkStats.getClicks());

// Ad-group-level stats.
// Get a sitelink in an ad group.
const adGroupSitelinkIterator = adGroup.extensions().sitelinks().get();
const adGroupSitelink = adGroupSitelinkIterator.next();
const adGroupSitelinkStats = adGroupSitelink.getStatsFor("LAST_30_DAYS");
console.log(adGroupSitelinkStats.getClicks());

অন্যান্য সমর্থিত বিজ্ঞাপন এক্সটেনশনগুলির পরিসংখ্যানও একইভাবে দেখা যাবে।

বিজ্ঞাপনের এক্সটেনশনগুলি পরিবর্তন করুন

বিদ্যমান সমর্থিত বিজ্ঞাপন এক্সটেনশনগুলো গুগল অ্যাডস স্ক্রিপ্ট দিয়ে পরিবর্তন করা যায়। উদাহরণস্বরূপ, নিম্নলিখিত কোড স্নিপেটটি একটি বিদ্যমান সাইটলিঙ্ক পরিবর্তন করবে:

// Get a sitelink in the account.
const sitelinkIterator = AdsApp.extensions().sitelinks().get();
const sitelink = sitelinkIterator.next();
console.log(sitelink.getLinkText()); // "original text"

// Get a sitelink from a campaign. Assume it's the same one as before.
const campaignSitelinkIterator = campaign.extensions().sitelinks().get();
const campaignSitelink = campaignSitelinkIterator.next();
console.log(campaignSitelink.getLinkText()); // "original text"

// Get a sitelink from an ad group. Assume it's the same one as before.
const adGroupSitelinkIterator = adGroup.extensions().sitelinks().get();
const adGroupSitelink = adGroupSitelinkIterator.next();
console.log(adGroupSitelink.getLinkText()); // "original text"

// Change the sitelink's link text. This change will affect all the campaigns
// and ad groups to which the sitelink belongs.
campaignSitelink.setLinkText("new link text");

// Same text!
console.log(campaignSitelink.getLinkText()); // "new link text"
console.log(adGroupSitelink.getLinkText()); // "new link text"
console.log(sitelink.getLinkText()); // "new link text"

দ্রষ্টব্য: আপনি যদি কোনো Sitelink পরিবর্তন করেন, তবে তা সেই সাইটলিঙ্কটির সাথে যুক্ত সমস্ত ক্যাম্পেইন এবং অ্যাড গ্রুপে বিজ্ঞাপন পরিবেশনকে প্রভাবিত করবে। এই নিয়মটি প্রযোজ্য হবে, আপনি সাইটলিঙ্কটি সরাসরি অ্যাকাউন্ট থেকে, কোনো সংশ্লিষ্ট ক্যাম্পেইনের CampaignSitelink থেকে, অথবা কোনো সংশ্লিষ্ট অ্যাড গ্রুপের AdGroupSitelink থেকে সংগ্রহ করুন না কেন। পূর্ববর্তী কোড উদাহরণটি এই আচরণটি প্রদর্শন করে।

অন্যান্য সমর্থিত বিজ্ঞাপন এক্সটেনশনগুলোর ক্ষেত্রেও একই ধারণা প্রযোজ্য।

বিজ্ঞাপন-গোষ্ঠী-স্তরের বিজ্ঞাপন এক্সটেনশনগুলি অ্যাক্সেস করুন

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

// This will return phone numbers that have been explicitly added to this
// ad group.
const adGroupPhoneNumberIterator = adGroup.extensions().phoneNumbers().get();

অন্যান্য সমর্থিত বিজ্ঞাপন এক্সটেনশনগুলোও একইভাবে বিজ্ঞাপন গ্রুপ স্তর থেকে অ্যাক্সেস করা যায়।

অ্যাকাউন্ট-স্তরের বিজ্ঞাপন এক্সটেনশনগুলি অ্যাক্সেস করুন

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

// This will return callouts that have been explicitly added to your account.
const accountCalloutIterator =
    AdsApp.currentAccount().extensions().callouts().get();

অ্যাকাউন্ট-স্তরের মোবাইল অ্যাপ এবং রিভিউগুলোও একইভাবে অ্যাক্সেস করা যায়।

অ্যাকাউন্ট-স্তরের বিজ্ঞাপন এক্সটেনশন যোগ করা, ক্যাম্পেইন-স্তর বা বিজ্ঞাপন-গ্রুপ-স্তরের বিজ্ঞাপন এক্সটেনশন যোগ করার মতোই। নিম্নলিখিত উদাহরণটি দেখায় কিভাবে একটি অ্যাকাউন্ট-স্তরের কলআউট এক্সটেনশন যোগ করতে হয়:

// Create a new callout in the account. Without adding the new callout as an ad
// group, campaign or account extension, it won't actually serve.
const calloutBuilder = AdsApp.extensions().newCalloutBuilder();
const newCallout = calloutBuilder.withText("Sample Text").build().getResult();

// Add the new callout as an account-level extension. This enables it to serve
// for all campaigns in the account.
AdsApp.currentAccount().addCallout(newCallout);

একইভাবে অ্যাকাউন্ট-স্তরের মোবাইল অ্যাপ এবং রিভিউ যোগ করা যেতে পারে।

ক্যাম্পেইন, অ্যাড গ্রুপ এবং অ্যাকাউন্ট অ্যাড এক্সটেনশনগুলি সরান

সমর্থিত অ্যাড এক্সটেনশনগুলো অ্যাকাউন্ট লেভেল থেকে ক্যাম্পেইন এবং অ্যাড গ্রুপ থেকে সরানো যায়। গুগল অ্যাডস স্ক্রিপ্ট কোনো অ্যাকাউন্ট থেকে একবারে সব অ্যাড এক্সটেনশন সরানোর সুবিধা দেয় না।

// Get a mobile app from a campaign.
const campaignMobileAppIterator = campaign.extensions().mobileApps().get();
const campaignMobileApp = campaignMobileAppIterator.next();

// Remove the mobile app.
campaign.removeMobileApp(campaignMobileApp);

// The mobile app still exists in the account and will be returned in the
// following iterator.
const mobileAppIterator = AdsApp.extensions().mobileApps().get();

একইভাবে, বিজ্ঞাপন-গোষ্ঠী-স্তরের বা অ্যাকাউন্ট-স্তরের মোবাইল অ্যাপ অপসারণ করতে:

// Get a mobile app from an ad group.
const adGroupMobileAppIterator = adGroup.extensions().mobileApps().get();
const adGroupMobileApp = adGroupMobileAppIterator.next();

// Remove the mobile app.
adGroup.removeMobileApp(adGroupMobileApp);

// Get an account-level mobile app.
const accountMobileAppIterator =
    AdsApp.currentAccount().extensions().mobileApps().get();
const accountMobileApp = accountMobileAppIterator.next();

// Remove the mobile app.
// Note that this removes the mobile app from the account level, so it won't
// serve as an account-level extension, but it will still exist in the
// account. It can still be added to an AdGroup or Campaign, or again as an
// account-level extension in the future.
AdsApp.currentAccount().removeMobileApp(accountMobileApp);

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