گزارش در 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"