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

نسخه 16.1.0 (24-04-2024)

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

مدیریت حساب

• CustomerNegativeCriterion.ip_block که از افزودن IP به عنوان یک معیار منفی در سطح مشتری پشتیبانی می کند.
• مقدار enum جدید: ProductLinkError.LINK_EXISTS .
• مقدار enum جدید: ProductLinkInvitationError.CUSTOMER_NOT_PERMITTED_TO_CREATE_INVITATION .

دارایی های

• پشتیبانی از دارایی‌های مربوط به Demand Gen به ad_group_ad_asset_view و asset_field_type_view .
• مقدار enum جدید: AssetFieldType.DISCOVERY_CAROUSEL_CARD .

مخاطبان

• مقدار enum جدید: ResourceLimitType.LOOKALIKE_USER_LISTS_PER_CUSTOMER که تعداد لیست های مشابه کاربر را که مشتری می تواند داشته باشد به 1000 محدود می کند.

کمپین ها

• پشتیبانی از شبیه‌سازی‌های پیشنهادی کمپین هدف ROAS برای کمپین‌های برنامه با استفاده از گزارش campaign_simulation .
• مقدار enum جدید: CampaignError.DYNAMIC_TEXT_ASSET_CANNOT_OPT_OUT_WITH_FINAL_URL_EXPANSION_OPT_IN .
• مقدار enum جدید: AdGroupPrimaryStatusReason.AD_GROUP_PAUSED_DUE_TO_LOW_ACTIVITY .
• مقدار شماره جدید: CampaignCriterionError.CANNOT_REMOVE_ALL_LOCATIONS_DUE_TO_TOO_MANY_COUNTRY_EXCLUSIONS .

تبدیل ها

• SkAdNetworkConversionValueSchema.postback_mappings که از ویژگی های SKAdNetwork 4.0 پشتیبانی می کند.
• پشتیبانی از هشدارها برای CustomerSkAdNetworkConversionValueSchemaService به عنوان MutateCustomerSkAdNetworkConversionValueSchemaRequest.enable_warnings اضافه شد. وقتی روی true تنظیم شود، هر گونه خطای غیرانسدادی مربوط به خرابی عملیات به عنوان MutateCustomerSkAdNetworkConversionValueSchemaResponse.warning برگردانده می شود.
• مقادیر enum جدید در CustomerSkAdNetworkConversionValueSchemaError :
  • INVALID_EVENT_COUNTER
  • INVALID_EVENT_NAME

شاخص

• فیلدهای جدید در BrandInfo :
  • display_name
  • primary_url
  • rejection_reason
  • status
• شماره جدید: BrandRequestRejectionReason .
• مقدار enum جدید: CriterionType.LIFE_EVENT .

آزمایش

• مقدار enum جدید: ExperimentError.INVALID_DURATION_FOR_AN_EXPERIMENT .

خدمات محلی

• local_services_lead.credit_details.credit_state و local_services_lead.credit_details.credit_state_last_update_date_time که به ترتیب وضعیت اعتبار و مُهر زمانی به‌روزرسانی وضعیت اعتبار را برمی‌گرداند.
• local_services_lead_conversation.message_details.attachment_urls که نشانی‌های اینترنتی را برمی‌گرداند که می‌توان از آنها برای دانلود محتویات پیوست استفاده کرد.

فیلم های

• customer.video_brand_safety_suitability و BrandSafetySuitability که از بازیابی مناسب بودن ایمنی برند ویدیویی در سطح مشتری پشتیبانی می کنند.
• مقدار enum جدید: VideoCampaignError.MUTATE_REQUIRES_RESERVATION .

نسخه 16 (21-02-2024)

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

مدیریت حساب

• advertising_partner از AccountLink به ProductLink و ProductLinkInvitation منتقل کرد.
• data_partner و google_ads را از AccountLink حذف کرد.
• IdentityVerificationService برای مدیریت راستی‌آزمایی تبلیغ‌کننده اضافه شد.
  • StartIdentityVerification() برای شروع یک جلسه تأیید با استفاده از verification_program ارائه شده استفاده می شود. یک جلسه تأیید جدید ایجاد می کند و یک پاسخ خالی را برای تأیید ایجاد شده با موفقیت برمی گرداند.
    • IdentityVerificationProgram.ADVERTISER_IDENTITY_VERIFICATION اضافه شد.
  • GetIdentityVerification() می تواند برای بازیابی اطلاعات تأیید استفاده شود که چندین شی از IdentityVerification را برمی گرداند. هر IdentityVerification شامل:
    • verification_program که نوع برنامه تایید هویت است
    • identity_verification_requirement که حاوی جزئیات مربوط به مهلتی است که تبلیغ‌کننده باید تأیید را در آن به پایان برساند.
    • verification_progress که حاوی جزئیات مربوط به جلسه تأیید است از جمله:
      • program_status وضعیت فعلی این جلسه تأیید را نشان می دهد
      • action_url مشتری را به یک URL هدایت می کند تا تأیید را تکمیل کند.
      • invitation_link_expiration_time تاریخ انقضای action_url را نشان می دهد
  • فهرست ها:
    • IdentityVerificationProgram
    • IdentityVerificationProgramStatus
  • خطاها:
    • IdentityVerificationError
