דיווח

הדוחות מספקים מידע על כל המשאבים השונים בחשבון. ניתן לאחזר מידע על קמפיינים, קבוצות של מודעות ואת הנתונים הסטטיסטיים שלהם, כדי לשנות היסטוריית החשבון שלך ועוד. תשתית הדיווח מגובה את Google Ads API ומשתמשת ב-GAQL כדי לציין אילו שדות, מדדים ותנאים רוצים להגדיר.

דוח לעומת חיפוש

יש שני מנגנונים עיקריים לדיווח. שניהם מקבלים את אותם סוגים של וההבדלים העיקריים באופן שבו הן מחזירות את התוצאות.

בשני המקרים נשתמש בשאילתה הבאה:

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 אם לא ניתן להמיר אותן לפורמט שטוח בווקטור יהיה זהה,

הערה: כשמשתמשים ב-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 תיעוד של כל ההגדרות האפשריות.