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

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

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

دارایی ها

• یک قسمت asset_coverage برای AssetGroup اضافه شد که اطلاعات مربوط به شکاف‌های موجود در گروه دارایی شما را برمی‌گرداند.
  • حاوی یک زیرفیلد ad_strength_action_items است که فهرستی از اقداماتی را که تبلیغ‌کننده می‌تواند برای بهبود قدرت تبلیغات یک گروه دارایی انجام دهد، برمی‌گرداند.

کمپین ها

• اکنون می‌توانید برای سرنخ‌ها در کمپین‌های خدمات محلی رتبه‌بندی یا بازخورد ارائه کنید. به عنوان بخشی از این تغییر، نسخه 19.1
  • سرویس جدیدی به نام LocalServicesLeadService اضافه شد. می‌توانید از روش ProvideLeadFeedback برای آپلود رتبه‌بندی و بازخورد برای سرنخ‌ها استفاده کنید.
  • یک فیلد جدید به نام lead_feedback_submitted به LocalServicesLead اضافه کرد تا به تعیین اینکه آیا بازخورد به سرنخ ارسال شده است یا خیر.
• یک ستون متریک جدید biddable_cohort_app_post_install_conversions برای کمپین های برنامه اضافه شد.

تقاضای ژنرال

• روش‌های اضافی در خدمات برنامه‌ریزی برای پشتیبانی از تقاضای Gen.

• پشتیبانی از کنترل‌های کانال در سطح AdGroup برای کمپین‌های نسل تقاضا اضافه شد. می‌توانید با استفاده از فیلد demand_gen_ad_group_settings ، یک گروه‌بندی کلی از پیش تعریف‌شده کانال‌ها یا زیرمجموعه‌ای از کانال‌ها را انتخاب کنید. کانال های زیر در نسخه فعلی پشتیبانی می شوند :

  • YouTube In-Stream
  • YouTube In-Feed
  • شورت یوتیوب
  • کشف کنید
  • جیمیل
  • نمایش

• یک نوع دارایی جدید برای TALL_PORTRAIT_MARKETING_IMAGE در معرض دید قرار گرفت. این نوع دارایی مربوط به قسمت tall_portrait_marketing_images در قالب آگهی چند دارایی تقاضای نسل است .

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

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

تبدیل ها

• اکنون می‌توانید فیلد google_ads_conversion_customer را هنگام ایجاد یک مشتری جدید با استفاده از Google Ads API تنظیم کنید. این قبلاً یک فیلد فقط خواندنی بود.
• اکنون می‌توانید هنگام آپلود تبدیل‌های آفلاین ، نوع مشتری مرتبط با تبدیل را مشخص کنید.
• یک فیلد session_attributes جدید برای ClickConversion معرفی شد.

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

• برای ارائه بازخورد در مورد کیفیت 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 پشتیبانی می شود.

توصیه ها

• فیلد جدید ad_strength برای ImprovePerformanceMaxAdStrengthRecommendation موجود است، که امتیاز قدرت آگهی فعلی گروه دارایی مرتبط با توصیه را برمی‌گرداند.

خرید

• اکنون می‌توانید استثناهای برند را برای تبلیغات خرید در کمپین‌های Performance Max لغو کنید. این از طریق یک فیلد pmax_campaign_settings جدید در سطح کمپین آشکار می‌شود، و فقط برای کمپین‌های PMax برای خرده‌فروشی کار می‌کند. اگر بخواهید این فیلد را برای یک نوع کمپین ناسازگار تنظیم کنید، یک خطای جدید CampaignError.BRAND_TARGETING_OVERRIDES_NOT_SUPPORTED ایجاد می شود.

ویدیوها

• پشتیبانی فقط خواندنی برای تبلیغات صوتی اضافه شد. برای آشنایی با این ویژگی به مرکز راهنمای Google Ads مراجعه کنید. این تغییرات نشان می دهد:
  • یک AdvertisingChannelSubType جدید با نام YOUTUBE_AUDIO .
  • یک AdGroupType جدید با نام YOUTUBE_AUDIO .
  • یک شماره قالب آگهی جدید به نام YOUTUBE_AUDIO_AD و فیلدهای YouTubeAudioAdInfo مربوط به آن.
• سنجه‌ها و بخش‌های جدیدی به معیارهای دستیابی به پرس و جو با تنظیم نمایشی اضافه شد. به عنوان بخشی از این تغییرات،
  • دو ستون معیار جدید به نام‌های 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

تبلیغات

