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)
  },
  "kpi": {
    object (Kpi)
  },
  "budget": {
    object (InsertionOrderBudget)
  },
  "bidStrategy": {
    object (BiddingStrategy)
  },
  "reservationType": enum (ReservationType),
  "optimizationObjective": enum (OptimizationObjective)
}
ক্ষেত্র
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 )

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

kpi

object ( Kpi )

প্রয়োজন। সন্নিবেশ আদেশের মূল কর্মক্ষমতা সূচক (KPI)।

ডিসপ্লে ও ভিডিও 360 ইন্টারফেসে এটিকে "লক্ষ্য" হিসাবে উল্লেখ করা হয়েছে৷

budget

object ( InsertionOrderBudget )

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

bidStrategy

object ( BiddingStrategy )

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

reservationType

enum ( ReservationType )

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

optimizationObjective

enum ( OptimizationObjective )

ঐচ্ছিক। সন্নিবেশ আদেশের অপ্টিমাইজেশন উদ্দেশ্য।

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

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

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

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

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

Kpi

সেটিংস যা একটি সন্নিবেশ আদেশের মূল কর্মক্ষমতা সূচক বা KPI নিয়ন্ত্রণ করে।

JSON প্রতিনিধিত্ব 
{
  "kpiType": enum (KpiType),
  "kpiAlgorithmId": string,

  // Union field kpi_value can be only one of the following:
  "kpiAmountMicros": string,
  "kpiPercentageMicros": string,
  "kpiString": string
  // End of list of possible types for union field kpi_value.
}
ক্ষেত্র
kpiType

enum ( KpiType )

প্রয়োজন। KPI এর ধরন।

kpiAlgorithmId

string ( int64 format)

ঐচ্ছিক। KPI_CUSTOM_IMPRESSION_VALUE_OVER_COST এর সাথে যুক্ত কাস্টম বিডিং অ্যালগরিদম আইডি৷ সঠিক KPI নির্বাচন না করা হলে এই ক্ষেত্রটি উপেক্ষা করা হয়।

ইউনিয়ন ক্ষেত্র kpi_value । প্রয়োজন। KPI এর মান। প্রাসঙ্গিক ক্ষেত্রটি kpi_type এর সাথে মিলে যায়। kpi_value নিম্নলিখিতগুলির মধ্যে একটি হতে পারে:
kpiAmountMicros

string ( int64 format)

লক্ষ্যের পরিমাণ, বিজ্ঞাপনদাতার মুদ্রার মাইক্রোতে।

kpiType এর মধ্যে একটি হলে প্রযোজ্য:

  • KPI_TYPE_CPM
  • KPI_TYPE_CPC
  • KPI_TYPE_CPA
  • KPI_TYPE_CPIAVC
  • KPI_TYPE_VCPM

উদাহরণস্বরূপ: 1500000 মুদ্রার 1.5 স্ট্যান্ডার্ড ইউনিট প্রতিনিধিত্ব করে।

kpiPercentageMicros

string ( int64 format)

মাইক্রোতে লক্ষ্য শতাংশের দশমিক উপস্থাপনা।

kpiType এর মধ্যে একটি হলে প্রযোজ্য:

  • KPI_TYPE_CTR
  • KPI_TYPE_VIEWABILITY
  • KPI_TYPE_CLICK_CVR
  • KPI_TYPE_IMPRESSION_CVR
  • KPI_TYPE_VTR
  • KPI_TYPE_AUDIO_COMPLETION_RATE
  • KPI_TYPE_VIDEO_COMPLETION_RATE

উদাহরণস্বরূপ: 70000 প্রতিনিধিত্ব করে 7% (দশমিক 0.07)।

kpiString

string

একটি KPI স্ট্রিং, যা খালি হতে পারে। 100টির বেশি অক্ষরের দৈর্ঘ্যের সাথে UTF-8 এনকোড করা আবশ্যক।

kpiType KPI_TYPE_OTHER হলে প্রযোজ্য।

কেপিআই টাইপ

সম্ভাব্য কী কর্মক্ষমতা সূচক (KPI) প্রকার।

