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

v21 (06-08-2025)

AI Max برای کمپین های جستجو

  • اکنون می توانید از فیلد ai_max_setting.enable_ai_max Campaign برای فعال کردن AI Max برای کمپین های جستجو استفاده کنید. کمپین‌های AI Max برای جستجو، دامنه کمپین جستجو را از طریق تطبیق عبارت‌های جستجو گسترش می‌دهد و اجازه می‌دهد کنترل کنید که آیا هدف‌گیری و کنترل‌های خلاقانه در هنگام تنظیم انجام می‌شوند یا خیر. کنترل‌های اتوماسیون دارایی نوشتاری و فهرست مارک‌ها که در درخواست‌های نسخه قبلی تنظیم شده بودند، همچنان رعایت می‌شوند تا زمانی که AI Max برای کمپین‌های جستجو به صراحت تغییر و خاموش شود. Campaign.ai_max_setting.bundling_required را می‌توان برای تعیین اینکه آیا کمپین‌های AI Max for Search باید فعال باشند تا کنترل‌های خودکارسازی دارایی‌های متنی و فهرست نام تجاری را رعایت یا اصلاح کنند، استفاده شود. هنگامی که یک کمپین والد AI Max را برای کمپین های جستجو فعال کرده باشد، می توان AdGroup.ai_max_ad_group_setting.disable_search_term_matching برای غیرفعال کردن تطبیق عبارت جستجو استفاده کرد. پست وبلاگ ما را ببینید قفل عملکرد سطح بعدی را با AI Max برای کمپین‌های جستجو باز کنید .

  • CampaignError.AI_MAX_MUST_BE_ENABLED اضافه شد، که وقتی FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION بدون فعال کردن AI Max برای کمپین های جستجو در کمپین انتخاب می کنید، برای کمپین های جستجو پرتاب می شود.

  • پشتیبانی برای اعمال کنترل های هدف در سطح گروه تبلیغات در کمپین های AI Max for Search اضافه شده است. اکنون می توانید معیارهای زیر را به گروه های تبلیغاتی اضافه کنید:

    • لیست های برند
    • مکان ها
    • صفحات وب (قوانین URL)

  • ai_max_search_term_ad_combination_view را برای گزارش عملکرد ترکیبی از عبارات جستجو، سرفصل‌ها و صفحات مقصد اضافه کرد. این نما نشان می‌دهد که کدام عبارت‌های جستجو تبلیغات شما را راه‌اندازی کرده‌اند و آن ترکیب‌های خاص چگونه عمل می‌کنند. نسخه آینده شامل یک نمای اضافی است که شامل داده‌های حداکثر عملکرد نیز می‌شود. اگر می خواهید از انتقال پیاده سازی خود برای دریافت داده های Performance Max اجتناب کنید، منتظر آن نسخه باشید.

  • AI_MAX به عنوان یک مقدار جدید برای بخش search_term_match_type اضافه شد.

دارایی ها

  • فیلدهای terms_and_conditions_text ، terms_and_conditions_uri ، promotion_barcode_info ، و promotion_qr_code_info را در PromotionAsset اضافه کرد. فیلدهای بارکد و کد QR در یکی از promotion_trigger قرار دارند.

  • FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION به AssetAutomationTypeEnum اضافه شد. با این تنظیم، می توانید تولید خودکار دارایی های متنی و صفحات مقصد را از URL نهایی در کمپین های جستجو کنترل کنید.

  • یک سرویس جدید AutomaticallyCreatedAssetRemovalService.RemoveCampaignAutomaticallyCreatedAsset اضافه کرد تا دارایی های ایجاد شده به طور خودکار از Campaign حذف شود. این سرویس فقط از حذف دارایی بسط URL نهایی پشتیبانی می کند.

  • DESCRIPTION_PREFIX به فهرست ServedAssetFieldType اضافه شد. این مشکلی را اصلاح می‌کند که در آن served_asset_field_type در ad_group_ad_asset_combination_view برای دارایی‌هایی که به‌عنوان پیشوند توصیف استفاده می‌شوند UNKNOWN بود.

