API جدید Search Ads 360 Reporting اکنون در دسترس است. به گروه Google searchads-api-announcements بپیوندید تا در مورد پیشرفت‌ها و نسخه‌های آینده به‌روز باشید.

این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

یادداشت های انتشار

نسخه 0 (07-10-2024)

این به روز رسانی شامل معیارهای جدید، منابع، فیلدها و برخی از تعاریف جدید نقشه برداری است. حتماً کتابخانه مشتری را به روز کنید تا از همه این تغییرات استفاده کنید.

معیارها اضافه شد

cross_device_conversions_by_conversion_date : تعداد تبدیل‌های بین دستگاهی بر اساس تاریخ تبدیل.
cross_device_conversions_value_by_conversion_date : مجموع ارزش تبدیل بین دستگاه ها بر اساس تاریخ تبدیل.
general_invalid_click_rate : درصد کلیک‌هایی که از تعداد کل کلیک‌های شما (فیلتر شده + کلیک‌های غیرفیلترشده) به دلیل کلیک‌های نامعتبر کلی فیلتر شده‌اند.
general_invalid_clicks : تعداد کلیک های نامعتبر عمومی.

cross_device_conversions_by_conversion_date و cross_device_conversions_value_by_conversion_date با این منابع سازگار هستند: ad_group_ad ، ad_group_audience_view ، ad_group ، bidding_strategy ، کمپین ، مشتری ، shopping_audience_form_view ، view_key .

نگاشت میدانی دوباره تعریف شد

نقشه‌برداری‌های میدانی برای dfaActions ، dfaActionsCrossEnv ، dfaRevenue ، dfaRevenueCrossEnv ، dfaTransactions ، dfaTransactionsCrossEnv برای برخی از گزارش‌های قدیمی تغییر کرده است.

میدان	قبلا	تعریف جدید
`dfaActions`	metrics.all_conversions - metrics.cross_device_conversions	metrics.all_conversions_by_conversion_date - metrics.cross_device_conversions_by_conversion_date
`dfaActionsCrossEnv`	metrics.all_conversions	metrics.all_conversions_by_conversion_date
`dfaRevenue`	metrics.all_conversions_value - metrics.cross_device_conversions_value	metrics.all_conversions_value_by_conversion_date - metrics.cross_device_conversions_value_by_conversion_date
`dfaRevenueCrossEnv`	metrics.all_conversions_value	metrics.all_conversions_value_by_conversion_date
`dfaTransactions`	metrics.all_conversions - metrics.cross_device_conversions	metrics.all_conversions_by_conversion_date - metrics.cross_device_conversions_by_conversion_date
`dfaTransactionsCrossEnv`	metrics.all_conversions	metrics.all_conversions_by_conversion_date

فهرست گزارش‌های قدیمی که نقشه‌برداری میدانی را تغییر داده‌اند

زمینه های جدید

ما در حال اضافه کردن campaign.effective_labels و ad_group.effective_labels هستیم.

برچسب‌های موثر برچسب‌هایی هستند که به ارث رسیده یا مستقیماً اختصاص داده شده‌اند.

منابع جدید

مرتبط با فیلدهای جدید effect_labels، منابع جدید ابرداده ارتباط بین برچسب‌های موثر و کمپین ( Campan_effective_label ) یا ad_group ( ad_group_effective_label ) را نگه می‌دارند.

نسخه 0 (23-08-2024)

در این به‌روزرسانی، ابرداده ستون سفارشی، فیلد renderType را اضافه می‌کند.

جزئیات CustomColumnRenderType را ببینید.

یک فیلد owner_customer_id جدید به منابع campaign_label ، ad_group_label ، ad_group_ad_label و ad_group_criterion_label اضافه شده است.

برای استفاده از این فیلدهای جدید، حتماً کتابخانه مشتری را به روز کنید.

نسخه 0 (01-08-2024)

این به روز رسانی شامل بخش بندی ساعتی و چندین فیلد جدید است

تقسیم بندی ساعتی

اکنون می توان بخش بندی ساعتی را در یک پرس و جو مشخص کرد. جزئیات بیشتر را در segments.hour مشاهده کنید.

start_time به منبع customer_manager_link اضافه شد

