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)
  }
}
ক্ষেত্র
name

string

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

advertiser Id

string ( int64 format)

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

campaign Id

string ( int64 format)

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

insertion Order Id

string ( int64 format)

প্রয়োজন। অপরিবর্তনীয়। লাইন আইটেম যে সন্নিবেশ আদেশের অনন্য আইডি।

line Item Id

string ( int64 format)

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

display Name

string

প্রয়োজন। লাইন আইটেমের প্রদর্শনের নাম।

UTF-8 সর্বাধিক 240 বাইটের আকারের সাথে এনকোড করা আবশ্যক৷

line Item Type

enum ( LineItemType )

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

entity Status

enum ( EntityStatus )

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

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

string ( Timestamp format)

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

RFC3339 UTC "জুলু" ফর্ম্যাটে একটি টাইমস্ট্যাম্প, ন্যানোসেকেন্ড রেজোলিউশন এবং নয়টি পর্যন্ত ভগ্নাংশের সংখ্যা। উদাহরণ: "2014-10-02T15:01:23Z" এবং "2014-10-02T15:01:23.045123456Z"

partner Costs[]

object ( PartnerCost )

অংশীদার লাইন আইটেম সঙ্গে যুক্ত খরচ.

lineItems.create পদ্ধতিতে অনুপস্থিত বা খালি থাকলে, নতুন তৈরি লাইন আইটেমটি তার মূল সন্নিবেশ আদেশ থেকে অংশীদারের খরচ উত্তরাধিকারী হবে।

flight

object ( LineItemFlight )

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

budget

object ( LineItemBudget )

প্রয়োজন। লাইন আইটেমের বাজেট বরাদ্দ সেটিং।

pacing

object ( Pacing )

প্রয়োজন। লাইন আইটেমের বাজেট খরচের গতি সেটিং।

frequency Cap

object ( FrequencyCap )

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

এই সেটিংস অবজেক্টের maxImpressions ক্ষেত্রটি ব্যবহার করা আবশ্যক যদি একটি সীমিত ক্যাপ বরাদ্দ করা হয়।

partner Revenue Model

object ( PartnerRevenueModel )

প্রয়োজন। লাইন আইটেমের অংশীদার রাজস্ব মডেল সেটিং।

conversion Counting

object ( ConversionCountingConfig )

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

creative Ids[]

string ( int64 format)

লাইন আইটেমের সাথে যুক্ত ক্রিয়েটিভের আইডি।

bid Strategy

object ( BiddingStrategy )

প্রয়োজন। লাইন আইটেম বিডিং কৌশল.

integration Details

object ( IntegrationDetails )

লাইন আইটেমের ইন্টিগ্রেশন বিশদ।

targeting Expansion

object ( TargetingExpansionConfig )

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

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

warning Messages[]

enum ( LineItemWarningMessage )

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

mobile App

object ( MobileApp )

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

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

reservation Type

enum ( ReservationType )

শুধুমাত্র আউটপুট। লাইন আইটেমের সংরক্ষণের ধরন।

exclude New Exchanges

boolean

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

youtube And Partners Settings

object ( YoutubeAndPartnersSettings )

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

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

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

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

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 ভিডিও বিজ্ঞাপন (15 সেকেন্ড পর্যন্ত) যা এড়িয়ে যাওয়া যাবে না।

এই ধরনের লাইন আইটেম এবং তাদের টার্গেটিং 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

সংযুক্ত টিভি ইউটিউব ভিডিও বিজ্ঞাপন (15 সেকেন্ড পর্যন্ত) যা এড়িয়ে যাওয়া যাবে না।

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

LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_REACH_OVER_THE_TOP

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

এই ধরনের লাইন আইটেম এবং তাদের টার্গেটিং 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

ইউটিউব ভিডিও বিজ্ঞাপন যা বিভিন্ন ধরনের বিজ্ঞাপন বিন্যাসের সাথে আরও ভিউ পাওয়ার লক্ষ্য করে।

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

LINE_ITEM_TYPE_DISPLAY_OUT_OF_HOME

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

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

LINE_ITEM_TYPE_VIDEO_OUT_OF_HOME

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

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

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

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

JSON প্রতিনিধিত্ব
{
  "flightDateType": enum (LineItemFlightDateType),
  "dateRange": {
    object (DateRange)
  }
}
ক্ষেত্র
flight Date Type

