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

v19 (26-02-2025)

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

مدیریت حساب

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

تبلیغات

دارایی ها

تبدیل ها

تغذیه می کند

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

هتل و سفر

  • 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 ارائه می‌شوند، استفاده می‌شود.

دارایی ها

کمپین ها

معیار

هتل و سفر

خدمات محلی

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

برنامه ریزی

  • (فقط برای حساب‌های مجاز) سرویس جدیدی با روش ContentCreatorInsightsService.GenerateCreatorInsights اضافه کرد که به کاربران امکان می‌دهد اطلاعات آماری درباره سازندگان برتر YouTube را بررسی کنند. این به مشتریان اجازه می‌دهد تا سازندگانی را با توجه به ترکیب هدف‌گیری مخاطب و هدف‌گیری محتوا یا اطلاعات بینش سازنده با فهرستی از شناسه‌های کانال YouTube جستجو کنند.
  • به‌روزرسانی‌های AudienceInsightsService.GenerateSuggestedTargetingInsights :
    • audience ، baseline_audience و data_month به audience_definition منتقل شدند.
    • audience_description برای ایجاد پیشنهادات هدف‌یابی از یک توضیح متنی فرم رایگان با استفاده از Gen AI اضافه شد.
  • 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_SHORT_TERM_QUERY_RESOURCE_CONSUMPTION
    • EXCESSIVE_LONG_TERM_QUERY_RESOURCE_CONSUMPTION

v17.1.0 (07-08-2024)

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

دارایی ها

مخاطبان

  • مقادیر enum جدید در UserListCustomerTypeCategory :
    • LOYALTY_TIER_1_MEMBERS
    • LOYALTY_TIER_2_MEMBERS
    • LOYALTY_TIER_3_MEMBERS
    • LOYALTY_TIER_4_MEMBERS
    • LOYALTY_TIER_5_MEMBERS
    • LOYALTY_TIER_6_MEMBERS
    • LOYALTY_TIER_7_MEMBERS

کمپین ها

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

  • نوع منبع تغییر وضعیت جدید: ASSET_GROUP .

تبدیل ها

برنامه ریزی

  • AudienceInsights.GenerateAudienceOverlapInsights() که یک ویژگی اولیه ورودی و مجموعه‌ای از ویژگی‌های مخاطب را می‌پذیرد و تخمین‌های همپوشانی دسترسی بالقوه YouTube را بین ویژگی اصلی و ویژگی‌های مخاطب برمی‌گرداند.

گزارش دهی

ویدیوها

v17 (05-06-2024)

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

تبلیغات

  • AdService.getAd حذف شد. این سرویس AdService با سایر خدمات موجود در Google Ads API مطابقت می دهد. برای روش توصیه شده برای واکشی تبلیغات و سایر انواع منابع، به بازیابی اشیا مراجعه کنید.
  • اعتبارسنجی های بیشتری برای ImageAdInfo.image_asset در رابطه با ابعاد و قالب اضافه شده است. اگر تصویر نامعتبر باشد ممکن است خطاهای زیر ایجاد شود:

دارایی ها

مخاطبان

مشاغل دسته ای

کمپین ها

  • در همه زمینه‌ها، فهرست‌بندی‌ها، خطاهای همه منابع در سراسر Google Ads API، مانند کمپین‌ها، تبلیغات و دارایی‌ها، Discovery به Gen Demand تغییر نام داد. برای مثال، AdvertisingChannelType.DISCOVERY اکنون AdvertisingChannelType.DEMAND_GEN است.
  • Campaign.keyword_match_type اضافه شد تا بتوانید نوع مطابقت کلمه کلیدی را برای همه کلمات کلیدی در یک کمپین تنظیم کنید.

تبدیل ها

معیارها

خدمات محلی

گزارش دهی

خرید

  • یک گزارش جدید shopping_product اضافه کرد که با صفحه محصولات رابط کاربری Google Ads مطابقت دارد. از بازگرداندن داده‌های مربوط به وضعیت فعلی محصولات از حساب‌های Google Merchant Center مرتبط با حساب Google Ads پشتیبانی می‌کند.

اهداف یکپارچه

ویدیوها

  • مقادیر زیر را به ContentLabelType اضافه کرد. می‌توانید این ContentLabelTypes در سطح مشتری حذف کنید:
    • BRAND_SUITABILITY_CONTENT_FOR_FAMILIES
    • BRAND_SUITABILITY_GAMES_FIGHTING
    • BRAND_SUITABILITY_GAMES_MATURE
    • BRAND_SUITABILITY_HEALTH_SENSITIVE
    • BRAND_SUITABILITY_HEALTH_SOURCE_UNDETERMINED
    • BRAND_SUITABILITY_NEWS_RECENT
    • BRAND_SUITABILITY_NEWS_SENSITIVE
    • BRAND_SUITABILITY_NEWS_SOURCE_NOT_FEATURED
    • BRAND_SUITABILITY_POLITICS
    • BRAND_SUITABILITY_RELIGION
  • هنگام ایجاد DemandGenVideoResponsiveAdInfo AdVideoAsset.ad_video_asset_info برای پشتیبانی از اولویت‌های موجودی برای دارایی‌های ویدیو اضافه کرد.
  • (فقط حساب های مجاز) Made Campaign.video_brand_safety_suitability قابل تغییر است.

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

برای یادداشت‌های انتشار آرشیو شده، نسخه‌های Sunsetted را ببینید.