ประเภทโฆษณา

Google Ads รองรับโฆษณาหลากหลายประเภท เช่น โฆษณาแบบข้อความ รูปภาพ และโฆษณาบนอุปกรณ์เคลื่อนที่ คู่มือนี้ครอบคลุมวิธีสร้าง ดึงข้อมูล และรายงานโฆษณาโดยใช้สคริปต์ Google Ads หากต้องการดูภาพรวมของโฆษณาทุกประเภทที่ Google Ads รองรับ โปรดดู คู่มือ API

การสร้างสรรค์

สคริปต์สามารถสร้างโฆษณาได้โดยใช้วิธี newAd() ในอินสแตนซ์ AdGroup ซึ่งจะแสดงผล AdBuilderSpace ที่สร้างเครื่องมือสร้างสำหรับ โฆษณาประเภทที่รองรับ

ข้อมูลโค้ดต่อไปนี้แสดงวิธีสร้างโฆษณา Search ที่ปรับเปลี่ยนตามบริบท

let adOperation = adGroup.newAd().responsiveSearchAdBuilder()
    .withHeadlines(["Headline 1", "Headline 2", "Headline 3"])
    .withDescriptions(["Description 1", "Description 2"])
    .withFinalUrl("http://www.example.com")
    .withPath1("path1")
    .withPath2("path2")
    .build();

การตรวจสอบ

ข้อมูลบางอย่างที่เชื่อมโยงกับโฆษณาทุกประเภทจะพร้อมใช้งานทันทีจาก Ad เช่น รหัสโฆษณาและสถานะการอนุมัติ นอกจากนี้ คุณยังหยุดชั่วคราว เปิดใช้ หรือนำโฆษณาออกได้

หากต้องการเข้าถึงช่องที่เฉพาะเจาะจงกับประเภทโฆษณา เช่น บรรทัดแรกของโฆษณา Search ที่ปรับเปลี่ยนตามบริบท ให้ใช้ asType() เพื่อสร้าง AdViewSpace ซึ่งจะให้สิทธิ์เข้าถึงเวอร์ชันขยายของ Adที่แสดง เมธอดเฉพาะประเภท

ข้อมูลโค้ดต่อไปนี้จะดึงข้อมูลบรรทัดแรกของโฆษณา Search ที่ปรับเปลี่ยนตามบริบททุกรายการ

const iterator = AdsApp.ads().withCondition("Type = RESPONSIVE_SEARCH_AD").get();
while (iterator.hasNext()) {
  let ad = iterator.next();
  let responsiveSearchAd = ad.asType().responsiveSearchAd();
  let headlines = responsiveSearchAd.getHeadlines();
}

โปรดสังเกตว่าเงื่อนไข Type = RESPONSIVE_SEARCH_AD จะทำให้มั่นใจว่าโฆษณาทุกรายการจากตัววนซ้ำเป็นโฆษณา Search ที่ปรับเปลี่ยนตามบริบท การพยายามดูโฆษณาที่มีประเภทไม่ถูกต้องจะทำให้เกิดข้อผิดพลาดที่หยุดการทำงานของสคริปต์ ดังนั้นคุณควรดูช่องเฉพาะประเภทเมื่อทราบประเภทของโฆษณาเท่านั้น

ข้อมูลโค้ดต่อไปนี้แสดงวิธีตรวจสอบว่าโฆษณาเป็นประเภทที่ถูกต้องหรือไม่ โดยใช้ Ad.isType() วิธี:

if (ad.isType().responsiveSearchAd()) {
  let responsiveSearchAd = ad.asType().responsiveSearchAd();
  let headlines = responsiveSearchAd.getHeadlines();
  let descriptions = responsiveSearchAd.getDescriptions();
}

แม้ว่าคุณจะกรองโฆษณาตามข้อความบรรทัดแรกโดยใช้ตัวเลือกมาตรฐานไม่ได้ แต่คุณสามารถกรองโฆษณาใน JavaScript ได้หลังจากดึงข้อมูลแล้ว

const iterator = AdsApp.ads().withCondition("Type = RESPONSIVE_SEARCH_AD").get();
while (iterator.hasNext()) {
  let ad = iterator.next();
  let responsiveSearchAd = ad.asType().responsiveSearchAd();
  let headlines = responsiveSearchAd.getHeadlines();
  // Filter for ads containing a specific headline.
  if (headlines.some(h => h.getText().includes("Special Offer"))) {
    console.log(`Found ad with ID ${ad.getId()}`);
  }
}

การรายงาน

คุณสามารถใช้มุมมอง ad_group_ad เพื่อค้นหาช่องโฆษณาเพิ่มเติมจากสถิติทั่วไป เช่น คุณสามารถ กรองตามประเภทโฆษณาโดยใช้ ad_group_ad.ad.type ข้อมูลโค้ดต่อไปนี้แสดงวิธีดึงข้อมูลสถิติสำหรับโฆษณา Search ที่ปรับเปลี่ยนตามบริบททั้งหมด

const results = AdsApp.search(
  "SELECT ad_group_ad.ad_group.id, " +
          "ad_group_ad.ad.id, " +
          "metrics.clicks, " +
          "metrics.impressions, " +
          "metrics.cost " +
  "FROM ad_group_ad " +
  "WHERE ad_group_ad.ad.type = 'RESPONSIVE_SEARCH_AD' " +
    "AND segments.date DURING LAST_7_DAYS");

while (results.hasNext()) {
  let row = results.next();
  let adId = row.adGroupAd.ad.id;
  let clicks = row.metrics.clicks;
  ...
}

การกรองตามเนื้อหาชิ้นงาน

หากต้องการกรองโฆษณา Search ที่ปรับเปลี่ยนตามบริบทตามเนื้อหาบรรทัดแรกหรือ คำอธิบายในวงกว้าง ให้ใช้ ad_group_ad_asset_view แหล่งข้อมูล มุมมองนี้จะถือว่าบรรทัดแรกและคำอธิบายแต่ละรายการเป็นแถวแยกกัน ซึ่งช่วยให้คุณกรองตามข้อความของชิ้นงานได้

ข้อมูลโค้ดต่อไปนี้จะดึงข้อมูลสถิติสำหรับโฆษณา Search ที่ปรับเปลี่ยนตามบริบททั้งหมดที่มีบรรทัดแรกที่เฉพาะเจาะจง

const results = AdsApp.search(
  "SELECT ad_group_ad.ad.id, " +
          "asset.text_asset.text, " +
          "metrics.clicks, " +
          "metrics.impressions " +
  "FROM ad_group_ad_asset_view " +
  "WHERE asset.text_asset.text LIKE '%Special Offer%' " +
    "AND ad_group_ad_asset_view.field_type = 'HEADLINE'");

while (results.hasNext()) {
  let row = results.next();
  let adId = row.adGroupAd.ad.id;
  let text = row.asset.textAsset.text;
  let clicks = row.metrics.clicks;
  console.log(`Ad ID ${adId} with headline "${text}" had ${clicks} clicks.`);
}

ดูข้อมูลเพิ่มเติมเกี่ยวกับการรายงานในสคริปต์ได้ในคู่มือการรายงานสำหรับ