کمپین ها

  • یک مقدار enum جدید MISSING_LOCATION_TARGETING به CampaignPrimaryStatusReason اضافه کرد. این دلیل وضعیت جدید فقط برای کمپین‌های دارای محدودیت مکان که مکان یابی را مشخص نمی‌کنند، بازگردانده می‌شود. برای کمپین‌های محدود به مکان، هرگونه تلاش برای افزودن مکان‌یابی خارج از محدوده مجاز منجر به خطای معیار LOCATION_TARGETING_NOT_ELIGIBLE_FOR_RESTRICTED_CAMPAIGN می‌شود.

  • پشتیبانی از شرکای ادغام شخص ثالث در سطوح VideoCustomer.third_party_integration_partners و Campaign.third_party_integration_partners اضافه شد. به مقاله مرکز راهنمایی ردیابی تبدیل برنامه با تجزیه و تحلیل برنامه شخص ثالث مراجعه کنید.

  • اکنون می توانید فیلد advertising_partner_ids را برای یک Campaign موجود تنظیم کنید. پیش از این، این فیلد فقط برای یک کمپین جدید در طول ایجاد آن تنظیم می شد.

  • با استفاده از یک لیست مشترک از نوع TYPE_PLACEMENT_LIST که در سطح حساب مدیر تعریف شده است، تبلیغ‌کنندگان اکنون می‌توانند از معیارهای CustomerNegativeCriterion برای حذف فهرستی از مکان‌ها در حساب‌های مشتری آگهی‌دهنده استفاده کنند.

  • DESCRIPTION_PREFIX به فهرست ServedAssetFieldType اضافه شد. این مشکلی را اصلاح می‌کند که در آن served_asset_field_type در ad_group_ad_asset_combination_view برای دارایی‌هایی که به‌عنوان پیشوند توصیف استفاده می‌شوند UNKNOWN بود.

  • پشتیبانی از فیلد target_roas_tolerance_percent_millis در استراتژی‌های پیشنهادی MaximizeConversionValue و TargetRoas اضافه شده است. TargetRoas.target_roas_tolerance_percent_millis فقط برای استراتژی های نمونه کارها در دسترس است، که فقط برای کمپین های جستجو در دسترس است.

  • کد خطای ProductGroup را تغییر داد. برای درخواست‌هایی که نقص نسبی فعال است، LISTING_GROUP_ERROR_IN_ANOTHER_OPERATION به جای INVALID_LISTING_GROUP_HIERARCHY برگردانده می‌شود.

  • یک منبع جدید LocationInterestView اضافه شد که عملکرد معیارهای علاقه مکان گروه آگهی را خلاصه می کند.

تبدیل ها

  • ENGAGED_VIEW به عنوان یک مقدار جدید برای بخش conversion_attribution_event_type اضافه شد.

  • مشتریان دیگر به حالت debug_enabled در ConversionUploadService دسترسی نخواهند داشت. این فیلد، اگر روی TRUE تنظیم شود، قبلاً برای تشخیص خطای CLICK_NOT_FOUND از SUCCESS برای تبدیل های پیشرفته برای واردات سرنخ استفاده می شد.

تقاضای ژنرال

  • کد خطا CampaignBudgetError.BUDGET_BELOW_DAILY_MINIMUM اضافه شد.BUDGET_BELOW_DAILY_MINIMUM. در آینده، این خطا هنگام تلاش برای تنظیم یک مقدار بودجه بسیار کم برای یک کمپین Demand Gen بازگردانده خواهد شد. جزئیات مربوط به حداقل بودجه مورد نیاز را می توان در فیلد جزئیات خطای جدید budgetDailyMinimumErrorDetails پیدا کرد.

تغییرات تبلیغات سیاسی اتحادیه اروپا

این تغییرات تبلیغات سیاسی اتحادیه اروپا نیز در نسخه های v19.2 و v20.1 انجام شده است.

  • Campaign.contains_eu_political_advertising اضافه شد. این فیلد نشان می‌دهد که آیا کمپین شما حاوی محتوای تبلیغاتی سیاسی با هدف اتحادیه اروپا است یا خیر. اگر این فیلد روی CONTAINS_EU_POLITICAL_ADVERTISING تنظیم شود، از 22 سپتامبر 2025، کمپین دیگر در اتحادیه اروپا اجرا نمی‌شود. اگر این فیلد تنظیم نشود، فراخوان‌های API برای ایجاد کمپین جدید با خطای FieldError.REQUIRED شکست می‌خورد.

    برای هر کمپین موجود، باید قبل از تلاش برای تغییر نزدیکی، مکان یا هدف گروه مکان در سطح کمپین یا گروه تبلیغات، قسمت contains_eu_political_advertising تنظیم کنید. فراخوان‌های API برای ایجاد یا به‌روزرسانی معیارهای کمپین یا گروه تبلیغات برای کمپین‌های موجود، با خطای CriterionError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION در صورتی که کمپین خوداظهاری را کامل نکرده باشد، ناموفق خواهد بود.

    برای نسخه‌های v19.x و 20.x، الزام تنظیم این فیلد هنوز اعمال نشده است، اما در آینده خواهد بود. این تغییر از قبل اعلام خواهد شد.

  • آزمایش‌ها و آزمایش‌ها یک ExperimentError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION ایجاد می‌کنند. MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION اگر کمپین‌های آزمایشی خود اعلام نکرده باشند که آیا حاوی تبلیغات سیاسی هستند که اتحادیه اروپا را هدف قرار می‌دهند یا خیر.

