रिलीज़ नोट्स

v18 (16-10-2024)

वर्शन 18 में ये नई सुविधाएं और अपडेट जोड़े गए हैं.

खाते का मैनेजमेंट

• (सिर्फ़ अनुमति वाली सूची में शामिल खातों के लिए) DataLinkService.CreateDataLink जोड़ा गया है. इससे, क्रिएटर के YouTube चैनल पर होस्ट किए गए वीडियो को Google Ads खाते से लिंक किया जा सकता है. वीडियो लिंक करने की सुविधा की मदद से, Google Ads खाता क्रिएटर के वीडियो का इस्तेमाल करके पार्टनरशिप विज्ञापन चला सकता है.

विज्ञापन ग्रुप

• AdGroup.exclude_demographic_expansion जोड़ा गया है. इसकी मदद से, optimized_targeting_enabled के true होने पर, डेमोग्राफ़िक्स को बड़ा किए जाने से बाहर रखा जा सकता है. यह सुविधा पहले सिर्फ़ मांग बढ़ाने में मदद करने वाले कैंपेन के लिए उपलब्ध थी.

विज्ञापन

• AdGroupAd.ad_group_ad_asset_automation_settings जोड़ा गया, जिससे विज्ञापनों को अपने-आप ऐसेट जनरेट करने की सुविधा के लिए ऑप्ट इन या ऑप्ट आउट किया जा सकता है.
• AssetAutomationType में ये वैल्यू जोड़ी गई हैं:
  • GENERATE_VERTICAL_YOUTUBE_VIDEOS
  • GENERATE_SHORTER_YOUTUBE_VIDEOS
• AdNetworkType.GOOGLE_OWNED_CHANNELS जोड़ा गया. इसका इस्तेमाल, Google के मालिकाना हक वाले चैनलों पर दिखाए जाने वाले विज्ञापनों के लिए किया जाता है. जैसे, YouTube, Gmail, और डिस्कवर फ़ीड.

ऐसेट

• 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 जोड़ा गया है. इससे डिसप्ले, मांग बढ़ाने में मदद करने वाले, और वीडियो कैंपेन के लिए, टारगेट किए गए कॉन्टेंट की परफ़ॉर्मेंस मेट्रिक मिलती हैं. जैसे, कीवर्ड, प्लेसमेंट, और विषय.

होटल और ट्रैवल

• Search Network में दिखने वाले विज्ञापनों में यात्रा के फ़ीड के लिए सहायता
  • Search Network में दिखने वाले विज्ञापनों में यात्रा के फ़ीड की मेट्रिक को सेगमेंट करने की अनुमति देने के लिए, ClickType.TRAVEL_ASSETS जोड़ा गया.
  • AssetSetType.TRAVEL_FEED जोड़ा गया, जिसका इस्तेमाल Search Network में दिखने वाले विज्ञापनों में यात्रा के फ़ीड का इस्तेमाल करने के लिए ऑप्ट-इन और ऑप्ट-आउट करने के लिए किया जा सकता है.
• (सिर्फ़ अनुमति वाले खातों के लिए) यात्रा की योजना को नए कन्वर्ज़न वैल्यू के नियम के तौर पर जोड़ा गया है. इसमें ये नए फ़ील्ड और वैल्यू शामिल हैं:
  • ValueRuleItineraryCondition के साथ ConversionValueRule.itinerary_condition, जो पहले से बुकिंग करने की विंडो, यात्रा की योजना की अवधि, और हफ़्ते के उन दिनों की जानकारी देने की सुविधा देता है जब यात्रा शुरू होनी है
  • ConversionValueRulePrimaryDimensionEnum.ITINERARY
  • ValueRuleSetDimension.ITINERARY
• होटल और सर्च कैंपेन के लिए, खास डेस्टिनेशन (शहर, देश, और इलाके) के आधार पर परफ़ॉर्मेंस डेटा को सेगमेंट करने की सुविधा देने के लिए, campaign और ad_group रिपोर्ट के लिए ये सेगमेंट जोड़े गए हैं:
  • segments.travel_destination_city
  • segments.travel_destination_country
  • segments.travel_destination_region

