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

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

• মোবাইল অ্যাপস
• ফোন নাম্বারগুলো
• কলআউট
• দাম
• স্নিপেট
• সাইটলিঙ্ক

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

সতর্কতা: সম্পদ-ভিত্তিক এক্সটেনশনগুলি শীঘ্রই ফিড-ভিত্তিক এক্সটেনশনগুলিকে প্রতিস্থাপন করবে। আরও তথ্যের জন্য মাইগ্রেশন গাইড দেখুন।

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

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

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

সৃষ্টি

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

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 বিজ্ঞাপন স্ক্রিপ্টগুলি আপনাকে অ্যাকাউন্ট, প্রচারাভিযান বা বিজ্ঞাপন গোষ্ঠী স্তরে সমর্থিত বিজ্ঞাপন এক্সটেনশনগুলির পরিসংখ্যান অ্যাক্সেস করতে দেয়।

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

// 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 বিজ্ঞাপন স্ক্রিপ্টের সাহায্যে পরিবর্তন করা যেতে পারে। উদাহরণস্বরূপ, নিম্নলিখিত কোড স্নিপেট একটি বিদ্যমান সাইটলিঙ্ক সংশোধন করবে:

// 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 above.
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 above.
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 থেকে। পূর্ববর্তী কোড উদাহরণ এই আচরণ প্রদর্শন করে.

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

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

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

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

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

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

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

// 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 বিজ্ঞাপন স্ক্রিপ্টগুলি একবারে একটি অ্যাকাউন্ট থেকে বিজ্ঞাপন এক্সটেনশনগুলি সরানো সমর্থন করে না।

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

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