گزارش‌ها در رابط کاربری Google Ads

این راهنما مفاهیم و قراردادهای نام‌گذاری گزارش‌ها در رابط کاربری 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 مراجعه کنید.

صفحه بندی

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

صفحه‌بندی از طریق نتایج هنگام بازیابی گزارش‌ها با 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"
قبلی
صفحه بندی
بعدی
نگاشت پارامترهای مسیر ارزش با فیلدهای گزارش