REST Resource: advertisers.lineItems

রিসোর্স: লাইনআইটেম

একটি একক লাইনের আইটেম।

JSON উপস্থাপনা
{
  "name": string,
  "advertiserId": string,
  "campaignId": string,
  "insertionOrderId": string,
  "lineItemId": string,
  "displayName": string,
  "lineItemType": enum (LineItemType),
  "entityStatus": enum (EntityStatus),
  "updateTime": string,
  "partnerCosts": [
    {
      object (PartnerCost)
    }
  ],
  "flight": {
    object (LineItemFlight)
  },
  "budget": {
    object (LineItemBudget)
  },
  "pacing": {
    object (Pacing)
  },
  "frequencyCap": {
    object (FrequencyCap)
  },
  "partnerRevenueModel": {
    object (PartnerRevenueModel)
  },
  "conversionCounting": {
    object (ConversionCountingConfig)
  },
  "creativeIds": [
    string
  ],
  "bidStrategy": {
    object (BiddingStrategy)
  },
  "integrationDetails": {
    object (IntegrationDetails)
  },
  "targetingExpansion": {
    object (TargetingExpansionConfig)
  },
  "warningMessages": [
    enum (LineItemWarningMessage)
  ],
  "mobileApp": {
    object (MobileApp)
  },
  "reservationType": enum (ReservationType),
  "excludeNewExchanges": boolean,
  "youtubeAndPartnersSettings": {
    object (YoutubeAndPartnersSettings)
  },
  "demandGenSettings": {
    object (DemandGenSettings)
  },
  "containsEuPoliticalAds": enum (EuPoliticalAdvertisingStatus),
  "optimizeFixedBidding": boolean
}
ক্ষেত্র
name

string

শুধুমাত্র আউটপুট। লাইন আইটেমটির রিসোর্স নাম।

advertiserId

string ( int64 format)

শুধুমাত্র আউটপুট। লাইন আইটেমটি যে বিজ্ঞাপনদাতার অন্তর্গত, তার অনন্য আইডি।

campaignId

string ( int64 format)

শুধুমাত্র আউটপুট। লাইন আইটেমটি যে ক্যাম্পেইনের অন্তর্গত, তার অনন্য আইডি।

insertionOrderId

string ( int64 format)

আবশ্যক। অপরিবর্তনীয়। লাইন আইটেমটি যে সন্নিবেশ ক্রমের অন্তর্গত, তার অনন্য আইডি।

lineItemId

string ( int64 format)

শুধুমাত্র আউটপুট। লাইন আইটেমটির অনন্য আইডি। সিস্টেম দ্বারা নির্ধারিত।

displayName

string

আবশ্যক। লাইন আইটেমটির প্রদর্শিত নাম।

অবশ্যই UTF-8 এনকোড করা হতে হবে এবং এর সর্বোচ্চ আকার হবে ২৪০ বাইট।

lineItemType

enum ( LineItemType )

আবশ্যক। অপরিবর্তনীয়। লাইন আইটেমের ধরণ।

entityStatus

enum ( EntityStatus )

প্রয়োজনীয়। এটি নিয়ন্ত্রণ করে যে কোনো আইটেম তার বাজেট ব্যয় করতে এবং মজুদ পণ্যের জন্য দরপত্র জমা দিতে পারবে কি না।

  • lineItems.create মেথডের জন্য শুধুমাত্র ENTITY_STATUS_DRAFT অনুমোদিত। একটি লাইন আইটেম সক্রিয় করতে, lineItems.patch মেথড ব্যবহার করুন এবং তৈরির পরে স্ট্যাটাসটি ENTITY_STATUS_ACTIVE এ আপডেট করুন।
  • একটি লাইন আইটেমকে অন্য কোনো স্ট্যাটাস থেকে পুনরায় ENTITY_STATUS_DRAFT স্ট্যাটাসে পরিবর্তন করা যাবে না।
  • যদি লাইন আইটেমটির প্যারেন্ট ইনসারশন অর্ডার সক্রিয় না থাকে, তাহলে লাইন আইটেমটির নিজের স্ট্যাটাস ENTITY_STATUS_ACTIVE হলেও সেটি তার বাজেট ব্যয় করতে পারে না।
updateTime

string ( Timestamp format)

শুধুমাত্র আউটপুট। লাইন আইটেমটি সর্বশেষ আপডেট করার সময়কার টাইমস্ট্যাম্প। সিস্টেম দ্বারা নির্ধারিত।

RFC 3339 ব্যবহার করা হয়, যেখানে তৈরি হওয়া আউটপুট সর্বদা Z-নরম্যালাইজড হবে এবং এতে ০, ৩, ৬ বা ৯টি ভগ্নাংশীয় অঙ্ক ব্যবহৃত হবে। "Z" ছাড়াও অন্যান্য অফসেটও গ্রহণ করা হয়। উদাহরণ: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" অথবা "2014-10-02T15:01:23+05:30"

partnerCosts[]

object ( PartnerCost )

এই লাইন আইটেমের সাথে সংশ্লিষ্ট অংশীদারী খরচসমূহ।

lineItems.create মেথডটি অনুপস্থিত বা খালি থাকলে, নতুন তৈরি হওয়া লাইন আইটেমটি তার প্যারেন্ট ইনসারশন অর্ডার থেকে পার্টনার কস্ট উত্তরাধিকার সূত্রে পাবে।

flight

object ( LineItemFlight )

প্রয়োজনীয়। লাইন আইটেমটির ফ্লাইটের শুরু এবং শেষের সময়।

budget

object ( LineItemBudget )

প্রয়োজনীয়। লাইন আইটেমটির বাজেট বরাদ্দ নির্ধারণ।

pacing

object ( Pacing )

প্রয়োজনীয়। লাইন আইটেমটির বাজেট ব্যয়ের গতি নির্ধারণ।

frequencyCap

object ( FrequencyCap )

ঐচ্ছিক। যদি লাইন আইটেমের ধরণ LINE_ITEM_TYPE_DEMAND_GEN না হয়, তবে এটি আবশ্যক। লাইন আইটেমটির ইম্প্রেশন ফ্রিকোয়েন্সি ক্যাপ সেটিংস।

সীমিত সীমা নির্ধারণ করতে হলে এই সেটিংস অবজেক্টের maxImpressions ফিল্ডটি অবশ্যই ব্যবহার করতে হবে।

partnerRevenueModel

object ( PartnerRevenueModel )

প্রয়োজনীয়। লাইন আইটেমটির পার্টনার রেভিনিউ মডেল সেটিং।

conversionCounting

object ( ConversionCountingConfig )

লাইন আইটেমটির রূপান্তর ট্র্যাকিং সেটিং।

creativeIds[]

string ( int64 format)

লাইন আইটেমটির সাথে সংশ্লিষ্ট সৃজনশীল ব্যক্তিদের আইডি।

bidStrategy

object ( BiddingStrategy )

প্রয়োজনীয়। উক্ত আইটেমটির দরপত্র কৌশল।

integrationDetails

object ( IntegrationDetails )

লাইন আইটেমটির একত্রীকরণের বিবরণ।

targetingExpansion

object ( TargetingExpansionConfig )

লাইন আইটেমটির অপ্টিমাইজ করা টার্গেটিং সেটিংস।

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

warningMessages[]

enum ( LineItemWarningMessage )

শুধুমাত্র আউটপুট। লাইন আইটেমটি দ্বারা তৈরি সতর্কবার্তাগুলো। এই সতর্কবার্তাগুলো লাইন আইটেমটি সংরক্ষণ করতে বাধা দেয় না, তবে কিছু সতর্কবার্তা লাইন আইটেমটি চালানোতে বাধা দিতে পারে।

