REST Resource: advertisers.lineItems

রিসোর্স: LineItem

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

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)

ঐচ্ছিক। YouTube ও পার্টনার লাইন আইটেমের জন্য নির্দিষ্ট সেটিংস।

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-এ সেট করা থাকলে, এই অপ্টিমাইজেশন বন্ধ করা থাকে এবং কোনও কারণেই বিড কমানো হবে না।

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

LineItemType

লাইন আইটেমের সম্ভাব্য ধরন।

লাইন আইটেমের ধরন নির্ধারণ করে যে কোন সেটিংস এবং বিকল্প প্রযোজ্য, যেমন বিজ্ঞাপনের ফর্ম্যাট বা টার্গেটিং বিকল্প।

Enums
LINE_ITEM_TYPE_UNSPECIFIED

এই ভার্সনে টাইপ ভ্যালু উল্লেখ করা নেই বা অজানা।

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

LINE_ITEM_TYPE_DISPLAY_DEFAULT ছবি, HTML5, নেটিভ বা রিচ মিডিয়া বিজ্ঞাপন।
LINE_ITEM_TYPE_DISPLAY_MOBILE_APP_INSTALL অ্যাপ ইনস্টল করার জন্য উৎসাহিত করে এমন বিজ্ঞাপন দেখান।
LINE_ITEM_TYPE_VIDEO_DEFAULT বিভিন্ন এনভায়রনমেন্টের জন্য CPM-এর ভিত্তিতে ভিডিও বিজ্ঞাপন বিক্রি করা হয়।
LINE_ITEM_TYPE_VIDEO_MOBILE_APP_INSTALL ভিডিও বিজ্ঞাপন যা কোনও অ্যাপ ইনস্টল করতে সাহায্য করে।
LINE_ITEM_TYPE_DISPLAY_MOBILE_APP_INVENTORY

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

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

LINE_ITEM_TYPE_VIDEO_MOBILE_APP_INVENTORY

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

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

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

YouTube ভিডিও বিজ্ঞাপন যা কনভার্সন প্রচার করে।

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

LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE

YouTube ভিডিও বিজ্ঞাপন (১৫ সেকেন্ড পর্যন্ত) যা স্কিপ করা যায় না।

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

LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_VIDEO_SEQUENCE

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

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

LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_AUDIO

YouTube অডিও বিজ্ঞাপন।

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

LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_REACH

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

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

LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_SIMPLE

ডিফল্ট YouTube ভিডিও বিজ্ঞাপন।

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

LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE_OVER_THE_TOP

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

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

LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_REACH_OVER_THE_TOP

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

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

LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_SIMPLE_OVER_THE_TOP

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

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

LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_TARGET_FREQUENCY

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

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

LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_VIEW

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

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

LINE_ITEM_TYPE_DISPLAY_OUT_OF_HOME

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

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

LINE_ITEM_TYPE_VIDEO_OUT_OF_HOME

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

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

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

LineItemFlight

লাইন আইটেম কতক্ষণ অ্যাক্টিভ থাকবে তা নিয়ন্ত্রণ করার সেটিংস।

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 বা তার পরের হতে হবে, দুটিই ২০৩৭ সালের আগের হতে হবে।

LineItemFlightDateType

লাইন আইটেমের ফ্লাইট তারিখের সম্ভাব্য ধরন।

Enums
LINE_ITEM_FLIGHT_DATE_TYPE_UNSPECIFIED এই ভার্সনে টাইপ ভ্যালু উল্লেখ করা নেই বা অজানা।
LINE_ITEM_FLIGHT_DATE_TYPE_INHERITED লাইন আইটেমের ফ্লাইট তারিখ তার পেরেন্ট ইনসার্শন অর্ডার থেকে নেওয়া হয়েছে।
LINE_ITEM_FLIGHT_DATE_TYPE_CUSTOM লাইন আইটেমটি নিজস্ব কাস্টম ফ্লাইট তারিখ ব্যবহার করে।

