Display & Video 360 API v4 থেকে v5-এ মাইগ্রেট করুন

শেষ আপডেট: ২২-১০-২০২৬

সতর্কতা: v5 ওপেন বিটা ভার্সনে আছে। বিটা ভার্সনে থাকাকালীন v5-এ ব্রেকিং পরিবর্তন করা হতে পারে এবং সেগুলি Display & Video 360 API রিলিজ নোট-এ তালিকাভুক্ত করা হবে। লাইভ বিটা ভার্সন দেখানোর জন্য প্রয়োজন অনুযায়ী এই ডকুমেন্ট আপডেট করা হবে।

আপনার অ্যাপ্লিকেশন মাইগ্রেট করুন

v4 থেকে v5-এ মাইগ্রেট করার জন্য v5 কল করতে আপনার এন্ডপয়েন্ট URL আপডেট করতে হবে, ব্রেকিং পরিবর্তনের জন্য আপনার অ্যাপ্লিকেশন আপডেট করতে হবে এবং আপনার ইন্টিগ্রেশনের জন্য সুবিধাজনক হতে পারে এমন কোনও নতুন ফিচার পর্যালোচনা করতে হবে।

আপনার API কল v4 থেকে v5-এ আপডেট করুন

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

যেমন, v4-এর সাথে advertisers.get পদ্ধতি কল করতে, নিম্নলিখিত URL ব্যবহার করুন:

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

v5-এর জন্য, URL আপডেট করে নিম্নলিখিত URL ব্যবহার করুন:

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

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

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

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

Display & Video 360 API v4 ও v5-এর মধ্যে পার্থক্যের সম্পূর্ণ তালিকা দেখতে, রিলিজ নোট দেখুন।

নতুন আইডি ও ধরন ব্যবহার করতে ইনভেনটরি সোর্স রিট্রিভাল ও টার্গেটিং আপডেট করুন

Display & Video 360 API v5 ইনভেনটরি সোর্স ডিল এবং নিলাম প্যাকেজ কীভাবে উদ্ধার এবং টার্গেট করা হয় তা পরিবর্তন করে।

v4-এ, inventorySources পরিষেবা ব্যবহার করে ফিরিয়ে আনা InventorySource রিসোর্স ইনভেনটরি সোর্স ডিল এবং নিলাম প্যাকেজ, উভয়কেই দেখায়। TARGETING_TYPE_INVENTORY_SOURCE ব্যবহার করে ডিল ও নিলাম প্যাকেজ, দুটিই টার্গেট করা হয়।

v5-এ, ইনভেনটরি সোর্স ডিল ও নিলাম প্যাকেজ আলাদাভাবে ম্যানেজ করা হয়:

• ইনভেনটরি সোর্স ডিল TARGETING_TYPE_INVENTORY_SOURCE_DEAL ব্যবহার করে টার্গেট করা হয়, advertisers.inventorySources এবং partners.inventorySources পরিষেবা ব্যবহার করে ফিরিয়ে আনা হয় এবং AssignedTargetingOption ফিল্ড inventorySourceDetails ব্যবহার করে টার্গেট করা হয়।
• TARGETING_TYPE_AUCTION_PACKAGE ব্যবহার করে নিলাম প্যাকেজ টার্গেট করা হয়, targetingTypes.targetingOptions পরিষেবা ব্যবহার করে উদ্ধার করা হয় এবং AssignedTargetingOption ফিল্ড auctionPackageDetails ব্যবহার করে টার্গেট করা হয়।

এই আপডেট, আগে থেকে থাকা ডিল ও নিলাম প্যাকেজের জন্য ব্যবহৃত আইডি পরিবর্তন করে, তাই মাইগ্রেশনের পরে আপনি আগে থেকে ক্যাশে করা কোনও InventorySource রিসোর্স আইডি ব্যবহার করতে পারবেন না।

এইসব পরিবর্তন ছাড়াও, v5 ইনভেনটরি সোর্সের অ্যাক্সেসর তৈরি, আপডেট ও এডিট করার ক্ষমতাও সরিয়ে দেয়।

Demand Gen ও YouTube রিসোর্সের জন্য দর্শক টার্গেটিং লজিক আপডেট করুন