Local Services

• अगर Local Services की लीड से जुड़ी बातचीत की कॉल रिकॉर्डिंग मौजूद नहीं है, तो PhoneCallDetails.call_recording_url खाली रहेगा. इसके बजाय, अमान्य यूआरएल दिखेगा.
• CategoryBid.target_cpa_bid_micro जोड़ा गया, जिसकी मदद से 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 गड़बड़ियां जोड़ी गई हैं. इनसे पता चलता है कि ब्रैंड के दिशा-निर्देशों की सुविधा चालू होने पर, परफ़ॉर्मेंस मैक्स कैंपेन में कैंपेन से जुड़े ज़रूरी CampaignAsset संसाधन नहीं हैं.
  • ब्रैंड दिशा-निर्देश चालू होने पर, field_type को BUSINESS_NAME पर सेट की गई कम से कम एक ऐसेट और LOGO को CampaignAsset संसाधनों के तौर पर कैंपेन से लिंक किया जाना चाहिए. प्रॉडक्ट फ़ीड की मदद से ऑनलाइन सेल के लिए, परफ़ॉर्मेंस मैक्स कैंपेन को यह शर्त सिर्फ़ तब पूरी करनी होगी, जब कैंपेन के ऐसेट ग्रुप से लिंक की गई ऐसेट मौजूद हों.
  • AssetLinkError में ये वैल्यू जोड़ी गई हैं:
    • BRAND_ASSETS_NOT_LINKED_AT_ASSET_GROUP_LEVEL, यह गड़बड़ी तब दिखती है, जब ब्रैंड ऐसेट को कैंपेन से लिंक करने के लिए, परफ़ॉर्मेंस मैक्स कैंपेन में AssetGroupAsset संसाधनों के बजाय, CampaignAsset संसाधनों का इस्तेमाल किया जाता है. ऐसा तब होता है, जब ब्रैंड दिशा-निर्देश चालू नहीं होते.
    • BRAND_ASSETS_NOT_LINKED_AT_CAMPAIGN_LEVEL गड़बड़ी, जो ब्रैंड के दिशा-निर्देशों के चालू होने पर, परफ़ॉर्मेंस मैक्स कैंपेन में ब्रैंड ऐसेट को CampaignAsset संसाधनों के बजाय, AssetGroupAsset संसाधनों के तौर पर कैंपेन से लिंक करने की कोशिश करने पर दिखती है.
• performance_max_placement_view जोड़ा गया है. इससे उन प्लेसमेंट के इंप्रेशन मिलते हैं जहां परफ़ॉर्मेंस मैक्स कैंपेन के विज्ञापन दिखाए गए थे.
• AssetGroupListingGroupFilterError.TREE_WAS_INVALID_BEFORE_MUTATION को जोड़ा गया

प्लानिंग

• (सिर्फ़ अनुमति वाले खातों के लिए) ContentCreatorInsightsService.GenerateCreatorInsights तरीके से एक नई सेवा जोड़ी गई है. इसकी मदद से, उपयोगकर्ता YouTube के टॉप क्रिएटर्स के बारे में अहम जानकारी देख सकते हैं. इसकी मदद से, ग्राहक ऑडियंस टारगेटिंग और कॉन्टेंट टारगेटिंग के कॉम्बिनेशन के हिसाब से क्रिएटर्स को खोज सकते हैं. इसके अलावा, YouTube चैनल आईडी की सूची के हिसाब से क्रिएटर की अहम जानकारी भी देखी जा सकती है.
• AudienceInsightsService.GenerateSuggestedTargetingInsights में हुए अपडेट:
  • audience, baseline_audience, और data_month को audience_definition में ले जाया गया.
  • जनरेटिव एआई का इस्तेमाल करके, फ़्री फ़ॉर्म टेक्स्ट ब्यौरे से टारगेटिंग के सुझाव जनरेट करने के लिए, audience_description जोड़ा गया.
