انواع تبلیغات

Google Ads از انواع تبلیغات مانند تبلیغات متنی، تصویری و موبایلی پشتیبانی می کند. این راهنما نحوه ایجاد، بازیابی و گزارش تبلیغات را با استفاده از اسکریپت های Google Ads پوشش می دهد. برای مروری بر همه انواع تبلیغات پشتیبانی شده توسط Google Ads، به راهنمای API مراجعه کنید.

توجه: تبلیغات نمایشی واکنش‌گرا از چندین دارایی متن، تصویر و ویدیو در یک آگهی پشتیبانی می‌کنند. تبلیغات نمایشی پاسخگو قدیمی از این ویژگی های جدید پشتیبانی نمی کنند. هم تبلیغات جدید و هم تبلیغات قدیمی مانند همیشه به کار خود ادامه می دهند، اما API برای بازیابی و دستکاری تبلیغات نمایشی واکنشگرا تغییر کرده است. لطفاً به مدیریت تبلیغات نمایشی واکنشگرای قدیمی مراجعه کنید.

ایجاد

اسکریپت ها می توانند با استفاده از روش newAd() در نمونه های AdGroup تبلیغات ایجاد کنند. این یک AdBuilderSpace را برمی گرداند که سازنده هایی برای انواع تبلیغات پشتیبانی شده ایجاد می کند.

قطعه زیر نحوه ایجاد یک تبلیغ متنی گسترده را نشان می دهد:

let adOperation = adGroup.newAd().expandedTextAdBuilder()
    .withHeadlinePart1("First headline part")
    .withHeadlinePart2("Second headline part")
    .withDescription("Ad description")
    .withFinalUrl("http://www.example.com")
    .withPath1("path1") // optional
    .withPath2("path2") // optional
    .build();

بازرسی

برخی از اطلاعات مرتبط با همه انواع تبلیغات، مانند شناسه آگهی و وضعیت تأیید، فوراً از طریق Ad در دسترس است. علاوه بر این، هر تبلیغی را می توان متوقف، فعال یا حذف کرد.

برای دسترسی به فیلدهای خاص برای نوع تبلیغ، مانند توضیحات یک تبلیغ متنی گسترده، از روش asType() برای ایجاد AdViewSpace استفاده کنید. این امکان دسترسی به نسخه توسعه یافته Ad را فراهم می کند که روش های نوع خاص را در معرض دید قرار می دهد.

قطعه زیر توضیحات هر تبلیغ متنی گسترده را دریافت می کند:

const iterator = AdsApp.ads().withCondition("Type = EXPANDED_TEXT_AD").get();
while (iterator.hasNext()) {
  let ad = iterator.next();
  let expandedTextAd = ad.asType().expandedTextAd();
  let description = expandedTextAd.getDescription();
}

توجه داشته باشید که شرط Type = EXPANDED_TEXT_AD تضمین می کند که هر آگهی از تکرار کننده یک تبلیغ متنی گسترده است. تلاش برای مشاهده یک تبلیغ با نوع نادرست منجر به خطایی می شود که اجرای اسکریپت شما را متوقف می کند، بنابراین دیدن فیلدهای نوع خاص فقط زمانی مهم است که نوع تبلیغ مشخص باشد.

قطعه زیر نشان می دهد که چگونه می توان با استفاده از متد Ad.isType() تشخیص داد که آیا یک تبلیغ از نوع صحیح است یا خیر:

if (ad.isType().expandedTextAd()) {
  let expandedTextAd = ad.asType().expandedTextAd();
  let headlinePart1 = expandedTextAd.getHeadlinePart1();
  let headlinePart2 = expandedTextAd.getHeadlinePart2();
}

گزارش نویسی

نمای ad_group_ad همچنین می تواند برای پرس و جو از فیلدهای تبلیغاتی خاص علاوه بر آمارهای معمولی، مانند ad_group_ad.expanded_text_ad.headline_part1 استفاده شود. قطعه زیر نشان می دهد که چگونه می توان آمار همه تبلیغات متنی گسترده ای را که حاوی "تخفیف فروش" در عنوان 1 هستند بازیابی کرد:

const results = AdsApp.search(
  "SELECT ad_group_ad.ad_group.id, " +
         "ad_group_ad.id, " +
         "ad_group_ad.expanded_text_ad.headline_part1, " +
         "ad_group_ad.expanded_text_ad.headline_part2, " +
         "metrics.clicks, " +
         "metrics.impressions, " +
         "metrics.cost" +
  "FROM ad_group_ad " +
  "WHERE ad_group_ad.expanded_text_ad.headline_part1 = 'Discount Sales' " +
    "AND segments.date DURING LAST_7_DAYS");

while (results.hasNext()) {
  let row = results.next();
  let headlinePart1 = row.adGroupAd.expandedTextAd.headlinePart1;
  let headlinePart2 = row.adGroupAd.expandedTextAd.headlinePart2;
  ...
}

برای اطلاعات بیشتر در مورد گزارش در اسکریپت به راهنمای گزارش ها مراجعه کنید.