Display & Video 360 API v5, ডিমান্ড জেনারেশন এবং YouTube রিসোর্সের জন্য অডিয়েন্স টার্গেটিং লজিক আপডেট করে যাতে প্রতিটি টার্গেট করা অডিয়েন্স তালিকার জন্য আলাদা আলাদা অ্যাসাইন করা বিকল্প ব্যবহার করা যায়।

v4-এ, সব দর্শক টার্গেটিং TARGETING_TYPE_AUDIENCE_GROUP ব্যবহার করে ম্যানেজ করা হয়।

v5-এ, ডিমান্ড জেনারেশন এবং YouTube বিজ্ঞাপন গ্রুপে অ্যাসাইন করা দর্শক টার্গেটিং নিম্নলিখিত টার্গেটিং প্রকারগুলির মধ্যে একটি এবং AssignedTargetingOption রিসোর্স ফিল্ড ব্যবহার করে ম্যানেজ করা হয়, যা দর্শকের প্রকারের উপর নির্ভর করে:

• TARGETING_TYPE_COMBINED_AUDIENCE combinedAudienceDetails ব্যবহার করছেন
• customListDetails ব্যবহার করে TARGETING_TYPE_CUSTOM_LIST
• TARGETING_TYPE_FIRST_PARTY_AND_PARTNER_AUDIENCE firstPartyAndPartnerAudienceDetails ব্যবহার করছেন
• TARGETING_TYPE_GOOGLE_AUDIENCE googleAudienceDetails ব্যবহার করছেন
• TARGETING_TYPE_LOOKALIKE_AUDIENCE lookalikeAudienceDetails ব্যবহার করছেন

সব ধরনের দর্শক টার্গেটিং ম্যানেজ করার জন্য লাইন আইটেম একটিই TARGETING_TYPE_AUDIENCE_GROUP AssignedTargetingOption ব্যবহার করা চালিয়ে যাবে।

কাস্টমার ম্যাচ অডিয়েন্স ম্যানেজমেন্টের জন্য ডেটা ম্যানেজার API-তে আপগ্রেড করুন

Display & Video 360 API v5-এ নিম্নলিখিত পদ্ধতিগুলি সরিয়ে দেওয়ার মাধ্যমে গ্রাহক ম্যাচ দর্শকদের মেম্বারশিপ তৈরি ও ম্যানেজ করার সুবিধা সরিয়ে দেওয়া হয়েছে:

• firstPartyAndPartnerAudiences.create
• firstPartyAndPartnerAudiences.editCustomerMatchMembers
• firstPartyAndPartnerAudiences.patch

'গ্রাহক ম্যাচ' অডিয়েন্স ম্যানেজ করা চালিয়ে যেতে, ডেটা ম্যানেজার API ব্যবহার করার জন্য আপনার ওয়ার্কফ্লো আপগ্রেড করুন।

ডিজিটাল আউট অফ হোম ইনসার্শন অর্ডার ফিরিয়ে আনার জন্য সহায়তা যোগ করুন

Display & Video 360 API v5, ডিজিটাল আউট অফ হোম ইনসার্শন অর্ডার ফিরিয়ে আনার জন্য সহায়তা যোগ করে।

আপনার বিজ্ঞাপনদাতারা ডিজিটাল আউট অফ হোম বিজ্ঞাপন ব্যবহার করলে, advertisers.insertionOrders.list-এ কল করা যেকোনও ইন্টিগ্রেশন আপগ্রেড করুন, যাতে InsertionOrder রিসোর্স অন্তর্ভুক্ত করা যায়, যার insertionOrderType ফিল্ড ভ্যালু হল OUT_OF_HOME।

v5-এ, ডিজিটাল আউট অফ হোম ইনসার্শন অর্ডারের অধীনে লাইন আইটেমগুলি v4-এর মতোই পুনরুদ্ধারযোগ্য থাকবে।

Adloox থেকে Peer39-এ রেফারেন্স আপডেট করুন

v5-এ, Adloox-এর (Scope3 নামেও পরিচিত) সাথে Display & Video 360 থার্ড-পার্টি ব্র্যান্ড উপযুক্ততা ইন্টিগ্রেশন রেফারেন্স করা ফিল্ড এবং enum ভ্যালু Peer39-এ আপডেট করা হয়েছে:

• ThirdPartyVerifierAssignedTargetingOptionDetails adloox ফিল্ড peer39 দিয়ে পরিবর্তন করা হয়েছে।
• PartnerCostType enum ভ্যালু PARTNER_COST_TYPE_ADLOOX এবং PARTNER_COST_TYPE_ADLOOX_PREBID-এর পরিবর্তে PARTNER_COST_TYPE_PEER39 এবং PARTNER_COST_TYPE_PEER39_PREBID ব্যবহার করা হয়েছে।