• AudienceInsightsService.GenerateTargetingSuggestionMetrics जोड़ा गया, जो ऑडियंस टारगेटिंग के दिए गए कॉम्बिनेशन के लिए संभावित रीच मेट्रिक दिखाता है.

सुझाव

• RecommendationService.GenerateRecommendations का इस्तेमाल अब कैंपेन बनाते समय, ऑप्टिमाइज़ किए गए बजट के सुझाव जनरेट करने के लिए किया जा सकता है. इसके लिए, GenerateRecommendationsRequest.recommendation_types[] में सुझाव टाइप के तौर पर CAMPAIGN_BUDGET को शामिल करें. यह सुविधा, परफ़ॉर्मेंस मैक्स और सर्च कैंपेन के लिए काम करती है.

रिपोर्टिंग

• SearchGoogleAdsRequest के summary_row_setting और return_total_results_count फ़ील्ड को search_settings फ़ील्ड से बदल दिया गया है. इसका टाइप SearchSettings है. साथ ही, इन फ़ील्ड को भी बदल दिया गया है:
  • omit_results
  • return_summary_row
  • return_total_results_count
• सामान्य अमान्य क्लिक के बारे में ये नई मेट्रिक जोड़ी गई हैं. जैसे, बॉट या क्रॉलर से जनरेट होने वाले क्लिक, अनियमित पैटर्न वाले क्लिक वगैरह. इनकी जानकारी, campaign रिपोर्ट की मदद से देखी जा सकती है.
  • metrics.general_invalid_clicks
  • metrics.general_invalid_click_rate
• QuotaError में ये वैल्यू जोड़ी गई हैं:
  • EXCESSIVE_SHORT_TERM_QUERY_RESOURCE_CONSUMPTION
  • EXCESSIVE_LONG_TERM_QUERY_RESOURCE_CONSUMPTION

v17.1.0 (07-08-2024)

v17_1 में ये नई सुविधाएं और अपडेट जोड़े गए हैं.

ऐसेट

• AdGroupAdService.RemoveAutomaticallyCreatedAssets() की मदद से, रिस्पॉन्सिव सर्च विज्ञापनों से जुड़ी, अपने-आप जनरेट हुई चुनिंदा ऐसेट हटाई जा सकती हैं.

ऑडियंस

• 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(), शेयर किए जा सकने वाले विज्ञापन की झलक के लिए यूआरएल (जवाब में shareable_preview_url) जनरेट करता है. ये यूआरएल, चालू और रोके गए एसेट ग्रुप के लिए होते हैं.
  • expiration_date_time फ़ील्ड से, जवाब में दिए गए यूआरएल के खत्म होने की तारीख का पता चलता है.
  • अगर कोई गड़बड़ी होती है, तो यह तरीका यूआरएल के बजाय 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 की संभावित पहुंच के ओवरलैप का अनुमान दिखाता है.

रिपोर्टिंग

• segments.date के आधार पर, per_store_view को सेगमेंट में बांटने की सुविधा

वीडियो

• ad_group, campaign जैसी रिपोर्ट का इस्तेमाल करके, वीडियो कैंपेन के लिए इन स्टैंडर्ड बिडिंग की रणनीतियों से जुड़ी जानकारी पाने में मदद:
  • Campaign.fixed_cpm (तय सीपीएम (हर हज़ार इंप्रेशन की लागत))
  • Campaign.target_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 को जोड़ा गया

एक साथ कई जॉब चलाना

