דיווח

הדוחות מספקים מידע על כל המשאבים השונים בחשבון. אפשר לאחזר מידע על קמפיינים, על קבוצות של מודעות ועל הנתונים הסטטיסטיים שלהם, על היסטוריית השינויים בחשבון ועוד. תשתית הדיווח נתמכת על ידי 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 רק אם לא ניתן יהיה להמיר אותם לייצוג שטוח.

דוגמה לדוח

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.