• DemandGenMultiAssetAdInfo.tall_portrait_marketing_images برای پشتیبانی از دارایی های تصویر پرتره با نسبت ابعاد 9:16 در تبلیغات تقاضای نسل اضافه کرد.

دارایی ها

• (فقط برای حساب های مجاز) پشتیبانی از دارایی های پیام از طریق Asset.business_message_asset ، BusinessMessageAsset و شماره ها و خطاهای زیر اضافه شد.
  • فهرست ها:
    • AssetFieldType.BUSINESS_MESSAGE
    • AssetType.BUSINESS_MESSAGE
    • BusinessMessageCallToActionType
    • BusinessMessageProvider
  • خطاها:
    • AssetError.CUSTOMER_NOT_ON_ALLOWLIST_FOR_WHATSAPP_MESSAGE_ASSETS
    • ResourceLimitType
      • BUSINESS_MESSAGE_ASSET_LINKS_PER_CUSTOMER
      • WHATSAPP_BUSINESS_MESSAGE_ASSET_LINKS_PER_CAMPAIGN
      • WHATSAPP_BUSINESS_MESSAGE_ASSET_LINKS_PER_AD_GROUP
• AssetAutomationType.GENERATE_LANDING_PAGE_PREVIEW اضافه شد تا از تولید خودکار پیش‌نمایش صفحه فرود پشتیبانی کند.
• AssetAutomationType.GENERATE_SHORTER_YOUTUBE_VIDEOS اکنون به‌طور پیش‌فرض برای تبلیغات واکنش‌گرای ویدیویی تقاضای نسل انتخاب شده است.
• (فقط برای حساب های مجاز، لیست مجاز در حال حاضر بسته است) Asset.app_deep_link_asset و AppDeepLinkAsset اضافه شد.

تبدیل ها

• اهداف تبدیل
  • LifecycleGoalValueSettings.high_lifetime_value از نسخه بتا خارج شده و اکنون قابل تغییر است.
  • CustomerLifecycleGoal.owner_customer برای نشان دادن نام منبع مشتری که هدف چرخه عمر مشتری را دارد، اضافه شد.
• ConversionActionType.SALESFORCE منسوخ شده است.

تغذیه می کند

• همه موجودیت‌های مرتبط با فید، مانند 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 اضافه شد تا امکان تنظیم رنگ‌ها و خانواده فونت برند را فراهم کند.
  • مقادیر جدید خطا:
    • BatchJobError.CAMPAIGN_AND_CAMPAIGN_ASSET_TRANSACTION_FAILURE
    • BrandGuidelinesMigrationError
    • BRAND_GUIDELINES_ALREADY_ENABLED
    • CANNOT_ENABLE_BRAND_GUIDELINES_FOR_REMOVED_CAMPAIGN
    • BRAND_GUIDELINES_LOGO_LIMIT_EXCEEDED
    • CANNOT_AUTO_POPULATE_BRAND_ASSETS_WHEN_BRAND_ASSETS_PROVIDED
    • AUTO_POPULATE_BRAND_ASSETS_REQUIRED_WHEN_BRAND_ASSETS_OMITTED
    • TOO_MANY_ENABLE_OPERATIONS
  • 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 اضافه شد.

برنامه ریزی

• (فقط برای حساب های مجاز) ContentCreatorInsightsService.GenerateTrendingInsights اضافه شد.GenerateTrendingInsights که به کاربران امکان می دهد موضوعات محتوای پرطرفدار را در YouTube برای تعاریف مخاطب خاص مشاهده کنند.
• GenerateCreatorInsightsRequest.country_locations[] اضافه شد تا کشورها را برای جستجوی معیارهای داده شده مشخص کند
• GenerateCreatorInsightsRequest.search_brand را برای تعیین نام تجاری برای جستجوی سازندگان اضافه کرد.
• فیلدهای جدیدی را به YouTubeChannelInsights اضافه کرد تا اطلاعات کانال اضافی را برای درخواست‌های search_channels ارائه کند:
  • channel_url
  • channel_description
  • top_videos
• فیلدهای ابرداده جدید به AudienceInsightsAttributeMetadata اضافه شد:
  • youtube_video_metadata
  • user_interest_attribute_metadata
  • knowledge_graph_attribute_metadata

ویدیوها

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

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

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

مدیریت حساب

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

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

• AdGroup.exclude_demographic_expansion اضافه شد که به شما امکان می‌دهد تا زمانی که optimized_targeting_enabled true است، اطلاعات جمعیتی را از گسترش حذف کنید، ویژگی که قبلاً فقط برای Demand Gen پشتیبانی می‌شد.

