گزارش نویسی

گزارش ها اطلاعاتی در مورد تمام منابع مختلف در حساب شما ارائه می دهند. می‌توانید اطلاعاتی درباره کمپین‌ها، گروه‌های تبلیغاتی، و آمار آن‌ها، تغییر تاریخچه حسابتان و موارد دیگر دریافت کنید. زیرساخت گزارش‌دهی توسط 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 مشورت کنید.