جزئیات بیشتر را در customer_manager_link.start_time ببینید

MULTIMEDIA_AD به ad_group_ad.ad.type اضافه شد

اکنون می‌توان معیارها و بخش‌ها را با نوع MULTIMEDIA_AD انتخاب کرد. پرس و جو از ویژگی های خاص چندرسانه ای در این نسخه پشتیبانی نمی شود.

نوع کمپین SOCIAL به camp.advertising_channel_type و SOCIAL_FACEBOOK_TRACKING_ONLY به camp.advertising_channel_sub_type اضافه شد.

اکنون می‌توان معیارها و بخش‌ها را با نوع کمپین SOCIAL و نوع فرعی SOCIAL_FACEBOOK_TRACKING_ONLY انتخاب کرد. پرس و جو از ویژگی های خاص SOCIAL یا SOCIAL_FACEBOOK_TRACKING_ONLY در این نسخه پشتیبانی نمی شود.

پشتیبانی برای average_quality_score اضافه شده است

جزئیات بیشتر را در متریک مشاهده کنید

نسخه 0 (18-04-2024)

این به‌روزرسانی‌ها شامل منبع استراتژی مناقصه قابل دسترسی است

استراتژی مناقصه در دسترس

نمایانگر نمایی از BiddingStrategies است که متعلق به مشتری است و با آن به اشتراک گذاشته شده است. برخلاف BiddingStrategy، این منبع شامل استراتژی‌هایی است که متعلق به مدیران مشتری است و با این مشتری به اشتراک گذاشته می‌شود - علاوه بر استراتژی‌های متعلق به این مشتری. این منبع معیارهایی را ارائه نمی دهد و فقط زیرمجموعه محدودی از ویژگی های BiddingStrategy را نشان می دهد.

جزئیات منبع accessible_bidding_strategy را ببینید.

نسخه 0 (12-02-2024)

این به روز رسانی شامل دسترسی به ستون های سفارشی و متغیرهای Floodlight سفارشی است

ستون های سفارشی

اکنون می توان ستون های تبدیل سفارشی و ستون های فرمول سفارشی را در یک پرس و جو مشخص کرد. جزئیات بیشتر را در مستندات ستون های سفارشی مشاهده کنید.

متغیرهای Floodlight سفارشی

متغیرهای Floodlight سفارشی را می‌توان برای آمار پس از 30/01/2024 در یک جستجو مشخص کرد. جزئیات بیشتر را در مستندات متغیرهای Floodlight سفارشی مشاهده کنید.

نسخه 0 (09-11-2023)

این به روز رسانی شامل منابع زیر است. برای مشاهده فیلدهایی که می توان برای این منابع پرس و جو کرد، و معیارها و بخش بندی هایی که می توان با آنها استفاده کرد، از پیوندها دیدن کنید.

گروه دارایی

جزئیات منابع asset_group را ببینید.

دارایی گروه دارایی

جزئیات منبع asset_group_asset را ببینید.

فیلتر گروه فهرست دارایی

جزئیات منبع asset_group_listing_group_filter را ببینید.

سیگنال گروه دارایی

جزئیات منبع asset_group_signal را ببینید.

نمای ترکیبی بالا گروه دارایی

جزئیات منبع asset_group_top_combination_view را ببینید.

نمای فروش داده های سبد خرید

جزئیات منبع cart_data_sales_view را ببینید.

تبدیل

جزئیات منبع تبدیل را ببینید.

نمای عملکرد خرید

جزئیات منبع shopping_performance_view را ببینید.

بازدید کنید

جزئیات منابع بازدید را ببینید.

نسخه 0 (15-08-2023)

این به‌روزرسانی شامل منابع زیر و یک پارامتر جدید برای پیکربندی تبدیل ارز برای معیارها است.

برای مشاهده فیلدهایی که می توان برای این منابع پرس و جو کرد، و معیارها و بخش بندی هایی که می توان با آنها استفاده کرد، از پیوندها دیدن کنید.

دارایی گروه تبلیغات

جزئیات منبع ad_group_asset را ببینید.

مجموعه دارایی گروه تبلیغات

جزئیات منبع ad_group_asset_set را ببینید.