تبلیغات

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

دارایی ها

• AssetType.DISCOVERY_CAROUSEL_CARD به AssetType.DEMAND_GEN_CAROUSEL_CARD تغییر نام داد.

کمپین ها

• metrics.store_visits_last_click_model_attributed_conversions اضافه شد، که تعداد بازدیدهای فروشگاه منتسب به آخرین مدل کلیک کمپین را برمی‌گرداند.
• معیارهای مربوط به مشاهده ویدیوی زیر را برای یک کمپین اضافه کرد:
  • metrics.video_view_rate_in_feed
  • metrics.video_view_rate_in_stream
  • metrics.video_view_rate_shorts
• metrics.results_conversions_purchase اضافه شد، که خریدهای تبدیل را برای نتایج اهداف یکپارچه یک کمپین برمی گرداند.
• مقدار پیش‌فرض DemandGenCampaignSettings.upgraded_targeting را از false به true تغییر داد.

معیار

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

هتل و سفر

• پشتیبانی از فیدهای سفر در تبلیغات جستجو
  • ClickType.TRAVEL_ASSETS اضافه شد تا امکان تقسیم بندی معیارهای فیدهای سفر در تبلیغات جستجو را فراهم کند.
  • AssetSetType.TRAVEL_FEED اضافه شد که می‌تواند برای انتخاب و انصراف از استفاده از Travel Feed در تبلیغات جستجو استفاده شود.
• (فقط برای حساب های مجاز) برنامه سفر به عنوان یک قانون ارزش تبدیل جدید با فیلدها و مقادیر جدید زیر اضافه شد:
  • ConversionValueRule.itinerary_condition با ValueRuleItineraryCondition ، که امکان تعیین پنجره رزرو قبلی، طول برنامه سفر و روزهای شروع سفر را فراهم می کند.
  • ConversionValueRulePrimaryDimensionEnum.ITINERARY
  • ValueRuleSetDimension.ITINERARY
• بخش‌های زیر را برای گزارش‌های campaign و ad_group اضافه کرد تا امکان تقسیم‌بندی داده‌های عملکرد بر اساس مقاصد خاص (شهرها، کشورها و مناطق) برای کمپین‌های هتل و جستجو فراهم شود:
  • segments.travel_destination_city
  • segments.travel_destination_country
  • segments.travel_destination_region

خدمات محلی

• PhoneCallDetails.call_recording_url به جای ارائه یک URL نامعتبر در صورتی که ضبط تماس برای مکالمه اصلی سرویس های محلی داده شده وجود نداشته باشد خالی خواهد بود.
• CategoryBid.target_cpa_bid_micro اضافه شد که امکان تنظیم CPA هدف را برای یک دسته از طریق Campaign.local_services_campaign_settings فراهم می کند.

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

• پشتیبانی از دستورالعمل های برند
  • Campaign.brand_guidelines_enabled اضافه شد، که نشان می‌دهد آیا دستورالعمل‌های برند برای یک کمپین حداکثر عملکرد فعال هستند یا خیر. در صورت فعال بودن، دارایی‌هایی که field_type روی BUSINESS_NAME ، LOGO ، LANDSCAPE_LOGO تنظیم شده است، باید به‌جای منابع AssetGroupAsset به‌عنوان منابع CampaignAsset مرتبط شوند.
  • خطاهای CampaignError.REQUIRED_BUSINESS_NAME_ASSET_NOT_LINKED و CampaignError.REQUIRED_LOGO_ASSET_NOT_LINKED اضافه شد، که نشان می‌دهد کمپین‌های Performance Max با دستورالعمل‌های برند فعال، منابع مورد نیاز CampaignAsset مرتبط با کمپین را ندارند.
  • وقتی دستورالعمل‌های نام تجاری فعال هستند، حداقل یک دارایی با field_type روی BUSINESS_NAME و حداقل یکی با LOGO باید به عنوان منابع CampaignAsset به کمپین مرتبط شود. کمپین‌های حداکثر عملکرد برای فروش آنلاین با فید محصول فقط زمانی باید این شرط را برآورده کنند که دارایی‌هایی وجود داشته باشند که به گروه‌های دارایی کمپین مرتبط هستند.
  • مقادیر زیر را به AssetLinkError اضافه کرد:
    • BRAND_ASSETS_NOT_LINKED_AT_ASSET_GROUP_LEVEL ، که هنگام تلاش برای پیوند دادن دارایی‌های برند به کمپین‌ها به‌عنوان منابع CampaignAsset به جای منابع AssetGroupAsset در کمپین‌های Performance Max با دستورالعمل‌های نام تجاری فعال نشده، پرتاب می‌شود.
    • خطای BRAND_ASSETS_NOT_LINKED_AT_CAMPAIGN_LEVEL ، که هنگام تلاش برای مرتبط کردن دارایی های مارک به کمپین ها به عنوان منابع AssetGroupAsset به جای منابع CampaignAsset در کمپین های Performance Max با فعال کردن دستورالعمل های مارک، ایجاد می شود.
