REST Resource: advertisers.lineItems

{
  "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)
  }
}

string

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

string ( int64 format)

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

string ( int64 format)

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

string ( int64 format)

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

string ( int64 format)

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

string

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

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

enum ( LineItemType )

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

enum ( EntityStatus )

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

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

string ( Timestamp format)

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

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

object ( PartnerCost )

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

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

object ( LineItemFlight )

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

object ( LineItemBudget )

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

object ( Pacing )

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

object ( FrequencyCap )

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

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

object ( PartnerRevenueModel )

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

object ( ConversionCountingConfig )

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

string ( int64 format)

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

object ( BiddingStrategy )

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

object ( IntegrationDetails )

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

object ( TargetingExpansionConfig )

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

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

enum ( LineItemWarningMessage )

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

object ( MobileApp )

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

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

enum ( ReservationType )

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

boolean

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

object ( YoutubeAndPartnersSettings )

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

{
  "flightDateType": enum (LineItemFlightDateType),
  "dateRange": {
    object (DateRange)
  }
}

enum ( LineItemFlightDateType )

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

object ( DateRange )

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

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

{
  "budgetAllocationType": enum (LineItemBudgetAllocationType),
  "budgetUnit": enum (BudgetUnit),
  "maxAmount": string
}

enum ( LineItemBudgetAllocationType )

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

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

enum ( BudgetUnit )

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

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 , এই ক্ষেত্রটি প্রযোজ্য নয় এবং সিস্টেম দ্বারা উপেক্ষা করা হবে৷

{
  "markupType": enum (PartnerRevenueModelMarkupType),
  "markupAmount": string
}

enum ( PartnerRevenueModelMarkupType )

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

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) প্রতিনিধিত্ব করে।

{
  "postViewCountPercentageMillis": string,
  "floodlightActivityConfigs": [
    {
      object (TrackingFloodlightActivityConfig)
    }
  ]
}

string ( int64 format)

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

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

object ( TrackingFloodlightActivityConfig )

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

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

{
  "floodlightActivityId": string,
  "postClickLookbackWindowDays": integer,
  "postViewLookbackWindowDays": integer
}

string ( int64 format)

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

integer

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

integer

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

{
  "appId": string,
  "platform": enum (Platform),
  "displayName": string,
  "publisher": string
}

string

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

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

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

enum ( Platform )

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

string

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

string

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

{
  "biddingStrategy": {
    object (YoutubeAndPartnersBiddingStrategy)
  },
  "viewFrequencyCap": {
    object (FrequencyCap)
  },
  "thirdPartyMeasurementSettings": {
    object (YoutubeAndPartnersThirdPartyMeasurementSettings)
  },
  "inventorySourceSettings": {
    object (YoutubeAndPartnersInventorySourceConfig)
  },
  "contentCategory": enum (YoutubeAndPartnersContentCategory),
  "effectiveContentCategory": enum (YoutubeAndPartnersContentCategory),
  "targetFrequency": {
    object (TargetFrequency)
  },
  "linkedMerchantId": string,
  "relatedVideoIds": [
    string
  ],
  "leadFormId": string,
  "videoAdSequenceSettings": {
    object (VideoAdSequenceSettings)
  }
}

object ( YoutubeAndPartnersBiddingStrategy )

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

object ( FrequencyCap )

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

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

object ( YoutubeAndPartnersThirdPartyMeasurementSettings )

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

object ( YoutubeAndPartnersInventorySourceConfig )

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

enum ( YoutubeAndPartnersContentCategory )

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

enum ( YoutubeAndPartnersContentCategory )

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

object ( TargetFrequency )

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

string ( int64 format)

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

string

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

string ( int64 format)

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

object ( VideoAdSequenceSettings )

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

{
  "viewabilityVendorConfigs": [
    {
      object (ThirdPartyVendorConfig)
    }
  ],
  "brandSafetyVendorConfigs": [
    {
      object (ThirdPartyVendorConfig)
    }
  ],
  "reachVendorConfigs": [
    {
      object (ThirdPartyVendorConfig)
    }
  ],
  "brandLiftVendorConfigs": [
    {
      object (ThirdPartyVendorConfig)
    }
  ]
}

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

object ( ThirdPartyVendorConfig )

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

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

• THIRD_PARTY_VENDOR_ZERF
• THIRD_PARTY_VENDOR_DOUBLE_VERIFY
• THIRD_PARTY_VENDOR_INTEGRAL_AD_SCIENCE

object ( ThirdPartyVendorConfig )

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

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

• THIRD_PARTY_VENDOR_NIELSEN
• THIRD_PARTY_VENDOR_COMSCORE
• THIRD_PARTY_VENDOR_KANTAR

object ( ThirdPartyVendorConfig )

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

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

• THIRD_PARTY_VENDOR_DYNATA
• THIRD_PARTY_VENDOR_KANTAR

{
  "vendor": enum (ThirdPartyVendor),
  "placementId": string
}

enum ( ThirdPartyVendor )

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

string

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

{
  "includeYoutubeSearch": boolean,
  "includeYoutubeVideos": boolean,
  "includeGoogleTv": boolean,
  "includeYoutubeVideoPartners": boolean
}

boolean

YouTube অনুসন্ধান ফলাফল পৃষ্ঠায় ইনভেন্টরি টার্গেট করা হবে কিনা।

boolean

YouTube-এ চ্যানেল এবং ভিডিওর ইনভেনটরি এবং অন্যান্য সাইটে এমবেড করা YouTube ভিডিওগুলি লক্ষ্য করা যায় কিনা।

boolean

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

boolean

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

{
  "targetCount": string,
  "timeUnit": enum (TimeUnit),
  "timeUnitCount": integer
}

string ( int64 format)

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

enum ( TimeUnit )

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

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

• TIME_UNIT_WEEKS

integer

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

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

• TIME_UNIT_WEEKS - 1 হতে হবে

{
  "minimumDuration": enum (VideoAdSequenceMinimumDuration),
  "steps": [
    {
      object (VideoAdSequenceStep)
    }
  ]
}

enum ( VideoAdSequenceMinimumDuration )

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

object ( VideoAdSequenceStep )

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

{
  "stepId": string,
  "adGroupId": string,
  "previousStepId": string,
  "interactionType": enum (InteractionType)
}

string ( int64 format)

ধাপের আইডি।

string ( int64 format)

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

string ( int64 format)

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

enum ( InteractionType )

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