REST Resource: advertisers.insertionOrders

সম্পদ: InsertionOrder

একটি একক সন্নিবেশ আদেশ.

JSON প্রতিনিধিত্ব
{
  "name": string,
  "advertiserId": string,
  "campaignId": string,
  "insertionOrderId": string,
  "displayName": string,
  "insertionOrderType": enum (InsertionOrderType),
  "entityStatus": enum (EntityStatus),
  "updateTime": string,
  "partnerCosts": [
    {
      object (PartnerCost)
    }
  ],
  "pacing": {
    object (Pacing)
  },
  "frequencyCap": {
    object (FrequencyCap)
  },
  "integrationDetails": {
    object (IntegrationDetails)
  },
  "performanceGoal": {
    object (PerformanceGoal)
  },
  "budget": {
    object (InsertionOrderBudget)
  },
  "bidStrategy": {
    object (BiddingStrategy)
  },
  "reservationType": enum (ReservationType),
  "billableOutcome": enum (BillableOutcome)
}
ক্ষেত্র
name

string

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

advertiserId

string ( int64 format)

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

campaignId

string ( int64 format)

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

insertionOrderId

string ( int64 format)

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

displayName

string

প্রয়োজন। সন্নিবেশ আদেশের প্রদর্শন নাম।

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

insertionOrderType

enum ( InsertionOrderType )

সন্নিবেশ আদেশের ধরন।

যদি এই ক্ষেত্রটি তৈরিতে অনির্দিষ্ট থাকে, তাহলে মানটি RTB তে ডিফল্ট হয়।

entityStatus

enum ( EntityStatus )

প্রয়োজন। সন্নিবেশ অর্ডার তার বাজেট এবং ইনভেন্টরিতে বিড করতে পারে কিনা তা নিয়ন্ত্রণ করে।

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

string ( Timestamp format)

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

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

partnerCosts[]

object ( PartnerCost )

সন্নিবেশ আদেশের সাথে যুক্ত অংশীদার খরচ.

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

pacing

object ( Pacing )

প্রয়োজন। সন্নিবেশ আদেশের বাজেট ব্যয়ের গতি সেটিং।

frequencyCap

object ( FrequencyCap )

প্রয়োজন। সন্নিবেশ অর্ডারের ফ্রিকোয়েন্সি ক্যাপিং সেটিং।

integrationDetails

object ( IntegrationDetails )

সন্নিবেশ আদেশের অতিরিক্ত ইন্টিগ্রেশন বিশদ।

performanceGoal

object ( PerformanceGoal )

প্রয়োজন। সন্নিবেশ ক্রম কর্মক্ষমতা লক্ষ্য.

budget

object ( InsertionOrderBudget )

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

bidStrategy

object ( BiddingStrategy )

সন্নিবেশ আদেশের বিডিং কৌশল। ডিফল্টরূপে, fixedBid সেট করা হয়।

reservationType

enum ( ReservationType )

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

billableOutcome

enum ( BillableOutcome )

অপরিবর্তনীয়। সন্নিবেশ আদেশের বিলযোগ্য ফলাফল।

ফলাফল ভিত্তিক ক্রয় অবমূল্যায়িত হয়. BILLABLE_OUTCOME_PAY_PER_IMPRESSION হল একমাত্র বৈধ মান৷

সন্নিবেশ অর্ডার টাইপ

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

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

এনামস
INSERTION_ORDER_TYPE_UNSPECIFIED সন্নিবেশ অর্ডারের ধরন নির্দিষ্ট করা নেই বা অজানা।
RTB রিয়েল-টাইম বিডিং।
OVER_THE_TOP ওভার-দ্য-টপ।

InsertionOrderBudget

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

JSON প্রতিনিধিত্ব
{
  "budgetUnit": enum (BudgetUnit),
  "automationType": enum (InsertionOrderAutomationType),
  "budgetSegments": [
    {
      object (InsertionOrderBudgetSegment)
    }
  ]
}
ক্ষেত্র
budgetUnit

enum ( BudgetUnit )

প্রয়োজন। অপরিবর্তনীয়। বাজেট একক নির্দিষ্ট করে দেয় বাজেট মুদ্রা ভিত্তিক নাকি ইম্প্রেশন ভিত্তিক।

automationType

enum ( InsertionOrderAutomationType )

সন্নিবেশ অর্ডারের জন্য বিড এবং বাজেট পরিচালনা করতে ব্যবহৃত অটোমেশনের ধরন।

যদি এই ক্ষেত্রটি তৈরিতে অনির্দিষ্ট থাকে, তাহলে মানটি ডিফল্ট হয়ে যায় INSERTION_ORDER_AUTOMATION_TYPE_NONE ।

budgetSegments[]

object ( InsertionOrderBudgetSegment )

