این راهنما مفاهیم و قراردادهای نامگذاری گزارش‌ها در رابط کاربری گوگل ادز را به گزارش‌هایی که می‌توانید با استفاده از زبان جستجوی گوگل ادز (GAQL) و API گوگل ادز تولید کنید، مرتبط می‌کند.
اصطلاحات رایج رابط کاربری
جدول زیر خلاصه‌ای از برخی از اصطلاحات رایج مورد استفاده در رابط کاربری و ارتباط آنها با زبان جستجوی گوگل ادز (GAQL) را نشان می‌دهد.
| رابط کاربری | جی‌کیوال |
|---|---|
| ستون‌ها | هر منبع، فیلد قطعه یا معیاری در بند SELECT از یک پرس‌وجوی GAQL. |
| محدوده تاریخ | محدوده‌های تاریخ به یک عبارت WHERE که روی segments.date فیلتر می‌کند، نگاشت می‌شوند. |
| فیلترها | یک یا چند شرط در عبارت WHERE . |
| فیلدهای قطعه‌ای | با گنجاندن فیلدهای بخش‌بندی در پرس‌وجوی GAQL خود، بخش‌بندی را اعمال کنید. |
| صفحه بندی | صفحه‌بندی، مجموعه نتایج پرس‌وجو را به چندین صفحه تقسیم می‌کند. |
ستون‌ها
ستون‌ها در رابط کاربری معادل فیلدهای Resource ، فیلدهای Segment و Metrics در GAQL هستند.
فیلتر کردن
شما می‌توانید داده‌ها را در گزارش‌های خود فیلتر و سازماندهی کنید.
محدوده‌های تاریخ
رابط کاربری گوگل ادز دارای جدولی است که آمار حساب کاربری را نمایش می‌دهد و یک منوی کشویی برای کنترل محدوده تاریخ این آمار دارد.
شما در GAQL با فیلتر کردن segments.date در عبارت WHERE یک کوئری GAQL، همین کنترل را دارید.
فیلترها
فیلترها در رابط کاربری معادل یک یا چند شرط در عبارت WHERE از GAQL هستند.
تقسیم‌بندی
برای آمار دقیق‌تر، داده‌ها را بر اساس بخش‌ها تقسیم کنید. برای مثال، فرض کنید می‌خواهید تعداد نمایش‌های خاص شبکه جستجوی گوگل را جدا از شبکه نمایش گوگل ببینید. در این صورت، گزارش خود را بر اساس شبکه تقسیم‌بندی کنید. برای نحوه گنجاندن فیلدهای بخش‌بندی در عبارت SELECT، به بخش تقسیم‌بندی مراجعه کنید.
صفحه بندی
با استفاده از کنترل‌های موجود در پایین هر جدول داده، در رابط کاربری گزارش‌های خود را پیمایش کنید. این کنترل‌ها به شما امکان می‌دهند صفحات را تغییر دهید و تعداد نتایج نمایش داده شده را از بین مجموعه‌ای از اندازه‌های تعریف شده انتخاب کنید.
هنگام بازیابی گزارش‌ها با استفاده از GoogleAdsService.Search through next_page_token ، امکان صفحه‌بندی نتایج وجود دارد. برای دریافت کل مجموعه نتایج بدون هیچ صفحه‌بندی، از GoogleAdsService.SearchStream استفاده کنید.
نتایج سفارش
در رابط کاربری، می‌توانید با انتخاب یک ستون، نتایج را مرتب کنید.
در GAQL، می‌توانید از دستور ORDER BY و دستور LIMIT برای مرتب‌سازی نتایج پرس‌وجوی خود استفاده کنید.
فرمت‌های دانلود
در رابط کاربری، گزارش‌ها را می‌توان در قالب‌های مختلفی مانند CSV، TSV یا XML دانلود کرد.
این API مستقیماً از فرمت‌های مختلف در خروجی خود پشتیبانی نمی‌کند، بنابراین شما باید مقداری پردازش پس از پردازش انجام دهید. به این نمونه کد مراجعه کنید که نحوه پیاده‌سازی قالب‌بندی CSV را در یک کلاینت نشان می‌دهد.
گزارش‌های زمانبندی و ایمیل
شما می‌توانید از طریق رابط کاربری، گزارش را زمانبندی و ایمیل کنید، اما این ویژگی‌ها در API پشتیبانی نمی‌شوند.
گزارش‌های از پیش تعریف‌شده
شما می‌توانید فهرستی از گزارش‌های از پیش تعریف‌شده را در رابط کاربری گوگل ادز ایجاد کنید.
در اینجا لیستی از گزارش‌های از پیش تعریف‌شده‌ی پایه و نام منبع GAQL منطبق با آنها آمده است.
| گزارش‌های از پیش تعریف‌شده‌ی پایه | نام منبع GAQL (در بند FROM مشخص کنید) |
|---|---|
| حساب کاربری | مشتری |
| کمپین، جزئیات کمپین | کمپین |
| گروه تبلیغاتی، جزئیات گروه تبلیغاتی | گروه_تبلیغاتی |
| آگهی، آدرس اینترنتی نهایی | گروه_تبلیغات_ad |
| کلمه کلیدی جستجو | کلمه کلیدی_view |
| عبارات جستجو | search_term_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، یکی از رایج‌ترین تفاوت‌ها این است که رابط کاربری به طور ضمنی موجودیت‌های حذف شده را فیلتر می‌کند، در حالی که API این کار را نمی‌کند.
برای تکرار یک نمای رابط کاربری پیش‌فرض، باید یک فیلتر، معمولاً با استفاده از یک فیلد status ، اضافه کنید تا ردیف‌های حذف شده را حذف کنید. برای مثال:
SELECT campaign.name
FROM campaign
WHERE campaign.status != "REMOVED"