حداکثر عملکرد

  • برای کمپین‌های جدید PMax، مقدار پیش‌فرض Campaign.brand_guidelines_enabled اکنون true است.

  • گزارش campaign_search_term_view اضافه شد. این نما معیارهای عبارات جستجو را در سطح کمپین جمع آوری می کند. این دیدگاه همچنین پشتیبانی از کمپین Performance Max را برای عبارات جستجو معرفی می کند.

  • PERFORMANCE_MAX به عنوان یک مقدار جدید برای بخش search_term_match_type اضافه شد.

برنامه ریزی

  • یک روش جدید ReachPlanService.ListPlannableUserInterests اضافه کرد که به تبلیغ‌کنندگان اجازه می‌دهد علایق کاربر (وابستگی‌ها و درون بازارها) پشتیبانی شده توسط ReachPlanService.GenerateReachForecast را کشف کنند. این روش از جستجو برای انواع خاص مورد علاقه کاربر و پرس و جو برای نام ها و مسیرها پشتیبانی می کند.

  • AdditionalApplicationInfo به ReachPlanService.ListPlannableUserLists به عنوان یک فیلد ورودی اختیاری اضافه شد.

  • پشتیبانی به AudienceInsightsService.ListAudienceInsightsAttributes اضافه شد تا لیست‌های کاربر 1P موجود برای شناسه مشتری که درخواست را ارائه می‌کند.

  • پشتیبانی از لیست‌های کاربر 1P به AudienceInsightsService.GenerateAudienceCompositionInsights اضافه شد تا بینش‌هایی را برای مخاطبانی که فهرست کاربران را هدف قرار می‌دهند، دریافت کند. هر درخواستی که فهرست کاربران را هدف قرار دهد فقط فهرست مخاطبان را برمی گرداند و فقط برای AudienceInsightsDimension زیر در دسترس است: AGE_RANGE ، GENDER ، AFFINITY_USER_INTEREST ، IN_MARKET_USER_INTEREST .

  • نوع ورودی مخاطب را به InsightsAudience برای AudienceInsightsService.GenerateTargetingSuggestionMetrics به روز کرد. ورودی مخاطب جدید ترکیبی از علایق کاربر را امکان‌پذیر می‌کند و از معیارهای دسترسی بالقوه برای تعاریف مخاطب سفارشی‌تر پشتیبانی می‌کند.

  • سهم مخاطب را به TrendInsightMetrics اضافه کرد تا سهم مخاطب را برای یک روند به دست آورد.

  • دسته‌های مرتبط جدید به KnowledgeGraphAttributeMetadata اضافه شد تا کاربران بتوانند ویژگی‌های نمودار دانش را بر اساس دسته فیلتر کنند.

