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)
  },
  "inventorySourceIds": [
    string
  ],
  "targetingExpansion": {
    object (TargetingExpansionConfig)
  },
  "warningMessages": [
    enum (LineItemWarningMessage)
  ],
  "mobileApp": {
    object (MobileApp)
  },
  "reservationType": enum (ReservationType),
  "excludeNewExchanges": boolean
}

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 )

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

string ( int64 format)

লাইন আইটেমের জন্য বরাদ্দ করা ব্যক্তিগত ইনভেন্টরি উত্সের আইডি।

object ( TargetingExpansionConfig )

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

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

enum ( LineItemWarningMessage )

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

object ( MobileApp )

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

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

enum ( ReservationType )

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

boolean

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

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

enum ( LineItemFlightDateType )

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

object ( DateRange )

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

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

string ( int64 format)

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

• যখন flightDateType LINE_ITEM_FLIGHT_DATE_TYPE_TRIGGER হয় তখন প্রয়োজন। অন্যথায় সেট করা উচিত নয়.
• সেট করা হলে, লাইন আইটেমের ফ্লাইট তারিখগুলি এর মূল সন্নিবেশ আদেশ থেকে উত্তরাধিকারসূত্রে প্রাপ্ত হয়৷
• সক্রিয় লাইন আইটেমগুলি খরচ হবে যখন নির্বাচিত ট্রিগারটি অভিভাবক সন্নিবেশ আদেশের ফ্লাইট তারিখের মধ্যে সক্রিয় করা হয়।

সতর্কতা: ম্যানুয়াল ট্রিগার ব্যবহার করে লাইন আইটেমগুলি আর Display & Video 360-এ পরিবেশন করা হয় না। এই ক্ষেত্রটি 1 আগস্ট, 2023-এ সূর্যাস্ত হবে। আরও তথ্যের জন্য আমাদের বৈশিষ্ট্য অবমূল্যায়ন ঘোষণা পড়ুন।

{
  "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 এর মধ্যে থাকতে হবে।

{
  "targetingExpansionLevel": enum (TargetingExpansionLevel),
  "excludeFirstPartyAudience": boolean
}

enum ( TargetingExpansionLevel )

প্রয়োজন। অপ্টিমাইজ করা টার্গেটিং চালু আছে কিনা।

এই ক্ষেত্রটি নিম্নলিখিত মানগুলিকে সমর্থন করে:

• NO_EXPANSION : অপ্টিমাইজ করা টার্গেটিং বন্ধ করা হয়েছে
• LEAST_EXPANSION : অপ্টিমাইজ করা টার্গেটিং চালু আছে

যদি এই ক্ষেত্রটি অন্য কোনো মানতে সেট করা থাকে, তাহলে এটি স্বয়ংক্রিয়ভাবে LEAST_EXPANSION এ সেট হয়ে যাবে।

NO_EXPANSION ক্ষেত্রের জন্য ডিফল্ট মান হবে এবং আপনি যদি ক্ষেত্র সেট না করেন তাহলে স্বয়ংক্রিয়ভাবে বরাদ্দ করা হবে৷

boolean

লক্ষ্য সম্প্রসারণে ব্যবহার থেকে প্রথম পক্ষের দর্শকদের বাদ দিতে হবে কিনা।

অপ্টিমাইজ করা টার্গেটিং লঞ্চের সাথে এই ক্ষেত্রটি অবমূল্যায়িত হয়েছে৷

এই ক্ষেত্র false সেট করা হবে. যদি এই ক্ষেত্রটি true হিসাবে সেট করা হয় যখন অবনমন করা হয়, এই লাইন আইটেমটিতে নির্ধারিত সমস্ত ইতিবাচক প্রথম-পক্ষের দর্শকদের টার্গেটিং একই প্রথম-পক্ষের দর্শকদের নেতিবাচক টার্গেটিং দিয়ে প্রতিস্থাপিত হবে যাতে সেই দর্শকদের অব্যাহত বর্জন নিশ্চিত করা যায়।

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

string

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

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

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

enum ( Platform )

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

string

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

string

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