پیگیری جایگاه و عملکرد آگهی

Google Ads API چندین نما برای تجزیه‌وتحلیل مکان نمایش آگهی‌هایتان و نحوه عملکرد آن‌ها ارائه می‌دهد: managed_placement_view، group_placement_view، detail_placement_view، و performance_max_placement_view. هر نما، لنز متفاوتی را برای داده‌های جای آگهی شما ارائه می‌دهد. برای «زبان پُرسمان Google Ads» آماده اجرا (GAQL) و پُرسمان‌های curl که صفحه‌های جای آگهی را در میانای کاربر Google Ads تکرار می‌کنند، کتاب راهنمای پُرسمان را ببینید.

نمای جای آگهی مدیریت‌شده

• آنچه نشان می‌دهد: منبع managed_placement_view داده‌های عملکرد را که براساس معیارهای جای آگهی مثبتی که در گروه‌های آگهی‌تان هدف‌یابی می‌کنید جمع‌آوری شده است ارائه می‌دهد. این نما شامل هر پنج نوع معیار مدیریت‌شده تحت محتوا > جای آگهی در میانای کاربر Google Ads است: وب‌سایت‌ها، کانال‌های YouTube، ویدیوهای YouTube، برنامه‌های تلفن همراه، و دسته‌های برنامه تلفن همراه.
• معادل میانای کاربر: محتوا > جای آگهی
• پرسمان‌ساز: کاوش در «پرسمان‌ساز»

انواع معیار جای آگهی هدف‌یابی‌شده

هر ردیف در منبع managed_placement_view فیلد AdGroupCriterion را که با مقدار ad_group_criterion.type آن مطابقت دارد پر می‌کند و سایر فیلدهای جای آگهی را تنظیم‌نشده باقی می‌گذارد:

نوع جای آگهی میانای کاربر	به‌ارزش ad_group_criterion.type	فیلدهای جزئیات معیار	یادداشت‌ها
وب‌سایت‌ها	PLACEMENT	ad_group_criterion.placement.url	نشانی وب‌سایت یا دامنه هدف.
کانال‌های YouTube	YOUTUBE_CHANNEL	ad_group_criterion.youtube_channel.channel_id	شناسه کانال YouTube. فیلد ad_group_criterion.display_name نام کانال را برمی‌گرداند.
ویدیوهای YouTube	YOUTUBE_VIDEO	ad_group_criterion.youtube_video.video_id	شناسه ویدیو YouTube. فیلد ad_group_criterion.display_name عنوان ویدیو را برمی‌گرداند.
برنامه‌ها	MOBILE_APPLICATION	ad_group_criterion.mobile_application.app_id، ad_group_criterion.mobile_application.name	شناسه برنامه در قالب {platform}-{platform_native_id} (1- برای iOS،‏ 2- برای Android) و نام برنامه.
دسته‌های برنامه	MOBILE_APP_CATEGORY	ad_group_criterion.mobile_app_category.mobile_app_category_constant	نام منبع در قالب mobileAppCategoryConstants/{mobile_app_category_id}. نام‌ها و سلسله‌مراتب دسته برنامه تلفن همراه را ببینید.

پُرسمان نمونه

برای واکشی سنجه‌های عملکرد در همه انواع جایگاه هدفمند در ۳۰ روز گذشته، فیلد ad_group_criterion.type را در کنار فیلدهای مختص نوع انتخاب کنید:

SELECT
  campaign.id,
  ad_group.id,
  managed_placement_view.resource_name,
  ad_group_criterion.criterion_id,
  ad_group_criterion.type,
  ad_group_criterion.display_name,
  ad_group_criterion.placement.url,
  ad_group_criterion.youtube_channel.channel_id,
  ad_group_criterion.youtube_video.video_id,
  ad_group_criterion.mobile_application.app_id,
  ad_group_criterion.mobile_application.name,
  ad_group_criterion.mobile_app_category.mobile_app_category_constant,
  metrics.impressions,
  metrics.clicks,
  metrics.cost_micros
FROM managed_placement_view
WHERE segments.date DURING LAST_30_DAYS