mobileApp

object ( MobileApp )

উক্ত আইটেম দ্বারা প্রচারিত মোবাইল অ্যাপ।

এটি শুধুমাত্র তখনই প্রযোজ্য যখন lineItemType মান LINE_ITEM_TYPE_DISPLAY_MOBILE_APP_INSTALL অথবা LINE_ITEM_TYPE_VIDEO_MOBILE_APP_INSTALL হয়।

reservationType

enum ( ReservationType )

শুধুমাত্র আউটপুট। লাইন আইটেমটির রিজার্ভেশন ধরণ।

excludeNewExchanges

boolean

লাইন আইটেম দ্বারা স্বয়ংক্রিয়ভাবে টার্গেট হওয়া থেকে নতুন এক্সচেঞ্জগুলোকে বাদ দেওয়া হবে কিনা। এই ফিল্ডটি ডিফল্টরূপে 'ফলস' থাকে।

youtubeAndPartnersSettings

object ( YoutubeAndPartnersSettings )

শুধুমাত্র আউটপুট। সেটিংসগুলো ইউটিউব এবং পার্টনার লাইন আইটেমগুলোর জন্য নির্দিষ্ট।

demandGenSettings

object ( DemandGenSettings )

ঐচ্ছিক। ডিমান্ড জেন লাইন আইটেমগুলোর জন্য নির্দিষ্ট সেটিংস।

শুধুমাত্র ডিমান্ড জেন লাইন আইটেমগুলোর ক্ষেত্রে প্রযোজ্য।

containsEuPoliticalAds

enum ( EuPoliticalAdvertisingStatus )

এই দফাটি ইউরোপীয় ইউনিয়নের রাজনৈতিক বিজ্ঞাপনে ব্যবহৃত হবে কিনা।

যদি মূল বিজ্ঞাপনদাতার মধ্যে containsEuPoliticalAds DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING হিসেবে সেট করা থাকে, তাহলে অন্য কোনোভাবে নির্দিষ্ট করা না থাকলে এই ফিল্ডটিতেও DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING মানটি নির্ধারিত হবে। এরপর এই ফিল্ডটি UI, API, বা স্ট্রাকচার্ড ডেটা ফাইল ব্যবহার করে আপডেট করা যাবে।

নতুন লাইন আইটেম তৈরি করার সময় এই ফিল্ডটি অবশ্যই নির্ধারণ করতে হবে। অন্যথায়, advertisers.lineItems.create অনুরোধটি ব্যর্থ হবে

optimizeFixedBidding

boolean

ঐচ্ছিক। নির্দিষ্ট বিড লাইন আইটেমগুলির জন্য DV360-এর বিড অপ্টিমাইজেশন সক্রিয় করা হবে কিনা।

ডিফল্টরূপে, DV360 আপনার ফিক্সড বিডকে অপ্টিমাইজ করে, যার জন্য এটি স্বয়ংক্রিয়ভাবে সেইসব ইম্প্রেশনের বিড কমিয়ে দেয় যেগুলোর ভালো পারফর্ম করার সম্ভাবনা কম। এই অপ্টিমাইজেশনটি ডিফল্টরূপে সক্রিয় থাকে (মানটি 'true' হলে)।

যখন এই ফিল্ডটির মান false সেট করা হয়, তখন এই অপটিমাইজেশনটি নিষ্ক্রিয় হয়ে যায় এবং কোনো কারণবশতই বিড কমানো হবে না।

এই সেটিংটি শুধুমাত্র সেইসব লাইন আইটেমগুলির ক্ষেত্রে প্রযোজ্য, যেগুলির biddingStrategy FIXED_BID টাইপের।

লাইনআইটেমটাইপ

একটি লাইন আইটেমের সম্ভাব্য প্রকারভেদ।

লাইন আইটেমের ধরন নির্ধারণ করে দেয় কোন কোন সেটিংস ও অপশন প্রযোজ্য হবে, যেমন বিজ্ঞাপনের ফরম্যাট বা টার্গেটিং অপশন।

এনাম
LINE_ITEM_TYPE_UNSPECIFIED

এই সংস্করণে টাইপের মান নির্দিষ্ট করা নেই অথবা তা অজানা।

এই ধরনের লাইন আইটেম এবং সেগুলোর টার্গেটিং এপিআই ব্যবহার করে তৈরি বা আপডেট করা যায় না।

LINE_ITEM_TYPE_DISPLAY_DEFAULT ইমেজ, এইচটিএমএল৫, নেটিভ বা রিচ মিডিয়া বিজ্ঞাপন।
LINE_ITEM_TYPE_DISPLAY_MOBILE_APP_INSTALL এমন বিজ্ঞাপন প্রদর্শন করুন যা অ্যাপ ইনস্টল করতে উৎসাহিত করে।
LINE_ITEM_TYPE_VIDEO_DEFAULT বিভিন্ন পরিবেশের জন্য সিपीएम ভিত্তিতে ভিডিও বিজ্ঞাপন বিক্রি করা হয়।
LINE_ITEM_TYPE_VIDEO_MOBILE_APP_INSTALL ভিডিও বিজ্ঞাপন যা অ্যাপ ইনস্টল করতে উৎসাহিত করে।
LINE_ITEM_TYPE_DISPLAY_MOBILE_APP_INVENTORY

মোবাইল অ্যাপ ইনভেন্টরিতে প্রদর্শিত বিজ্ঞাপন।

এই ধরনের লাইন আইটেম এবং সেগুলোর টার্গেটিং এপিআই ব্যবহার করে তৈরি বা আপডেট করা যায় না।

LINE_ITEM_TYPE_VIDEO_MOBILE_APP_INVENTORY

মোবাইল অ্যাপ ইনভেন্টরিতে ভিডিও বিজ্ঞাপন পরিবেশন করা হয়।

এই ধরনের লাইন আইটেম এবং সেগুলোর টার্গেটিং এপিআই ব্যবহার করে তৈরি বা আপডেট করা যায় না।

LINE_ITEM_TYPE_AUDIO_DEFAULT আরটিবি অডিও বিজ্ঞাপনগুলো বিভিন্ন পরিবেশের জন্য বিক্রি করা হতো।
LINE_ITEM_TYPE_VIDEO_OVER_THE_TOP OTT ইনসারশন অর্ডারে উপস্থিত ওভার-দ্য-টপ বিজ্ঞাপন। এই প্রকারটি শুধুমাত্র সেইসব লাইন আইটেমের জন্য প্রযোজ্য, যেগুলোর ইনসারশন অর্ডার হলো insertionOrderType OVER_THE_TOP
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_ACTION

ইউটিউব ভিডিও বিজ্ঞাপন যা রূপান্তর বাড়াতে সাহায্য করে।

এই ধরনের লাইন আইটেম এবং সেগুলোর টার্গেটিং এপিআই ব্যবহার করে তৈরি বা আপডেট করা যায় না।

LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE

ইউটিউব ভিডিও বিজ্ঞাপন (সর্বোচ্চ ১৫ সেকেন্ড পর্যন্ত) যা স্কিপ করা যায় না।

এই ধরনের লাইন আইটেম এবং সেগুলোর টার্গেটিং এপিআই ব্যবহার করে তৈরি বা আপডেট করা যায় না।

LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_VIDEO_SEQUENCE

ইউটিউব ভিডিও বিজ্ঞাপন, যেগুলো বিভিন্ন ফরম্যাটের মিশ্রণ ব্যবহার করে একটি নির্দিষ্ট ক্রমে গল্প দেখায়।

এই ধরনের লাইন আইটেম এবং সেগুলোর টার্গেটিং এপিআই ব্যবহার করে তৈরি বা আপডেট করা যায় না।

LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_AUDIO

ইউটিউব অডিও বিজ্ঞাপন।

এই ধরনের লাইন আইটেম এবং সেগুলোর টার্গেটিং এপিআই ব্যবহার করে তৈরি বা আপডেট করা যায় না।

LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_REACH

ইউটিউব ভিডিও বিজ্ঞাপন যা কম খরচে আরও বেশি স্বতন্ত্র ব্যবহারকারীর কাছে পৌঁছানোর জন্য অপ্টিমাইজ করা হয়। এতে বাম্পার বিজ্ঞাপন, স্কিপযোগ্য মাঝ-স্ট্রিম বিজ্ঞাপন, অথবা বিভিন্ন ধরনের বিজ্ঞাপনের মিশ্রণ অন্তর্ভুক্ত থাকতে পারে।

এই ধরনের লাইন আইটেম এবং সেগুলোর টার্গেটিং এপিআই ব্যবহার করে তৈরি বা আপডেট করা যায় না।

LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_SIMPLE

ইউটিউবের ডিফল্ট ভিডিও বিজ্ঞাপন।

এই ধরনের লাইন আইটেম এবং সেগুলোর টার্গেটিং এপিআই ব্যবহার করে তৈরি বা আপডেট করা যায় না।

LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE_OVER_THE_TOP

কানেক্টেড টিভিতে ইউটিউব ভিডিও বিজ্ঞাপন (সর্বোচ্চ ১৫ সেকেন্ড) আসে, যা স্কিপ করা যায় না।

এই ধরনের লাইন আইটেম এবং সেগুলোর টার্গেটিং এপিআই ব্যবহার করে তৈরি বা আপডেট করা যায় না।

LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_REACH_OVER_THE_TOP

কানেক্টেড টিভি ইউটিউব ভিডিও বিজ্ঞাপন যা কম খরচে আরও বেশি স্বতন্ত্র ব্যবহারকারীর কাছে পৌঁছানোর জন্য অপ্টিমাইজ করা হয়। এতে বাম্পার বিজ্ঞাপন, স্কিপযোগ্য ইন-স্ট্রিম বিজ্ঞাপন, অথবা বিভিন্ন ধরনের বিজ্ঞাপনের মিশ্রণ অন্তর্ভুক্ত থাকতে পারে।

এই ধরনের লাইন আইটেম এবং সেগুলোর টার্গেটিং এপিআই ব্যবহার করে তৈরি বা আপডেট করা যায় না।

LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_SIMPLE_OVER_THE_TOP

কানেক্টেড টিভির ডিফল্ট ইউটিউব ভিডিও বিজ্ঞাপন। শুধুমাত্র ইন-স্ট্রিম বিজ্ঞাপন ফরম্যাট অন্তর্ভুক্ত।

এই ধরনের লাইন আইটেম এবং সেগুলোর টার্গেটিং এপিআই ব্যবহার করে তৈরি বা আপডেট করা যায় না।

LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_TARGET_FREQUENCY

এই লাইন আইটেম টাইপের উদ্দেশ্য হলো একটি নির্দিষ্ট সময়কালে একই ব্যক্তিকে লক্ষ্য সংখ্যক বার ইউটিউব বিজ্ঞাপন দেখানো।

এই ধরনের লাইন আইটেম এবং সেগুলোর টার্গেটিং এপিআই ব্যবহার করে তৈরি বা আপডেট করা যায় না।

LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_VIEW

ইউটিউব ভিডিও বিজ্ঞাপন, যেগুলোর লক্ষ্য হলো বিভিন্ন ধরনের বিজ্ঞাপন ফরম্যাটের মাধ্যমে আরও বেশি ভিউ পাওয়া।

এই ধরনের লাইন আইটেম এবং সেগুলোর টার্গেটিং এপিআই ব্যবহার করে তৈরি বা আপডেট করা যায় না।

LINE_ITEM_TYPE_DISPLAY_OUT_OF_HOME

ডিজিটাল-আউট-অফ-হোম ইনভেন্টরিতে প্রদর্শিত বিজ্ঞাপন।

এই ধরনের লাইন আইটেম এবং সেগুলোর টার্গেটিং এপিআই ব্যবহার করে তৈরি বা আপডেট করা যায় না।

LINE_ITEM_TYPE_VIDEO_OUT_OF_HOME

ডিজিটাল আউট-অফ-হোম ইনভেন্টরিতে ভিডিও বিজ্ঞাপন পরিবেশন করা হয়।

এই ধরনের লাইন আইটেম এবং সেগুলোর টার্গেটিং এপিআই ব্যবহার করে তৈরি বা আপডেট করা যায় না।

LINE_ITEM_TYPE_DEMAND_GEN

ডিমান্ড জেন বিজ্ঞাপন।

লাইনআইটেমফ্লাইট

যে সেটিংসগুলো একটি লাইন আইটেমের সক্রিয় থাকার সময়কাল নিয়ন্ত্রণ করে।

JSON উপস্থাপনা
{
  "flightDateType": enum (LineItemFlightDateType),
  "dateRange": {
    object (DateRange)
  }
}
ক্ষেত্র
flightDateType

enum ( LineItemFlightDateType )

আবশ্যক। লাইন আইটেমটির ফ্লাইট তারিখের ধরণ।

dateRange

object ( DateRange )

লাইন আইটেমটির ফ্লাইট শুরু এবং শেষের তারিখ। এগুলো মূল বিজ্ঞাপনদাতার টাইম জোনের সাপেক্ষে নির্ধারণ করা হয়।

  • flightDateType যখন LINE_ITEM_FLIGHT_DATE_TYPE_CUSTOM হয়, তখন এটি আবশ্যক। অন্যথায় শুধু আউটপুট দিন।
  • নতুন ফ্লাইট তৈরি করার সময়, startDate এবং endDate উভয়ই ভবিষ্যতের হতে হবে।
  • অতীতের কোনো startDate থাকা একটি চলমান ফ্লাইটের endDate পরিবর্তনযোগ্য কিন্তু startDate অপরিবর্তনযোগ্য।
  • endDate অবশ্যই startDate বা তার পরের হতে হবে এবং উভয় তারিখই ২০৩৭ সালের আগে হতে হবে।

লাইনআইটেমফ্লাইটতারিখেরপ্রকার

একটি লাইন আইটেমের ফ্লাইট তারিখের সম্ভাব্য প্রকারভেদ।

এনাম
LINE_ITEM_FLIGHT_DATE_TYPE_UNSPECIFIED এই সংস্করণে টাইপের মান নির্দিষ্ট করা নেই অথবা তা অজানা।
LINE_ITEM_FLIGHT_DATE_TYPE_INHERITED লাইন আইটেমটির ফ্লাইটের তারিখগুলো এর প্যারেন্ট ইনসারশন অর্ডার থেকে উত্তরাধিকারসূত্রে প্রাপ্ত হয়।
LINE_ITEM_FLIGHT_DATE_TYPE_CUSTOM এই লাইন আইটেমটি তার নিজস্ব নির্ধারিত ফ্লাইটের তারিখ ব্যবহার করে।

লাইনআইটেমবাজেট

বাজেট কীভাবে বরাদ্দ করা হবে তা নিয়ন্ত্রণ করে এমন সেটিংস।

JSON উপস্থাপনা
{
  "budgetAllocationType": enum (LineItemBudgetAllocationType),
  "budgetUnit": enum (BudgetUnit),
  "maxAmount": string
}
ক্ষেত্র
budgetAllocationType

enum ( LineItemBudgetAllocationType )

প্রয়োজনীয়। বাজেট বরাদ্দের ধরণ।