گزارش ها

  • اکنون انواع معیارهای جدید برای AssetGroupAsset ، ChannelAggregateAssetView ، و CampaignAggregateAssetView در دسترس است. علاوه بر این، برای ChannelAggregateAssetView و CampaignAggregateAssetView ، impressions که قبلاً برای کمپین‌های Performance Max صفر شده بودند، اکنون مقدار واقعی خود را گزارش می‌کنند.

  • منبع AssetSet را با ChangeStatus قابل انتخاب کرد تا کاربران بتوانند اطلاعات بیشتری در مورد نوع منبع AssetSet یا CampaignAssetSet در یک جستار دریافت کنند.

  • منبع CampaignAssetSet را با ChangeStatus قابل انتخاب کرد تا کاربران بتوانند اطلاعات بیشتری درباره منبع نوع AssetSet یا CampaignAssetSet در یک جستار دریافت کنند.

  • یک بخش search_term_targeting_status جدید اضافه شد که می تواند در نمای عبارت جستجوی کمپین انتخاب شود.

  • یک final_url_expansion_asset_view جدید اضافه شد.

  • پشتیبانی از معیارهای value_adjustment و all_value_adjustment در گزارش AssetGroup اضافه شده است.

  • AssetGroupAsset را براساس ad_network_type تقسیم‌بندی کرد.

  • بخش جدیدی اضافه شد landing_page_source که می‌تواند با منبع landing_page_view استفاده شود.

  • یک بخش search_term_match_source جدید اضافه شد که می تواند در بازدیدهای عبارت جستجو و جستجوی کمپین انتخاب شود.

  • یک بخش جدید match_type اضافه شد که می تواند از نمای کلمه کلیدی انتخاب شود.

  • پشتیبانی از معیارها برای خوشه های هدف پرس و جو منحصر به فرد با:

  • یک نوع کلیک جدید VEHICLE_ASSETS در بخش‌بندی click_view برای ردیابی و گزارش کلیک‌های مربوط به قالب‌های تبلیغاتی ویژه دارایی‌های خودرو اضافه شد.

ویدئو

نسخه 20.1 (06-08-2025)

این تغییرات تبلیغات سیاسی اتحادیه اروپا نیز در نسخه های v19.2 و v21 انجام شده است.

تغییرات تبلیغات سیاسی اتحادیه اروپا

  • Campaign.contains_eu_political_advertising اضافه شد. این فیلد نشان می‌دهد که آیا کمپین شما حاوی محتوای تبلیغاتی سیاسی با هدف اتحادیه اروپا است یا خیر. اگر این فیلد روی CONTAINS_EU_POLITICAL_ADVERTISING تنظیم شود، از 22 سپتامبر 2025، این کمپین دیگر در اتحادیه اروپا فعال نخواهد شد.

    برای هر کمپین موجود، باید قبل از تلاش برای تغییر نزدیکی، مکان یا هدف گروه مکان در سطح کمپین یا گروه تبلیغات، قسمت contains_eu_political_advertising تنظیم کنید. فراخوان‌های API برای ایجاد یا به‌روزرسانی معیارهای کمپین یا گروه تبلیغات برای کمپین‌های موجود، با خطای CriterionError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION در صورتی که کمپین خوداظهاری را کامل نکرده باشد، ناموفق خواهد بود.

    برای نسخه‌های v19.x و 20.x، الزام تنظیم این فیلد هنوز اعمال نشده است، اما در آینده خواهد بود. این تغییر از قبل اعلام خواهد شد.

  • آزمایش‌ها و آزمایش‌ها یک ExperimentError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION ایجاد می‌کنند. MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION اگر کمپین‌های آزمایشی خود اعلام نکرده باشند که آیا حاوی تبلیغات سیاسی هستند که اتحادیه اروپا را هدف قرار می‌دهند یا خیر.

نسخه 20 (04-06-2025)

ویژگی ها و به روز رسانی های جدید زیر در نسخه 20 اضافه شد.

دارایی ها

چندین معیار و ستون بخش جدید برای گزارش asset_group اضافه شد.

ستون های متریک

ستون ها را قطعه بندی کنید

کمپین ها

تبدیل ها

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

  • فیلد ClickConversion.user_ip_address اضافه شد. Google Ads از تطبیق آدرس IP برای کاربران نهایی در منطقه اقتصادی اروپا (EEA)، بریتانیا (بریتانیا) یا سوئیس (CH) پشتیبانی نمی‌کند. لطفاً منطقی را اضافه کنید تا به طور مشروط اشتراک‌گذاری آدرس‌های IP از کاربران این مناطق را حذف کنید. اطمینان حاصل کنید که اطلاعات واضح و جامعی را در مورد داده‌هایی که در سایت‌ها، برنامه‌ها و سایر دارایی‌های خود جمع‌آوری می‌کنید به کاربران ارائه می‌دهید و در مواردی که طبق قانون یا هر خط‌مشی قابل‌اجرای Google لازم است، رضایت دریافت می‌کنید. برای جزئیات بیشتر به صفحه درباره واردات تبدیل آفلاین مراجعه کنید.

تقاضای ژنرال