• AuthorizationError.ACTION_NOT_PERMITTED_FOR_SUSPENDED_ACCOUNT اضافه شد.ACTION_NOT_PERMITTED_FOR_SUSPENDED_ACCOUNT.

دارایی های

• تغییرات asset_group :
  • پشتیبانی از بخش‌های مرتبط با زمان، مانند segments.year و segments.month اضافه شده است.
  • به جای تقسیم‌بندی منبع، campaign را به یک منبع منتسب تبدیل کرد.

کمپین ها

• تغییرات در کمپین های تقاضای نسل:
  • پشتیبانی برای تنظیم Campaign.shopping_setting به کمپین نسل تقاضای موجود اضافه شد.
  • ShoppingSetting.disable_product_feed برای غیرفعال کردن فید محصول اختیاری کمپین‌های Demand Gen اضافه شد.
  • Ad.demand_gen_product_ad و DemandGenProductAdInfo مربوطه اضافه شد که برای کمپین های Demand Gen با یک Campaign.shopping_setting غیر تهی در دسترس است.
• به فیلدهای زیر به AdGroup اضافه شد تا نشان دهد که آیا گروه تبلیغات در حال ارائه است یا دلایل عدم ارائه آن:
  • primary_status
  • primary_status_reasons
• به فیلدهای زیر به AdGroupAd اضافه شد تا نشان دهد آیا تبلیغ گروه تبلیغاتی در حال ارائه است یا دلایل عدم ارائه آن:
  • primary_status
  • primary_status_reasons
• مقادیر زیر را به AdGroupError اضافه کرد:
  • CANNOT_ADD_AD_GROUP_FOR_CAMPAIGN_TYPE
  • INVALID_STATUS

آزمایش کنید

• Experiment.sync_enabled اضافه شد تا مشخص شود آیا همگام‌سازی باید در آزمایش فعال شود یا خیر. با فعال کردن همگام‌سازی ، تغییرات ایجاد شده در کمپین اصلی در حین اجرای آزمایش، به‌طور خودکار در کمپین آزمایشی کپی می‌شود.
• ExperimentError.CANNOT_ENABLE_SYNC_FOR_UNSUPPORTED_EXPERIMENT_TYPE اضافه شد.CANNOT_ENABLE_SYNC_FOR_UNSUPPORTED_EXPERIMENT_TYPE.
• CampaignError.CANNOT_MODIFY_TEXT_ASSET_AUTOMATION_WITH_ENABLED_TRIAL اضافه شد.CANNOT_MODIFY_TEXT_ASSET_AUTOMATION_WITH_ENABLED_TRIAL.

هتل و سفر

• فیلدهای زیر را به آگهی ListingDimensionInfo for a Things to do اضافه کرد تا امکان ایجاد گروه‌های فهرست‌بندی بر اساس ایالت و شهری که فعالیت سفر در آن در دسترس است را فراهم کند:
  • activity_state
  • activity_city
• پشتیبانی برای بخش‌های زیر به travel_activity_performance_view اضافه شد:
  • segments.activity_city
  • segments.activity_country
  • segments.activity_state

خدمات محلی

• LocalServicesVerificationArtifact.business_registration_check_verification_artifact و BusinessRegistrationCheckArtifact اضافه شد تا به تبلیغ‌کنندگان امکان نظارت بر روند تأیید ثبت کسب و کار را بدهد.
• یک منبع جدید local_services_employee اضافه کرد تا به تبلیغ‌کنندگان اجازه دهد اطلاعات کارمندانی را که اضافه کرده‌اند بازیابی کنند.

برنامه ریزی

• score از AudienceInsightsAttributeMetadata حذف شد.

توصیه ها

• RecommendationService.GenerateRecommendations() اضافه شد که توصیه هایی را بر اساس تنظیمات مشخص شده، مانند انواع توصیه ها و انواع کانال های تبلیغاتی، برمی گرداند. این به ویژه در طول ساخت کمپین مفید است.
• RecommendationMetrics.conversions_value اضافه شد.
• کلیدواژه‌های توصیه‌شده با نوع تطابق کلمه کلیدی تنظیم‌نشده، اکنون recommended_match_type به جای UNKNOWN روی UNSPECIFIED تنظیم کرده‌اند.
• انواع توصیه های زیر را اضافه کرد:
  • MAXIMIZE_CONVERSION_VALUE_OPT_IN که شرکت در استراتژی پیشنهاد قیمت حداکثر تبدیل را توصیه می کند
  • IMPROVE_GOOGLE_TAG_COVERAGE که استفاده از Google Tag را در صفحات بیشتری توصیه می کند
  • PERFORMANCE_MAX_FINAL_URL_OPT_IN که توصیه می‌کند بسط URL نهایی را برای کمپین‌های Performance Max خود روشن کنید
  • REFRESH_CUSTOMER_MATCH_LIST که توصیه می کند فهرست مشتریانی را که در 90 روز گذشته به روز نشده است به روز کنید.
  • CUSTOM_AUDIENCE_OPT_IN که ایجاد یک مخاطب سفارشی را توصیه می کند
  • LEAD_FORM_ASSET که اضافه کردن دارایی‌های فرم سرنخ را در سطح کمپین یا مشتری توصیه می‌کند
  • IMPROVE_DEMAND_GEN_AD_STRENGTH که بهبود قدرت تبلیغات در کمپین های نسل تقاضا را توصیه می کند

