میانای کاربری Google Ads قابلیت‌های گزارش‌دهی را ارائه می‌دهد. برای ایجاد گزارش، به سیستم حساب Google Ads خود وارد شوید، روی پویش‌ها در منو پیمایش سمت راست کلیک کنید، و سپس روی اطلاعات آماری و گزارش‌ها کلیک کنید. برای ایجاد گزارش از ابتدا، روی ویرایشگر گزارش کلیک کنید.
این راهنما مفاهیم گزارش‌دهی رایج و قراردادهای نام‌گذاری در واسط کاربر Google Ads را به گزارش‌هایی که می‌توانید بااستفاده از «زبان پُرسمان Google Ads» (GAQL) و Google Ads API تولید کنید نگاشت می‌کند. همچنین می‌توانید پیام‌واره‌های موجود در واسط کاربر را دنبال کنید تا گزارشی ایجاد کنید که بهترین تناسب را با الزامات شما داشته باشد.
ابزارها و منابع
برای نمونه‌های دقیق‌تر و راهنمایی خودکار در نگاشت صفحه‌های واسط کاربر به 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'