• BatchJobError.REQUEST_TOO_LARGE जोड़ा गया, जो तब दिखेगा, जब सबमिट किया गया AddBatchJobOperationsRequest 10484504 बाइट से ज़्यादा होगा.
• BatchJobService का इस्तेमाल करते समय, MutateOperation.asset_group_operation को सेट करने की सुविधा जोड़ी गई. इससे, आपको पूरे परफ़ॉर्मेंस मैक्स कैंपेन बनाने और मैनेज करने के लिए, बैच प्रोसेसिंग का इस्तेमाल करने में मदद मिलती है. खास तौर पर बनाई गई हमारी नई गाइड देखें.

कैंपेन

• Google Ads API के सभी फ़ील्ड, एनम, और गड़बड़ियों में, डिस्कवरी कैंपेन का नाम बदलकर मांग बढ़ाने में मदद करने वाले कैंपेन कर दिया गया है. जैसे, कैंपेन, विज्ञापन, और ऐसेट. उदाहरण के लिए, 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
• gender_view के लिए, metrics.search_impression_share के साथ काम करने की सुविधा जोड़ी गई
• keyword_view के लिए, metrics.phone_calls के साथ काम करने की सुविधा जोड़ी गई

Local Services

• LocalServicesLeadService.AppendLeadConversation() को जोड़ा गया है, इसका इस्तेमाल LocalServicesLead में नया LocalServicesLeadConversation जोड़ने के लिए किया जाता है. यह लीड बनाने के तरीके के आधार पर, एसएमएस जैसे सही चैनलों के ज़रिए उपयोगकर्ताओं को मैसेज भेजता है.
  • AppendLeadConversationRequest.conversations का साइज़ 1,000 तक सीमित है.
  • Conversation.local_services_lead में सिर्फ़ उस LocalServicesLead की जानकारी दी जा सकती है जिसके लिए lead_type को LeadType.MESSAGE पर सेट किया गया हो.
• 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 दिखेगा. उदाहरण के लिए, एक ही क्वेरी में product_link.advertising_partner.customer और product_link.data_partner.data_partner_id को नहीं चुना जा सकता.
• GoogleAdsService.Search को page_size पास करने पर, RequestError.PAGE_SIZE_NOT_SUPPORTED वाली गड़बड़ी दिखेगी.

शॉपिंग

• एक नई रिपोर्ट shopping_product जोड़ी गई है, जो Google Ads के यूज़र इंटरफ़ेस (यूआई) के प्रॉडक्ट पेज से जुड़ी है. यह Google Ads खाते से लिंक किए गए Google Merchant Center खातों के प्रॉडक्ट की मौजूदा स्थिति से जुड़ा डेटा दिखाता है.
  • GoogleAdsService.Search या GoogleAdsService.SearchStream का इस्तेमाल करते समय, segments.date का इस्तेमाल करके shopping_product रिपोर्ट की मेट्रिक को फ़िल्टर किया जा सकता है. तारीख के हिसाब से सेगमेंटेशन करने की अनुमति नहीं है. ऐसा करने पर, आपको 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 जोड़ा गया.
• (सिर्फ़ अनुमति वाले खातों के लिए) Campaign.video_brand_safety_suitability के लिए, बदलाव करने की अनुमति दी गई.

v16.1.0 (24-04-2024)

v16.1 में ये सुविधाएं और बदलाव जोड़े गए थे.

खाते का मैनेजमेंट

• CustomerNegativeCriterion.ip_block इसमें ग्राहक के लेवल पर, नेगेटिव क्राइटेरियम के तौर पर आईपी जोड़ने की सुविधा होती है.
• नई वैल्यू: ProductLinkError.LINK_EXISTS.
• नई वैल्यू: ProductLinkInvitationError.CUSTOMER_NOT_PERMITTED_TO_CREATE_INVITATION.

ऐसेट

• मांग बढ़ाने में मदद करने वाले विज्ञापन से जुड़ी ऐसेट के लिए, ad_group_ad_asset_view और asset_field_type_view से जुड़ी सहायता.
• नई वैल्यू: AssetFieldType.DISCOVERY_CAROUSEL_CARD.

ऑडियंस