توجه: انتخاب فیلدهای segments (مانند segments.date) در عبارت SELECT جای‌گذاری‌های هدفمند با سنجه‌های صفر را مستثنی می‌کند (به مستثنی کردن سنجه‌های صفر با بخش‌بندی مراجعه کنید). برای بازیابی همه معیارهای جای آگهی پیکربندی‌شده بدون سنجه، مستقیماً منبع ad_group_criterion را پرس‌وجو کنید.

نام‌ها و سلسله مراتب دسته برنامه تلفن همراه

در میانای کاربر Google Ads، دسته‌های هدف‌یابی‌شده برنامه تلفن همراه مسیر کامل فروشگاه را نمایش می‌دهند، مثلاً دسته‌های برنامه > Apple App Store > آموزش. هنگام پرسمان کردن Google Ads API، رفتارهای زیر را درنظر داشته باشید:

• ثابت‌های دسته برنامه تلفن همراه منسوب: منبع mobile_app_category_constant منبع منسوب منبع managed_placement_view نیست. به‌جای آن، فیلد ad_group_criterion.mobile_app_category.mobile_app_category_constant را انتخاب کنید (برای مثال، mobileAppCategoryConstants/60503)، یا وقتی به سنجه‌ها نیاز ندارید، منبع ad_group_criterion را پُرسمان کنید.
• نام‌های نمایشی فقط برگ: هر دو فیلد ad_group_criterion.display_name و mobile_app_category_constant.name فقط نام دسته برگ را برمی‌گردانند، مانند "Education" یا "Games". هیچ‌کدام از فیلدها شامل مسیر فروشگاه برنامه اصلی نیست.
• حل کردن مسیر فروشگاه برنامه: Google Play و Apple App Store نام‌های دسته برگ را در شناسه‌های معیار متمایز هم‌رسانی می‌کنند. برای مثال، شناسه‌های معیار 60005 (/All Apps/Google Play/Education)، 60060 (/All Apps/Google Play/Family/Education)، و 60503 (/All Apps/Apple App Store/Education) همگی "Education" را در فیلدهای name و display_name برمی‌گردانند. پسوند {mobile_app_category_id} را از نام منبع استخراج کنید و مسیر سلسله‌مراتبی کامل آن را در جدول یا فایل CSV دسته‌های برنامه تلفن همراه جستجو کنید.

نمای جای آگهی گروهی

• آنچه نشان می‌دهد: منبع group_placement_view نشان می‌دهد که آگهی‌های شما واقعاً در کجا در «شبکه تبلیغات» و YouTube ارائه شده‌اند، صرف‌نظر از اینکه جای آگهی‌ها به‌طور صریح هدف‌یابی شده باشند یا به‌طور خودکار توسط سیستم Google کشف شده باشند. این می‌تواند شامل وب‌سایت‌ها، کانال‌ها یا ویدیوهای YouTube، و برنامه‌ها باشد.
• معادل واسط کاربر: محتوا > محل نمایش آگهی‌ها
• پرسمان‌ساز: کاوش در «پرسمان‌ساز»

پُرسمان نمونه

پرسمان زیر سنجه‌های عملکرد را برای دامنه‌ها، برنامه‌های تلفن همراه، و کانال‌های YouTube که آگهی‌ها در ۳۰ روز گذشته در آن‌ها نمایش داده شده‌اند واکشی می‌کند:

SELECT
  campaign.id,
  ad_group.id,
  group_placement_view.display_name,
  group_placement_view.target_url,
  group_placement_view.placement_type,
  metrics.impressions,
  metrics.clicks,
  metrics.cost_micros
FROM group_placement_view
WHERE segments.date DURING LAST_30_DAYS

ردیف «مجموع: سایر»

برای تسریع تولید گزارش، منابع group_placement_view و detail_placement_view جای آگهی‌های تکی را که حداقل آستانه فعالیت برای ظهور یا تعامل را ندارند مستثنی می‌کنند.

