वर्शन 2 से वर्शन 3 पर माइग्रेट करें

पिछला अपडेट: 31-10-2023

अपना ऐप्लिकेशन माइग्रेट करें

v2 से v3 पर माइग्रेट करने के लिए, अपने एंडपॉइंट यूआरएल को v3 को कॉल करने की ज़रूरत होती है और बदलावों को नुकसान पहुंचाने के लिए, आपके ऐप्लिकेशन को खाते में अपडेट करना.

अपने एपीआई कॉल को v2 से v3 में अपडेट करना

अगर आपको v2 के बजाय v3 का इस्तेमाल करना है, तो आपको इसके नए वर्शन के लिए अपने अनुरोधों में बदलाव करना होगा एंडपॉइंट के बारे में भी बताएंगे.

उदाहरण के लिए, v2 की मदद से advertisers.get तरीके को कॉल करने के लिए, आपको निम्न URL का उपयोग करें:

GET https://displayvideo.googleapis.com/v2/advertisers/advertiserId

वर्शन 3 के लिए यूआरएल को इनमें अपडेट करें:

GET https://displayvideo.googleapis.com/v3/advertisers/advertiserId

अगर एपीआई को अनुरोध करने के लिए, क्लाइंट लाइब्रेरी का इस्तेमाल किया जा रहा है, तो और अपने कॉन्फ़िगरेशन को v3 का इस्तेमाल करने के लिए अपडेट करें.

ज़रूरी बदलाव करें

हम वर्शन 3 में नुकसान पहुंचाने वाले कई बदलाव पेश कर रहे हैं. इनकी समीक्षा करें साथ ही, आपको इसमें ज़रूरी बदलाव करने होंगे, डिसप्ले और Video 360 API.

YouTube के संसाधनों और उनसे जुड़ी टारगेटिंग को पाने वाले कॉल को अपडेट करें

• YoutubeAdGroup और YoutubeAdGroupAd संसाधनों को इससे बदल दिया गया है AdGroup और AdGroupAd संसाधन. इन नए संसाधनों से जानकारी करीब-करीब वैसी ही है जैसी v2 संसाधनों में उपलब्ध है. हालांकि, इसमें अपडेट किए गए फ़ील्ड का इस्तेमाल किया जा सकता है नाम या ईनम के टाइप का इस्तेमाल करते हैं. अपने इंटिग्रेशन में, AdGroup और इसके साथ YoutubeAdGroup या YoutubeAdGroupAd संसाधन AdGroupAd संसाधन और कॉल को इन v2 सेवाओं पर अपडेट करें, ताकि संबंधित v3 सेवा:
  • advertisers.youtubeAdGroupAds से advertisers.adGroupAds
  • advertisers.youtubeAdGroups से advertisers.adGroups
  • advertisers.youtubeAdGroups.targetingTypes.assignedTargetingOptions से advertisers.adGroups.targetingTypes.assignedTargetingOptions
• YoutubeAndPartnersBiddingStrategy ऑब्जेक्ट के रेफ़रंस नए youtubeAndPartnersBid फ़ील्ड में ले जाया गया सामान्य BiddingStrategy ऑब्जेक्ट में. कॉन्टेंट बनाने biddingStrategy फ़ील्ड को YoutubeAndPartnersSettingsऑब्जेक्ट. अपना इंटिग्रेशन अपडेट करके, YouTube लाइन आइटम या विज्ञापन समूहों के लिए बोली कार्यनीति BiddingStrategy ऑब्जेक्ट के bidStrategy फ़ील्ड में LineItem या AdGroup संसाधन.
• thirdPartyMeasurementSettings फ़ील्ड का नाम बदलकर यह कर दिया गया है thirdPartyMeasurementConfigs YoutubeAndPartnersSettings ऑब्जेक्ट और YoutubeAndPartnersThirdPartyMeasurementSettings ऑब्जेक्ट का नाम बदलकर यह कर दिया गया है ThirdPartyMeasurementConfigs. अपना इंटिग्रेशन अपडेट करके, नए फ़ील्ड का इस्तेमाल करके, तीसरे पक्ष के मेज़रमेंट कॉन्फ़िगरेशन की जानकारी हासिल करना और ऑब्जेक्ट की ज़रूरत होती है.