• नई एनम वैल्यू: ResourceLimitType.LOOKALIKE_USER_LISTS_PER_CUSTOMER इससे, किसी ग्राहक के लिए मिलती-जुलती उपयोगकर्ता सूचियों की संख्या 1,000 तक सीमित हो जाती है.

कैंपेन

• campaign_simulation रिपोर्ट का इस्तेमाल करके, ऐप्लिकेशन कैंपेन के लिए टारगेट आरओएएस कैंपेन बिड सिम्युलेशन दिखाने की सुविधा.
• नई वैल्यू: CampaignError.DYNAMIC_TEXT_ASSET_CANNOT_OPT_OUT_WITH_FINAL_URL_EXPANSION_OPT_IN.
• नई वैल्यू: 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 के तौर पर दिखाया जाएगा.
• CustomerSkAdNetworkConversionValueSchemaError में नई ईनम वैल्यू:
  • INVALID_EVENT_COUNTER
  • INVALID_EVENT_NAME

नियम और शर्तें

• BrandInfo में नए फ़ील्ड:
  • display_name
  • primary_url
  • rejection_reason
  • status
• नया एनम: BrandRequestRejectionReason.
• नई वैल्यू: CriterionType.LIFE_EVENT.

प्रयोग

• नई वैल्यू: ExperimentError.INVALID_DURATION_FOR_AN_EXPERIMENT.

Local Services

• 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, जो ग्राहक के लेवल पर, ब्रैंड के लिहाज़ से वीडियो के सही होने की जानकारी पाने में मदद करते हैं.
• नई वैल्यू: VideoCampaignError.MUTATE_REQUIRES_RESERVATION.