خريد كردن

• CampaignError.CANNOT_LINK_TO_COMPARISON_SHOPPING_SERVICE_ACCOUNT و CampaignError.CANNOT_TARGET_NETWORK_FOR_COMPARISON_SHOPPING_SERVICE_LINKED_ACCOUNTS اضافه شد.CANNOT_TARGET_NETWORK_FOR_COMPARISON_SHOPPING_SERVICE_LINKED_ACCOUNTS به منظور ارائه خطاهای دقیق‌تر برای کمپین‌های حساب خرید مرکز خرید مرتبط با یک Comparison .
• مقادیر زیر را به AssetGroupListingGroupFilterError اضافه کرد:
  • DIMENSION_TYPE_NOT_ALLOWED
  • DUPLICATE_WEBPAGE_FILTER_UNDER_ASSET_GROUP
  • FILTER_EXCLUSION_NOT_ALLOWED
  • LISTING_SOURCE_NOT_ALLOWED
  • MULTIPLE_LISTING_SOURCES
  • MULTIPLE_WEBPAGE_CONDITION_TYPES_NOT_ALLOWED
  • MULTIPLE_WEBPAGE_TYPES_PER_ASSET_GROUP
  • PAGE_FEED_FILTER_HAS_PARENT

اهداف چرخه زندگی

• update به CustomerLifecycleGoalOperation و CampaignLifecycleGoalOperation اضافه شد تا این نوع عملیات با سایر انواع عملیات در API سازگار باشد.

نسخه 15 (18-10-2023)

ویژگی ها و به روز رسانی های جدید زیر در نسخه 15 معرفی شدند.

مدیریت حساب

• اگر حساب شما به دلیل فعالیت غیرمجاز حساب به حالت تعلیق درآمده است، customer.status و customer_client.status اکنون به عنوان SUSPENDED برگردانده می شوند. قبلا، آنها به عنوان ENABLED بازگردانده شده بودند.
• پشتیبانی اضافه شده برای افزودن و حذف پیوند بین حساب Google Ads و حساب Merchant Center:
  • ProductLink.merchant_center و MerchantCenterIdentifier اضافه شد.
  • LinkedProductType.MERCHANT_CENTER اضافه شد.
• ProductLinkInvitationService و ProductLinkInvitation برای پشتیبانی از به روز رسانی دعوت نامه پیوند ارسال شده از محصولات دیگر، برای حساب های Hotel Center و Merchant Center در دسترس است.
• MerchantCenterLinkService حذف شد.
  • برای پیوند دادن حساب‌های Google Ads با حساب‌های Merchant Center، از ProductLinkInvitationService و ProductLinkService استفاده کنید.
• AccountLink.hotel_center حذف شد و پشتیبانی از به‌روزرسانی دعوت‌نامه‌های پیوند از حساب‌های مرکز هتل با استفاده از AccountLinkService .
  • برای به روز رسانی یک دعوت نامه پیوند از حساب مرکز هتل، از ProductLinkInvitationService استفاده کنید.

دارایی های

• ImageAdInfo.media_file با ImageAdInfo.image_asset جایگزین کرد تا از افزودن و حذف تصاویر با استفاده از دارایی ها پشتیبانی کند. در نتیجه، MediaFileService نیز حذف کردیم که دیگر مورد نیاز نیست.
• اضافه شد ListingGroupFilterDimension.webpage برای پشتیبانی از ایجاد فیلتر گروه لیست بر اساس برچسب های سفارشی و زیر رشته های URL.
  • همچنین AssetGroupListingGroupFilter.vertical با AssetGroupListingGroupFilter.listing_source و ListingGroupFilterListingSource جایگزین شد.
• برای نشان دادن منبع دارایی گروه دارایی asset_group_asset.source اضافه شد.
• ad_group_ad_asset_view.source اضافه شد تا منبع دارایی آگهی گروه آگهی را نشان دهد.

مخاطبان

• برای Customer Match، CustomerMatchUserListMetadata.consent را اضافه کرد تا از ارائه رضایت پشتیبانی کند. از 6 مارس 2024، اگر رضایت کاربران منطقه اقتصادی اروپا وجود نداشته باشد، ارزش رضایت به‌عنوان عدم رضایت تعیین می‌شود. داده‌های کاربران بدون رضایت EEA پردازش نمی‌شوند و نمی‌توانند برای شخصی‌سازی آگهی با استفاده از «تطابق با مشتری» استفاده شوند. راهنمای مطابقت مشتری ما را برای جزئیات بیشتر بررسی کنید.
• برای فروش فروشگاه، UserData.consent را اضافه کرد تا از ارائه رضایت پشتیبانی کند. برای جزئیات بیشتر ، راهنمای فروش فروشگاه ما را بررسی کنید. اگر از «تطابق مشتری» با فروش فروشگاه استفاده می‌کنید، سؤالات متداول را برای اطلاعات بیشتر مرور کنید.
• UserList.lookalike_user_list اضافه شد تا از ایجاد یک بخش Lookalike پشتیبانی کند، مخاطبی که براساس مخاطبان اولیه موجود ایجاد شده است. بخش‌های مشابه را می‌توان فقط در کمپین نسل تقاضا استفاده کرد.

