v2 থেকে v3 তে স্থানান্তর করুন

শেষ আপডেট: 2023-10-31

আপনার আবেদন স্থানান্তর করুন

v2 থেকে v3 তে স্থানান্তরিত করার জন্য v3 কল করতে আপনার এন্ডপয়েন্ট URL গুলি আপডেট করতে হবে এবং পরিবর্তনগুলি ভাঙার জন্য অ্যাকাউন্টে আপনার অ্যাপ্লিকেশন আপডেট করতে হবে৷

v2 থেকে v3 তে আপনার API কলগুলি আপডেট করুন৷

v2-এর পরিবর্তে v3 ব্যবহার করতে, নতুন v3 এন্ডপয়েন্ট ব্যবহার করার জন্য আপনাকে আপনার অনুরোধ আপডেট করতে হবে।

উদাহরণস্বরূপ, v2 দিয়ে advertisers.get পদ্ধতিতে কল করতে, আপনি নিম্নলিখিত URL ব্যবহার করবেন:

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

v3 এর জন্য, নিম্নলিখিতটিতে URL আপডেট করুন:

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

আপনি যদি API-তে অনুরোধ করার জন্য একটি ক্লায়েন্ট লাইব্রেরি ব্যবহার করেন, তাহলে ক্লায়েন্ট লাইব্রেরির সবচেয়ে সাম্প্রতিক সংস্করণটি ব্যবহার করুন এবং v3 ব্যবহার করতে আপনার কনফিগারেশন আপডেট করুন।

প্রয়োজনীয় পরিবর্তন করুন

আমরা v3 তে বেশ কিছু ব্রেকিং পরিবর্তন আনছি। নিম্নলিখিত নির্দেশাবলী পর্যালোচনা করুন এবং Display & Video 360 API-এর আপনার বিদ্যমান ব্যবহারের সাথে প্রাসঙ্গিক প্রয়োজনীয় পরিবর্তনগুলি করুন৷

YouTube সংস্থানগুলি এবং তাদের সম্পর্কিত টার্গেটিং পুনরুদ্ধার করার কলগুলি আপডেট করুন৷

• YoutubeAdGroup এবং YoutubeAdGroupAd সংস্থানগুলি AdGroup এবং AdGroupAd সংস্থান দ্বারা প্রতিস্থাপিত হয়েছে৷ এই নতুন সংস্থানগুলি v2 সংস্থান হিসাবে প্রায় অভিন্ন তথ্য সরবরাহ করে তবে আপডেট করা ক্ষেত্রের নাম বা enum প্রকারগুলি ব্যবহার করতে পারে। আপনার ইন্টিগ্রেশনে, আপনার YoutubeAdGroup বা YoutubeAdGroupAd সংস্থানগুলির ব্যবহারকে AdGroup এবং AdGroupAd সংস্থানগুলির সাথে প্রতিস্থাপন করুন এবং সংশ্লিষ্ট v3 পরিষেবাতে নিম্নলিখিত v2 পরিষেবাগুলিতে কলগুলি আপডেট করুন:
  • advertisers.youtubeAdGroupAds to advertisers.adGroupAds
  • advertisers.youtubeAdGroups থেকে advertisers.adGroups
  • advertisers.youtubeAdGroups.targetingTypes.assignedTargetingOptions to advertisers.adGroups.targetingTypes.assignedTargetingOptions
• YoutubeAndPartnersBiddingStrategy অবজেক্টের রেফারেন্স সাধারণ BiddingStrategy অবজেক্টের মধ্যে একটি নতুন youtubeAndPartnersBid ফিল্ডে সরানো হয়েছে। biddingStrategy ক্ষেত্রটি YoutubeAndPartnersSettings অবজেক্ট থেকে সরানো হয়েছে। LineItem বা AdGroup রিসোর্সে bidStrategy ক্ষেত্রের BiddingStrategy অবজেক্ট থেকে YouTube লাইন আইটেম বা বিজ্ঞাপন গোষ্ঠীর জন্য বিডিং কৌশল পুনরুদ্ধার করতে আপনার ইন্টিগ্রেশন আপডেট করুন।
• YoutubeAndPartnersSettings অবজেক্টে thirdPartyMeasurementSettings ফিল্ডের নাম পরিবর্তন করে thirdPartyMeasurementConfigs কনফিগ করা হয়েছে এবং YoutubeAndPartnersThirdPartyMeasurementSettings অবজেক্টের নাম পরিবর্তন করে ThirdPartyMeasurementConfigs করা হয়েছে। নতুন ক্ষেত্র এবং বস্তু ব্যবহার করে তৃতীয় পক্ষের পরিমাপ কনফিগারেশন তথ্য পুনরুদ্ধার করতে আপনার ইন্টিগ্রেশন আপডেট করুন।