توصیه ها

  • هنگام استفاده از GenerateRecommendationsRequest ، پشتیبانی از ShoppingSetting در طول ساخت کمپین اضافه شد.
  • فیلد merchant_center_account_id را به GenerateRecommendationsRequest اضافه کرد تا نشان دهد چه زمانی توصیه‌ها باید برای خرده‌فروشی تولید شوند، نه کمپین‌های استاندارد عملکرد حداکثر.

برنامه ریزی

  • AudienceInsightsDimension.YOUTUBE_LINEUP برای جایگزینی AudienceInsightsDimension.YOUTUBE_DYNAMIC_LINEUP در AudienceInsightsService و ContentCreatorInsightsService اضافه شد. این بعد جدید به شما امکان می‌دهد اطلاعات آماری و فراداده‌های مجموعه‌های YouTube Select (YTS) را بازیابی کنید. اشیاء مرتبط با YOUTUBE_DYNAMIC_LINEUP مانند DynamicLineupAttributeMetadata و AudienceInsightsDynamicLineup جایگزین شدند تا با حذف گسترده تر Dynamic Lineups در سراسر Google Ads هماهنگ شوند. این ویژگی فقط برای حساب‌های موجود در فهرست مجاز در دسترس است.
  • AdditionalApplicationInfo و ApplicationInstance در AudienceInsightsService ، ContentCreatorInsightsService و ReachPlanService اضافه شد. این ویژگی فقط برای حساب‌های موجود در فهرست مجاز در دسترس است.
  • AudienceInsightsService و ContentCreatorInsightsService برای ارائه اطلاعات دقیق تر به روز کرد. اکنون می‌توانید با استفاده از AudienceInsightsDimension.DEVICE و AudienceInsightsAttribute.device جدید در هر دو سرویس، داده‌های سازنده محتوا را بر اساس دستگاه تقسیم‌بندی کنید. این ویژگی فقط برای حساب‌های موجود در فهرست مجاز در دسترس است.
  • برای تجزیه و تحلیل جامع‌تر سازنده محتوا، معیارهای ویدیوی انباشته اضافی به GenerateCreatorInsightsResponse اضافه شد: engagement_rate ، average_views_per_video ، average_likes_per_video ، average_shares_per_video ، average_comments_per_video ، تعداد shorts_views_count ، shorts_video_count is_brand_connect_creator . این ویژگی فقط برای حساب‌های موجود در فهرست مجاز در دسترس است.
  • sub_country_locations به GenerateCreatorInsightsRequest برای ContentCreatorInsightsService اضافه شد. این اجازه می دهد تا مکان های جغرافیایی زیرکشور را مشخص کنید تا جستجوها برای اطلاعات بینش سازندگان را اصلاح کنید. فیلد sub_country_locations تنها زمانی پشتیبانی می‌شود که از یک search_attributes در فیلد criteria استفاده کنید. اگر sub_country_locations با انواع معیارهای دیگر ارائه شود، درخواست نامعتبر خواهد بود. این امکان هدف گذاری و تجزیه و تحلیل جغرافیایی دقیق تری را برای بینش سازنده محتوا فراهم می کند. این ویژگی فقط برای حساب‌های موجود در فهرست مجاز در دسترس است.
  • ReachPlanService.ListPlannableUserLists اضافه شد که لیست های کاربران شخص اول متعلق به یک مشتری را برمی گرداند و UserListInfo به گزینه های هدف گیری مخاطب در GenerateReachForecastRequest اضافه کرد. این به شما امکان می‌دهد لیست‌های کاربری قابل برنامه‌ریزی را برای یک مشتری خاص بازیابی کنید و سپس برای کمپین‌هایی که آن مخاطبان خاص را هدف قرار می‌دهند، پیش‌بینی‌های دسترسی ایجاد کنید. این پیشرفت‌ها با ترکیب داده‌های مخاطبان شخص اول شما مستقیماً در پیش‌بینی، برنامه‌ریزی دسترسی متناسب را بهبود می‌بخشند. پیش‌بینی دسترسی فقط برای حساب‌های مجاز در دسترس است.

ویدیوها

  • آگهی‌های AdFormatType.PAUSE اضافه شد که روی ویدیوهای YouTube ارگانیک روی صفحه‌های تلویزیون ارائه می‌شوند، که در گزارش گنجانده شده است. این تبلیغات مستقیماً در کنار قاب ویدیوی ثابت در صفحه مکث نمایش داده می شوند. این شامل آگهی‌های ویدیویی «Demand Gen» نمی‌شود که در پانل آگهی زیر یا بالای یک ویدیوی ارگانیک موقتاً متوقف شده نمایش داده می‌شوند و تحت AdFormatType.INFEED گزارش می‌شوند.

