میانای کاربر Google Ads قابلیت‌های گزارش‌دهی را ارائه می‌دهد. برای ایجاد گزارش، به سیستم حساب Google Ads خود وارد شوید، روی پویش‌ها در منوِ پیمایش سمت راست کلیک کنید، و سپس روی اطلاعات آماری و گزارش‌ها کلیک کنید. برای ایجاد گزارش از ابتدا، روی ویرایشگر گزارش کلیک کنید.
این راهنما مفاهیم گزارش‌دهی رایج و قراردادهای نام‌گذاری در میانای کاربر Google Ads را به گزارش‌هایی که می‌توانید بااستفاده از Google Ads Query Language (GAQL) و Google Ads API تولید کنید نگاشت می‌کند. همچنین می‌توانید پیام‌واره‌های میانای کاربر را دنبال کنید تا گزارشی را که بهترین تناسب را با نیازهایتان دارد ایجاد کنید.
ابزارها و منابع
برای نمونه‌های دقیق‌تر و راهنمایی خودکار در نگاشت صفحه‌های میانای کاربر به API، منابع زیر را ببینید:
- Query Cookbook: مجموعهای از پُرسمان‌های GAQL که داده‌های موجود در بسیاری از صفحه‌های میانای کاربر Google Ads را تکرار می‌کند.
- افزونه گزارش Google Ads API: افزونه Chrome که به شما کمک می‌کند نام‌های فیلد و منبع API را مستقیماً در میانای کاربر Google Ads شناسایی کنید.
اصطلاحات رایج میانای کاربر
جدول زیر برخی‌از اصطلاحات رایج مورداستفاده در میانای کاربر و نگاشت آن‌ها به زبان پُرسمان Google Ads (GAQL) را خلاصه می‌کند.
| رابط کاربری | GAQL |
|---|---|
| ستون‌ها | هر منبع، فیلد بخش، یا سنجه در SELECT عبارت
یک پُرسمان GAQL. |
| محدوده تاریخ | محدوده‌های تاریخ به عبارت WHERE
فیلتر کردن در segments.date نگاشت می‌شوند. |
| فیلترها | یک یا چند شرط در بند WHERE. |
| فیلدهای بخش | با گنجاندن فیلدهای بخش در پُرسمان GAQL، بخش‌بندی را اعمال کنید. |
| صفحه‌بندی | صفحه‌بندی مجموعه نتایج پُرسمان را به چند صفحه تقسیم می‌کند. |
ستون‌ها
ستون‌ها در میانای کاربر معادل استفاده از عبارت SELECT برای
فیلدهای منبع،
فیلدهای بخش، یا
سنجه‌ها در GAQL است.
برای اطلاعات بیشتر، درباره ستون‌ها در جدول آمار را ببینید.
محدوده تاریخ
میانای کاربر Google Ads جدولی دارد که آمار حساب را نمایش می‌دهد و منوِ کرکره‌ای برای کنترل محدوده تاریخ این آمار دارد.
در GAQL با فیلتر کردن روی
segments.date در عبارت WHERE از پُرسمان
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 |
| گروه‌های دارایی | asset_group |
|
آگهی، نشانی وب نهایی |
ad_group_ad |
| محصولات | shopping_performance_view, shopping_product |
| کلیدواژه جستجو | keyword_view |
| عبارت‌های جستجو | search_term_view, campaign_search_term_view |
| پولی و عادی (الگوی رؤیت‌پذیری رقابتی)* |
paid_organic_search_term_view |
| صفحه مقصد | landing_page_view |
| صفحه مقصد گسترده | expanded_landing_page_view |
| محتوا > جای آگهی | managed_placement_view |
| محتوا > کجا نمایش داده شده است | group_placement_view |
| محتوا > کجا نمایش داده شده است > مشاهده جزئیات | detail_placement_view |
| جای آگهی پویش‌های «عملکرد بیشینه» | performance_max_placement_view |
| محتوا > موضوع‌ها | topic_view |
| مخاطبان | ad_group_audience_view، campaign_audience_view |
| مخاطبان > جمعیت‌شناسی > سن | age_range_view |
| مخاطبان > جمعیت‌شناسی > جنسیت | gender_view |
| مکان‌ها | location_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'