v16 (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, पुष्टि करने के लिए ग्राहक को किसी यूआरएल पर रीडायरेक्ट करता है.
      • invitation_link_expiration_time, action_url के लिए, समयसीमा खत्म होने की तारीख दिखाता है
  • Enums:
    • IdentityVerificationProgram
    • IdentityVerificationProgramStatus
  • गड़बड़ियां:
    • IdentityVerificationError
• AuthorizationError.ACTION_NOT_PERMITTED_FOR_SUSPENDED_ACCOUNT को जोड़ा गया.

ऐसेट

• asset_group में किए गए बदलाव:
  • समय से जुड़े सेगमेंट के लिए सहायता जोड़ी गई है, जैसे कि segments.year और segments.month.
  • campaign को सेगमेंट करने वाले संसाधन के बजाय, एट्रिब्यूट वाले संसाधन में बदल दिया गया.

कैंपेन

• मांग बढ़ाने में मदद करने वाले कैंपेन में होने वाले बदलाव:
  • मांग बढ़ाने में मदद करने वाले किसी मौजूदा कैंपेन में, Campaign.shopping_setting को सेट करने की सुविधा जोड़ी गई है.
  • मांग बढ़ाने में मदद करने वाले कैंपेन के वैकल्पिक प्रॉडक्ट फ़ीड को बंद करने के लिए, ShoppingSetting.disable_product_feed को जोड़ा गया है.
  • Ad.demand_gen_product_ad और उससे जुड़ा DemandGenProductAdInfo जोड़ा गया है. यह वैल्यू, मांग बढ़ाने में मदद करने वाले उन कैंपेन के लिए उपलब्ध है जिनमें 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 को जोड़ा गया.
• CampaignError.CANNOT_MODIFY_TEXT_ASSET_AUTOMATION_WITH_ENABLED_TRIAL को जोड़ा गया.

होटल और ट्रैवल

• 'क्या-क्या करें' प्लैटफ़ॉर्म पर दिखने वाले विज्ञापन के लिए, ListingDimensionInfo में ये फ़ील्ड जोड़े गए हैं. इससे, उस राज्य और शहर के हिसाब से लिस्टिंग ग्रुप बनाए जा सकेंगे जहां यात्रा से जुड़ी गतिविधि उपलब्ध है:
  • activity_state
  • activity_city
• travel_activity_performance_view में, इन सेगमेंट के लिए सहायता जोड़ी गई है:
  • segments.activity_city
  • segments.activity_country
  • segments.activity_state

Local Services

• विज्ञापन देने वालों को कारोबार के रजिस्ट्रेशन की पुष्टि की प्रोसेस की प्रोग्रेस पर नज़र रखने की सुविधा देने के लिए, LocalServicesVerificationArtifact.business_registration_check_verification_artifact और BusinessRegistrationCheckArtifact को जोड़ा गया है.
• विज्ञापन देने वालों को, जोड़ी गई कर्मचारी की जानकारी वापस पाने की अनुमति देने के लिए, एक नया संसाधन local_services_employee जोड़ा गया है.

प्लानिंग

• AudienceInsightsAttributeMetadata से score को हटाया गया.

सुझाव

• RecommendationService.GenerateRecommendations() को जोड़ा गया है. यह तय की गई सेटिंग के आधार पर सुझाव दिखाता है. जैसे, सुझाव के टाइप और विज्ञापन चैनल के टाइप. यह खास तौर पर कैंपेन बनाते समय मददगार होता है.
• RecommendationMetrics.conversions_value को जोड़ा गया.
• सुझाए गए कीवर्ड के लिए, अब कीवर्ड मैच टाइप सेट नहीं किया गया है. साथ ही, recommended_match_type को UNKNOWN के बजाय UNSPECIFIED पर सेट किया गया है.
• इस तरह के सुझाव जोड़े गए:
  • MAXIMIZE_CONVERSION_VALUE_OPT_IN इसमें कन्वर्ज़न वैल्यू बढ़ाने वाली बिडिंग की रणनीति के लिए ऑप्ट-इन करने का सुझाव दिया जाता है
  • IMPROVE_GOOGLE_TAG_COVERAGE जो ज़्यादा पेजों पर Google टैग डिप्लॉय करने का सुझाव देता है
  • PERFORMANCE_MAX_FINAL_URL_OPT_IN इससे, परफ़ॉर्मेंस मैक्स कैंपेन के लिए फ़ाइनल यूआरएल एक्सपैंशन को चालू करने का सुझाव मिलता है
  • REFRESH_CUSTOMER_MATCH_LIST इसमें, ग्राहक की ऐसी सूची को अपडेट करने का सुझाव दिया जाता है जिसे पिछले 90 दिनों में अपडेट नहीं किया गया है
  • CUSTOM_AUDIENCE_OPT_IN जिसमें कस्टम ऑडियंस बनाने का सुझाव दिया गया हो
  • LEAD_FORM_ASSET यह कैंपेन या ग्राहक के लेवल पर लीड फ़ॉर्म ऐसेट जोड़ने का सुझाव देता है
  • IMPROVE_DEMAND_GEN_AD_STRENGTH जो मांग बढ़ाने में मदद करने वाले कैंपेन में विज्ञापन की क्वालिटी को बेहतर बनाने का सुझाव देता है

शॉपिंग

• Comparison Shopping Service Center खाते से लिंक किए गए शॉपिंग कैंपेन के लिए, गड़बड़ियों की ज़्यादा जानकारी देने के लिए, CampaignError.CANNOT_LINK_TO_COMPARISON_SHOPPING_SERVICE_ACCOUNT और CampaignError.CANNOT_TARGET_NETWORK_FOR_COMPARISON_SHOPPING_SERVICE_LINKED_ACCOUNTS जोड़ा गया.
• 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

लाइफ़साइकल के लक्ष्य

• CustomerLifecycleGoalOperation और CampaignLifecycleGoalOperation में update जोड़ा गया, ताकि इन ऑपरेशन टाइप को एपीआई में मौजूद अन्य ऑपरेशन टाइप के साथ अलाइन किया जा सके.

संग्रहित किए गए रिलीज़ नोट

संग्रहित किए गए रिलीज़ नोट के लिए, बंद किए गए वर्शन देखें.