v19.2 (06-08-2025)

این تغییرات تبلیغات سیاسی اتحادیه اروپا نیز در نسخه های v20.1 و v21 انجام شده است.

تغییرات تبلیغات سیاسی اتحادیه اروپا

  • Campaign.contains_eu_political_advertising اضافه شد. این فیلد نشان می‌دهد که آیا کمپین شما حاوی محتوای تبلیغاتی سیاسی با هدف اتحادیه اروپا است یا خیر. اگر این فیلد روی CONTAINS_EU_POLITICAL_ADVERTISING تنظیم شود، از 22 سپتامبر 2025، این کمپین دیگر در اتحادیه اروپا فعال نخواهد شد.

    برای هر کمپین موجود، باید قبل از تلاش برای تغییر نزدیکی، مکان یا هدف گروه مکان در سطح کمپین یا گروه تبلیغات، قسمت contains_eu_political_advertising تنظیم کنید. فراخوان‌های API برای ایجاد یا به‌روزرسانی معیارهای کمپین یا گروه تبلیغات برای کمپین‌های موجود، با خطای CriterionError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION در صورتی که کمپین خوداظهاری را کامل نکرده باشد، ناموفق خواهد بود.

    برای نسخه‌های v19.x و 20.x، الزام تنظیم این فیلد هنوز اعمال نشده است، اما در آینده خواهد بود. منتظر اعلام این تغییر باشید.

  • آزمایش‌ها و آزمایش‌ها یک ExperimentError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION ایجاد می‌کنند. MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION اگر کمپین‌های آزمایشی خود اعلام نکرده باشند که آیا حاوی تبلیغات سیاسی هستند که اتحادیه اروپا را هدف قرار می‌دهند یا خیر.

نسخه 19.1 (16-04-2025)

ویژگی ها و تغییرات زیر در نسخه 19.1 اضافه شده است.

دارایی ها

کمپین ها

تقاضای ژنرال

تاریخچه را تغییر دهید

  • پشتیبانی از سه نوع منبع دیگر به ChangeStatusResourceType اضافه شده است:
    • CAMPAIGN_BUDGET
    • ASSET_SET
    • CAMPAIGN_ASSET_SET
  • می توانید این سه نوع با دانه بندی ریز را از گزارش change_status بازیابی کنید.

تبدیل ها

تبلیغات خدمات محلی

  • برای ارائه بازخورد در مورد کیفیت LocalServicesLead ، یک RPC ProvideLeadFeedback جدید به LocalServicesLeadService اضافه کرد.
  • یک فیلد جدید lead_feedback_submitted به منبع LocalServicesLead اضافه شد که تأیید می کند آیا بازخورد برای یک منبع خاص ارائه شده است.

خدمات برنامه ریزی

  • پشتیبانی از پیش‌بینی‌های ماهانه فرکانس هدف در ReachPlanService.GenerateReachForecast اضافه شد.
    • هنگام استفاده از کد محصول قابل برنامه ریزی TARGET_FREQUENCY برای ایجاد پیش بینی دسترسی ماهانه فرکانس هدف، برنامه نویسان می توانند TargetFrequencyTimeUnit.MONTHLY در TargetFrequencySettings تنظیم کنند.
  • روش جدیدی اضافه شد ReachPlanService.GenerateConversionRates ، که به تبلیغ‌کنندگان اجازه می‌دهد نرخ‌های تبدیل پیشنهادی را برای محصولات قابل برنامه‌ریزی پشتیبانی شده درخواست کنند.
  • پیش‌بینی نسل تقاضا در ReachPlanService.GenerateReachForecast :
    • توسعه‌دهندگان اکنون می‌توانند پیش‌بینی رسیدن به کمپین‌های تقاضای نسل را درخواست کنند. توسعه دهندگان می توانند از کد محصول قابل برنامه ریزی DEMAND_GEN_MAX_CONVERSIONS جدید برای ایجاد پیش بینی های دسترسی نسل تقاضا استفاده کنند.
    • یک فیلد conversion_rate جدید اضافه شد که به توسعه دهندگانی که درخواست پیش‌بینی‌های رسیدن به تقاضای نسل تقاضا می‌کنند اجازه می‌دهد نرخ تبدیل را ارائه دهند. نرخ تبدیل پیشنهادی را می توان با استفاده از روش جدید ReachPlanService.GenerateConversionRates بازیابی کرد. این فیلد برای درخواست‌های پیش‌بینی تقاضای نسل لازم است. برای سایر محصولات قابل برنامه ریزی پشتیبانی نمی شود.
    • یک قسمت conversions جدید به پیش بینی های برگشتی اضافه شد. این فیلد شامل تعداد تبدیل ها در یک نقطه معین از منحنی دسترسی است. تبدیل فقط برای محصول قابل برنامه ریزی DEMAND_GEN_MAX_CONVERSIONS پشتیبانی می شود.