LINE_ITEM_BUDGET_ALLOCATION_TYPE_AUTOMATIC শুধুমাত্র তখনই প্রযোজ্য হবে যখন প্যারেন্ট ইনসারশন অর্ডারের জন্য অটোমেটিক বাজেট অ্যালোকেশন সক্রিয় করা থাকে।

ডিমান্ড জেন লাইন আইটেমগুলির জন্য এই ফিল্ডটি অবশ্যই LINE_ITEM_BUDGET_ALLOCATION_TYPE_FIXED এ সেট করতে হবে।

budgetUnit

enum ( BudgetUnit )

শুধুমাত্র আউটপুট। বাজেট ইউনিট নির্দিষ্ট করে যে বাজেটটি মুদ্রা-ভিত্তিক নাকি ইম্প্রেশন-ভিত্তিক। এই মানটি প্যারেন্ট ইনসারশন অর্ডার থেকে উত্তরাধিকারসূত্রে প্রাপ্ত হয়।

maxAmount

string ( int64 format)

এই নির্দিষ্ট খাতে ব্যয়ের সর্বোচ্চ বাজেট পরিমাণ। এটি অবশ্যই ০-এর চেয়ে বেশি হতে হবে।

যখন budgetAllocationType হলো:

  • LINE_ITEM_BUDGET_ALLOCATION_TYPE_AUTOMATIC , এই ফিল্ডটি অপরিবর্তনীয় এবং সিস্টেম দ্বারা সেট করা হয়।
  • LINE_ITEM_BUDGET_ALLOCATION_TYPE_FIXED , যদি budgetUnit হয়:
    • BUDGET_UNIT_CURRENCY ফিল্ডটি বিজ্ঞাপনদাতার মুদ্রার মাইক্রো এককে ব্যয়ের জন্য সর্বোচ্চ বাজেটের পরিমাণ নির্দেশ করে। উদাহরণস্বরূপ, 1500000 মানে মুদ্রার ১.৫ স্ট্যান্ডার্ড ইউনিট।
    • BUDGET_UNIT_IMPRESSIONS , এই ফিল্ডটি পরিবেশনযোগ্য ইম্প্রেশনের সর্বোচ্চ সংখ্যা নির্দেশ করে।
  • LINE_ITEM_BUDGET_ALLOCATION_TYPE_UNLIMITED , এই ফিল্ডটি প্রযোজ্য নয় এবং সিস্টেম এটিকে উপেক্ষা করবে।

লাইনআইটেমবাজেটবরাদ্দপ্রকার

বাজেট বরাদ্দের সম্ভাব্য প্রকারভেদ।

এনাম
LINE_ITEM_BUDGET_ALLOCATION_TYPE_UNSPECIFIED এই সংস্করণে টাইপের মান নির্দিষ্ট করা নেই অথবা তা অজানা।
LINE_ITEM_BUDGET_ALLOCATION_TYPE_AUTOMATIC লাইন আইটেমটির জন্য স্বয়ংক্রিয় বাজেট বরাদ্দ সক্রিয় করা হয়েছে।
LINE_ITEM_BUDGET_ALLOCATION_TYPE_FIXED এই নির্দিষ্ট খাতের জন্য একটি নির্দিষ্ট সর্বোচ্চ বাজেট বরাদ্দ করা হয়।
LINE_ITEM_BUDGET_ALLOCATION_TYPE_UNLIMITED এই নির্দিষ্ট আইটেমটির ক্ষেত্রে কোনো বাজেট সীমা প্রযোজ্য নয়।

অংশীদার রাজস্ব মডেল

যে সেটিংসগুলো অংশীদারদের আয় কীভাবে গণনা করা হবে তা নিয়ন্ত্রণ করে।

JSON উপস্থাপনা
{
  "markupType": enum (PartnerRevenueModelMarkupType),
  "markupAmount": string
}
ক্ষেত্র
markupType

enum ( PartnerRevenueModelMarkupType )

প্রয়োজনীয়। পার্টনার রেভিনিউ মডেলের মার্কআপ টাইপ।

ডিমান্ড জেন লাইন আইটেমগুলির জন্য এই ফিল্ডটি অবশ্যই PARTNER_REVENUE_MODEL_MARKUP_TYPE_TOTAL_MEDIA_COST_MARKUP এ সেট করতে হবে।

markupAmount

string ( int64 format)

আবশ্যক। পার্টনার রেভিনিউ মডেলের মার্কআপের পরিমাণ। অবশ্যই ০-এর সমান বা তার বেশি হতে হবে।

  • যখন markupType PARTNER_REVENUE_MODEL_MARKUP_TYPE_CPM হিসেবে সেট করা হয়, তখন এই ফিল্ডটি বিজ্ঞাপনদাতার মুদ্রার মাইক্রো এককে CPM মার্কআপকে প্রকাশ করে। উদাহরণস্বরূপ, 1500000 মানে হলো মুদ্রাটির ১.৫ স্ট্যান্ডার্ড ইউনিট।
  • যখন markupType PARTNER_REVENUE_MODEL_MARKUP_TYPE_MEDIA_COST_MARKUP হিসেবে সেট করা হয়, তখন এই ফিল্ডটি মিলিসেকেন্ডে মিডিয়া খরচের শতাংশ মার্কআপকে প্রকাশ করে। উদাহরণস্বরূপ, ১০০ মানে হলো ০.১% (দশমিক ০.০০১)।
  • যখন markupType PARTNER_REVENUE_MODEL_MARKUP_TYPE_TOTAL_MEDIA_COST_MARKUP হিসেবে সেট করা হয়, তখন এই ফিল্ডটি মোট মিডিয়া খরচের শতাংশ মার্কআপকে মিলিসেকেন্ডে প্রকাশ করে। উদাহরণস্বরূপ, ১০০ মানে হলো ০.১% (দশমিক ০.০০১)।

পার্টনাররেভিনিউমডেলমার্কআপটাইপ

অংশীদার রাজস্ব মডেলের সম্ভাব্য মার্কআপের প্রকারভেদ।

এনাম
PARTNER_REVENUE_MODEL_MARKUP_TYPE_UNSPECIFIED এই সংস্করণে টাইপের মান নির্দিষ্ট করা নেই অথবা তা অজানা।
PARTNER_REVENUE_MODEL_MARKUP_TYPE_CPM একটি নির্দিষ্ট CPM-এর ভিত্তিতে অংশীদারী আয় গণনা করুন।
PARTNER_REVENUE_MODEL_MARKUP_TYPE_MEDIA_COST_MARKUP

অংশীদারের মিডিয়া খরচের উপর শতাংশ সারচার্জ আরোপ করে তার রাজস্ব গণনা করুন।

PARTNER_REVENUE_MODEL_MARKUP_TYPE_TOTAL_MEDIA_COST_MARKUP অংশীদারের মোট মিডিয়া খরচের উপর একটি শতাংশ সারচার্জ আরোপ করে তার রাজস্ব গণনা করুন, যার মধ্যে সমস্ত অংশীদার খরচ এবং ডেটা খরচ অন্তর্ভুক্ত।

রূপান্তর গণনা কনফিগারেশন

যে সেটিংসগুলো নিয়ন্ত্রণ করে রূপান্তরগুলো কীভাবে গণনা করা হবে।

ক্লিকের পরের সমস্ত কনভার্সন গণনা করা হবে। ভিউ দেখার পরের কনভার্সন গণনার জন্য একটি শতাংশের মান নির্ধারণ করা যেতে পারে।