کمپین ها

• به روز رسانی کمپین های Performance Max:

  • AssetGroupSignal اکنون از دو نوع سیگنال پشتیبانی می‌کند که می‌توانند برای هدف‌یابی پیشرفته به یک گروه دارایی متصل شوند:
    • AssetGroupSignal.audience
      • Audience.scope و Audience.asset_group برای محدود کردن استفاده مخاطبان به یک گروه دارایی خاص اضافه شد. Audience.asset_group باید تنظیم شود اگر و فقط اگر Audience.scope ASSET_GROUP باشد.
    • AssetGroupSignal.search_theme
      • برای پشتیبانی از این نوع معیار جدید، CriterionType.SEARCH_THEME اضافه شد. این نوع معیار جدید را فقط می‌توان در کمپین‌های Performance Max برای ایجاد AssetGroupSignal با پر کردن AssetGroupSignal.search_theme با معیار SearchThemeInfo استفاده کرد.
  • AssetGroupSignalOperation.exempt_policy_violation_keys برای پشتیبانی از درخواست معافیت هنگام افزودن سیگنال گروه دارایی اضافه شد.
  • یک asset_group_top_combination_view جدید برای گزارش دارایی‌های با عملکرد برتر در سطح گروه دارایی اضافه کرد.
  • هم اکنون asset_group را می توان با فیلدهای متریک برای پشتیبانی از بازیابی عملکرد کمپین حداکثر عملکرد جستجو کرد.
  • در PerformanceMaxUpgradeStatus ، نام UPGRADE_ELIGIBLE به UPGRADE_ELIGIBLE تغییر یافت.

• برای کمپین‌های Demand Gen و Discovery Target CPA، شبیه‌سازی‌های پیشنهادی CPA هدف در سطح کمپین ( campaign_simulation.target_cpa_point_list.points ) اکنون TargetCpaSimulationPoint.interactions را به جای TargetCpaSimulationPoint.clicks برمی‌گرداند.

• BrandSuggestionService اضافه شد که می تواند مارک هایی را بر اساس پیشوند مارک ارائه شده و لیست مستثنی شده مارک ها پیشنهاد کند. این مارک‌ها را می‌توان برای ایجاد یک معیار BRAND استفاده کرد، به مجموعه مشترک BRANDS اضافه کرد و سپس با ایجاد یک CampaignCriterion با مجموعه brand_list به مجموعه مشترک، به کمپین پیوست. معیارهای کمپین را می توان به ترتیب در کمپین های جستجو هدف قرار داد و در کمپین های حداکثر عملکرد حذف کرد.

  • زمینه های:
    • SharedCriterion.brand
    • CampaignCriterion.brand_list
  • فهرست ها:
    • SharedSetType.BRANDS
    • CriterionType.BRAND_LIST

• Campaign.asset_automation_settings[] برای نشان دادن وضعیت اتوماسیون هر نوع دارایی اضافه شد.

• مقادیر زیر را به فهرست CampaignPrimaryStatusReason اضافه کرد:

  • NO_ASSET_GROUPS
  • ASSET_GROUPS_PAUSED

تبدیل ها

• برای پشتیبانی از ارائه رضایت، CallConversion.consent و ClickConversion.consent اضافه شد. راهنمای تبدیل تماس ما را بررسی کنید و برای جزئیات بیشتر روی راهنمای تبدیل کلیک کنید .
• فیلدهای زیر مربوط به تبدیل‌های SKAdNetwork را اضافه کرد که هنگام درخواست از customer یا campaign در دسترس است:
  • بخش ها:
    • segments.sk_ad_network_coarse_conversion_value
    • segments.sk_ad_network_source_domain
    • segments.sk_ad_network_source_type
    • segments.sk_ad_network_postback_sequence_index
  • معیارهای:
    • metrics.sk_ad_network_total_conversions
    • metrics.sk_ad_network_installs
• metrics.sk_ad_network_conversions با metrics.sk_ad_network_installs جایگزین شد.
• پشتیبانی برای تشخیص آپلود تبدیل آفلاین اضافه شده است
  • offline_conversion_upload_client_summary را از قسمتی در منبع customer به گزارش سطح بالا منتقل کرد. از این گزارش برای به دست آوردن جزئیات مفید از وضعیت آپلود تبدیل مانند تعداد رویدادهای موفق، میزان موفقیت و درصد خطا استفاده کنید.
    • هشدار : تبدیلی که آپلود می‌شود اما منجر به خطای ConversionUploadError.CLICK_NOT_FOUND می‌شود. خطای CLICK_NOT_FOUND همچنان به عنوان موفقیت‌آمیز محسوب می‌شود، اما به‌عنوان OfflineConversionAlert نیز پرچم‌گذاری می‌شود.
  • job_id به‌عنوان یک پارامتر اختیاری برای انواع درخواست‌های زیر اضافه کرد تا بتوانید به‌طور منطقی چندین درخواست آپلود را در یک کار مفهومی گروه‌بندی کنید:
    • UploadConversionAdjustmentsRequest
    • UploadClickConversionsRequest
  • INVALID_JOB_ID به خطاهای زیر اضافه شد:
    • ConversionAdjustmentUploadError
    • ConversionUploadError
  • در خطاهای زیر INVALID_CONVERSION_ACTION با NO_CONVERSION_ACTION_FOUND و INVALID_CONVERSION_ACTION_TYPE جایگزین شد:
    • ConversionAdjustmentUploadError
    • ConversionUploadError