enum ( LineItemFlightDateType )

প্রয়োজন। লাইন আইটেমের ফ্লাইটের তারিখের ধরন।

date Range

object ( DateRange )

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

  • যখন flightDateType LINE_ITEM_FLIGHT_DATE_TYPE_CUSTOM হয় তখন প্রয়োজন। আউটপুট শুধুমাত্র অন্যথায়.
  • একটি নতুন ফ্লাইট তৈরি করার সময়, উভয় startDate এবং endDate ভবিষ্যতে হতে হবে।
  • অতীতে একটি startDate সহ একটি বিদ্যমান ফ্লাইটের একটি পরিবর্তনযোগ্য endDate থাকে কিন্তু একটি অপরিবর্তনীয় startDate থাকে।
  • endDate অবশ্যই 2037 সালের আগে 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
}
ক্ষেত্র
budget Allocation Type

enum ( LineItemBudgetAllocationType )

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

LINE_ITEM_BUDGET_ALLOCATION_TYPE_AUTOMATIC শুধুমাত্র তখনই প্রযোজ্য যখন প্যারেন্ট সন্নিবেশ অর্ডারের জন্য স্বয়ংক্রিয় বাজেট বরাদ্দ সক্ষম করা হয়৷

budget Unit

enum ( BudgetUnit )

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

max Amount

string ( int64 format)

লাইন আইটেমটি ব্যয় করবে সর্বোচ্চ বাজেটের পরিমাণ। 0-এর বেশি হতে হবে।

যখন 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 কোন বাজেট সীমা লাইন আইটেম প্রয়োগ করা হয় না.

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

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

JSON প্রতিনিধিত্ব
{
  "markupType": enum (PartnerRevenueModelMarkupType),
  "markupAmount": string
}
ক্ষেত্র
markup Type

enum ( PartnerRevenueModelMarkupType )

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

markup Amount

string ( int64 format)

প্রয়োজন। অংশীদার রাজস্ব মডেলের মার্কআপ পরিমাণ। 0 এর থেকে বড় বা সমান হতে হবে।

  • যখন markupType PARTNER_REVENUE_MODEL_MARKUP_TYPE_CPM হিসাবে সেট করা হয়, তখন এই ক্ষেত্রটি বিজ্ঞাপনদাতার মুদ্রার মাইক্রোতে CPM মার্কআপ উপস্থাপন করে। উদাহরণস্বরূপ, 1500000 মুদ্রার 1.5 স্ট্যান্ডার্ড ইউনিট প্রতিনিধিত্ব করে।
  • যখন markupType PARTNER_REVENUE_MODEL_MARKUP_TYPE_MEDIA_COST_MARKUP হিসাবে সেট করা হয়, তখন এই ক্ষেত্রটি মিলিতে মিডিয়া খরচ শতাংশ মার্কআপ উপস্থাপন করে। উদাহরণস্বরূপ, 100 0.1% (দশমিক 0.001) প্রতিনিধিত্ব করে।
  • যখন markupType PARTNER_REVENUE_MODEL_MARKUP_TYPE_TOTAL_MEDIA_COST_MARKUP হিসাবে সেট করা হয়, তখন এই ক্ষেত্রটি মিলিতে মোট মিডিয়া খরচ শতাংশ মার্কআপ উপস্থাপন করে। উদাহরণস্বরূপ, 100 0.1% (দশমিক 0.001) প্রতিনিধিত্ব করে।

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)
    }
  ]
}
ক্ষেত্র
post View Count Percentage Millis

string ( int64 format)

মিলিতে (শতাংশের 1/1000) গণনা করার জন্য পোস্ট-ভিউ কনভার্সনগুলির শতাংশ। 0 এবং 100000 এর মধ্যে থাকতে হবে।

উদাহরণস্বরূপ, ক্লিক-পরবর্তী রূপান্তরগুলির 50% ট্র্যাক করতে, 50000 এর একটি মান সেট করুন।

floodlight Activity Configs[]

object ( TrackingFloodlightActivityConfig )

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

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

TrackingFloodlightActivityConfig

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

JSON প্রতিনিধিত্ব
{
  "floodlightActivityId": string,
  "postClickLookbackWindowDays": integer,
  "postViewLookbackWindowDays": integer
}
ক্ষেত্র
floodlight Activity Id

string ( int64 format)

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

post Click Lookback Window Days

integer

