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 এনকোডেড হতে হবে।
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)

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

RFC 3339 ব্যবহার করে, যেখানে জেনারেট করা আউটপুট সবসময় Z-নরমালাইজড হবে এবং ০, ৩, ৬ বা ৯টি ভগ্নাংশ সংখ্যা ব্যবহার করবে। "Z" ছাড়া অন্যান্য অফসেটও গ্রহণ করা হয়। যেমন: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" বা "2014-10-02T15:01:23+05:30"।
partnerCosts[]

object (PartnerCost)

ঐচ্ছিক। ইনসার্শন অর্ডারের সাথে যুক্ত পার্টনারের খরচ।

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

object (Pacing)

প্রয়োজনীয়। ইনসার্শন অর্ডারের বাজেট খরচের স্পিড সেটিং।

pacingType PACING_TYPE_ASAP, pacingPeriod PACING_PERIOD_FLIGHT-এর সাথে মানানসই নয়।
frequencyCap

object (FrequencyCap)

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

object (IntegrationDetails)

ঐচ্ছিক। ইনসার্শন অর্ডারের অতিরিক্ত ইন্টিগ্রেশন বিবরণ।
kpi

object (Kpi)

প্রয়োজনীয়। ইনসার্শন অর্ডারের মূল অবদান সূচক (KPI)।

Display & Video 360 ইন্টারফেসে এটিকে"লক্ষ্য " হিসেবে উল্লেখ করা হয়।
budget

object (InsertionOrderBudget)

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

object (BiddingStrategy)

ঐচ্ছিক। ইনসার্শন অর্ডারের বিডিং স্ট্র্যাটেজি। ডিফল্ট হিসেবে, fixedBid সেট করা আছে।

budget ফিল্ড automationType-এর মান INSERTION_ORDER_AUTOMATION_TYPE_BUDGET বা INSERTION_ORDER_AUTOMATION_TYPE_BID_BUDGET হিসেবে সেট করা থাকলে, ইনসার্শন অর্ডার তার লাইন আইটেমে এই বিডিং স্ট্র্যাটেজি প্রয়োগ করবে। কোনও লাইন আইটেমের enableOptimizedTargeting সেটিংয়ের সাথে আরোপিত বিডিং স্ট্র্যাটেজি মানানসই না হলে, অপ্টিমাইজ করা টার্গেটিং সেটিং আপডেট করা হবে।
reservationType

enum (ReservationType)

শুধু আউটপুট। ইনসার্শন অর্ডারের রিজার্ভেশনের ধরন।
optimizationObjective

enum (OptimizationObjective)

প্রয়োজনীয়। ইনসার্শন অর্ডারের অপ্টিমাইজেশন সংক্রান্ত উদ্দেশ্য।

InsertionOrderType

ইনসার্শন অর্ডারের সম্ভাব্য ধরন।

ইনসার্শন অর্ডারের ধরন নির্ধারণ করে যে কোন সেটিংস এবং বিকল্প প্রযোজ্য, যেমন বিজ্ঞাপনের ফর্ম্যাট বা টার্গেটিং বিকল্প।

Enums
INSERTION_ORDER_TYPE_UNSPECIFIED ইনসার্শন অর্ডারের ধরন উল্লেখ করা নেই বা অজানা।
RTB রিয়েল-টাইম বিডিং।
OVER_THE_TOP ওভার-দ্য-টপ।
OUT_OF_HOME আউট-অফ-হোম।

Kpi

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

JSON উপস্থাপনা 
{
  "kpiType": enum (KpiType),
  "kpiAlgorithmId": string,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "kpiAmountMicros": string,
  "kpiPercentageMicros": string,
  "kpiString": string
  // End of mutually exclusive fields.
}
ফিল্ড
kpiType

enum (KpiType)

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

string (int64 format)

ঐচ্ছিক। KPI_CUSTOM_IMPRESSION_VALUE_OVER_COST-এর সাথে যুক্ত কাস্টম বিডিং অ্যালগরিদম আইডি। সঠিক KPI বেছে না নিলে এই ফিল্ডটি উপেক্ষা করা হয়।
প্রয়োজনীয়। KPI-এর ভ্যালু। প্রাসঙ্গিক ফিল্ড kpi_type-এর সাথে সম্পর্কিত। নিচে পারস্পরিকভাবে এক্সক্লুসিভ ফিল্ডের তালিকা দেওয়া হল। উত্তরে সর্বাধিক একটি ফিল্ড সেট করা হবে:
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 স্ট্রিং, যা খালি থাকতে পারে। UTF-8 এনকোড করা হতে হবে এবং ১০০ অক্ষরের বেশি হওয়া চলবে না।

kpiType, KPI_TYPE_OTHER হলে প্রযোজ্য।
মিউচুয়ালি এক্সক্লুসিভ ফিল্ডের শেষ।

KpiType

সম্ভাব্য মূল অবদান সূচক (KPI)-এর ধরন।