• سه گزارش برای پشتیبانی از انتساب بین شبکه‌ای Sandbox Privacy Android بدون تغییر مسیر اضافه شد:
  • android_privacy_shared_key_google_campaign که حاوی shared_campaign_key و برخی فیلدهایی است که به رمزگذاری کلید کمک می کنند.
  • android_privacy_shared_key_google_ad_group که حاوی shared_ad_group_key و برخی فیلدهایی است که به رمزگذاری کلید کمک می کنند.
  • android_privacy_shared_key_google_network_type که حاوی shared_network_type_key و برخی فیلدهایی است که به رمزگذاری کلید کمک می کند.
• ConversionActionError.CANNOT_SET_RULE_BASED_ATTRIBUTION_MODELS اضافه شد.CANNOT_SET_RULE_BASED_ATTRIBUTION_MODELS. یک ConversionActionOperation که تلاش می‌کند از یکی از مدل‌های انتساب مبتنی بر قانون منسوخ استفاده کند، اکنون با این خطا شکست می‌خورد. قبلاً، عملیات با یک خطای UNKNOWN شکست می خورد.

هتل و سفر

• پشتیبانی برای فیلدهای زیر در travel_activity_group_view و travel_activity_performance_view اضافه شده است:
  • بخش ها:
    • segments.activity_account_id
    • segments.activity_rating
    • segments.external_activity_id
  • معیارهای:
    • metrics.search_absolute_top_impression_share
    • metrics.search_budget_lost_absolute_top_impression_share
    • metrics.search_budget_lost_impression_share
    • metrics.search_budget_lost_top_impression_share
    • metrics.search_impression_share
    • metrics.search_rank_lost_absolute_top_impression_share
    • metrics.search_rank_lost_impression_share
    • metrics.search_rank_lost_top_impression_share
    • metrics.search_top_impression_share

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

• LocalServicesSettings و فیلدهای آن به گزارش customer برای بازگرداندن مجوز و وضعیت بیمه دقیق تبلیغ‌کننده خدمات محلی اضافه شد.
• گزارش‌های جدید زیر را برای خدمات محلی اضافه کرد:
  • local_services_lead شامل تمام جزئیات مربوط به آگهی‌های خدمات محلی است، مانند lead_charged ، lead_type ، lead_status .
    • فهرست ها:
      • LeadStatus
      • LeadType
  • local_services_lead_conversation حاوی جزئیات پیام و مکالمه تلفنی مانند conversation_channel ، call_duration_millis ، call_recording_url است.
    • URL ضبط تماس تلفنی با حساب مشتری هدف و حساب‌های مدیر آن تأیید می‌شود.
  • local_services_verification_artifact مصنوعات تبلیغ کننده خدمات محلی مانند بررسی پیشینه، مجوزهای کسب و کار و داده های بیمه کسب و کار را برمی گرداند. هرگونه اسناد مرتبط با مجوز و بیمه را می توان از طریق یک URL در دسترس قرار داد.
    • فهرست ها:
      • LocalServicesVerificationArtifactStatus
      • LocalServicesVerificationArtifactType
      • LocalServicesInsuranceRejectionReason
      • LocalServicesLicenseRejectionReason

برنامه ریزی

• پشتیبانی برای بازگشت Forecast.views و PlannedProductForecast.views برای ReachPlanService.ListPlannableProducts برای انواع محصول قابل اجرا اضافه شد.
• پشتیبانی اضافه شده برای بازگشت PlannableTargeting.surface_targeting برای ReachPlanService.ListPlannableProducts ، که سطوح موجود برای یک محصول را توصیف می کند.
• یک فهرست جدید ReachPlanSurface اضافه شد.
• پشتیبانی برای هدف قرار دادن فرکانس هدف با استفاده از AdvancedProductTargeting.target_frequency_settings اضافه شده است که PlannedProductForecast.average_frequency را برمی گرداند.
• AudienceInsightsService.GenerateSuggestedTargetingInsights برای بازگرداندن مخاطبان قابل هدف پیشنهادی اضافه شد.
• مقادیر زیر را به ReachPlanError اضافه کرد:
  • NOT_FORECASTABLE_NOT_ENOUGH_INVENTORY
  • NOT_FORECASTABLE_ACCOUNT_NOT_ENABLED

توصیه ها

• RecommendationSubscriptionService اضافه شد که اشتراک های توصیه را مدیریت می کند:
  • منبع: RecommendationSubscription
  • فیلد: MutateOperation.recommendation_subscription_operation
  • Enum: ChangeClientType.GOOGLE_ADS_RECOMMENDATIONS_SUBSCRIPTION
  • خطاها:
    • RecommendationSubscriptionError
    • RecommendationSubscriptionStatus