প্রয়োজন। একটি বিজ্ঞাপনে ক্লিক করার পর যে দিনগুলিতে একটি রূপান্তর গণনা করা যেতে পারে। 0 থেকে 90 এর মধ্যে থাকতে হবে।

post View Lookback Window Days

integer

প্রয়োজন। একটি বিজ্ঞাপন দেখার পর যে দিনগুলিতে একটি রূপান্তর গণনা করা যেতে পারে। 0 থেকে 90 এর মধ্যে থাকতে হবে।

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 এই লাইন আইটেমটির অ্যাপ্লিকেশান এবং URL টার্গেটিং কোনো মোবাইল অ্যাপ অন্তর্ভুক্ত করে না৷ এই লাইন আইটেমের প্রকারের জন্য আপনাকে আপনার চ্যানেল, সাইটলিস্ট বা অ্যাপ্লিকেশান টার্গেটিং-এ মোবাইল অ্যাপ্লিকেশানগুলি অন্তর্ভুক্ত করতে হবে৷ লাইন আইটেম চালানো হবে না.
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
}
ক্ষেত্র
app Id

string

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

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

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

platform

enum ( Platform )

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

display Name

string

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

publisher

string

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

প্ল্যাটফর্ম

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

Enums
PLATFORM_UNSPECIFIED প্ল্যাটফর্ম নির্দিষ্ট করা নেই।
IOS iOS প্ল্যাটফর্ম।
ANDROID অ্যান্ড্রয়েড প্ল্যাটফর্ম।

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

YouTube এবং অংশীদারদের লাইন আইটেমগুলির জন্য সেটিংস৷

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)
  }
}
ক্ষেত্র
view Frequency Cap

object ( FrequencyCap )

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

এই সেটিংস অবজেক্টের maxViews ক্ষেত্রটি ব্যবহার করা আবশ্যক যদি একটি সীমিত ক্যাপ বরাদ্দ করা হয়।

third Party Measurement Configs

object ( ThirdPartyMeasurementConfigs )

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

inventory Source Settings

object ( YoutubeAndPartnersInventorySourceConfig )

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

content Category

enum ( YoutubeAndPartnersContentCategory )

YouTube এবং অংশীদারদের বিজ্ঞাপনগুলি যে ধরনের সামগ্রীতে দেখানো হবে।

effective Content Category

enum ( YoutubeAndPartnersContentCategory )

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

target Frequency

object ( TargetFrequency )

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

linked Merchant Id

string ( int64 format)

ঐচ্ছিক। পণ্য ফিডের জন্য লাইন আইটেমের সাথে লিঙ্ক করা ব্যবসায়ীর আইডি।

related Video Ids[]

string

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

lead Form Id

string ( int64 format)

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

video Ad Sequence Settings

object ( VideoAdSequenceSettings )

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

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

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

JSON প্রতিনিধিত্ব
{
  "viewabilityVendorConfigs": [
    {
      object (ThirdPartyVendorConfig)
    }
  ],
  "brandSafetyVendorConfigs": [
    {
      object (ThirdPartyVendorConfig)
    }
  ],
  "reachVendorConfigs": [
    {
      object (ThirdPartyVendorConfig)
    }
  ],
  "brandLiftVendorConfigs": [
    {
      object (ThirdPartyVendorConfig)
    }
  ]
}
ক্ষেত্র
viewability Vendor Configs[]

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
brand Safety Vendor Configs[]

object ( ThirdPartyVendorConfig )

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

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

  • THIRD_PARTY_VENDOR_ZERF
  • THIRD_PARTY_VENDOR_DOUBLE_VERIFY
  • THIRD_PARTY_VENDOR_INTEGRAL_AD_SCIENCE
reach Vendor Configs[]

object ( ThirdPartyVendorConfig )

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

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

  • THIRD_PARTY_VENDOR_NIELSEN
  • THIRD_PARTY_VENDOR_COMSCORE
  • THIRD_PARTY_VENDOR_KANTAR
brand Lift Vendor Configs[]

object ( ThirdPartyVendorConfig )

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

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

  • THIRD_PARTY_VENDOR_DYNATA
  • THIRD_PARTY_VENDOR_KANTAR

ThirdPartyVendorConfig

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

JSON প্রতিনিধিত্ব
{
  "vendor": enum (ThirdPartyVendor),
  "placementId": string
}
ক্ষেত্র
vendor