প্রয়োজন। বাজেট বিভাগের তালিকা। একটি সন্নিবেশ অর্ডার চলমান সময়ের জন্য একটি নির্দিষ্ট বাজেট নির্দিষ্ট করতে একটি বাজেট সেগমেন্ট ব্যবহার করুন৷

InsertionOrderAutomationType

স্বয়ংক্রিয় সন্নিবেশ অর্ডার বিড এবং বাজেটের জন্য সম্ভাব্য বিকল্প।

এনামস
INSERTION_ORDER_AUTOMATION_TYPE_UNSPECIFIED সন্নিবেশ অর্ডার অটোমেশন বিকল্পটি নির্দিষ্ট করা নেই বা এই সংস্করণে অজানা।
INSERTION_ORDER_AUTOMATION_TYPE_BUDGET স্বয়ংক্রিয় বাজেট বরাদ্দ। performanceGoal দ্বারা সংজ্ঞায়িত কর্মক্ষমতা অপ্টিমাইজ করার জন্য সিস্টেমটিকে স্বয়ংক্রিয়ভাবে বাজেটের মালিকানার লাইন আইটেমগুলিতে স্থানান্তর করার অনুমতি দিন। বিড সেটিংসে কোনো অটোমেশন নেই।
INSERTION_ORDER_AUTOMATION_TYPE_NONE সন্নিবেশ অর্ডার স্তরে বিড বা বাজেটের কোন স্বয়ংক্রিয়তা নেই। বিড এবং বাজেট অবশ্যই লাইন আইটেম স্তরে ম্যানুয়ালি কনফিগার করা উচিত।
INSERTION_ORDER_AUTOMATION_TYPE_BID_BUDGET সিস্টেমকে স্বয়ংক্রিয়ভাবে বিডগুলি সামঞ্জস্য করার অনুমতি দিন এবং performanceGoal দ্বারা সংজ্ঞায়িত কর্মক্ষমতা অপ্টিমাইজ করতে লাইন আইটেমগুলির মালিকানাধীন বাজেটে স্থানান্তর করুন৷

InsertionOrderBudgetSegment

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

JSON প্রতিনিধিত্ব
{
  "budgetAmountMicros": string,
  "description": string,
  "dateRange": {
    object (DateRange)
  },
  "campaignBudgetId": string
}
ক্ষেত্র
budgetAmountMicros

string ( int64 format)

প্রয়োজন। প্রদত্ত dateRange জন্য সন্নিবেশ অর্ডার ব্যয় করবে বাজেটের পরিমাণ। পরিমাণ মাইক্রোতে আছে। 0-এর বেশি হতে হবে। উদাহরণস্বরূপ, 500000000 মুদ্রার 500টি স্ট্যান্ডার্ড একক প্রতিনিধিত্ব করে।

description

string

বাজেট সেগমেন্টের বিবরণ। এটি প্রতিটি বাজেট বিভাগের জন্য ক্রয় আদেশের তথ্য প্রবেশ করতে ব্যবহার করা যেতে পারে এবং সেই তথ্য চালানগুলিতে মুদ্রিত থাকতে পারে।

UTF-8 এনকোড করা আবশ্যক।

dateRange

object ( DateRange )

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

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

string ( int64 format)

প্রচারাভিযানের বাজেটের budgetId যা এই সন্নিবেশ অর্ডার বাজেট সেগমেন্টের একটি অংশ৷

বিলযোগ্য ফলাফল

একটি সন্নিবেশ আদেশের জন্য সম্ভাব্য বিলযোগ্য ফলাফল।

এনামস
BILLABLE_OUTCOME_UNSPECIFIED অনির্দিষ্ট বিলযোগ্য ফলাফল।
BILLABLE_OUTCOME_PAY_PER_IMPRESSION প্রতি ইমপ্রেশনে অর্থ প্রদান করুন।
BILLABLE_OUTCOME_PAY_PER_CLICK

প্রতি ক্লিকের দিতে.

BILLABLE_OUTCOME_PAY_PER_VIEWABLE_IMPRESSION

সক্রিয় ভিউ প্রতি অর্থ প্রদান করুন।

পদ্ধতি

bulkListInsertionOrderAssignedTargetingOptions

 টার্গেটিং প্রকার জুড়ে একটি সন্নিবেশ অর্ডারের নির্ধারিত টার্গেটিং বিকল্পের তালিকা করে।

create

 একটি নতুন সন্নিবেশ আদেশ তৈরি করে।

delete

 একটি সন্নিবেশ আদেশ মুছে দেয়।

get

 একটি সন্নিবেশ আদেশ পায়.

list

 একটি বিজ্ঞাপনদাতা মধ্যে সন্নিবেশ আদেশ তালিকা.

patch

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