विज्ञापन देने वाले लोग या कंपनियां बनाते समय, ज़रूरी बिलिंग कॉन्फ़िगरेशन शामिल करें

इस फ़ील्ड में, अब billingConfig एक ज़रूरी फ़ील्ड है Advertiser संसाधन. अपना advertisers.create अपडेट करें यह पुष्टि करने के अनुरोध करता है कि यह फ़ील्ड सेट है या नहीं. डिफ़ॉल्ट बिलिंग जानकारी यह हो सकती है: नए Partner के ज़रिए, पैरंट पार्टनर की जानकारी वापस पाई जा सकती है संसाधन billingConfig फ़ील्ड.

ऑप्टिमाइज़ की गई टारगेटिंग को कंट्रोल करने के लिए, नए फ़ील्ड का इस्तेमाल करें

एक नए बूलियन enableOptimizedTargeting फ़ील्ड ने TargetingExpansionConfig में targetingExpansionLevel फ़ील्ड ऑब्जेक्ट है.

नया केपीआई फ़ील्ड इस्तेमाल करने के लिए, इंसर्शन ऑर्डर के इंटिग्रेशन को अपडेट करना

एक नए kpi फ़ील्ड ने performanceGoal फ़ील्ड को बदल दिया है InsertionOrder संसाधन. इस नए फ़ील्ड में Kpi का इस्तेमाल किया गया है ऑब्जेक्ट, PerformanceGoal ऑब्जेक्ट की जगह पर है और नए फ़ील्ड और ईनम का इस्तेमाल करता है.

उन सेवाओं और फ़ील्ड के रेफ़रंस हटाएं जो अब काम नहीं करतीं

पिछली सुविधा के साथ अलाइन करने के लिए v3 में कई इकाइयां हटाई गईं बंद करना:

• advertisers.manualTriggers सेवा को मैन्युअल ट्रिगर से हटा दिया गया है बंद कर दिए गए हैं.
• billableOutcome फ़ील्ड को नतीजे के आधार पर की गई खरीदारी के तौर पर InsertionOrder संसाधन बंद कर दिया गया है.

दूसरे बदलाव

ऊपर बताए गए नुकसान पहुंचा सकने वाले बदलावों के अलावा, v3 नए सुविधाएँ.

शुरुआती लॉन्च के बाद v3 में जोड़ी गई सुविधाओं को हमारी रिलीज़ में देखा जा सकता है नोट.

आस-पास की जगह की सूची मैनेज करना

वर्शन 3 में, आस-पास की जगहों की सूचियों को पूरी तरह से मैनेज किया जा सकता है. इससे आपको ये काम करने में मदद मिलेगी advertisers.locationLists.assignedLocations सेवा का इस्तेमाल इन कामों के लिए करें TARGETING_LOCATION_TYPE_PROXIMITY को असाइन की गई जगहें बनाएं और मिटाएं LocationList संसाधन. स्थानों की पहचान इसके आईडी का उपयोग करके की जाती है TARGETING_TYPE_POI TargetingOption संसाधन. ये काम किए जा सकते हैं targetingTypes.targetingOptions.search का इस्तेमाल करके वापस लाया गया.

नियम-आधारित कस्टम बिडिंग एल्गोरिदम बनाने की सुविधा

वर्शन 3 में, नियम-आधारित कस्टम बिडिंग एल्गोरिदम बनाने और उन्हें हासिल करने के लिए, customBiddingAlgorithms, media, customBiddingAlgorithms.rules सेवाएं.

यह सुविधा बीटा वर्शन में है और इसे सिर्फ़ उन पार्टनर के लिए उपलब्ध है जिन्हें अनुमति मिली है. अगर आपके पार्टनर को अनुमति वाली सूची में शामिल नहीं किया गया है, तो आपके अनुरोध पर गड़बड़ी दिखेगी.