• performance_max_placement_view اضافه شد، که نمایش‌هایی را از مکان‌هایی که تبلیغات حداکثر عملکرد در آن‌ها ارائه شده است، برمی‌گرداند.
• AssetGroupListingGroupFilterError.TREE_WAS_INVALID_BEFORE_MUTATION اضافه شد.TREE_WAS_INVALID_BEFORE_MUTATION

برنامه ریزی

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

توصیه ها

• RecommendationService.GenerateRecommendations اکنون می تواند برای ایجاد توصیه هایی در مورد پیشنهادهای بودجه بهینه شده در طول ساخت کمپین، با گنجاندن نوع توصیه CAMPAIGN_BUDGET در GenerateRecommendationsRequest.recommendation_types[] استفاده شود. این برای کمپین‌های Performance Max و Search کار می‌کند.

گزارش

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

v17.1.0 (07-08-2024)

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

دارایی ها

• AdGroupAdService.RemoveAutomaticallyCreatedAssets() به شما امکان می دهد دارایی های مشخص شده ایجاد شده به طور خودکار مرتبط با تبلیغات جستجوی پاسخگو را حذف کنید.

مخاطبان

• مقادیر 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

کمپین ها

• ShareablePreviewService.GenerateShareablePreviews() URL های shareable_preview_url را در پاسخ برای پیش نمایش های تبلیغاتی قابل اشتراک گذاری برای گروه های دارایی فعال و متوقف شده ایجاد می کند.
  • قسمت expiration_date_time تاریخ انقضای URL های موجود در پاسخ را نشان می دهد.
  • اگر خطایی رخ دهد، روش به جای URL ها partial_failure_error برمی گرداند.

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

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

تبدیل ها

• فیلد بخش جدید برای نسخه SKAdNetwork : segments.sk_ad_network_version
• offline_conversion_upload_conversion_action_summary ، که عیب‌یابی آپلود تبدیل را در سطح اقدام تبدیل نشان می‌دهد.
• معیارهای زیر به گزارش‌های تشخیصی آفلاین اضافه می‌شوند تا تعداد تبدیل‌های آپلود شده را که هنوز در حال پردازش هستند، نشان دهند:
  • offline_conversion_upload_client_summary
    • pending_event_count
    • pending_rate
  • offline_conversion_upload_conversion_action_summary :
    • pending_count

برنامه ریزی

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

گزارش

• پشتیبانی از تقسیم بندی per_store_view بر اساس segments.date

ویدیوها

• پشتیبانی برای بازیابی اطلاعات مربوط به استراتژی‌های پیشنهادی استاندارد زیر برای کمپین‌های ویدیویی با استفاده از گزارش‌ها، مانند ad_group ، campaign :
  • Campaign.fixed_cpm (CPM ثابت (هزینه در هزار نمایش))
  • Campaign.target_cpv (CPV هدف (هزینه هر بازدید))
• Campaign.video_campaign_settings که به شما امکان می دهد با استفاده از فیلدهای گزارش زیر تعیین کنید که تبلیغات ویدیویی در کدام موجودی نمایش داده شود:
  • campaign.video_campaign_settings.video_ad_inventory_control.allow_in_feed
  • campaign.video_campaign_settings.video_ad_inventory_control.allow_in_stream
  • campaign.video_campaign_settings.video_ad_inventory_control.allow_shorts
• segments.ad_format_type که به شما امکان می‌دهد گزارش‌های زیر را بر اساس نوع قالب تبلیغ ویدیویی تقسیم‌بندی کنید:
  • ad_group
  • ad_group_ad
  • ad_group_ad_asset_view
  • campaign
  • customer

v17 (05-06-2024)

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

تبلیغات

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

دارایی ها

• فهرست جدید اضافه شد: ClickType.AD_IMAGE
• گزارش‌های جدید زیر را با معیارهای جدید برای کمپین‌های حداکثر عملکرد و جستجو اضافه کرد:
  • campaign_aggregate_asset_view
  • channel_aggregate_asset_view

مخاطبان