• انواع توصیه های زیر را اضافه کرد:
  • FORECASTING_SET_TARGET_CPA که توصیه می‌کند قبل از رویداد فصلی که پیش‌بینی می‌شود ترافیک را افزایش دهد، یک CPA هدف را برای کمپین‌هایی که مشخص‌شده ندارند، تنظیم کنید.
  • SET_TARGET_CPA که توصیه می‌کند برای کمپین‌هایی که CPA مشخصی ندارند، یک CPA هدف تعیین کنید.
  • SET_TARGET_ROAS که توصیه می‌کند یک ROAS هدف را برای کمپین‌هایی که مشخص نشده‌اند تعیین کنید.

گزارش نویسی

• سنجه‌های جدید زیر را اضافه کرد که می‌توان با campaign (در دسترس برای کمپین‌های Display، Video، Discovery، و App) و segments.device پرس‌وجو کرد:
  • metrics.unique_users
  • metrics.average_impression_frequency_per_user

خريد كردن

• ShoppingSetting.sales_country حذف شد که مقادیر آن اکنون به عنوان ShoppingSetting.feed_label برگردانده شده است.
  • می‌توانید با استفاده از فیلد ShoppingSetting.feed_label ، از یک فید Merchant Center خاص برای کمپین استفاده کنید. باید روی مقدار برچسب فید یا کد کشور دو حرفی که قبلاً برای ShoppingSetting.sales_country استفاده شده است تنظیم شود. برای جزئیات بیشتر، به مقاله پشتیبانی برای برچسب‌های خوراک مراجعه کنید.
• وابستگی دسته‌های محصول به کد کشور در گزارش‌گیری حذف شد. مجموعه شناسه های دسته پشتیبانی شده تغییر نکرده است.
  • فیلدهای زیر استفاده شده در shopping_performance_view را جایگزین کرد:
    • segments.product_bidding_category_level1 با segments.product_category_level1
    • segments.product_bidding_category_level2 با segments.product_category_level2
    • segments.product_bidding_category_level3 با segments.product_category_level3
    • segments.product_bidding_category_level4 با segments.product_category_level4
    • segments.product_bidding_category_level5 با segments.product_category_level5
  • product_bidding_category_constant با product_category_constant جایگزین شد، که همه بومی سازی های موجود یک دسته را در یک فیلد تکراری برمی گرداند.
  • ListingDimensionInfo.product_bidding_category با ListingDimensionInfo.product_category جایگزین شد.
  • ListingGroupFilterDimension.product_bidding_category با ListingGroupFilterDimension.product_category جایگزین شد.
• پشتیبانی برای افزودن Campaign.shopping_setting به کمپین های جستجو حذف شد. تلاش برای ایجاد یک کمپین جستجو با Campaign.shopping_setting یا افزودن Campaign.shopping_setting به یک کمپین جستجوی موجود اکنون منجر به OPERATION_NOT_PERMITTED_FOR_CONTEXT می شود.
• پشتیبانی برای افزودن CampaignCriterion.listing_scope به کمپین های جستجو حذف شد. تلاش برای افزودن CampaignCriterion.listing_scope به کمپین جستجوی موجود اکنون به OPERATION_NOT_PERMITTED_FOR_CONTEXT منجر می شود.
• تبدیل‌های زیر را با معیارهای داده سبد خرید اضافه کرد:
  • metrics.orders
  • metrics.average_order_value_micros
  • metrics.average_cart_size
  • metrics.cost_of_goods_sold_micros
  • metrics.gross_profit_micros
  • metrics.gross_profit_margin
  • metrics.revenue_micros
  • metrics.units_sold
  • metrics.cross_sell_cost_of_goods_sold_micros
  • metrics.cross_sell_gross_profit_micros
  • metrics.cross_sell_revenue_micros
  • metrics.cross_sell_units_sold
  • metrics.lead_cost_of_goods_sold_micros
  • metrics.lead_gross_profit_micros
  • metrics.lead_revenue_micros
  • metrics.lead_units_sold
  • همه این معیارها با گزارش های زیر قابل انتخاب هستند:
    • ad_group
    • ad_group_ad
    • asset_group_product_group_view
    • campaign
    • customer
    • keyword_view
    • product_group_view
    • shopping_performance_view

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

• برای پیکربندی اهداف جذب مشتری در سطح مشتری، CustomerLifecycleGoalService.ConfigureCustomerLifecycleGoals اضافه شد.
  • گزارش: customer_lifecycle_goal
• CampaignLifecycleGoalService.ConfigureCampaignLifecycleGoals برای پیکربندی اهداف جذب مشتری در سطح کمپین اضافه شد.
  • گزارش: campaign_lifecycle_goal
• CampaignConversionGoalError.CANNOT_USE_STORE_SALE_GOAL_FOR_PERFORMANCE_MAX_CAMPAIGN اضافه شد.CANNOT_USE_STORE_SALE_GOAL_FOR_PERFORMANCE_MAX_CAMPAIGN.
• مقادیر زیر را به ConversionGoalCampaignConfigError اضافه کرد:
  • EMPTY_CONVERSION_GOALS
  • STORE_SALE_STORE_VISIT_CANNOT_BE_BOTH_INCLUDED
  • PERFORMANCE_MAX_CAMPAIGN_CANNOT_USE_CUSTOM_GOAL_WITH_STORE_SALES