enum ( ThirdPartyVendor )

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

placement Id

string

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

থার্ডপার্টি ভেন্ডর

বিক্রেতা যারা তৃতীয় পক্ষের পরিমাপ সঞ্চালন.

Enums
THIRD_PARTY_VENDOR_UNSPECIFIED অজানা তৃতীয় পক্ষের বিক্রেতা।
THIRD_PARTY_VENDOR_MOAT পরিখা।
THIRD_PARTY_VENDOR_DOUBLE_VERIFY DoubleVerify.
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 ডাইনাটা।

YoutubeAnd PartnersInventorySourceConfig

সেটিংস যা নিয়ন্ত্রণ করে যে YouTube সম্পর্কিত ইনভেন্টরিগুলি YouTube এবং অংশীদারদের লাইন আইটেম লক্ষ্য করবে৷

JSON প্রতিনিধিত্ব
{
  "includeYoutube": boolean,
  "includeGoogleTv": boolean,
  "includeYoutubeVideoPartners": boolean
}
ক্ষেত্র
include Youtube

boolean

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

include Google Tv

boolean

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

include Youtube Video Partners

boolean

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

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

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 কন্টেন্টের একটি কম পরিসর নিয়ে গঠিত একটি বিভাগ যা উচ্চতর প্রয়োজনীয়তা পূরণ করে, বিশেষ করে অনুপযুক্ত ভাষা এবং যৌন পরামর্শ সংক্রান্ত।

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

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

JSON প্রতিনিধিত্ব
{
  "targetCount": string,
  "timeUnit": enum (TimeUnit),
  "timeUnitCount": integer
}
ক্ষেত্র
target Count

string ( int64 format)

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

time Unit

enum ( TimeUnit )

সময়ের একক যেখানে লক্ষ্য ফ্রিকোয়েন্সি প্রয়োগ করা হবে।

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

  • TIME_UNIT_WEEKS
time Unit Count

integer

টার্গেট ফ্রিকোয়েন্সি স্থায়ী হবে timeUnit সংখ্যা।

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

  • TIME_UNIT_WEEKS - 1 হতে হবে

VideoAdSequenceSettings

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

JSON প্রতিনিধিত্ব
{
  "minimumDuration": enum (VideoAdSequenceMinimumDuration),
  "steps": [
    {
      object (VideoAdSequenceStep)
    }
  ]
}
ক্ষেত্র
minimum Duration

enum ( VideoAdSequenceMinimumDuration )

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

steps[]

object ( VideoAdSequenceStep )

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

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

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

Enums
VIDEO_AD_SEQUENCE_MINIMUM_DURATION_UNSPECIFIED অনির্দিষ্ট বা অজানা।
VIDEO_AD_SEQUENCE_MINIMUM_DURATION_WEEK 7 দিন।
VIDEO_AD_SEQUENCE_MINIMUM_DURATION_MONTH 30 দিন।

VideoAdSequenceStep

একটি VideoAdSequence-এ একটি একক ধাপের বিশদ বিবরণ৷

JSON প্রতিনিধিত্ব
{
  "stepId": string,
  "adGroupId": string,
  "previousStepId": string,
  "interactionType": enum (InteractionType)
}
ক্ষেত্র
step Id

string ( int64 format)

ধাপের আইডি।

ad Group Id

string ( int64 format)

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

previous Step Id

string ( int64 format)

আগের ধাপের আইডি। প্রথম ধাপে আগের ধাপ নেই।

interaction Type

enum ( InteractionType )

আগের ধাপে মিথস্ক্রিয়া যা দর্শককে এই ধাপে নিয়ে যাবে। প্রথম ধাপে ইন্টারঅ্যাকশন টাইপ নেই।

ইন্টারঅ্যাকশন টাইপ

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

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

পদ্ধতি

bulk Edit Assigned Targeting Options

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

bulk List Assigned Targeting Options

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

bulk Update

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

create

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

delete

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

duplicate

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

generate Default

সন্নিবেশ আদেশ এবং একটি ENTITY_STATUS_DRAFT entity_status থেকে উত্তরাধিকারসূত্রে প্রাপ্ত সেটিংস (টার্গেটিং সহ) সহ একটি নতুন লাইন আইটেম তৈরি করে।

get

একটি লাইন আইটেম পায়.

list

একটি বিজ্ঞাপনদাতা লাইন আইটেম তালিকা.

patch

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