گزارش در UI

این راهنما مفاهیم و قراردادهای نام‌گذاری گزارش‌ها در رابط کاربری Google Ads را به گزارش‌هایی که می‌توانید با استفاده از زبان جستجوی Google Ads (GAQL) و Google Ads API ایجاد کنید، ترسیم می‌کند.

اصطلاحات رایج رابط کاربری

جدول زیر برخی از اصطلاحات رایج مورد استفاده در UI و نگاشت آنها به زبان جستجوی تبلیغات گوگل (GAQL) را خلاصه می کند.

UI	GAQL
ستون ها	هر منبع، فیلد بخش یا متریک در عبارت SELECT یک جستار GAQL.
محدوده زمانی	محدوده تاریخ به یک بند WHERE که در segments.date فیلتر می شود، نگاشت می شود.
فیلترها	یک یا چند شرط در بند WHERE .
فیلدهای بخش	با گنجاندن فیلدهای بخش در جستار GAQL خود ، بخش بندی را اعمال کنید.
صفحه بندی	صفحه بندی مجموعه نتایج پرس و جو را به چندین صفحه تقسیم می کند.

ستون ها

ستون‌ها در رابط کاربری معادل فیلدهای منبع ، فیلدهای بخش و متریک در GAQL هستند.

فیلتر کردن

محدوده تاریخ

رابط کاربری Google Ads دارای جدولی است که آمار حساب ها را نشان می دهد و یک منوی کشویی برای کنترل محدوده تاریخ این آمارها.

شما با فیلتر کردن segments.date در عبارت WHERE یک کوئری GAQL، همان کنترل را در GAQL دارید.

فیلترها

فیلترها در UI معادل یک یا چند شرط در بند WHERE GAQL هستند.

تقسیم بندی

برای آمار دقیق تر، می توانید داده ها را بر اساس بخش تقسیم کنید. به عنوان مثال، ممکن است علاقه مند باشید تعداد نمایش های مربوط به شبکه جستجوی گوگل را جدا از شبکه نمایش گوگل ببینید. در این صورت، گزارش خود را بر اساس شبکه تقسیم بندی می کنید. به بخش بندی در مورد نحوه گنجاندن فیلدهای بخش در عبارت SELECT مراجعه کنید.

صفحه بندی

با استفاده از کنترل‌های موجود در پایین هر جدول از داده‌ها، در میان گزارش‌های خود در رابط کاربری پیمایش می‌کنید که به شما امکان می‌دهد صفحات را تغییر دهید و تعداد نتایج را برای نمایش از مجموعه‌ای از اندازه‌های تعریف شده انتخاب کنید.

صفحه‌بندی از طریق نتایج هنگام بازیابی گزارش‌ها با GoogleAdsService.Search در دسترس است. از طریق next_page_token کنید. برای واکشی کل مجموعه نتایج بدون صفحه بندی، از GoogleAdsService.SearchStream استفاده کنید.

نتایج را سفارش دهید

در UI، می توانید نتایج را با انتخاب یک ستون سفارش دهید.

در GAQL می توانید از بند ORDER BY و بند LIMIT برای سفارش نتیجه پرس و جو خود استفاده کنید.

دانلود فرمت ها

در UI، گزارش ها را می توان در قالب های مختلف مانند CSV، TSV یا XML دانلود کرد.

API مستقیماً از فرمت‌های مختلف در خروجی خود پشتیبانی نمی‌کند، بنابراین باید برخی از مراحل پس از پردازش را انجام دهید. نمونه کدی را ببینید که نحوه اجرای قالب بندی CSV را در یک کلاینت نشان می دهد .

برنامه ریزی و گزارش های ایمیل

زمان‌بندی و ارسال ایمیل گزارش در رابط کاربری موجود است، اما در API پشتیبانی نمی‌شود.

گزارش های از پیش تعریف شده

می‌توانید فهرستی از گزارش‌های از پیش تعریف‌شده را در رابط کاربری Google Ads ایجاد کنید.

در اینجا لیستی از گزارش های از پیش تعریف شده اولیه و نام منبع GAQL مطابق با آنها آمده است.

گزارش های از پیش تعریف شده اولیه	نام منبع GAQL (در بند FROM مشخص کنید)
حساب	مشتری
پویش، جزئیات کمپین	پویش
گروه تبلیغات، جزئیات گروه تبلیغاتی	ad_group
آگهی، URL نهایی	ad_group_ad
کلیدواژه ها را جست و جو کنید	keyword_view
عبارات جستجو	search_term_view
پولی و ارگانیک	pay_organic_search_term_view
صفحه فرود	landing_page_view
صفحه فرود گسترش یافته است	expanded_landing_page_view

به عنوان مثال از جدول بالا، می توانید از GAQL زیر برای ایجاد گزارش حساب استفاده کنید:

SELECT
  customer.descriptive_name,
  customer.id,
  metrics.clicks,
  metrics.impressions,
  metrics.ctr,
  metrics.average_cpc,
  metrics.cost_micros,
  metrics.absolute_top_impression_percentage,
  metrics.top_impression_percentage,
  metrics.average_cpm
FROM customer
WHERE segments.date DURING LAST_7_DAYS

تفاوت های مشترک

هنگام مقایسه گزارش‌های UI با گزارش‌های API، یکی از رایج‌ترین تفاوت‌ها این است که UI به طور ضمنی موجودیت‌های حذف شده را فیلتر می‌کند، در حالی که API این کار را نمی‌کند.

برای تکرار یک نمای رابط کاربری پیش‌فرض، باید یک فیلتر، معمولاً با استفاده از فیلد status ، اضافه کنید تا ردیف‌های حذف شده را حذف کنید، به عنوان مثال:

SELECT campaign.name
FROM campaign
WHERE campaign.status != "REMOVED"