LineItemBudget

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

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 বলতে কারেন্সির 1.5 স্ট্যান্ডার্ড ইউনিট বোঝায়।
    • BUDGET_UNIT_IMPRESSIONS, এই ফিল্ডে সর্বাধিক কতগুলি ইম্প্রেশন দেখানো হবে তা উল্লেখ করা হয়।
  • LINE_ITEM_BUDGET_ALLOCATION_TYPE_UNLIMITED, এই ফিল্ড প্রযোজ্য নয় এবং সিস্টেম এটি উপেক্ষা করবে।

LineItemBudgetAllocationType

বাজেট বরাদ্দের সম্ভাব্য ধরন।

Enums
LINE_ITEM_BUDGET_ALLOCATION_TYPE_UNSPECIFIED এই ভার্সনে টাইপ ভ্যালু উল্লেখ করা নেই বা অজানা।
LINE_ITEM_BUDGET_ALLOCATION_TYPE_AUTOMATIC লাইন আইটেমের জন্য অটোমেটিক বাজেট অ্যালোকেশন চালু করা আছে।
LINE_ITEM_BUDGET_ALLOCATION_TYPE_FIXED লাইন আইটেমের জন্য একটি নির্দিষ্ট সর্বাধিক বাজেটের পরিমাণ বরাদ্দ করা হয়েছে।
LINE_ITEM_BUDGET_ALLOCATION_TYPE_UNLIMITED লাইন আইটেমে কোনও বাজেট সীমা প্রয়োগ করা হয়নি।

PartnerRevenueModel

পার্টনারের উপার্জন কীভাবে গণনা করা হয় তা নিয়ন্ত্রণ করার সেটিংস।

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 বলতে কারেন্সির 1.5 স্ট্যান্ডার্ড ইউনিট বোঝায়।
  • markupType-এর ভ্যালু PARTNER_REVENUE_MODEL_MARKUP_TYPE_MEDIA_COST_MARKUP হিসেবে সেট করা হলে, এই ফিল্ডে মিডিয়া খরচের শতাংশের মার্কআপ মিলিতে দেখানো হয়। যেমন, ১০০ মানে ০.১% (দশমিক ০.০০১)।
  • markupType-এর মান PARTNER_REVENUE_MODEL_MARKUP_TYPE_TOTAL_MEDIA_COST_MARKUP হিসেবে সেট করা হলে, এই ফিল্ডে মিলিতে মোট মিডিয়া খরচের শতাংশ মার্কআপ দেখানো হয়। যেমন, ১০০ মানে ০.১% (দশমিক ০.০০১)।

PartnerRevenueModelMarkupType

পার্টনারের উপার্জনের মডেলের সম্ভাব্য মার্কআপের ধরন।

Enums
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 পার্টনারের মোট মিডিয়া খরচের সারচার্জের শতাংশের ভিত্তিতে পার্টনারের উপার্জন হিসেব করুন, যার মধ্যে পার্টনারের সব খরচ ও ডেটা খরচ অন্তর্ভুক্ত থাকে।

ConversionCountingConfig

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

ক্লিক-পরবর্তী সব কনভার্সন গণনা করা হবে। পোস্ট-ভিউ কনভার্সন গণনার জন্য শতাংশের মান সেট করা যেতে পারে।

JSON উপস্থাপনা
{
  "postViewCountPercentageMillis": string,
  "floodlightActivityConfigs": [
    {
      object (TrackingFloodlightActivityConfig)
    }
  ],
  "primaryAttributionModelId": string
}
ফিল্ড
postViewCountPercentageMillis

string (int64 format)

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

যেমন, ক্লিক-পরবর্তী কনভার্সনের ৫০% ট্র্যাক করতে, ৫০,০০০ ভ্যালু সেট করুন।

floodlightActivityConfigs[]

object (TrackingFloodlightActivityConfig)

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

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

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

primaryAttributionModelId

string (int64 format)

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

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

TrackingFloodlightActivityConfig

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