دارایی

جزئیات منابع دارایی را ببینید.

مجموعه دارایی

جزئیات منابع asset_set را ببینید.

دارایی مجموعه دارایی

جزئیات منبع asset_set_asset را ببینید.

دارایی کمپین

جزئیات منبع Campaign_asset را ببینید.

مجموعه دارایی های کمپین

جزئیات منبع Campaign_asset_set را ببینید.

دارایی مشتری

جزئیات منبع customer_asset را ببینید.

مجموعه دارایی مشتری

جزئیات منبع customer_asset_set را ببینید.

تبدیل ارز

با استفاده از metrics_currency در قسمت PARAMETERS می توان ارز محاسبه متریک را مشخص کرد.

فهرست مشتریان قابل دسترس

تمام حساب های قابل دسترسی را با استفاده از روش ListAccessibleCustomers فهرست کنید

نسخه 0 (15-05-2023)

این به روز رسانی شامل منبع زیر است. برای مشاهده فیلدهایی که می توان برای این منبع پرس و جو کرد، و معیارها و بخش بندی هایی که می توان با آن استفاده کرد، از پیوندها دیدن کنید.

آگهی گروه تبلیغاتی

جزئیات منبع ad_group_ad را ببینید.

نسخه 0 (06-04-2023)

این به روز رسانی شامل منابع زیر است. برای مشاهده فیلدهایی که می توان برای هر منبع پرس و جو کرد، و معیارها و بخش بندی هایی که می توان با آن منبع استفاده کرد، از پیوندها دیدن کنید.

نمای مخاطب گروه تبلیغات

جزئیات منبع ad_group_audience_view را ببینید.

برچسب معیار گروه تبلیغات

جزئیات منبع ad_group_criterion_label را ببینید.

برچسب گروه تبلیغاتی

جزئیات منبع ad_group_label را ببینید.

نمای محدوده سنی

جزئیات منبع age_range_view را ببینید.

معیار کمپین

جزئیات منبع Campaign_criterion را ببینید.

برچسب کمپین

جزئیات منبع Campaign_label را ببینید

نمایش عبارت جستجوی تبلیغات جستجوی پویا

جزئیات منبع dynamic_search_ads_search_term_view را ببینید.

نمایش صفحه وب

جزئیات منبع webpage_view را ببینید.

برچسب بزنید

جزئیات منبع برچسب را ببینید.

نسخه 0 (05-12-2022)

نسخه v0 شامل منابع و خدمات زیر است. برای مشاهده فیلدهایی که می توان برای هر منبع پرس و جو کرد، و معیارها و بخش بندی هایی که می توان با آن منبع استفاده کرد، از پیوندها دیدن کنید.

گروه تبلیغات

جزئیات منبع ad_group را ببینید.

مناقصه

جزئیات منبع bidding_strategy را ببینید.

کمپین ها

جزئیات منابع کمپین را ببینید.

اقدام تبدیل

جزئیات منبع conversion_action را ببینید.

مشتری

جزئیات منابع مشتری را ببینید.

کلمه کلیدی

جزئیات منبع keyword_view را ببینید.

گروه محصولات

جزئیات منبع product_group_view را ببینید.

SearchAds360FieldService

SearchAds360FieldService یک کاتالوگ از تمام فیلدهای قابل پرس و جو ارائه می کند. ابرداده در این فیلدها شامل توضیحات، انواع و سازگاری با فیلدهای دیگر است. بیشتر بدانید .

SearchAds360 Service

SearchAds360Service برای بازیابی چندین منبع در یک پرس و جو است. منابع قابل استعلام عبارتند از:
- AdGroup
- BiddingStrategy
- Campaign
- ConversionAction
- Customer
- Keyword
- ProductGroup
معیارهایی مانند برداشت‌ها و کلیک‌ها را نیز می‌توان با استفاده از SearchAds360Service برای این منابع بازیابی کرد:
- AdGroup
- BiddingStrategy
- Campaign
- ConversionAction
- Customer
- Keyword
- ProductGroup
SearchAds360Service امکان تقسیم بندی بر اساس فیلدها، مانند فیلدهای تاریخ را فراهم می کند. بیشتر بدانید .