এনামস
KPI_TYPE_UNSPECIFIED এই সংস্করণে KPI প্রকার নির্দিষ্ট করা নেই বা অজানা।
KPI_TYPE_CPM KPI হল CPM (প্রতি মিলের খরচ)।
KPI_TYPE_CPC KPI হল CPC (প্রতি ক্লিকের খরচ)।
KPI_TYPE_CPA KPI হল CPA (প্রতি কর্মের খরচ)।
KPI_TYPE_CTR KPI হল CTR (ক্লিক-থ্রু রেট) শতাংশ।
KPI_TYPE_VIEWABILITY KPI হল দর্শনযোগ্যতা শতাংশ৷
KPI_TYPE_CPIAVC KPI হল CPIAVC (প্রতি ইম্প্রেশনের খরচ শ্রবণযোগ্য এবং সম্পূর্ণ হলে দৃশ্যমান)।
KPI_TYPE_CPE KPI হল CPE (প্রতি ব্যস্ততার খরচ)।
KPI_TYPE_CPV KPI CPV তে সেট করা হয়েছে (প্রতি দর্শনের খরচ)।
KPI_TYPE_CLICK_CVR KPI হল ক্লিক রূপান্তর হার (প্রতি ক্লিকে রূপান্তর) শতাংশ।
KPI_TYPE_IMPRESSION_CVR KPI হল ইম্প্রেশন কনভার্সন রেট (প্রতি ইমপ্রেশনে কনভার্সন) শতাংশ।
KPI_TYPE_VCPM KPI হল VCPM (প্রতি হাজার দর্শনীয় ইম্প্রেশনের খরচ)।
KPI_TYPE_VTR KPI হল YouTube ভিউ রেট (প্রতি ইমপ্রেশনে YouTube ভিউ) শতাংশ।
KPI_TYPE_AUDIO_COMPLETION_RATE KPI হল অডিও সমাপ্তির হার (প্রতি ইমপ্রেশনে সম্পূর্ণ অডিও শোনা) শতাংশ।
KPI_TYPE_VIDEO_COMPLETION_RATE KPI হল ভিডিও সম্পূর্ণ হওয়ার হার (প্রতি ইমপ্রেশনে সম্পূর্ণ ভিডিও ভিউ) শতাংশ।
KPI_TYPE_CPCL KPI CPCL-এ সেট করা হয়েছে (প্রতি সম্পূর্ণ অডিও শোনার খরচ)।
KPI_TYPE_CPCV KPI সিপিসিভিতে সেট করা হয়েছে (প্রতি সম্পূর্ণ ভিডিও দেখার খরচ)।
KPI_TYPE_TOS10 KPI স্ক্রিনে 10+ সেকেন্ডের সময়ের হারে সেট করা হয়েছে (অন্তত 10 সেকেন্ডের জন্য স্ক্রিনে থাকা পরিমাপযোগ্য, অ-ছাড়াযোগ্য ইম্প্রেশনের শতাংশ)।
KPI_TYPE_MAXIMIZE_PACING কেপিআই সম্পূর্ণ বাজেট ব্যয়কে অগ্রাধিকার দেওয়ার সময় ব্র্যান্ডের প্রভাব সর্বাধিক করতে সেট করা হয়েছে।
KPI_TYPE_CUSTOM_IMPRESSION_VALUE_OVER_COST KPI কাস্টম ইম্প্রেশন মানকে খরচ দ্বারা ভাগ করে সেট করা হয়।
KPI_TYPE_OTHER KPI কিছু অন্য মান.

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 স্বয়ংক্রিয় বাজেট বরাদ্দ। kpi দ্বারা সংজ্ঞায়িত কর্মক্ষমতা অপ্টিমাইজ করার জন্য সিস্টেমটিকে স্বয়ংক্রিয়ভাবে বাজেটের মালিকানার লাইন আইটেমগুলিতে স্থানান্তর করার অনুমতি দিন। বিড সেটিংসে কোনো অটোমেশন নেই।
INSERTION_ORDER_AUTOMATION_TYPE_NONE সন্নিবেশ অর্ডার স্তরে বিড বা বাজেটের কোন স্বয়ংক্রিয়তা নেই। বিড এবং বাজেট লাইন আইটেম স্তরে ম্যানুয়ালি কনফিগার করা আবশ্যক।
INSERTION_ORDER_AUTOMATION_TYPE_BID_BUDGET সিস্টেমকে স্বয়ংক্রিয়ভাবে বিডগুলি সামঞ্জস্য করার অনুমতি দিন এবং kpi দ্বারা সংজ্ঞায়িত কর্মক্ষমতা অপ্টিমাইজ করতে লাইন আইটেমগুলির মালিকানাধীন বাজেটে স্থানান্তর করুন৷

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 যা এই সন্নিবেশ অর্ডার বাজেট সেগমেন্টের একটি অংশ৷

অপ্টিমাইজেশান অবজেক্টিভ

সম্ভাব্য ধরনের অপ্টিমাইজেশান উদ্দেশ্য.

এনামস
OPTIMIZATION_OBJECTIVE_UNSPECIFIED এই সংস্করণে প্রকার মান নির্দিষ্ট করা নেই বা অজানা।
CONVERSION ইম্প্রেশনকে অগ্রাধিকার দিন যা বিক্রয় এবং রূপান্তর বাড়ায়।
CLICK ইম্প্রেশনকে অগ্রাধিকার দিন যা ওয়েবসাইট ট্রাফিক, অ্যাপ, অ্যাপ স্টোর বাড়ায়।
BRAND_AWARENESS নির্দিষ্ট মানের ইমপ্রেশনকে অগ্রাধিকার দিন।
CUSTOM উদ্দেশ্য নির্ধারিত কাস্টম বিডিং অ্যালগরিদম দ্বারা সংজ্ঞায়িত করা হয়।
NO_OBJECTIVE উদ্দেশ্য সংজ্ঞায়িত করা হয় না. যেকোন কেপিআই বা বিডিং কৌশল ব্যবহার করা যেতে পারে।

পদ্ধতি

create

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

delete

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

get

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

list

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

listAssignedTargetingOptions

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

patch

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