ประเภทโฆษณา

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.`);
}

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