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

نسخه ۰ (۲۰۲۵-۱۱-۱۰)

فیلدهای URL جدید

داریم اضافه می‌کنیم

معیارهای جدید برای UserLocationView

معیارهای زیر اکنون هنگام پرس و جو از منبع user_location_view در دسترس هستند:

اصلاح نام منبع

الگوی نام منبع برای منابع برچسب مؤثر زیر اصلاح شده است تا از owner_customer_id استفاده کند تا اطمینان حاصل شود که شامل شناسه مشتری است که مالک برچسب است:

  • CampaignEffectiveLabel
  • AdGroupEffectiveLabel
  • CriterionEffectiveLabel (در AdGroupCriterionEffectiveLabel )
  • AdGroupAdEffectiveLabel

مثال: الگوی CampaignEffectiveLabel از customers/{customer_id}/campaignEffectiveLabels/{campaign_id}~{label_id} به customers/{owner_customer_id}/campaignEffectiveLabels/{campaign_id}~{label_id} تغییر کرد.

نسخه ۰ (۲۰۲۵-۰۶-۱۲)

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

فیلدهای جدید

داریم اضافه می‌کنیم

برای کمک به پیمایش سلسله مراتب حساب‌های کاربری Search Ads 360 .

نسخه ۰ (۲۰۲۵-۰۱-۲۱)

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

گسترش MCC

هنگام درخواست یک bidding_strategy ، اکنون می‌توانید یک مقدار بولی ( enable_mcc_expansion ) را در بخش پارامترها تنظیم کنید.

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

نسخه ۰ (۲۰۲۴-۱۱-۰۸)

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

فیلدهای جدید

ما ad_group_ad.effective_labels و ad_group_criterion.effective_labels را اضافه می‌کنیم.

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

منابع جدید

نمای موقعیت مکانی کاربر

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

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

در رابطه با فیلدهای جدید effective_labels، دو منبع جدید وجود دارد که فراداده‌های ارتباط بین برچسب‌های effective و ad_group_ad ( ad_group_ad_effective_label ) یا ad_group_criterion ( ad_group_criterion_effective_label ) را نگهداری می‌کنند.

نسخه ۰ (۲۰۲۴-۱۰-۰۷)

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

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

cross_device_conversions_by_conversion_date و cross_device_conversions_value_by_conversion_date با این منابع سازگار هستند: ad_group_ad ، ad_group_audience_view ، ad_group ، bidding_strategy ، campaign ، customer ، campaign_audience_view ، keyword_view ، و shopping_performance_view .

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

نگاشت‌های فیلد برای 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 معیارها.all_conversions معیارها.همه_تبدیل‌ها_براساس_تاریخ_تبدیل
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 معیارها.all_conversions_value معیارها.همه_ارزش_تبدیل_شده_بر_اساس_تاریخ_تبدیل
dfaTransactions metrics.all_conversions - metrics.cross_device_conversions metrics.all_conversions_by_conversion_date - metrics.cross_device_conversions_by_conversion_date
dfaTransactionsCrossEnv معیارها.all_conversions معیارها.همه_تبدیل‌ها_براساس_تاریخ_تبدیل

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

فیلدهای جدید

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

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

منابع جدید

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

نسخه ۰ (۲۰۲۴-۰۸-۲۳)

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

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

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

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

نسخه ۰ (۲۰۲۴-۰۸-۰۱)

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

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

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

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

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

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

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

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

پشتیبانی از امتیاز کیفیت متوسط ​​اضافه شد

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

نسخه ۰ (۲۰۲۴-۰۴-۱۸)

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

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

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

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

نسخه ۰ (۲۰۲۴-۰۲-۱۲)

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

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

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

متغیرهای نورافکن سفارشی

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

نسخه ۰ (۲۰۲۳-۱۱-۰۹)

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

گروه دارایی

جزئیات منابع 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 را ببینید.

بازدید

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

نسخه ۰ (۲۰۲۳-۰۸-۱۵)

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

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

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

جزئیات منبع 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

نسخه ۰ (۲۰۲۳-۰۵-۱۵)

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

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

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

نسخه ۰ (۲۰۲۳-۰۴-۰۶)

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

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

جزئیات منبع 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 را ببینید.

برچسب

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

نسخه ۰ (۲۰۲۲-۱۲-۰۵)

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

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

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

مناقصه

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

کمپین‌ها

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

اقدام تبدیل

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

مشتری

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

کلمه کلیدی

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

گروه محصول

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

خدمات میدانی جستجوAds360

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

خدمات جستجوAds360

  • SearchAds360Service برای بازیابی چندین منبع در یک پرس‌وجوی واحد در نظر گرفته شده است. منابع قابل پرس‌وجو عبارتند از:

    • AdGroup
    • BiddingStrategy
    • Campaign
    • ConversionAction
    • Customer
    • Keyword
    • ProductGroup

  • معیارهایی مانند تعداد نمایش و کلیک را می‌توان با استفاده از SearchAds360Service برای این منابع نیز بازیابی کرد:

    • AdGroup
    • BiddingStrategy
    • Campaign
    • ConversionAction
    • Customer
    • Keyword
    • ProductGroup

  • SearchAds360Service امکان تقسیم‌بندی بر اساس فیلدها، مانند فیلدهای تاریخ را فراهم می‌کند. اطلاعات بیشتر .