فیلم های

• پشتیبانی اضافه شده برای هدف قرار دادن Google TV در سطح کمپین:
  • NetworkSettings.target_google_tv_network اضافه شد
  • AdNetworkType.GOOGLE_TV اضافه شد.
• پشتیبانی اضافه شده برای هدف قرار دادن YouTube در سطح کمپین:
  • NetworkSettings.target_youtube اضافه شد
  • در AdNetworkType ، YOUTUBE_WATCH و YOUTUBE_SEARCH در YOUTUBE ادغام شدند.
  • CampaignError.CANNOT_TARGET_DISPLAY_NETWORK_WITHOUT_YOUTUBE اضافه شد.CANNOT_TARGET_DISPLAY_NETWORK_WITHOUT_YOUTUBE.

نسخه 14.1.0 (09-08-2023)

ویژگی ها و به روز رسانی های جدید زیر در نسخه 14.1 معرفی شدند.

مدیریت حساب

• Customer.customer_agreement_setting که نشان می دهد آیا مشتری شرایط خدمات فرم اصلی را پذیرفته است یا خیر

دارایی های

• فیلدهای جدید در AssetGroup برای نشان دادن اینکه آیا گروه دارایی در حال ارائه است یا دلایل عدم ارائه آن:
  • primary_status
  • primary_status_reasons
• فیلدهای جدید در AssetGroupAsset برای نشان دادن اینکه آیا دارایی گروه دارایی در حال استفاده است یا دلایل عدم استفاده از آن:
  • primary_status
  • primary_status_details
  • primary_status_reasons
• مقادیر جدید در فهرست CallToActionType :
  • BUY_NOW
  • DONATE_NOW
  • ORDER_NOW
  • PLAY_NOW
  • SEE_MORE
  • START_NOW
  • VISIT_SITE
  • WATCH_NOW
• مقادیر جدید در فهرست AssetLinkError :
  • CUSTOMER_NOT_VERIFIED
  • UNSUPPORTED_CALL_TO_ACTION
  • PAGE_FEED_INVALID_LABEL_TEXT

صورتحساب

• فیلدهای جدید در Invoice و AccountSummary :
  • export_charge_subtotal_amount_micros
  • export_charge_tax_amount_micros
  • export_charge_total_amount_micros

کمپین ها

• مقادیر جدید در فهرست CampaignPrimaryStatusReason :

  • HAS_ASSET_GROUPS_DISAPPROVED
  • HAS_ASSET_GROUPS_LIMITED_BY_POLICY
  • MOST_ASSET_GROUPS_UNDER_REVIEW

• (فقط حساب‌های مجاز) DiscoveryCampaignSettings با upgraded_targeting :

  • وقتی upgraded_targeting روی true تنظیم شده است، می‌توانید یک مکان و یک زبان را به عنوان معیار گروه آگهی اضافه کنید

شاخص

• مقدار enum جدید: CriterionError.INVALID_DETAILED_DEMOGRAPHIC

• (فقط حساب های مجاز) پشتیبانی از افزودن LanguageInfo و LocationInfo به عنوان AdGroupCriterion :

  • این فقط برای یک کمپین Discovery با هدف ارتقا یافته فعال است

آزمایش

• مقادیر جدید در Enum ExperimentError :
  • DUPLICATE_EXPERIMENT_CAMPAIGN_NAME
  • CANNOT_REMOVE_IN_CREATION_EXPERIMENT
  • CANNOT_ADD_CAMPAIGN_WITH_DEPRECATED_AD_TYPES

توصیه ها

• انواع جدید توصیه ها:
  • PerformanceMaxOptInRecommendation که توصیه می کند اولین کمپین Performance Max را در حساب کاربری ایجاد کنید
  • ImprovePerformanceMaxAdStrengthRecommendation که بهبود قدرت گروه دارایی در کمپین Performance Max را توصیه می کند.
  • MigrateDynamicSearchAdsCampaignToPerformanceMaxRecommendation که انتقال یک کمپین تبلیغات جستجوی پویا به حداکثر عملکرد را توصیه می کند.

گزارش نویسی

• معیارها و بخش‌های جدید درباره مشتریان جدید در مقابل مشتریان بازگشتی:
  • metrics.new_customer_lifetime_value
  • metrics.all_new_customer_lifetime_value
  • segments.new_versus_returning_customers
• بازدیدهای جدید customer_search_term_insight و campaign_search_term_insight :
  • metrics.search_volume محدوده حجم را برای دسته بندی عبارت جستجوی بینش نشان می دهد

خريد كردن

• فیلدهای جدید برای فهرست کردن گروه ها:
  • ListingGroupInfo.path
  • AssetGroupListingGroupFilter.path
• فیلد جدید: ShoppingSetting.advertising_partner_ids
• مقادیر جدید در فهرست CampaignError :
  • NOT_LINKED_ADVERTISING_PARTNER
  • INVALID_NUMBER_OF_ADVERTISING_PARTNER_IDS

فیلم های

• (فقط حساب‌های مجاز) AdType.DISCOVERY_VIDEO_RESPONSIVE_AD و DiscoveryVideoResponsiveAdInfo مربوط به آن