YouTube লাইন আইটেম, বিজ্ঞাপন গ্রুপ ও বিজ্ঞাপনের জন্য ফিল্ড আপডেট করা

v5-এ, LineItem, AdGroup এবং AdGroupAd রিসোর্সের বিভিন্ন ফিল্ড সরিয়ে দেওয়া বা আপডেট করা হয়েছে। এইসব পরিবর্তন বিবেচনা করার জন্য আপনার রিসোর্স রিট্রিভাল লজিক আপডেট করুন।

LineItem রিসোর্সে:

• YoutubeAndPartnersSettings ফিল্ড relatedVideoIds পরিবর্তন করে relatedVideos করা হয়েছে।

LineItem এবং AdGroup রিসোর্সে:

• TargetingExpansionConfig ফিল্ড audienceExpansionSeedListExcluded এবং audienceExpansionLevel সরিয়ে দেওয়া হয়েছে।

AdGroupAd রিসোর্সে:

• একটি containsSyntheticMedia ফিল্ড যোগ করা হয়েছে।
• AudioAd, CommonInStreamAttribute এবং VideoPerformanceAd অবজেক্টে trackingUrl ফিল্ড দুটি ফিল্ডে বিভক্ত করা হয়েছে, trackingUrl এবং userSpecifiedTrackingUrl, যাতে ট্র্যাকিংয়ের জন্য ব্যবহৃত URL এবং ব্যবহারকারীর নির্দিষ্ট করা ট্র্যাকিং URL-এর মধ্যে পার্থক্য করা যায়।

শীঘ্রই বন্ধ করা হবে এমন enum ভ্যালুর রেফারেন্স সরিয়ে দিন

v5-এ, আগে থেকে বন্ধ হয়ে যাওয়া enum ভ্যালু সম্পূর্ণভাবে সরিয়ে দেওয়া হয়েছে। API-তে অনুরোধ করার সময় এইসব ভ্যালু ব্যবহার করলে v4-এ সমস্যা হবে, এই পরিবর্তন v5 ক্লায়েন্ট লাইব্রেরি থেকে এগুলির যেকোনও রেফারেন্স সরিয়ে দেয়। v5-এ আপগ্রেড করার সময় আপনার কোডে এইসব বাতিল করা ভ্যালুর কোনও রেফারেন্স থাকলে সমস্যা হতে পারে।

Enum-এর ধরন যার প্রভাবিত ভ্যালু আছে, তার মধ্যে এগুলি অন্তর্ভুক্ত: ContentRatingTier, GoogleAudienceType, SdfVersion এবং SensitiveCategory। সরিয়ে দেওয়া সব enum ভ্যালুর সম্পূর্ণ তালিকা দেখতে আমাদের রিলিজ নোট দেখুন।

নতুন ফিচার পর্যালোচনা করুন

ব্রেকিং পরিবর্তন ছাড়াও, v5-এ নিম্নলিখিত নতুন ফিচার যোগ করা হয়েছে:

• TARGETING_TYPE_YOUTUBE_VIDEO এবং TARGETING_TYPE_YOUTUBE_CHANNEL টার্গেটিং ধরনের অধীনে বিজ্ঞাপনদাতার লেভেলে YouTube ভিডিও এবং চ্যানেল বাদ দেওয়ার টার্গেটিংয়ের সম্পূর্ণ ম্যানেজমেন্ট। v4-এ, এই টার্গেটিং শুধু পড়া যেত।
• ডিজিটাল আউট অফ হোম InsertionOrder রিসোর্স তৈরি করার ক্ষমতা।
• AdGroup ফিল্ড adSource এবং creativeAssignments এবং AdGroupAd ফিল্ড parentCreativeId যোগ করার মাধ্যমে অ্যাসাইন করা ক্রিয়েটিভ ব্যবহার করে বিজ্ঞাপন গ্রুপে বিজ্ঞাপন তৈরি করার জন্য সহায়তা।
• LookalikeAudience রিসোর্স তৈরি ও ফিরিয়ে আনার ক্ষমতা।
• AdGroupAd রিসোর্সে একটি নতুন containsSyntheticMedia ফিল্ড।