JSON উপস্থাপনা
{
  "floodlightActivityId": string,
  "postClickLookbackWindowDays": integer,
  "postViewLookbackWindowDays": integer
}
ফিল্ড
floodlightActivityId

string (int64 format)

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

postClickLookbackWindowDays

integer

প্রয়োজনীয়। বিজ্ঞাপনে ক্লিক করার কত দিন পরে কনভার্সন গণনা করা হতে পারে। ০ থেকে ৯০-এর মধ্যে হতে হবে।

postViewLookbackWindowDays

integer

প্রয়োজনীয়। কোনও বিজ্ঞাপন দেখার কত দিন পরে কনভার্সন গণনা করা হতে পারে। ০ থেকে ৯০-এর মধ্যে হতে হবে।

LineItemWarningMessage

লাইন আইটেম দ্বারা জেনারেট করা সতর্কতামূলক মেসেজ। এই ধরনের সতর্কতা লাইন আইটেম সেভ করা ব্লক করে না, তবে লাইন আইটেম রান করা ব্লক করতে পারে।

Enums
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 এই লাইন আইটেমের ইনসার্শন অর্ডারের শেষ হওয়ার তারিখ অতীতে সেট করা আছে। লাইন আইটেমটি চলবে না।

MobileApp

মোবাইল অ্যাপ ইনস্টল লাইন আইটেমের মাধ্যমে প্রোমোট করা মোবাইল অ্যাপ।

JSON উপস্থাপনা
{
  "appId": string,
  "platform": enum (Platform),
  "displayName": string,
  "publisher": string
}
ফিল্ড
appId

string

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

Android অ্যাপকে Android-এর Play Store-এর ব্যবহার করা বান্ডিল আইডি দ্বারা শনাক্ত করা হয়, যেমন com.google.android.gm।

iOS অ্যাপ নয় সংখ্যার অ্যাপ আইডি দ্বারা শনাক্ত করা হয় যা Apple-এর অ্যাপ স্টোর ব্যবহার করে, যেমন 422689480।

platform

enum (Platform)

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

displayName

string

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

publisher

string

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

প্ল্যাটফর্ম

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

Enums
PLATFORM_UNSPECIFIED প্ল্যাটফর্ম নির্দিষ্ট করা হয়নি।
IOS iOS প্ল্যাটফর্ম।
ANDROID Android প্ল্যাটফর্ম।

YoutubeAndPartnersSettings

YouTube ও পার্টনার লাইন আইটেমের জন্য সেটিংস।

JSON উপস্থাপনা
{
  "viewFrequencyCap": {
    object (FrequencyCap)
  },
  "thirdPartyMeasurementConfigs": {
    object (ThirdPartyMeasurementConfigs)
  },
  "inventorySourceSettings": {
    object (YoutubeAndPartnersInventorySourceConfig)
  },
  "contentCategory": enum (YoutubeAndPartnersContentCategory),
  "effectiveContentCategory": enum (YoutubeAndPartnersContentCategory),
  "targetFrequency": {
    object (TargetFrequency)
  },
  "linkedMerchantId": string,
  "relatedVideos": [
    {
      object (RelatedVideo)
    }
  ],
  "leadFormId": string,
  "videoAdSequenceSettings": {
    object (VideoAdSequenceSettings)
  },
  "videoAdInventoryControl": {
    object (VideoAdInventoryControl)
  }
}
ফিল্ড
viewFrequencyCap

object (FrequencyCap)

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

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

thirdPartyMeasurementConfigs

object (ThirdPartyMeasurementConfigs)

ঐচ্ছিক। লাইন আইটেমের থার্ড-পার্টি মেজারমেন্ট কনফিগারেশন।

inventorySourceSettings

object (YoutubeAndPartnersInventorySourceConfig)

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

contentCategory

enum (YoutubeAndPartnersContentCategory)

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

effectiveContentCategory

enum (YoutubeAndPartnersContentCategory)

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

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

targetFrequency

object (TargetFrequency)

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

linkedMerchantId

string (int64 format)

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