نسخه 14 (07-06-2023)

ویژگی ها و به روز رسانی های جدید زیر در نسخه 14 معرفی شدند.

کمپین ها

• CampaignBudgetError.BUDGET_AMOUNT_MUST_BE_UNSET_FOR_CUSTOM_BUDGET_PERIOD اضافه شد.BUDGET_AMOUNT_MUST_BE_UNSET_FOR_CUSTOM_BUDGET_PERIOD

تبدیل ها

• پشتیبانی برای شناسایی تبدیل‌های Google Analytics و تعیین اینکه آیا یک تبدیل از ویژگی Universal Analytics یا GA4 وارد شده است یا خیر:

  • مقادیر زیر را به ConversionActionType اضافه کرد:
    • UNIVERSAL_ANALYTICS_GOAL
    • UNIVERSAL_ANALYTICS_TRANSACTION
    • GOOGLE_ANALYTICS_4_CUSTOM
    • GOOGLE_ANALYTICS_4_PURCHASE
  • ConversionAction.google_analytics_4_settings اضافه شد

• Customer.offline_conversion_client_summaries اضافه شد که وضعیت و اطلاعات تشخیصی آپلودها و تنظیمات تبدیل آفلاین مشتری را خلاصه می کند.

  • Enums
    • OfflineEventUploadClient :
      • GOOGLE_ADS_API
      • GOOGLE_ADS_WEB_CLIENT
      • ADS_DATA_CONNECTOR
    • OfflineConversionDiagnosticStatus :
      • EXCELLENT
      • GOOD
      • NEEDS_ATTENTION
      • NO_RECENT_UPLOAD

• job_id به پاسخ‌های ارسال شده توسط ConversionAdjustmentUploadService.UploadConversionAdjustments و ConversionUploadService.UploadClickConversions برای مرتبط کردن پاسخ به OfflineConversionUploadSummary.job_id اضافه شد.

شاخص

• پشتیبانی اضافه شده برای بازیابی، ایجاد و به روز رسانی کلمات کلیدی منفی در سطح حساب :

  • زمینه های:
    • CustomerNegativeCriterion.negative_keyword_list
  • فهرست ها:
    • CriterionType.NEGATIVE_KEYWORD_LIST
    • SharedSetType.ACCOUNT_LEVEL_NEGATIVE_KEYWORDS
    • ResourceLimitType
      • SHARED_SETS_PER_ACCOUNT_FOR_ACCOUNT_LEVEL_NEGATIVE_KEYWORDS
      • ACCOUNT_LEVEL_NEGATIVE_KEYWORDS_PER_SHARED_SET
  • خطاها:
    • CriterionError
      • NEGATIVE_KEYWORD_SHARED_SET_DOES_NOT_EXIST
      • CANNOT_ADD_REMOVED_NEGATIVE_KEYWORD_SHARED_SET
      • CANNOT_HAVE_MULTIPLE_NEGATIVE_KEYWORD_LIST_PER_ACCOUNT
      • CUSTOMER_CANNOT_ADD_CRITERION_OF_THIS_TYPE

• CriterionError.CANNOT_TARGET_SIMILAR_USER_LIST اضافه شد.CANNOT_TARGET_SIMILAR_USER_LIST

تبلیغات هتل

• تغییر نام SuggestTravelAssetsRequest.place_id به SuggestTravelAssetsRequest.place_ids

برنامه ریزی

• روش های زیر را از KeywordPlanService حذف کرد:
  • GenerateForecastCurve
  • GenerateForecastMetrics
  • GenerateForecastTimeSeries
  • GenerateHistoricalMetrics
• KeywordPlanIdeaService.GenerateKeywordForecastMetrics برای پشتیبانی از تولید معیارهای پیش‌بینی کمپین کلمات کلیدی بدون نیاز به ایجاد طرح کلیدواژه در ابتدا اضافه شد.
• پشتیبانی برای بازیابی گزارش campaign_criterion_simulation حذف شد
• پشتیبانی از YOUTUBE_DYNAMIC_LINEUP به عنوان یک بعد در AudienceInsightsService.ListAudienceInsightsAttributes اضافه شد.
• DynamicLineupAttributeMetadata.sample_channels اضافه شد که در پاسخ‌های GenerateAudienceCompositionInsights برای ارائه کانال‌های نمونه در لاین‌آپ‌ها استفاده می‌شود.

توصیه ها

• DynamicImageExtensionOptInRecommendation اضافه شد که توصیه می کند پسوندهای تصویر پویا را در حساب فعال کنید
• LowerTargetRoasRecommendation اضافه شد که کاهش ROAS هدف را توصیه می کند
• RaiseTargetCpaRecommendation اضافه شد که افزایش CPA هدف را توصیه می کند
• ResponsiveSearchAdAssetRecommendation.current_ad اضافه شد

گزارش نویسی

• مقادیر زیر را به ServedAssetFieldType اضافه کرد که از ad_group_ad_asset_view.pinned_field در دسترس هستند:
  • SITELINK
  • CALL
  • MOBILE_APP
  • CALLOUT
  • STRUCTURED_SNIPPET
  • PRICE
  • PROMOTION
  • AD_IMAGE
  • LEAD_FORM
  • BUSINESS_LOGO

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

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