توصیه ها

ویدیوها

  • پشتیبانی فقط خواندنی برای تبلیغات صوتی اضافه شد. برای آشنایی با این ویژگی به مرکز راهنمای Google Ads مراجعه کنید. این تغییر نشان می دهد:
  • سنجه‌ها و بخش‌های جدیدی به معیارهای دستیابی به پرس و جو با تنظیم نمایشی اضافه شد. به عنوان بخشی از این تغییرات،
    • دو ستون معیار جدید به نام‌های coviewed_impressions و primary_impressions معرفی شدند.
    • دو بخش جدید به نام های adjusted_age_range و adjusted_gender معرفی شدند.
    • اگر هر یک از دو بخش جدید در کنار یک فیلد متریک دسترسی انتخاب شوند ( coviewed_impressions ، primary_impressions ، unique_users ، یا average_impression_frequency_per_user )، بخش دیگر نیز باید برای بازیابی آمار معتبر برای این ستون‌ها انتخاب شود.
    • این ویژگی در حال حاضر فقط برای مشتریان لیست مجاز در دسترس است.

v19 (26-02-2025)

ویژگی ها و تغییرات زیر در نسخه 19 اضافه شده است.

مدیریت حساب

  • مقادیر زیر را به CustomerError اضافه کرد تا تغییرات آتی را در نظر بگیرد:
    • CREATION_DENIED_FOR_POLICY_VIOLATION
    • CREATION_DENIED_INELIGIBLE_MCC

تبلیغات

دارایی ها

تبدیل ها

تغذیه می کند

  • همه موجودیت‌های مرتبط با فید، مانند Feed ، FeedMapping ، FeedService ، AdGroupFeed ، feed_placeholder_view ، و غیره حذف شد. کاربران اکنون باید از assets برای رسیدن به همان هدف استفاده کنند. برای لیست تمام نهادهای حذف شده، از یادداشت های مهاجرت دیدن کنید.

هتل و سفر

  • min_days و max_days از ValueRuleItineraryAdvanceBookingWindow را به یک فیلد optional تبدیل کرد تا امکان تعیین 0 به عنوان مقدار را فراهم کند. این از هدف گیری برای جستجوهای مسافرتی که امروزه انجام می شود پشتیبانی می کند.

حداکثر عملکرد

  • (فقط برای حساب های مجاز) دستورالعمل های برند
    • Campaign.brand_guidelines_enabled را فقط هنگام ایجاد کمپین Performance Max قابل تغییر کرد.
    • این با Performance Max برای اهداف سفر ناسازگار است.
    • برای فعال کردن دستورالعمل‌های برند برای کمپین‌های Performance Max موجود، از CampaignService.EnablePMaxBrandGuidelines جدید اضافه شده استفاده کنید. غیرفعال کردن دستورالعمل‌های برند پشتیبانی نمی‌شود.
    • Campaign.brand_guidelines و BrandGuidelines اضافه شد تا امکان تنظیم رنگ‌ها و خانواده فونت برند را فراهم کند.
    • مقادیر جدید خطا:
    • CampaignError
    • BRAND_GUIDELINES_NOT_ENABLED_FOR_CAMPAIGN
    • BRAND_GUIDELINES_MAIN_AND_ACCENT_COLORS_REQUIRED
    • BRAND_GUIDELINES_COLOR_INVALID_FORMAT
    • BRAND_GUIDELINES_UNSUPPORTED_FONT_FAMILY
    • BRAND_GUIDELINES_UNSUPPORTED_CHANNEL
    • CANNOT_ENABLE_BRAND_GUIDELINES_FOR_TRAVEL_GOALS
    • CUSTOMER_NOT_ALLOWLISTED_FOR_BRAND_GUIDELINES
  • AssetAutomationType.GENERATE_ENHANCED_YOUTUBE_VIDEOS برای پشتیبانی از تولید خودکار دارایی‌های ویدیویی پیشرفته برای کمپین‌های Performance Max اضافه شد.