এই Merchant Center অ্যাকাউন্টটি আগে থেকেই বিজ্ঞাপনদাতার সাথে লিঙ্ক করা থাকতে হবে।

relatedVideos[]

object (RelatedVideo)

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

leadFormId

string (int64 format)

ঐচ্ছিক। লিড জেনারেট করার জন্য ফর্মের আইডি।

videoAdSequenceSettings

object (VideoAdSequenceSettings)

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

videoAdInventoryControl

object (VideoAdInventoryControl)

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

ThirdPartyMeasurementConfigs

কোন থার্ড-পার্টি ভেন্ডর নির্দিষ্ট লাইন আইটেম মেট্রিক পরিমাপ করছে তা নিয়ন্ত্রণ করার সেটিংস।

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_MACROMILL

ThirdPartyVendorConfig

থার্ড-পার্টি মেজারমেন্ট ভেন্ডর কীভাবে কনফিগার করা হয় তা নিয়ন্ত্রণ করার সেটিংস।

JSON উপস্থাপনা
{
  "vendor": enum (ThirdPartyVendor),
  "placementId": string
}
ফিল্ড
vendor

enum (ThirdPartyVendor)

থার্ড-পার্টি মেজারমেন্ট ভেন্ডর।

placementId

string

লাইন আইটেম শনাক্ত করার জন্য থার্ড-পার্টি ভেন্ডরের প্ল্যাটফর্মের মাধ্যমে ব্যবহার করা আইডি।

ThirdPartyVendor

থার্ড-পার্টি মেজারমেন্ট করে এমন ভেন্ডর।

Enums
THIRD_PARTY_VENDOR_UNSPECIFIED অজানা থার্ড-পার্টি ভেন্ডর।
THIRD_PARTY_VENDOR_MOAT Moat.
THIRD_PARTY_VENDOR_DOUBLE_VERIFY DoubleVerify.
THIRD_PARTY_VENDOR_INTEGRAL_AD_SCIENCE Integral Ad Science.
THIRD_PARTY_VENDOR_COMSCORE Comscore.
THIRD_PARTY_VENDOR_TELEMETRY টেলিমেট্রি।
THIRD_PARTY_VENDOR_MEETRICS Meetrics.
THIRD_PARTY_VENDOR_ZEFR ZEFR.
THIRD_PARTY_VENDOR_NIELSEN Nielsen.
THIRD_PARTY_VENDOR_KANTAR Kantar.
THIRD_PARTY_VENDOR_DYNATA Dynata.
THIRD_PARTY_VENDOR_TRANSUNION Transunion.
THIRD_PARTY_VENDOR_ORIGIN সূত্র থেকে নেওয়া হয়েছে তা ব্রাউজার বুঝতে পারে।
THIRD_PARTY_VENDOR_GEMIUS Gemius.
THIRD_PARTY_VENDOR_MEDIA_SCOPE MediaScope.
THIRD_PARTY_VENDOR_AUDIENCE_PROJECT Audience Project.
THIRD_PARTY_VENDOR_VIDEO_AMP ভিডিও অ্যাম্প।
THIRD_PARTY_VENDOR_ISPOT_TV Ispot TV.
THIRD_PARTY_VENDOR_INTAGE Intage.
THIRD_PARTY_VENDOR_MACROMILL Macromill.
THIRD_PARTY_VENDOR_VIDEO_RESEARCH ভিডিও রিসার্চ।
THIRD_PARTY_VENDOR_AQUILA Aquila.

YoutubeAndPartnersInventorySourceConfig

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

JSON উপস্থাপনা
{
  "includeYoutube": boolean,
  "includeGoogleTv": boolean,
  "includeYoutubeVideoPartners": boolean
}
ফিল্ড
includeYoutube

boolean

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

includeGoogleTv

boolean

ঐচ্ছিক। Google TV-তে উপলভ্য ভিডিও অ্যাপে ইনভেনটরি টার্গেট করা হবে কিনা।

includeYoutubeVideoPartners

boolean

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

YoutubeAndPartnersContentCategory