• در واسط کاربری Google Ads: واسط کاربری جای آگهی‌هایی را که این آستانه فعالیت را برآورده نمی‌کنند در ردیف خلاصه‌ای با برچسب مجموع: سایر جمع‌آوری می‌کند.
• در Google Ads API: این API جایگاه‌هایی را که آستانه فعالیت را برآورده نمی‌کنند از نتایج گزارش حذف می‌کند و ردیف خلاصه‌ای را که فیلد group_placement_view.placement یا detail_placement_view.placement مقدار "Other" دارد برنمی‌گرداند.

درنتیجه، مجموع ردیف‌های جای آگهی تکی در منابع group_placement_view و detail_placement_view ممکن است کمتر از کل سنجه‌های گروه آگهی یا پویش باشد. برای اطلاعات بیشتر، به درباره گزارش «محل نمایش آگهی‌ها» مراجعه کنید. برای جزئیات مربوط به نحوه تأثیر آستانه‌ها و فراداده‌های مفقود بر مقایسه‌های بین‌نمایی، به تفاوت‌های سنجه بین نماهای جای آگهی و ردیف‌های دارای جزئیات جای آگهی غیرقابل‌دسترس مراجعه کنید.

تنظیمات هدف‌یابی جایگاه

رفتار و سودمندی group_placement_view تحت تأثیر TargetingSetting برای بُعد PLACEMENT در سطح گروه آگهی است. این تنظیم حاوی فهرستی از target_restrictions است که هرکدام فیلد بولی bid_only دارند که تعیین می‌کند آگهی‌هایتان فقط در جایگاه‌های هدفمند نشان داده شوند یا در جایگاه‌های دیگر هم نشان داده شوند. درباره تنظیمات «هدف‌یابی» و «مشاهده» را ببینید.

• bid_only = false: این مقدار با هدف‌یابی در واسط کاربری Google Ads برای جای آگهی‌ها مطابقت دارد. اگر گروه آگهی شما روی «هدف‌یابی» تنظیم شده باشد، آگهی‌هایتان فقط در جای آگهی‌هایی که صریحاً به‌عنوان معیار اضافه کرده‌اید نشان داده می‌شود. می‌توانید انتخاب کنید که تعدیل‌های قیمت پیشنهادی را برای این جای آگهی‌ها اعمال کنید. در این سناریو، group_placement_view تا حد زیادی managed_placement_view را منعکس می‌کند، اما همچنان مشمول آستانه‌های حداقل فعالیت است.
• bid_only = true: این مقدار با مشاهده در واسط کاربری Google Ads برای جای آگهی‌ها مطابقت دارد. اگر گروه آگهی‌تان روی «مشاهده» تنظیم شده باشد، آگهی‌هایتان می‌توانند در هر جای آگهی واجدشرایطی در «شبکه تبلیغات» و YouTube نشان داده شوند. همچنین می‌توانید تعدیل قیمت‌های پیشنهادی را برای هر جای آگهی که هدف‌یابی کرده‌اید اعمال کنید. در این مورد، group_placement_view برای کشف جایگاه‌های جدیدی که آگهی‌هایتان در آن‌ها نمایش داده می‌شود بسیار مهم است، که سپس می‌توانید آن‌ها را به‌عنوان جایگاه‌های مدیریت‌شده یا حذفی اضافه کنید.

نمای جای آگهی مفصل

• آنچه نشان می‌دهد: منبع detail_placement_view تفکیک دقیق‌تری از جای آگهی‌ها ارائه می‌دهد و جزئیاتی فراتر از سطح دامنه یا کانال ارائه می‌کند. برای مثال، می‌تواند نشانی‌های وب یا شناسه‌های ویدیو YouTube خاصی را که آگهی‌هایتان در آن‌ها نمایش داده شده است نشان دهد.
• معادل واسط کاربر: معادل انتخاب ردیف‌ها در محتوا > محل نمایش آگهی‌ها، سپس کلیک کردن روی مشاهده جزئیات.
• پرسمان‌ساز: کاوش در «پرسمان‌ساز»
• ملاحظات مهم: مشابه منبع group_placement_view، این نما جای آگهی‌های کم‌فعالیت را که حداقل آستانه فعالیت را برآورده نمی‌کنند حذف می‌کند (بخش «ردیف کل: سایر» را ببینید).

