การรายงาน

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

รายงานเทียบกับการค้นหา

กลไกหลักในการรายงานมี 2 กลไก ทั้ง 2 ประเภทยอมรับการค้นหาประเภทเดียวกัน แต่แตกต่างกันตรงวิธีการแสดงผลลัพธ์

สำหรับทั้ง 2 กรณี เราจะใช้ข้อความค้นหาต่อไปนี้

SELECT
  campaign.id,
  campaign.status,
  metrics.clicks,
  metrics.impressions,
  customer.id
FROM campaign
WHERE
  metrics.impressions > 0

AdsApp.report()

ซึ่งจะแสดงผลการค้นหาแบบแบนคล้ายพจนานุกรม คุณสามารถเข้าถึงช่องต่างๆ ได้ราวกับใช้พจนานุกรม เช่น row["campaign.id"] และ row["metrics.impressions"] โดยตรง เมื่อใช้รูปแบบนี้ คุณจะส่งออกผลลัพธ์ไปยังสเปรดชีตได้โดยตรงโดยใช้เมธอด exportToSheet() รูปแบบนี้ไม่ใช่รูปแบบเนทีฟที่ Google Ads API แสดงผลลัพธ์ ดังนั้นในบางกรณีบางช่องอาจไม่พร้อมใช้งานในรูปแบบนี้ ในกรณีนี้ คุณควรใช้ search แทน

AdsApp.search()

การดำเนินการนี้จะแสดงรายการออบเจ็กต์ GoogleAdsRow ซึ่งมีช่องต่างๆ ซึ่งแต่ละช่องอาจมีช่องย่อย คุณจึงเข้าถึง row.campaign.id และ row.metrics.impressions เพื่อดึงข้อมูล โดยทั่วไปแล้ว รูปแบบนี้จะมีประโยชน์มากกว่าหากคุณวางแผนที่จะประมวลผลข้อมูลแบบเป็นโปรแกรม และฟิลด์บางฟิลด์อาจใช้ได้เฉพาะในรูปแบบ search เท่านั้นหากแปลงเป็นรูปแบบ Flat ไม่ได้

หมายเหตุ: เมื่อใช้ AdsApp.search ฟิลด์ที่แสดงผลจะอยู่ใน lowerCamelCase แม้ว่าจะระบุไว้ใน underscore_case ในข้อความค้นหาก็ตาม ตัวอย่างเช่น หากช่องในการค้นหาคือ campaign.start_date คุณต้องใช้ campaign.startDate เพื่อดึงข้อมูลผลลัพธ์จากแถว

ตัวอย่างรายงาน

let report = AdsApp.report(
    "SELECT " +
    " ad_group.id, search_term_view.search_term, metrics.ctr, metrics.cost_micros, metrics.impressions " +
    "FROM search_term_view " +
    "WHERE metrics.impressions < 10 AND segments.date DURING LAST_30_DAYS");

let rows = report.rows();
while (rows.hasNext()) {
    let row = rows.next();
    let query = row["search_term_view.search_term"];
    let impressions = row["metrics.impressions"];
}

ดูรายละเอียดทั้งหมดเกี่ยวกับการใช้มุมมองนี้ได้ในเอกสารประกอบของ AdsApp.report

ตัวอย่างการค้นหา

let search = AdsApp.search(
    "SELECT " +
    " ad_group.id, search_term_view.search_term, metrics.ctr, metrics.cost_micros, metrics.impressions " +
    "FROM search_term_view " +
    "WHERE metrics.impressions < 10 AND segments.date DURING LAST_30_DAYS");

while (search.hasNext()) {
    let row = search.next();
    let query = row.searchTermView.searchTerm;
    let impressions = row.metrics.impressions;
}

ดูการตั้งค่าทั้งหมดที่เป็นไปได้ในเอกสารประกอบฉบับเต็มของ Adsapp.search