JSON উপস্থাপনা
{
  "postViewCountPercentageMillis": string,
  "floodlightActivityConfigs": [
    {
      object (TrackingFloodlightActivityConfig)
    }
  ],
  "primaryAttributionModelId": string
}
ক্ষেত্র
postViewCountPercentageMillis

string ( int64 format)

গণনার জন্য পোস্ট-ভিউ কনভার্সনের শতাংশ, মিলিসেকেন্ডে (শতাংশের ১/১০০০ ভাগ)। মানটি অবশ্যই ০ থেকে ১০০০০০-এর মধ্যে হতে হবে।

উদাহরণস্বরূপ, পোস্ট-ক্লিক কনভার্সনের ৫০% ট্র্যাক করতে, মানটি ৫০০০০ সেট করুন।

floodlightActivityConfigs[]

object ( TrackingFloodlightActivityConfig )

রূপান্তর ট্র্যাক করতে ব্যবহৃত ফ্ল্যাডলাইট অ্যাক্টিভিটি কনফিগারেশন।

গণনাকৃত কনভার্সনের সংখ্যা হলো এই ফিল্ডে নির্দিষ্ট করা সমস্ত ফ্ল্যাডলাইট অ্যাক্টিভিটি আইডি দ্বারা গণনা করা সমস্ত কনভার্সনের সমষ্টি।

লাইন আইটেমটিতে একটি কাস্টম বিডিং অ্যালগরিদম নির্ধারণ করা থাকলে এই ফিল্ডটি আপডেট করা যাবে না। আপনি যদি একই অনুরোধে এই ফিল্ডটি সেট করেন এবং একটি কাস্টম বিডিং অ্যালগরিদম নির্ধারণ করেন, তাহলে ফ্লাডলাইট অ্যাক্টিভিটিগুলো অবশ্যই কাস্টম বিডিং অ্যালগরিদম দ্বারা ব্যবহৃত অ্যাক্টিভিটিগুলোর সাথে মিলতে হবে।

primaryAttributionModelId

string ( int64 format)

ঐচ্ছিক। কনভার্সন পরিমাপের জন্য ব্যবহৃত অ্যাট্রিবিউশন মডেল। এই অ্যাট্রিবিউশন মডেলটি নির্ধারণ করবে কীভাবে কনভার্সন গণনা করা হবে। প্রাইমারি মডেলটি আপনি একটি ফ্লাডলাইট কনফিগারেশন বা গ্রুপের জন্য সেট করতে পারেন। আরও বিস্তারিত এখানে

শুধুমাত্র ডিমান্ড জেন লাইন আইটেমগুলোর ক্ষেত্রে প্রযোজ্য।

ট্র্যাকিংফ্লাডলাইটঅ্যাক্টিভিটিকনফিগ

এমন সেটিংস যা একটিমাত্র ফ্ল্যাডলাইট অ্যাক্টিভিটি কনফিগের আচরণ নিয়ন্ত্রণ করে।

JSON উপস্থাপনা
{
  "floodlightActivityId": string,
  "postClickLookbackWindowDays": integer,
  "postViewLookbackWindowDays": integer
}
ক্ষেত্র
floodlightActivityId

string ( int64 format)

প্রয়োজনীয়। ফ্লাডলাইট অ্যাক্টিভিটির আইডি।

postClickLookbackWindowDays

integer

আবশ্যক। কোনো বিজ্ঞাপনে ক্লিক করার পর কত দিনের মধ্যে একটি কনভার্সন গণনা করা হবে। সংখ্যাটি অবশ্যই ০ থেকে ৯০-এর মধ্যে হতে হবে (উভয় দিনসহ)।

postViewLookbackWindowDays

integer

আবশ্যক। একটি বিজ্ঞাপন দেখার পর যত দিনের মধ্যে একটি কনভার্সন গণনা করা যেতে পারে, সেই দিনের সংখ্যা। সংখ্যাটি অবশ্যই ০ থেকে ৯০-এর মধ্যে হতে হবে (উভয় দিনসহ)।

লাইনআইটেমসতর্কবার্তা

একটি লাইন আইটেম দ্বারা তৈরি সতর্কবার্তা। এই ধরনের সতর্কবার্তাগুলো একটি লাইন আইটেম সংরক্ষণ করতে বাধা দেয় না, কিন্তু এটি রান হতে বাধা দিতে পারে।

এনাম
LINE_ITEM_WARNING_MESSAGE_UNSPECIFIED অনির্দিষ্ট বা অজানা।
INVALID_FLIGHT_DATES এই লাইন আইটেমটিতে ফ্লাইটের তারিখগুলো অবৈধ। লাইন আইটেমটি চালানো হবে না।
EXPIRED এই আইটেমটির শেষ তারিখ অতীত হয়ে গেছে।
PENDING_FLIGHT এই আইটেমটি ভবিষ্যতে চালু হবে।
ALL_PARTNER_ENABLED_EXCHANGES_NEGATIVELY_TARGETED পার্টনার-সক্ষম সকল এক্সচেঞ্জকে নেতিবাচকভাবে লক্ষ্যবস্তু করা হয়েছে। লাইন আইটেমটি চালানো হবে না।
INVALID_INVENTORY_SOURCE কোনো সক্রিয় ইনভেন্টরি উৎসকে লক্ষ্য করা হচ্ছে না। লাইন আইটেমটি চালানো হবে না।
APP_INVENTORY_INVALID_SITE_TARGETING এই লাইন আইটেমটির অ্যাপস ও ইউআরএল টার্গেটিং-এ কোনো মোবাইল অ্যাপ অন্তর্ভুক্ত নেই। এই লাইন আইটেমটির ধরনের জন্য আপনাকে আপনার চ্যানেল, সাইটলিস্ট বা অ্যাপস টার্গেটিং-এ মোবাইল অ্যাপ অন্তর্ভুক্ত করতে হবে। লাইন আইটেমটি রান হবে না।
APP_INVENTORY_INVALID_AUDIENCE_LISTS এই লাইন আইটেমটি কোনো মোবাইল ব্যবহারকারীকে টার্গেট করছে না। এই লাইন আইটেমটির ধরনের জন্য আপনাকে মোবাইল ব্যবহারকারীদের একটি তালিকা টার্গেট করতে হবে। লাইন আইটেমটি রান হবে না।
NO_VALID_CREATIVE এই লাইন আইটেমটিতে কোনো বৈধ ক্রিয়েটিভ নেই। লাইন আইটেমটি রান হবে না।
PARENT_INSERTION_ORDER_PAUSED এই লাইন আইটেমটির সন্নিবেশ ক্রম স্থগিত করা হয়েছে। লাইন আইটেমটি রান হবে না।
PARENT_INSERTION_ORDER_EXPIRED এই লাইন আইটেমটির সন্নিবেশ ক্রমের শেষ তারিখ অতীতে সেট করা আছে। লাইন আইটেমটি রান হবে না।

মোবাইল অ্যাপ

একটি মোবাইল অ্যাপ ইনস্টল লাইন আইটেম দ্বারা প্রচারিত একটি মোবাইল অ্যাপ।

JSON উপস্থাপনা
{
  "appId": string,
  "platform": enum (Platform),
  "displayName": string,
  "publisher": string
}
ক্ষেত্র
appId

string

প্রয়োজনীয়। প্ল্যাটফর্ম স্টোর কর্তৃক প্রদত্ত অ্যাপটির আইডি।

অ্যান্ড্রয়েড অ্যাপগুলো অ্যান্ড্রয়েডের প্লে স্টোর দ্বারা ব্যবহৃত বান্ডেল আইডি দিয়ে শনাক্ত করা হয়, যেমন com.google.android.gm