برنامه ریزی

ویدیوها

  • پس از انتشار DataLinkService.CreateDataLink ، روش‌های زیر را اضافه کردیم تا بتوانیم پیوندهای داده‌ای ایجاد شده قبلی را تغییر دهیم:
    • RemoveDataLink برای حذف پیوندهای داده در حساب Google Ads
    • UpdateDataLink برای پذیرش، رد و لغو پیوندهای داده در حساب Google Ads
  • پشتیبانی از VIDEO_OUTSTREAM از فهرست‌های زیر حذف شد:

نسخه 18 (16-10-2024)

ویژگی ها و به روز رسانی های جدید زیر در نسخه 18 اضافه شده است.

مدیریت حساب

  • (فقط برای حساب های مجاز) DataLinkService.CreateDataLink اضافه شد، که اجازه می دهد یک حساب Google Ads را به ویدیوهای سازنده میزبانی شده در کانال YouTube سازنده پیوند دهید. پیوند ویدیو به حساب Google Ads امکان می‌دهد تبلیغات مشارکتی را با استفاده از ویدیوهای سازنده اجرا کند.

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

تبلیغات

  • AdGroupAd.ad_group_ad_asset_automation_settings اضافه شد، که اجازه می‌دهد تبلیغات را در تولید دارایی خودکار یا خارج از آن انتخاب کنید.
  • مقادیر زیر را به AssetAutomationType اضافه کرد:
    • GENERATE_VERTICAL_YOUTUBE_VIDEOS
    • GENERATE_SHORTER_YOUTUBE_VIDEOS
  • AdNetworkType.GOOGLE_OWNED_CHANNELS اضافه شد، که توسط تبلیغاتی که در کانال‌های متعلق به Google مانند YouTube، Gmail و فید Discover ارائه می‌شوند، استفاده می‌شود.

دارایی ها

کمپین ها

معیار

  • content_criterion_view اضافه شد، که معیارهای عملکرد محتوای هدفمند مانند کلمات کلیدی، مکان‌ها و موضوعات را برای کمپین‌های Display، Demand Gen و ویدیو برمی‌گرداند.

هتل و سفر

خدمات محلی

حداکثر عملکرد

برنامه ریزی

  • (فقط برای حساب‌های مجاز) سرویس جدیدی با روش ContentCreatorInsightsService.GenerateCreatorInsights اضافه کرد که به کاربران امکان می‌دهد اطلاعات آماری درباره سازندگان برتر YouTube را بررسی کنند. این به مشتریان اجازه می‌دهد تا سازندگانی را با توجه به ترکیب هدف‌گیری مخاطب و هدف‌گیری محتوا یا اطلاعات بینش سازنده با فهرستی از شناسه‌های کانال YouTube جستجو کنند.
  • به‌روزرسانی‌های AudienceInsightsService.GenerateSuggestedTargetingInsights :
    • audience ، baseline_audience و data_month به audience_definition منتقل شدند.
    • audience_description برای ایجاد پیشنهادات هدف‌یابی از یک توضیح متنی فرم رایگان با استفاده از هوش مصنوعی مولد اضافه شد.
  • AudienceInsightsService.GenerateTargetingSuggestionMetrics اضافه شد، که معیارهای دسترسی بالقوه را برای ترکیب‌های هدف‌گیری مخاطب خاص برمی‌گرداند.

توصیه ها

گزارش

  • زمینه های summary_row_setting و return_total_results_count از SearchGoogleAdsRequest را با قسمت search_settings جایگزین کرد ، که نوع آن SearchSettings با زمینه های زیر است:
    • omit_results
    • return_summary_row
    • return_total_results_count
  • معیارهای جدید زیر را در مورد کلیک های نامعتبر عمومی ، مانند مواردی که توسط رباتها یا خزنده ها ایجاد می شود ، اضافه کرد. آنها را می توان با گزارش campaign انتخاب کرد.
  • مقادیر زیر را به QuotaError اضافه کرد:
    • EXCESSIVE_LONG_TERM_QUERY_RESOURCE_CONSUMPTION

یادداشت های آزادی بایگانی شده

نسخه های Sunsetted را برای یادداشت های آزادی بایگانی مشاهده کنید.