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

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

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

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

अपने एपीआई कॉल को वर्शन 2 से v3 में अपडेट करें

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

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

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

v3 के लिए, यूआरएल को यहां अपडेट करें:

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

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

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

हम v3 में कई नुकसान पहुंचा सकने वाले बदलाव पेश कर रहे हैं. नीचे दिए गए निर्देशों को देखें और Display & Video 360 API के मौजूदा इस्तेमाल के हिसाब से ज़रूरी बदलाव करें.

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

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

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

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

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

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

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

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

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

मौजूदा सुविधाओं को रोकने के साथ अलाइन करने के लिए, v3 में कई इकाइयों को हटा दिया गया है:

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

दूसरे बदलाव

ऊपर बताए गए नुकसान पहुंचाने वाले बदलावों के अलावा, v3 में नई सुविधाएं भी मौजूद हैं.

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

नज़दीकी जगह की सूची का मैनेजमेंट

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

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

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

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