iOS অ্যাপগুলোকে অ্যাপলের অ্যাপ স্টোর দ্বারা ব্যবহৃত একটি নয়-অঙ্কের অ্যাপ আইডি দিয়ে শনাক্ত করা হয়, যেমন 422689480

platform

enum ( Platform )

শুধুমাত্র আউটপুট। অ্যাপ প্ল্যাটফর্ম।

displayName

string

শুধুমাত্র আউটপুট। অ্যাপটির নাম।

publisher

string

শুধুমাত্র আউটপুট। অ্যাপ প্রকাশক।

প্ল্যাটফর্ম

সম্ভাব্য মোবাইল অ্যাপ প্ল্যাটফর্মগুলো।

এনাম
PLATFORM_UNSPECIFIED প্ল্যাটফর্ম নির্দিষ্ট করা নেই।
IOS আইওএস প্ল্যাটফর্ম।
ANDROID অ্যান্ড্রয়েড প্ল্যাটফর্ম।

ইউটিউব এবং অংশীদারদের সেটিংস

ইউটিউব এবং পার্টনার লাইন আইটেমগুলোর জন্য সেটিংস।

JSON উপস্থাপনা
{
  "viewFrequencyCap": {
    object (FrequencyCap)
  },
  "thirdPartyMeasurementConfigs": {
    object (ThirdPartyMeasurementConfigs)
  },
  "inventorySourceSettings": {
    object (YoutubeAndPartnersInventorySourceConfig)
  },
  "contentCategory": enum (YoutubeAndPartnersContentCategory),
  "effectiveContentCategory": enum (YoutubeAndPartnersContentCategory),
  "targetFrequency": {
    object (TargetFrequency)
  },
  "linkedMerchantId": string,
  "relatedVideoIds": [
    string
  ],
  "leadFormId": string,
  "videoAdSequenceSettings": {
    object (VideoAdSequenceSettings)
  },
  "videoAdInventoryControl": {
    object (VideoAdInventoryControl)
  }
}
ক্ষেত্র
viewFrequencyCap

object ( FrequencyCap )

লাইন আইটেমটির ফ্রিকোয়েন্সি সর্বোচ্চ সীমা সেটিংস দেখুন।

সীমিত সীমা নির্ধারণ করতে হলে এই সেটিংস অবজেক্টের maxViews ফিল্ডটি অবশ্যই ব্যবহার করতে হবে।

thirdPartyMeasurementConfigs

object ( ThirdPartyMeasurementConfigs )

ঐচ্ছিক। লাইন আইটেমটির তৃতীয়-পক্ষের পরিমাপ কনফিগারেশন।

inventorySourceSettings

object ( YoutubeAndPartnersInventorySourceConfig )

এই সেটিংসগুলো নিয়ন্ত্রণ করে যে লাইন আইটেমটি ইউটিউব এবং পার্টনারদের কোন ইনভেন্টরিগুলোকে টার্গেট করবে।

contentCategory

enum ( YoutubeAndPartnersContentCategory )

শুধুমাত্র আউটপুট। যে ধরনের কন্টেন্টের ওপর ইউটিউব এবং পার্টনারদের বিজ্ঞাপন দেখানো হবে।

effectiveContentCategory

enum ( YoutubeAndPartnersContentCategory )

শুধুমাত্র আউটপুট। লাইন আইটেমটি পরিবেশন করার সময় যে কন্টেন্ট ক্যাটাগরিটি কার্যকর হয়। যখন লাইন আইটেম এবং বিজ্ঞাপনদাতা উভয় ক্ষেত্রেই কন্টেন্ট ক্যাটাগরি সেট করা থাকে, তখন লাইন আইটেমটি পরিবেশন করার সময় কঠোরতরটি কার্যকর হবে।

নতুন লাইন আইটেমগুলো শুধুমাত্র বিজ্ঞাপনদাতা স্তরের সেটিং গ্রহণ করবে।

targetFrequency

object ( TargetFrequency )

ঐচ্ছিক। একটি নির্দিষ্ট সময়কালে একই ব্যক্তিকে এই আইটেমের বিজ্ঞাপনগুলো গড়ে কতবার দেখানো হবে।

linkedMerchantId

string ( int64 format)

ঐচ্ছিক। প্রোডাক্ট ফিড প্রদানের জন্য ব্যবহৃত মার্চেন্ট সেন্টার অ্যাকাউন্টের আইডি।

এই মার্চেন্ট সেন্টার অ্যাকাউন্টটি অবশ্যই বিজ্ঞাপনদাতার সাথে আগে থেকেই সংযুক্ত থাকতে হবে।

relatedVideoIds[]

string

ঐচ্ছিক। মোবাইল ডিভাইসে ইউটিউব অ্যাপে বিজ্ঞাপনটি চলার সময়, মূল ভিডিও বিজ্ঞাপনের নিচে ভিডিওগুলোর আইডি দেখা যায়।

leadFormId

string ( int64 format)

ঐচ্ছিক। লিড তৈরির ফর্মটির আইডি।

videoAdSequenceSettings

object ( VideoAdSequenceSettings )

ঐচ্ছিক। VideoAdSequence সম্পর্কিত সেটিংস।

videoAdInventoryControl

object ( VideoAdInventoryControl )

ঐচ্ছিক। এই লাইন আইটেমের জন্য কোন ইনভেন্টরি অনুমোদিত হবে তা নিয়ন্ত্রণ করার সেটিংস।

থার্ডপার্টিমেজারমেন্টকনফিগস

এমন সেটিংস যা নিয়ন্ত্রণ করে যে তৃতীয় পক্ষের বিক্রেতারা নির্দিষ্ট লাইন আইটেম মেট্রিকগুলো কী পরিমাপ করছে।

JSON উপস্থাপনা
{
  "viewabilityVendorConfigs": [
    {
      object (ThirdPartyVendorConfig)
    }
  ],
  "brandSafetyVendorConfigs": [
    {
      object (ThirdPartyVendorConfig)
    }
  ],
  "reachVendorConfigs": [
    {
      object (ThirdPartyVendorConfig)
    }
  ],
  "brandLiftVendorConfigs": [
    {
      object (ThirdPartyVendorConfig)
    }
  ]
}
ক্ষেত্র
viewabilityVendorConfigs[]

object ( ThirdPartyVendorConfig )

ঐচ্ছিক। তৃতীয় পক্ষের বিক্রেতারা দর্শনযোগ্যতা পরিমাপ করছে।

নিম্নলিখিত তৃতীয় পক্ষের বিক্রেতারা প্রযোজ্য:

  • THIRD_PARTY_VENDOR_MOAT
  • THIRD_PARTY_VENDOR_DOUBLE_VERIFY
  • THIRD_PARTY_VENDOR_INTEGRAL_AD_SCIENCE
  • THIRD_PARTY_VENDOR_COMSCORE
  • THIRD_PARTY_VENDOR_TELEMETRY
  • THIRD_PARTY_VENDOR_MEETRICS
brandSafetyVendorConfigs[]

object ( ThirdPartyVendorConfig )

ঐচ্ছিক। ব্র্যান্ডের নিরাপত্তা পরিমাপকারী তৃতীয় পক্ষের বিক্রেতারা।

নিম্নলিখিত তৃতীয় পক্ষের বিক্রেতারা প্রযোজ্য:

  • THIRD_PARTY_VENDOR_ZEFR
  • THIRD_PARTY_VENDOR_DOUBLE_VERIFY
  • THIRD_PARTY_VENDOR_INTEGRAL_AD_SCIENCE
reachVendorConfigs[]

object ( ThirdPartyVendorConfig )

ঐচ্ছিক। তৃতীয় পক্ষের বিক্রেতারা প্রচারের পরিধি পরিমাপ করছে।

