رابط کاربری گوگل ادز قابلیتهای گزارشدهی را ارائه میدهد. برای ایجاد گزارش، وارد حساب گوگل ادز خود شوید. در سمت چپ روی کمپینها کلیک کنید و سپس روی بینشها و گزارشها کلیک کنید. برای ایجاد گزارش از ابتدا، روی ویرایشگر گزارش کلیک کنید.
این راهنما مفاهیم رایج گزارشدهی و قراردادهای نامگذاری در رابط کاربری گوگل ادز را به گزارشهایی که میتوانید با استفاده از زبان جستجوی گوگل ادز (GAQL) و API گوگل ادز تولید کنید، مرتبط میکند. همچنین میتوانید دستورالعملهای موجود در رابط کاربری را دنبال کنید تا گزارشی را ایجاد کنید که به بهترین وجه با نیازهای شما مطابقت داشته باشد.
ابزارها و منابع
برای مثالهای دقیقتر و کمک خودکار در نگاشت صفحات رابط کاربری به API، به منابع زیر مراجعه کنید:
- کتاب راهنمای کوئری : مجموعهای از کوئریهای GAQL که دادههای موجود در بسیاری از صفحات رابط کاربری رایج گوگل ادز را تکرار میکنند.
- افزونه گزارشدهی API گوگل ادز : یک افزونه کروم که به شما کمک میکند نام منابع و فیلدهای API را مستقیماً در رابط کاربری گوگل ادز شناسایی کنید.
اصطلاحات رایج رابط کاربری
جدول زیر خلاصهای از برخی از اصطلاحات رایج مورد استفاده در رابط کاربری و ارتباط آنها با زبان جستجوی گوگل ادز (GAQL) را نشان میدهد.
| رابط کاربری | جیکیوال |
|---|---|
| ستونها | هر منبع، فیلد قطعه یا معیاری در بند SELECT از یک پرسوجوی GAQL. |
| محدوده تاریخ | محدودههای تاریخ به یک عبارت WHERE که روی segments.date فیلتر میکند، نگاشت میشوند. |
| فیلترها | یک یا چند شرط در عبارت WHERE . |
| فیلدهای قطعهای | با گنجاندن فیلدهای بخشبندی در پرسوجوی GAQL خود، بخشبندی را اعمال کنید. |
| صفحه بندی | صفحهبندی، مجموعه نتایج پرسوجو را به چندین صفحه تقسیم میکند. |
ستونها
ستونها در رابط کاربری معادل استفاده از یک عبارت SELECT برای فیلدهای 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 پشتیبانی نمیشوند.
نگاشت نماهای رابط کاربری به منابع 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'