توجه: منبع detail_placement_view در سطح دانه‌ای گزارش می‌دهد (نشانی‌های وب و شناسه‌های ویدیو به‌صورت جداگانه) و می‌تواند داده‌های با تعداد مقادیر متمایز بالا را برگرداند. همیشه پُرسمان‌ها را براساس محدوده تاریخ یا پویش‌ها و گروه‌های آگهی خاص فیلتر کنید تا از حجم زیاد بار داده و اتمام مهلت پُرسمان جلوگیری شود.

پُرسمان نمونه

برای محدود کردن حجم نتایج، پُرسمان زیر سنجه‌های جای آگهی در سطح نشانی وب و سطح ویدیو را در بازه زمانی ۷ روزه واکشی می‌کند. برای حساب‌های بزرگ، با فیلد campaign.id یا ad_group.id فیلتر بیشتری اعمال کنید:

SELECT
  campaign.id,
  ad_group.id,
  detail_placement_view.display_name,
  detail_placement_view.target_url,
  detail_placement_view.group_placement_target_url,
  detail_placement_view.placement_type,
  metrics.impressions,
  metrics.clicks,
  metrics.cost_micros
FROM detail_placement_view
WHERE segments.date DURING LAST_7_DAYS

برای مستثنی کردن ردیف‌هایی که فراداده جای آگهی برای آن‌ها دردسترس نیست، AND detail_placement_view.target_url IS NOT NULL را اضافه کنید (ردیف‌های دارای جزئیات جای آگهی غیرقابل‌دسترس را ببینید). وقتی به فیلدهای resource_name برگردانده‌شده نیاز ندارید، عبارت PARAMETERS omit_unselected_resource_names = true را اضافه کنید.

تفاوت‌های سنجه بین نماهای جای آگهی

حداقل آستانه فعالیت به‌طور مستقل در هر سطح از دانه‌بندی ارزیابی می‌شود:

• منبع group_placement_view آستانه را در سراسر دامنه، برنامه تلفن همراه، یا کانال YouTube انبوهشی ارزیابی می‌کند.
• منبع detail_placement_view آستانه را به‌طور جداگانه برای هر نشانی وب صفحه یا ویدیو YouTube ارزیابی می‌کند.

منبع detail_placement_view نشانی‌های وب صفحه تکی یا ویدیوهای YouTube را که به آستانه نرسیده‌اند حذف می‌کند. درنتیجه، جمع کردن ردیف‌های detail_placement_view برای یک دامنه یا کانال YouTube (فیلترشده براساس فیلد detail_placement_view.group_placement_target_url) می‌تواند تعداد ظهور کمتری نسبت‌به ردیف group_placement_view مربوطه برگرداند.

ردیف‌های با جزئیات جای ناموجود

پرسمان دربرابر منبع group_placement_view یا detail_placement_view می‌تواند چندین ردیف را در همان گروه آگهی با فیلدهای placement، display_name، و target_url تنظیم‌نشده و مقدار resource_name یکسان (برای مثال، منتهی به ~MTRf) برگرداند.

این رفتار به‌دلایل زیر رخ می‌دهد:

• گروه‌بندی جای آگهی داخلی: هر دو نما سنجه‌های عملکرد را براساس شناسه جای آگهی داخلی منحصربه‌فرد گروه‌بندی می‌کنند، نه براساس فیلدهای رشته‌ای resource_name یا placement.
• فراداده جای آگهی دردسترس نیست: در واسط کاربری Google Ads، جای آگهی‌های بدون فراداده در جدول‌های جستجوی باطن به‌صورت نامشخص، کانال دیگر دردسترس نیست، یا ویدیو دیگر دردسترس نیست نشان داده می‌شود. در میانای برنامه‌سازی کاربردی، هر شناسه جای آگهی متمایز همچنان یک ردیف سنجه برمی‌گرداند که فیلدهای placement، display_name، و target_url در آن تنظیم نشده است.
• نام‌های منبع ترکیبی: پسوند {base64_placement} در فیلد resource_name از {type_id}_{placement} کدبندی Base64 شده است، که در آن {type_id} یک شناسه نوع جای آگهی داخلی است و نه شماره شمارشی PlacementType. وقتی فیلد placement_type برابر با WEBSITE (شناسه داخلی 14) است و فیلد placement تنظیم نشده است، رشته "14_" به MTRf کدگذاری می‌شود (به‌طور مشابه، MOBILE_APPLICATION رشته "55_" را به NTVf، YOUTUBE_VIDEO رشته "89_" را به ODlf، و YOUTUBE_CHANNEL رشته "90_" را به OTBf کدگذاری می‌کند). بنابراین، چندین جای آگهی از یک نوع با فراداده غیرقابل‌دسترس در یک گروه آگهی، مقدار resource_name یکسانی را هم‌رسانی می‌کنند درحالی‌که ردیف‌های سنجه‌های جداگانه‌ای را گزارش می‌کنند.