নিম্নলিখিত তৃতীয় পক্ষের বিক্রেতারা প্রযোজ্য:

  • THIRD_PARTY_VENDOR_NIELSEN
  • THIRD_PARTY_VENDOR_COMSCORE
  • THIRD_PARTY_VENDOR_KANTAR
  • THIRD_PARTY_VENDOR_VIDEO_RESEARCH
  • THIRD_PARTY_VENDOR_MEDIA_SCOPE
  • THIRD_PARTY_VENDOR_AUDIENCE_PROJECT
  • THIRD_PARTY_VENDOR_VIDEO_AMP
  • THIRD_PARTY_VENDOR_ISPOT_TV
  • THIRD_PARTY_VENDOR_GEMIUS
brandLiftVendorConfigs[]

object ( ThirdPartyVendorConfig )

ঐচ্ছিক। তৃতীয় পক্ষের বিক্রেতারা ব্র্যান্ড লিফট পরিমাপ করছে।

নিম্নলিখিত তৃতীয় পক্ষের বিক্রেতারা প্রযোজ্য:

  • THIRD_PARTY_VENDOR_DYNATA
  • THIRD_PARTY_VENDOR_KANTAR
  • THIRD_PARTY_VENDOR_INTAGE
  • THIRD_PARTY_VENDOR_NIELSEN
  • THIRD_PARTY_VENDOR_MACROMILL

থার্ডপার্টিভেন্ডরকনফিগ

যে সেটিংসগুলো নিয়ন্ত্রণ করে তৃতীয় পক্ষের পরিমাপ বিক্রেতাদের কীভাবে কনফিগার করা হবে।

JSON উপস্থাপনা
{
  "vendor": enum (ThirdPartyVendor),
  "placementId": string
}
ক্ষেত্র
vendor

enum ( ThirdPartyVendor )

তৃতীয় পক্ষের পরিমাপ সরবরাহকারী।

placementId

string

লাইন আইটেমটি শনাক্ত করার জন্য তৃতীয় পক্ষের বিক্রেতার প্ল্যাটফর্ম কর্তৃক ব্যবহৃত আইডি।

তৃতীয় পক্ষের বিক্রেতা

যেসব বিক্রেতা তৃতীয় পক্ষের মাধ্যমে পরিমাপ সম্পাদন করে।

এনাম
THIRD_PARTY_VENDOR_UNSPECIFIED অজ্ঞাত তৃতীয় পক্ষের বিক্রেতা।
THIRD_PARTY_VENDOR_MOAT পরিখা।
THIRD_PARTY_VENDOR_DOUBLE_VERIFY ডাবলভেরিফাই।
THIRD_PARTY_VENDOR_INTEGRAL_AD_SCIENCE ইন্টিগ্রাল অ্যাড সায়েন্স।
THIRD_PARTY_VENDOR_COMSCORE কমস্কোর।
THIRD_PARTY_VENDOR_TELEMETRY টেলিমেট্রি।
THIRD_PARTY_VENDOR_MEETRICS মিট্রিক্স।
THIRD_PARTY_VENDOR_ZEFR জেফর।
THIRD_PARTY_VENDOR_NIELSEN নিলসেন।
THIRD_PARTY_VENDOR_KANTAR কান্টার।
THIRD_PARTY_VENDOR_DYNATA ডাইনাটা।
THIRD_PARTY_VENDOR_TRANSUNION ট্রান্সইউনিয়ন।
THIRD_PARTY_VENDOR_ORIGIN উৎপত্তি।
THIRD_PARTY_VENDOR_GEMIUS জেমিয়াস।
THIRD_PARTY_VENDOR_MEDIA_SCOPE মিডিয়াস্কোপ।
THIRD_PARTY_VENDOR_AUDIENCE_PROJECT দর্শক প্রকল্প।
THIRD_PARTY_VENDOR_VIDEO_AMP ভিডিও অ্যাম্প।
THIRD_PARTY_VENDOR_ISPOT_TV আইস্পট টিভি।
THIRD_PARTY_VENDOR_INTAGE ইনটেজ।
THIRD_PARTY_VENDOR_MACROMILL ম্যাক্রোমিল।
THIRD_PARTY_VENDOR_VIDEO_RESEARCH ভিডিও গবেষণা।

ইউটিউব এবং অংশীদারদের ইনভেন্টরি সোর্স কনফিগারেশন

এই সেটিংসগুলো নিয়ন্ত্রণ করে যে, 'YouTube and Partners' লাইন আইটেমটি YouTube সম্পর্কিত কোন ইনভেন্টরিগুলোকে টার্গেট করবে।

JSON উপস্থাপনা
{
  "includeYoutube": boolean,
  "includeGoogleTv": boolean,
  "includeYoutubeVideoPartners": boolean
}
ক্ষেত্র
includeYoutube

boolean

ঐচ্ছিক। ইউটিউবে ইনভেন্টরি টার্গেট করা হবে কিনা। এর মধ্যে সার্চ, চ্যানেল এবং ভিডিও উভয়ই অন্তর্ভুক্ত।

includeGoogleTv

boolean

ঐচ্ছিক। গুগল টিভির সাথে উপলব্ধ ভিডিও অ্যাপগুলিতে ইনভেন্টরি টার্গেট করা হবে কিনা।

includeYoutubeVideoPartners

boolean

ইউটিউবের মতো একই ব্র্যান্ড সুরক্ষা মান অনুসরণকারী সহযোগী সাইট এবং অ্যাপের একটি সংগ্রহে ইনভেন্টরি টার্গেট করা হবে কিনা।

ইউটিউব এবং অংশীদারদের বিষয়বস্তু বিভাগ

ইউটিউব এবং পার্টনারদের কন্টেন্টের জন্য ব্র্যান্ড সুরক্ষা বিভাগসমূহ।

এনাম
YOUTUBE_AND_PARTNERS_CONTENT_CATEGORY_UNSPECIFIED এই সংস্করণে বিষয়বস্তুর বিভাগ নির্দিষ্ট করা নেই বা অজানা।
YOUTUBE_AND_PARTNERS_CONTENT_CATEGORY_STANDARD এমন একটি বিভাগ যেখানে বেশিরভাগ ব্র্যান্ডের জন্য উপযুক্ত বিভিন্ন ধরনের কন্টেন্ট রয়েছে। এই কন্টেন্টগুলো ইউটিউবের বিজ্ঞাপন-বান্ধব নির্দেশিকার উপর ভিত্তি করে তৈরি।
YOUTUBE_AND_PARTNERS_CONTENT_CATEGORY_EXPANDED একটি বিভাগ যার মধ্যে ইউটিউব এবং ভিডিও পার্টনারদের সমস্ত কন্টেন্ট অন্তর্ভুক্ত, যা মনিটাইজেশনের মানদণ্ড পূরণ করে।
YOUTUBE_AND_PARTNERS_CONTENT_CATEGORY_LIMITED এমন একটি বিভাগ যেখানে সীমিত পরিসরের বিষয়বস্তু থাকে যা কঠোরতর শর্ত পূরণ করে, বিশেষ করে অনুপযুক্ত ভাষা এবং যৌন ইঙ্গিতপূর্ণতার ক্ষেত্রে।

টার্গেটফ্রিকোয়েন্সি

এমন একটি সেটিং যা নিয়ন্ত্রণ করে যে একটি নির্দিষ্ট সময়কালে একই ব্যক্তিকে গড়ে কতবার বিজ্ঞাপন দেখানো হবে।

JSON উপস্থাপনা
{
  "targetCount": string,
  "timeUnit": enum (TimeUnit),
  "timeUnitCount": integer
}
ক্ষেত্র
targetCount

string ( int64 format)