YouTube এবং পার্টনার কন্টেন্টের জন্য ব্র্যান্ডের নিরাপত্তা সংক্রান্ত বিভাগ।

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

TargetFrequency

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

JSON উপস্থাপনা
{
  "targetCount": string,
  "timeUnit": enum (TimeUnit),
  "timeUnitCount": integer
}
ফিল্ড
targetCount

string (int64 format)

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

timeUnit

enum (TimeUnit)

সময়ের ইউনিট যেখানে টার্গেট ফ্রিকোয়েন্সি প্রয়োগ করা হবে।

নিম্নলিখিত সময়ের ইউনিট প্রযোজ্য:

  • TIME_UNIT_WEEKS
  • TIME_UNIT_MONTHS
timeUnitCount

integer

টার্গেট ফ্রিকোয়েন্সি যতগুলি timeUnit পর্যন্ত চলবে।

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

  • TIME_UNIT_WEEKS - ১ হতে হবে
  • TIME_UNIT_MONTHS - ১ হতে হবে

RelatedVideo

এই ধরনের ভিডিও এন্ট্রিকে দেখায়।

JSON উপস্থাপনা
{
  "videoId": string,
  "videoAssetId": string
}
ফিল্ড
videoId

string

শুধু আউটপুট। সম্পর্কিত ভিডিওর YouTube ভিডিও আইডি।

videoAssetId

string (int64 format)

প্রয়োজনীয়। YouTube ভিডিওর জন্য AdAsset রিসোর্সের adAssetId।

VideoAdSequenceSettings

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

JSON উপস্থাপনা
{
  "minimumDuration": enum (VideoAdSequenceMinimumDuration),
  "steps": [
    {
      object (VideoAdSequenceStep)
    }
  ]
}
ফিল্ড
minimumDuration

enum (VideoAdSequenceMinimumDuration)

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

steps[]

object (VideoAdSequenceStep)

যেসব ধাপ নিয়ে সিকোয়েন্স তৈরি হয়।

VideoAdSequenceMinimumDuration

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

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

VideoAdSequenceStep

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 নেই।

InteractionType

কোনও ধাপে ইন্টার‍্যাকশনের ধরন।

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

VideoAdInventoryControl

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

JSON উপস্থাপনা
{
  "allowInStream": boolean,
  "allowInFeed": boolean,
  "allowShorts": boolean,
  "allowNonSkippableInStream": boolean
}
ফিল্ড
allowInStream

boolean

ঐচ্ছিক। ইন-স্ট্রিম ফর্ম্যাটে বিজ্ঞাপন দেখানো যাবে কিনা।

allowInFeed

boolean

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

allowShorts

boolean

ঐচ্ছিক। Shorts ফর্ম্যাটে বিজ্ঞাপন দেখানো যাবে কিনা।

allowNonSkippableInStream

boolean

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

DemandGenSettings

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

JSON উপস্থাপনা
{
  "thirdPartyMeasurementConfigs": {
    object (ThirdPartyMeasurementConfigs)
  },
  "linkedMerchantId": string,
  "geoLanguageTargetingEnabled": boolean
}
ফিল্ড
thirdPartyMeasurementConfigs

object (ThirdPartyMeasurementConfigs)

ঐচ্ছিক। ডিমান্ড জেনারেশন লাইন আইটেমের জন্য থার্ড-পার্টি মেজারমেন্ট সেটিংস।

linkedMerchantId

string (int64 format)

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

এই Merchant Center অ্যাকাউন্টটি আগে থেকেই বিজ্ঞাপনদাতার সাথে লিঙ্ক করা থাকতে হবে।

geoLanguageTargetingEnabled

boolean

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

পদ্ধতি

bulkEditAssignedTargetingOptions

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

bulkListAssignedTargetingOptions

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

bulkUpdate

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

create

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

delete

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

duplicate

লাইন আইটেম ডুপ্লিকেট করে।

get

লাইন আইটেম পায়।

list

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

patch

আগে থেকে থাকা লাইন আইটেম আপডেট করে।