هنگام پردازش نتایج group_placement_view یا detail_placement_view در کد کارخواه، ردیف‌ها را صرفاً براساس فیلد resource_name حذف تکرار نکنید، زیرا انجام این کار می‌تواند سنجه‌ها را در جای آگهی‌های متمایز با فراداده غیرقابل‌دسترس بازنویسی کند. برای مستثنی کردن ردیف‌های دارای فراداده غیرقابل‌دسترس در GAQL، فیلتر را روی فیلد target_url یا display_name اعمال کنید، زیرا فیلدهای placement و resource_name قابل‌فیلتر کردن نیستند. برای مثال، از WHERE group_placement_view.target_url IS NOT NULL یا WHERE detail_placement_view.target_url IS NOT NULL استفاده کنید.

نمای جای آگهی عملکرد بیشینه

• آنچه نشان می‌دهد: منبع performance_max_placement_view داده‌های ظهور (metrics.impressions) را برای جای آگهی‌هایی که آگهی‌های «عملکرد بیشینه» در آن‌ها ارائه شده است ارائه می‌دهد. در نسخه ۲۴ و جدیدتر، می‌توانید performance_max_placement_view را براساس segments.ad_network_type بخش‌بندی کنید (در نسخه ۲۳ پشتیبانی نمی‌شود).
• معادل میانای کاربر: اطلاعات آماری و گزارش‌ها > ویرایشگر گزارش > جای آگهی پویش‌های «بیشینه‌سازی عملکرد»
• پرسمان‌ساز: کاوش در «پرسمان‌ساز»

پُرسمان نمونه

پرسمان زیر ظهورهای جای آگهی را که براساس نوع شبکه آگهی بخش‌بندی شده‌اند برای پویش‌های «عملکرد بیشینه» در ۳۰ روز گذشته واکشی می‌کند:

SELECT
  campaign.id,
  performance_max_placement_view.display_name,
  performance_max_placement_view.target_url,
  performance_max_placement_view.placement_type,
  segments.ad_network_type,
  metrics.impressions
FROM performance_max_placement_view
WHERE segments.date DURING LAST_30_DAYS

انتخاب نمای جای آگهی

• از managed_placement_view برای ارزیابی عملکرد جای آگهی‌هایی که به‌طور فعال هدف‌یابی می‌کنید و برای آن‌ها پیشنهاد قیمت می‌دهید استفاده کنید.
• از group_placement_view برای درک کامل گستره مکان‌هایی که آگهی‌هایتان نمایش داده می‌شوند استفاده کنید، به‌ویژه هنگام استفاده از تنظیم «مشاهده»، تا فرصت‌های هدف‌یابی جدید یا موارد حذفی را کشف کنید.
• از detail_placement_view برای دریافت جزئی‌ترین جزئیات درباره نشانی‌های وب یا ویدیوهای خاصی که آگهی‌های شما در آن‌ها نمایش داده شده‌اند استفاده کنید، که اغلب پس‌از شناسایی دامنه یا کانال موردعلاقه در group_placement_view استفاده می‌شود.
• از performance_max_placement_view برای بازرسی ظهورهای جای آگهی برای پویش‌های «عملکرد بیشینه» استفاده کنید.