पिछला अपडेट: 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
सेवाओं का इस्तेमाल करके, नियम पर आधारित कस्टम बिडिंग वाले एल्गोरिदम बनाए जा सकते हैं और उन्हें वापस लाया जा सकता है.
फ़िलहाल, यह सुविधा बीटा वर्शन में उपलब्ध है. यह सिर्फ़ उन पार्टनर के लिए उपलब्ध है जिन्हें अनुमति मिली है. अगर आपका पार्टनर, अनुमति वाली सूची में शामिल नहीं है, तो आपके अनुरोध पर गड़बड़ी का मैसेज दिखेगा.