বিজ্ঞাপনদাতা তৈরি করার সময় প্রয়োজনীয় বিলিং কনফিগারেশন অন্তর্ভুক্ত করুন

billingConfig এখন Advertiser সংস্থার একটি প্রয়োজনীয় ক্ষেত্র। এই ক্ষেত্রটি সেট করা আছে কিনা তা যাচাই করতে আপনার advertisers.create অনুরোধ আপডেট করুন। নতুন Partner রিসোর্স billingConfig ফিল্ডের মাধ্যমে মূল অংশীদারের জন্য ডিফল্ট বিলিং তথ্য পুনরুদ্ধার করা যেতে পারে।

অপ্টিমাইজ করা টার্গেটিং নিয়ন্ত্রণ করতে নতুন ক্ষেত্র ব্যবহার করুন

একটি নতুন বুলিয়ান enableOptimizedTargeting ক্ষেত্র TargetingExpansionConfig অবজেক্টে targetingExpansionLevel ক্ষেত্র প্রতিস্থাপন করেছে।

নতুন KPI ফিল্ড ব্যবহার করতে সন্নিবেশ অর্ডার ইন্টিগ্রেশন আপডেট করুন

InsertionOrder রিসোর্সে একটি নতুন kpi ক্ষেত্র performanceGoal ফিল্ড প্রতিস্থাপন করেছে। এই নতুন ক্ষেত্রটি PerformanceGoal অবজেক্টের জায়গায় একটি Kpi অবজেক্ট ব্যবহার করে এবং নতুন ক্ষেত্র এবং enums ব্যবহার করে।

অবহেলিত পরিষেবা এবং ক্ষেত্রগুলির রেফারেন্সগুলি সরান৷

অতীতের বৈশিষ্ট্য অবমূল্যায়নের সাথে সারিবদ্ধ করতে v3 তে বিভিন্ন সত্তা সরানো হয়েছে:

• advertisers.manualTriggers পরিষেবাটি সরানো হয়েছে কারণ ম্যানুয়াল ট্রিগারগুলিকে বাতিল করা হয়েছে ৷
• billableOutcome ক্ষেত্রটি InsertionOrder রিসোর্স থেকে সরানো হয়েছে কারণ ফলাফল ভিত্তিক কেনাকাটা অবমূল্যায়িত হয়েছে ।

অতিরিক্ত পরিবর্তন

উপরে তালিকাভুক্ত ব্রেকিং পরিবর্তনগুলি ছাড়াও, v3 নতুন বৈশিষ্ট্যগুলিও প্রবর্তন করে।

প্রারম্ভিক লঞ্চের পর v3-তে যোগ করা বৈশিষ্ট্যগুলি আমাদের রিলিজ নোটে পাওয়া যাবে।

প্রক্সিমিটি অবস্থান তালিকা ব্যবস্থাপনা

v3 তে আপনি প্রক্সিমিটি অবস্থান তালিকাগুলি সম্পূর্ণরূপে পরিচালনা করতে পারেন, যা আপনাকে TARGETING_LOCATION_TYPE_PROXIMITY LocationList সংস্থানগুলিতে নির্ধারিত অবস্থানগুলি তৈরি এবং মুছতে advertisers.locationLists.assignedLocations পরিষেবা ব্যবহার করার অনুমতি দেয়৷ TARGETING_TYPE_POI TargetingOption রিসোর্সের ID ব্যবহার করে অবস্থানগুলি চিহ্নিত করা হয়৷ এগুলি targetingTypes.targetingOptions.search ব্যবহার করে পুনরুদ্ধার করা যেতে পারে।

নিয়ম-ভিত্তিক কাস্টম বিডিং অ্যালগরিদম তৈরি করার ক্ষমতা

v3-এ, আপনি customBiddingAlgorithms , media , customBiddingAlgorithms.rules পরিষেবাগুলি ব্যবহার করে নিয়ম-ভিত্তিক কাস্টম বিডিং অ্যালগরিদম তৈরি এবং পুনরুদ্ধার করতে পারেন৷

এই বৈশিষ্ট্যটি বিটাতে রয়েছে এবং শুধুমাত্র অনুমোদিত তালিকাভুক্ত অংশীদারদের জন্য উপলব্ধ। যদি আপনার সঙ্গীকে অনুমতি দেওয়া না হয়, তাহলে আপনার অনুরোধে একটি ত্রুটি দেখাবে।