Enums
KPI_TYPE_UNSPECIFIED এই ভার্সনে KPI-এর ধরন উল্লেখ করা নেই বা জানা নেই।
KPI_TYPE_CPM KPI হল CPM (প্রতি হাজার ইম্প্রেশনের জন্য খরচ)।
KPI_TYPE_CPC KPI হল CPC (ক্লিক প্রতি দাম)।
KPI_TYPE_CPA KPI হল CPA (অ্যাকশন পিছু খরচ)।
KPI_TYPE_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-কে CPCV (সম্পূর্ণ ভিডিও ভিউ প্রতি খরচ) হিসেবে সেট করা হয়েছে।
KPI_TYPE_TOS10 KPI স্ক্রিনে ১০+ সেকেন্ড সময় কাটানোর হারের উপর সেট করা হয় (পরিমাপযোগ্য, এড়িয়ে যাওয়া যায় না এমন ইম্প্রেশনের শতাংশ যা স্ক্রিনে অন্তত ১০ সেকেন্ডের জন্য ছিল)।
KPI_TYPE_MAXIMIZE_PACING সম্পূর্ণ বাজেট খরচ করার বিষয়টিকে অগ্রাধিকার দেওয়ার পাশাপাশি ব্র্যান্ড ইম্প্যাক্ট সর্বাধিক করার জন্য KPI সেট করা হয়।
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

ইনসার্শন অর্ডার বিড ও বাজেট অটোমেট করার সম্ভাব্য বিকল্প।

Enums
INSERTION_ORDER_AUTOMATION_TYPE_UNSPECIFIED ইনসার্শন অর্ডার অটোমেশন বিকল্পটি এই ভার্সনে নির্দিষ্ট করা নেই বা অজানা।
INSERTION_ORDER_AUTOMATION_TYPE_BUDGET অটোমেটিক বাজেট বরাদ্দ করা। kpi-এর মাধ্যমে নির্ধারিত পারফর্ম্যান্স অপ্টিমাইজ করার জন্য সিস্টেমকে অটোমেটিক বাজেট শিফট করে মালিকানাধীন লাইন আইটেমে নিয়ে যাওয়ার অনুমতি দিন। বিড সেটিংসে কোনও অটোমেশন নেই।
INSERTION_ORDER_AUTOMATION_TYPE_NONE ইনসার্শন অর্ডার লেভেলে বিড বা বাজেটের কোনও অটোমেশন নেই। লাইন আইটেম লেভেলে বিড ও বাজেট ম্যানুয়ালি কনফিগার করতে হবে।
INSERTION_ORDER_AUTOMATION_TYPE_BID_BUDGET bidStrategy-এর মাধ্যমে নির্ধারিত পারফর্ম্যান্স অপ্টিমাইজ করার জন্য, সিস্টেমকে অটোমেটিক বিড অ্যাডজাস্ট করতে এবং ওনিং লাইন আইটেমে বাজেট শিফট করার অনুমতি দিন।

InsertionOrderBudgetSegment

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

JSON উপস্থাপনা 
{
  "budgetAmountMicros": string,
  "description": string,
  "dateRange": {
    object (DateRange)
  },
  "campaignBudgetId": string
}
ফিল্ড
budgetAmountMicros

string (int64 format)

প্রয়োজনীয়। প্রদত্ত dateRange-এর জন্য ইনসার্শন অর্ডার যে পরিমাণ বাজেট খরচ করবে। পরিমাণটি মাইক্রোতে আছে। ০-এর থেকে বড় হতে হবে। যেমন, 500000000 বলতে কারেন্সির ৫০০ স্ট্যান্ডার্ড ইউনিট বোঝায়।
description

string

ঐচ্ছিক। বাজেট সেগমেন্টের বিবরণ। প্রতিটি বাজেট সেগমেন্টের জন্য কেনার অর্ডার সংক্রান্ত তথ্য লিখতে এবং ইনভয়েসে সেই তথ্য প্রিন্ট করতে এটি ব্যবহার করা যেতে পারে।

UTF-8 এনকোড করা হতে হবে।
dateRange

object (DateRange)

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

  • নতুন বাজেট সেগমেন্ট তৈরি করার সময়, startDate এবং endDate দুটিই ভবিষ্যতের কোনও তারিখ হতে হবে।
  • অতীতে startDate সহ আগে থেকে থাকা বাজেট সেগমেন্টে পরিবর্তনযোগ্য endDate থাকলেও startDate পরিবর্তন করা যায় না।
  • endDate অবশ্যই startDate বা তার পরের হতে হবে, দুটিই ২০৩৭ সালের আগের হতে হবে।
campaignBudgetId

string (int64 format)

ঐচ্ছিক। ক্যাম্পেন বাজেটের budgetId, যার অংশ হল এই ইনসার্শন অর্ডার বাজেট সেগমেন্ট।

OptimizationObjective

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

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

পদ্ধতি

create

 নতুন ইনসার্শন অর্ডার তৈরি করে।

delete

 ইনসার্শন অর্ডার মুছে দেয়।

get

 ইনসার্শন অর্ডার পায়।

list

 বিজ্ঞাপনদাতার ইনসার্শন অর্ডার তালিকাভুক্ত করে।

patch

 আগে থেকে থাকা ইনসার্শন অর্ডার আপডেট করে।