דיווח

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