REST Resource: advertisers.insertionOrders

রিসোর্স: ইনসারশনঅর্ডার

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

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)

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

RFC 3339 ব্যবহার করে, যেখানে উৎপন্ন আউটপুট সর্বদা Z-স্বাভাবিক হবে এবং 0, 3, 6 অথবা 9 ভগ্নাংশ সংখ্যা ব্যবহার করবে। "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)।

এটিকে ডিসপ্লে এবং ভিডিও 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 )

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

সন্নিবেশকরণের ধরণ

সন্নিবেশ আদেশের সম্ভাব্য প্রকারগুলি।

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

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

কেপিআই

একটি সন্নিবেশ ক্রমের মূল কর্মক্ষমতা নির্দেশক, বা 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

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

kpiString

string

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

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

KpiType সম্পর্কে

সম্ভাব্য কী পারফরম্যান্স ইন্ডিকেটর (KPI) প্রকার।

এনামস
KPI_TYPE_UNSPECIFIED এই সংস্করণে KPI প্রকার নির্দিষ্ট করা নেই অথবা অজানা।
KPI_TYPE_CPM KPI হল CPM (প্রতি হাজারে খরচ)।
KPI_TYPE_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_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_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 )

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

সন্নিবেশ ক্রমঅটোমেশন প্রকার

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

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

সন্নিবেশকরণক্রমবাজেটবিভাগ

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

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 অবশ্যই startDate অথবা তার পরে হতে হবে, উভয়ই ২০৩৭ সালের আগে।
campaignBudgetId

string ( int64 format)

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

অপ্টিমাইজেশনউদ্দেশ্য

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

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

পদ্ধতি

create

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

delete

 একটি সন্নিবেশ ক্রম মুছে ফেলে।

get

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

list

 বিজ্ঞাপনদাতার মধ্যে সন্নিবেশ আদেশ তালিকাভুক্ত করে।

listAssignedTargetingOptions

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

patch

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