• OfflineUserDataJobError.OPERATION_LEVEL_CONSENT_PROVIDED اضافه شد.OPERATION_LEVEL_CONSENT_PROVIDED

مشاغل دسته ای

• BatchJobError.REQUEST_TOO_LARGE اضافه شد، که زمانی که AddBatchJobOperationsRequest ارسال شده بزرگتر از 10484504 بایت باشد پرتاب می شود.
• پشتیبانی برای تنظیم MutateOperation.asset_group_operation هنگام استفاده از BatchJobService اضافه شد. این به شما امکان می دهد از پردازش دسته ای برای ایجاد و مدیریت کل کمپین های Performance Max استفاده کنید. راهنمای اختصاصی جدید ما را ببینید.

کمپین ها

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

تبدیل ها

• برای تبدیل SKAdNetwork ،
  • segments.sk_ad_network_conversion_value به segments.sk_ad_network_fine_conversion_value تغییر نام داد.
  • segments.sk_ad_network_redistributed_fine_conversion_value اضافه شد.
• معیارهای زیر اکنون با پاسخ بازگردانده می شوند حتی زمانی که صفر باشند. این باعث می شود آنها با سایر معیارها سازگار باشند.
  • metrics.all_conversions_value_by_conversion_date
  • metrics.all_conversions_by_conversion_date
  • metrics.conversions_value_by_conversion_date
  • metrics.conversions_by_conversion_date

معیارها

• به فیلدهای زیر به AdGroupCriterion اضافه شد تا نشان دهد آیا معیار گروه آگهی در حال ارائه است یا دلایل عدم ارائه آن:
  • primary_status
  • primary_status_reasons
• پشتیبانی از metrics.search_impression_share برای gender_view اضافه شد
• پشتیبانی از metrics.phone_calls برای keyword_view اضافه شد

خدمات محلی

• اضافه شد LocalServicesLeadService.AppendLeadConversation() برای الحاق یک LocalServicesLeadConversation جدید به LocalServicesLead استفاده می شود که بسته به نحوه ایجاد لید، پیام ها را از طریق کانال های مناسب مانند SMS برای کاربران ارسال می کند.
  • اندازه AppendLeadConversationRequest.conversations به 1000 محدود است.
  • فقط LocalServicesLead با lead_type تنظیم شده روی LeadType.MESSAGE را می توان در Conversation.local_services_lead مشخص کرد.
• مقادیر enum جدید به ConversationType اضافه شد:
  • WHATSAPP برای نشان دادن یک مکالمه معرفی شده از طریق WhatsApp.
  • ADS_API برای نمایش یک مکالمه معرفی شده با استفاده از روش جدید LocalServicesLeadService.AppendLeadConversation() .
• فیلدهای جدید زیر را به local_services_verification_artifact اضافه کرد:
  • local_services_verification_artifact.insurance_verification_artifact.expiration_date_time
  • local_services_verification_artifact.license_verification_artifact.expiration_date_time

گزارش

• اکنون می‌توانید هنگام جستجوی product_link ، فقط فیلدهای مربوط به یک محصول پیوندی را انتخاب کنید. انتخاب چندین فیلد از چندین محصول پیوند داده شده باعث QueryError.PROHIBITED_FIELD_COMBINATION_IN_SELECT_CLAUSE می شود.PROHIBITED_FIELD_COMBINATION_IN_SELECT_CLAUSE. برای مثال، product_link.advertising_partner.customer و product_link.data_partner.data_partner_id را نمی توان در یک جستار انتخاب کرد.
• ارسال یک page_size به GoogleAdsService.Search منجر به خطای RequestError.PAGE_SIZE_NOT_SUPPORTED می شود.

خرید

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

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

• UserListCustomerTypeService.MutateUserListCustomerTypes() برای پیکربندی انواع مشتریان مخاطب اضافه شد.
• CustomerLifecycleGoal.lifecycle_goal_customer_definition_settings حذف شد. برای پیکربندی تنظیمات مخاطب اهداف چرخه حیات مشتری، به جای آن از UserListCustomerTypeService.MutateUserListCustomerTypes() استفاده کنید.
  • با تنظیم UserListCustomerType.customer_type_category به UserListCustomerTypeCategory.PURCHASERS یک لیست کاربری را ضمیمه یا لغو ضمیمه کنید تا به ترتیب آن را در یک تعریف مشتری موجود برای اهداف چرخه عمر مشتری قرار دهید یا از آن حذف کنید. برای جزئیات بیشتر از بخش مخاطبان خود بازدید کنید.

ویدیوها

• مقادیر زیر را به 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 را ببینید.