รายงาน

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

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

มีกลไกหลัก 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 หากไม่สามารถแปลงเป็นแฟลต การให้คำแนะนำ

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

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 เกี่ยวกับการตั้งค่าที่เป็นไปได้ทั้งหมด