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

Google Ads স্ক্রিপ্ট নিম্নলিখিত বিজ্ঞাপন এক্সটেনশনে কাজ করে:

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

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

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

আপনি একইভাবে অন্যান্য কাজ করে এমন বিজ্ঞাপন এক্সটেনশন তাদের নিজ নিজ ইটারেটর ব্যবহার করে ফিরিয়ে আনতে পারেন।

ক্রিয়েশন

Google Ads স্ক্রিপ্ট আপনাকে বিল্ডার ব্যবহার করে কাজ করে এমন বিজ্ঞাপন এক্সটেনশন তৈরি করতে দেয়। যেমন, নিম্নলিখিত কোড স্নিপেট আপনার অ্যাকাউন্টে ফোন নম্বর তৈরি করতে ফোন নম্বর বিল্ডার ব্যবহার করে:

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);

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

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

Google Ads স্ক্রিপ্ট আপনাকে অ্যাকাউন্ট, ক্যাম্পেন বা বিজ্ঞাপন গ্রুপ লেভেলে কাজ করে এমন বিজ্ঞাপন এক্সটেনশনের পরিসংখ্যান অ্যাক্সেস করতে দেয়।

যেমন, সাইটলিঙ্ক সংক্রান্ত পরিসংখ্যান পেতে:

// 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());

অন্যান্য কাজ করে এমন বিজ্ঞাপন এক্সটেনশনের পরিসংখ্যান একই উপায়ে অ্যাক্সেস করা যেতে পারে।

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

Google Ads স্ক্রিপ্টের মাধ্যমে আগে থেকে কাজ করে এমন বিজ্ঞাপন এক্সটেনশন পরিবর্তন করা যেতে পারে। যেমন, নিম্নলিখিত কোড স্নিপেট আগে থেকে থাকা সাইটলিঙ্ক পরিবর্তন করবে:

// 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"

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

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

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

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

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

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

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

// 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);

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

ক্যাম্পেন, বিজ্ঞাপন গ্রুপ ও অ্যাকাউন্ট বিজ্ঞাপন এক্সটেনশন সরানো

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

// 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);

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