timeUnit এবং timeUnitCount দ্বারা নির্ধারিত সময়সীমার মধ্যে, গড়ে যতবার একই ব্যক্তিকে বিজ্ঞাপনগুলো দেখানো হবে, তার লক্ষ্যমাত্রা।

timeUnit

enum ( TimeUnit )

সময়ের সেই একক, যেটিতে লক্ষ্যমাত্রা কম্পাঙ্ক প্রয়োগ করা হবে।

নিম্নলিখিত সময় এককটি প্রযোজ্য:

  • TIME_UNIT_WEEKS
timeUnitCount

integer

লক্ষ্য ফ্রিকোয়েন্সিটি কত timeUnit স্থায়ী হবে।

timeUnit এর মানের উপর ভিত্তি করে নিম্নলিখিত বিধিনিষেধগুলি প্রযোজ্য:

  • TIME_UNIT_WEEKS - অবশ্যই ১ হতে হবে

ভিডিও বিজ্ঞাপন ক্রম সেটিংস

VideoAdSequence সম্পর্কিত সেটিংস।

JSON উপস্থাপনা
{
  "minimumDuration": enum (VideoAdSequenceMinimumDuration),
  "steps": [
    {
      object (VideoAdSequenceStep)
    }
  ]
}
ক্ষেত্র
minimumDuration

enum ( VideoAdSequenceMinimumDuration )

একই ব্যবহারকারীর এই ক্রমটি পুনরায় দেখার আগে ন্যূনতম সময় ব্যবধান।

steps[]

object ( VideoAdSequenceStep )

যে ধাপগুলো নিয়ে অনুক্রমটি গঠিত।

VideoAdSequence ন্যূনতম সময়কাল

একই ব্যবহারকারী পুনরায় VideoAdSequence দেখার আগে সম্ভাব্য সর্বনিম্ন বিরতির সময়ের জন্য ব্যবহৃত এনাম।

এনাম
VIDEO_AD_SEQUENCE_MINIMUM_DURATION_UNSPECIFIED অনির্দিষ্ট বা অজানা।
VIDEO_AD_SEQUENCE_MINIMUM_DURATION_WEEK ৭ দিন।
VIDEO_AD_SEQUENCE_MINIMUM_DURATION_MONTH ৩০ দিন।

ভিডিও বিজ্ঞাপন ক্রম ধাপ

একটি VideoAdSequence-এর একটি ধাপের বিস্তারিত বিবরণ।

JSON উপস্থাপনা
{
  "stepId": string,
  "adGroupId": string,
  "previousStepId": string,
  "interactionType": enum (InteractionType)
}
ক্ষেত্র
stepId

string ( int64 format)

ধাপটির আইডি।

adGroupId

string ( int64 format)

ধাপটির সংশ্লিষ্ট বিজ্ঞাপন গ্রুপের আইডি।

previousStepId

string ( int64 format)

পূর্ববর্তী ধাপের আইডি। প্রথম ধাপের কোনো পূর্ববর্তী ধাপ নেই।

interactionType

enum ( InteractionType )

পূর্ববর্তী ধাপের সেই ইন্টারঅ্যাকশন যা দর্শককে এই ধাপে নিয়ে আসবে। প্রথম ধাপটির কোনো ইন্টারঅ্যাকশনটাইপ (interactionType) নেই।

মিথস্ক্রিয়ার ধরণ

একটি ধাপে মিথস্ক্রিয়ার প্রকারভেদ।

এনাম
INTERACTION_TYPE_UNSPECIFIED অনির্দিষ্ট বা অজানা
INTERACTION_TYPE_PAID_VIEW অর্থের বিনিময়ে দেখার সুযোগ।
INTERACTION_TYPE_SKIP দর্শক কর্তৃক উপেক্ষিত।
INTERACTION_TYPE_IMPRESSION একটি (দেখা) বিজ্ঞাপন ইম্প্রেশন।
INTERACTION_TYPE_ENGAGED_IMPRESSION এমন একটি বিজ্ঞাপন যা দর্শক তাৎক্ষণিকভাবে এড়িয়ে যাননি, কিন্তু বিলযোগ্য ইভেন্টেও পৌঁছায়নি।

ভিডিও বিজ্ঞাপন ইনভেন্টরি নিয়ন্ত্রণ

নির্দিষ্ট কিছু ইউটিউব লাইন আইটেম টাইপে ব্যবহৃত ভিডিও বিজ্ঞাপন ইনভেন্টরি নিয়ন্ত্রণ।

JSON উপস্থাপনা
{
  "allowInStream": boolean,
  "allowInFeed": boolean,
  "allowShorts": boolean
}
ক্ষেত্র
allowInStream

boolean

ঐচ্ছিক। বিজ্ঞাপনগুলো ইন-স্ট্রিম ফরম্যাট হিসেবে প্রদর্শিত হতে পারবে কিনা।

allowInFeed

boolean

ঐচ্ছিক। বিজ্ঞাপনগুলো ইন-ফিড ফরম্যাট হিসেবে প্রদর্শিত হতে পারবে কিনা।

allowShorts

boolean

ঐচ্ছিক। বিজ্ঞাপনগুলো শর্টস ফরম্যাটে পরিবেশন করা যাবে কিনা।

ডিমান্ডজেনসেটিংস

ডিমান্ড জেন লাইন আইটেমগুলির জন্য সেটিংস।

JSON উপস্থাপনা
{
  "thirdPartyMeasurementConfigs": {
    object (ThirdPartyMeasurementConfigs)
  },
  "linkedMerchantId": string,
  "geoLanguageTargetingEnabled": boolean
}
ক্ষেত্র
thirdPartyMeasurementConfigs

object ( ThirdPartyMeasurementConfigs )

ঐচ্ছিক। ডিমান্ড জেন লাইন আইটেমের জন্য তৃতীয় পক্ষের পরিমাপ সেটিংস।

linkedMerchantId

string ( int64 format)

ঐচ্ছিক। প্রোডাক্ট ফিড প্রদানের জন্য ব্যবহৃত মার্চেন্ট সেন্টার অ্যাকাউন্টের আইডি।

এই মার্চেন্ট সেন্টার অ্যাকাউন্টটি অবশ্যই বিজ্ঞাপনদাতার সাথে আগে থেকেই সংযুক্ত থাকতে হবে।

geoLanguageTargetingEnabled

boolean

ঐচ্ছিক। অপরিবর্তনীয়। লাইন আইটেম স্তরে অবস্থান এবং ভাষা টার্গেটিং সেট করা যাবে কিনা। অন্যথায়, প্রাসঙ্গিক টার্গেটিং প্রকারগুলি সরাসরি অ্যাড গ্রুপগুলিতে বরাদ্দ করতে হবে।

পদ্ধতি

bulkEditAssignedTargetingOptions

একাধিক লাইন আইটেমের অধীনে বাল্ক এডিট টার্গেটিং অপশন।

bulkListAssignedTargetingOptions

বিভিন্ন টার্গেটিং টাইপ জুড়ে একাধিক লাইন আইটেমের জন্য নির্ধারিত টার্গেটিং অপশনগুলির তালিকা দেখায়।

bulkUpdate

একাধিক লাইন আইটেম আপডেট করে।

create

একটি নতুন লাইন আইটেম তৈরি করে।

delete

একটি লাইন আইটেম মুছে দেয়।

duplicate

একটি লাইন আইটেমের প্রতিলিপি তৈরি করে।

get

একটি আলাদা আইটেম পায়।

list

বিজ্ঞাপনদাতার আইটেমগুলো তালিকাভুক্ত করে।

patch

বিদ্যমান একটি লাইন আইটেম আপডেট করে।