میانای کاربری Google Ads قابلیت‌های گزارش‌دهی را ارائه می‌دهد. برای ایجاد گزارش، به سیستم حساب Google Ads خود وارد شوید، در منو پیمایش سمت راست روی پویش‌ها کلیک کنید، و سپس روی اطلاعات آماری و گزارش‌ها کلیک کنید. برای ایجاد گزارش از ابتدا، روی ویرایشگر گزارش کلیک کنید.
این راهنما مفاهیم گزارش‌دهی رایج و قراردادهای نام‌گذاری در میانای کاربری Google Ads را به گزارش‌هایی که می‌توانید بااستفاده از Google Ads Query Language (GAQL) و Google Ads API تولید کنید نگاشت می‌کند. همچنین می‌توانید پیام‌واره‌های موجود در واسط کاربر را دنبال کنید تا گزارشی ایجاد کنید که بهترین تناسب را با الزامات شما داشته باشد.
ابزارها و منابع
برای نمونه‌های دقیق‌تر و راهنمایی خودکار در نگاشت صفحه‌های UI به API، منابع زیر را ببینید:
- Query Cookbook: مجموعه‌ای از پرسمان‌های GAQL که داده‌های یافت‌شده در بسیاری از صفحه‌های میانای کاربر Google Ads را تکرار می‌کند.
- افزونه گزارش‌دهی Google Ads API: افزونه Chrome که به شما کمک می‌کند نام‌های فیلد و منبع API را مستقیماً در «میانای کاربر Google Ads» شناسایی کنید.
اصطلاحات رایج واسط کاربر
جدول زیر برخی‌از اصطلاحات رایج مورداستفاده در میانای کاربر و نگاشت آن‌ها به Google Ads Query Language (GAQL) را خلاصه می‌کند.
| رابط کاربری | GAQL |
|---|---|
| ستون‌ها | هر منبع، فیلد بخش، یا سنجه در SELECT عبارت
یک پُرسمان GAQL. |
| محدوده تاریخ | محدوده‌های تاریخ به عبارت WHERE
فیلترشده در segments.date نگاشت می‌شود. |
| فیلترها | یک یا چند شرط در بند WHERE. |
| فیلدهای بخش | با افزودن فیلدهای بخش به پُرسمان GAQL خود، بخش‌بندی را اعمال کنید. |
| صفحه‌بندی | صفحه‌بندی مجموعه نتایج پُرسمان را به چند صفحه تقسیم می‌کند. |
ستون‌ها
ستون‌ها در میانای کاربری معادل استفاده از عبارت SELECT برای
فیلدهای منبع،
فیلدهای بخش، یا
سنجه‌ها در GAQL است.
برای اطلاعات بیشتر، درباره ستون‌ها در جدول آمار را ببینید.
محدوده تاریخ
رابط کاربری Google Ads جدولی دارد که آمار حساب را نمایش می‌دهد و منوِ کرکره‌ای برای کنترل محدوده تاریخ این آمار دارد.
با فیلتر کردن روی
segments.date در عبارت WHERE پُرسمان GAQL،
همین کنترل را در GAQL دارید.
فیلترها
فیلترها در واسط کاربر معادل یک یا چند شرط در
بند WHERE GAQL هستند.
برای اطلاعات بیشتر، فیلتر کردن نمای داده‌های عملکرد را ببینید.
تقسیم بندی
برای آمار دقیق‌تر، داده‌ها را براساس بخش‌ها تقسیم کنید. برای مثال، فرض کنید می‌خواهید تعداد ظهورهای مختص «شبکه جستجوی Google» را جدا از «شبکه تبلیغات Google» ببینید. در این صورت، گزارش خود را براساس
شبکه بخش‌بندی کنید. برای آشنایی با نحوه گنجاندن فیلدهای بخش در عبارت SELECT، به بخش‌بندی مراجعه کنید.
شماره‌گذاری صفحات
بااستفاده از کنترل‌های موجود در پایین هر جدول داده، در گزارش‌هایتان در واسط کاربر پیمایش کنید. این کنترل‌ها به شما امکان می‌دهند صفحه‌ها را عوض کنید و تعداد نتایج نمایشی را از مجموعه‌ای از اندازه‌های تعریف‌شده انتخاب کنید.
برای صفحه‌بندی نتایج هنگام بازیابی گزارش‌ها، از
GoogleAdsService.Search با
next_page_token استفاده کنید. برای واکشی کل مجموعه نتایج
بدون صفحه‌بندی، از
GoogleAdsService.SearchStream استفاده کنید.
ترتیب نتایج
در میانای کاربر، می‌توانید با انتخاب ستون، نتایج را مرتب کنید.
در GAQL، می‌توانید از بند ORDER BY و بند LIMIT برای مرتب کردن و محدود کردن نتایج پُرسمان استفاده کنید.
قالب‌های بارگیری
در واسط کاربر، گزارش‌ها را می‌توان در قالب‌های مختلفی مثل CSV، TSV، یا XML بارگیری کرد.
این میانای برنامه‌سازی کاربردی مستقیماً خروجی را در فایل‌هایی مثل CSV قالب‌بندی نمی‌کند، بنابراین برنامه کارخواه شما باید پاسخ را قالب‌بندی کند. برای آشنایی با نحوه پیاده‌سازی قالب‌بندی CSV در یک کارخواه، گزارش پویش به نمونه کد CSV را ببینید.
زمان‌بندی و ایمیل کردن گزارش‌ها
می‌توانید گزارشی را از واسط کاربر زمان‌بندی و ایمیل کنید، اما این ویژگی‌ها در API پشتیبانی نمی‌شوند.
نگاشت نماهای میانای کاربر به منابع API
در اینجا فهرستی از نماهای رایج واسط کاربر و «نام منبع GAQL» منطبق با آن‌ها آورده شده است.
| بازدیدهای واسط کاربر | نام منبع GAQL (در عبارت FROM مشخص کنید) |
|---|---|
| حساب | مشتری |
| پویش، جزئیات پویش |
پویش |
| گروه آگهی، جزئیات گروه آگهی |
ad_group |
|
آگهی، نشانی وب نهایی |
ad_group_ad |
| کلیدواژه جستجو | keyword_view |
| عبارت‌های جستجو | search_term_view |
| پولی و عادی (الگوی رؤیت‌پذیری رقابتی)* |
paid_organic_search_term_view |
| صفحه مقصد | landing_page_view |
| صفحه مقصد گسترده | expanded_landing_page_view |
| محتوا > جای آگهی | managed_placement_view |
| محتوا > کجا نمایش داده شده است | group_placement_view |
| محتوا > کجا نمایش داده شده است > مشاهده جزئیات | detail_placement_view |
| مخاطبان > جمعیت‌شناسی > سن | age_range_view |
| مخاطبان > جمعیت‌شناسی > جنسیت | gender_view |
| مکان‌ها | location_view |
| محتوا > موضوع‌ها | topic_view |
| مکان‌ها > گزارش جغرافیایی | geographic_view |
* برای تولید گزارش پولی و عادی، باید حساب «کنسول جستجوی Google» را در سطح مشتری به حساب Google Ads خود پیوند دهید.
به‌عنوان نمونه‌ای از جدول قبلی، می‌توانید از پُرسمان GAQL زیر برای
تولید گزارش «حساب» تجمیع‌شده در ۷ روز گذشته استفاده کنید (اگر می‌خواهید سنجه‌ها براساس روز تفکیک شوند، segments.date
را به عبارت SELECT اضافه کنید):
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
تفاوت‌های رایج
هنگام مقایسه گزارش‌های رابط کاربری با گزارش‌های API، یکی از رایج‌ترین تفاوت‌ها این است که رابط کاربری به‌طور ضمنی نهادهای حذف‌شده را فیلتر می‌کند، درحالی‌که API این کار را نمی‌کند.
برای تکرار نمای پیش‌فرض میانای کاربر، فیلتری بااستفاده از فیلد status اضافه کنید تا
ردیف‌های برداشته‌شده را مستثنی کنید (یا به‌طور صریح نهادهای ENABLED و PAUSED را اضافه کنید). برای مثال:
SELECT campaign.name
FROM campaign
WHERE campaign.status != 'REMOVED'