REST Resource: advertisers.campaigns

রিসোর্স: ক্যাম্পেন

একটি ক্যাম্পেন।

JSON উপস্থাপনা 
{
  "name": string,
  "advertiserId": string,
  "campaignId": string,
  "displayName": string,
  "entityStatus": enum (EntityStatus),
  "updateTime": string,
  "campaignGoal": {
    object (CampaignGoal)
  },
  "campaignFlight": {
    object (CampaignFlight)
  },
  "frequencyCap": {
    object (FrequencyCap)
  },
  "campaignBudgets": [
    {
      object (CampaignBudget)
    }
  ]
}
ফিল্ড
name

string

শুধু আউটপুট। ক্যাম্পেনের রিসোর্স নাম।
advertiserId

string (int64 format)

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

string (int64 format)

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

string

প্রয়োজনীয়। ক্যাম্পেনের ডিসপ্লে নাম।

সর্বাধিক ২৪০ বাইট সাইজের UTF-8 এনকোডেড হতে হবে।
entityStatus

enum (EntityStatus)

প্রয়োজনীয়। এই ক্যাম্পেনের অধীনে ইনসার্শন অর্ডার বাজেট খরচ করতে এবং ইনভেনটরিতে বিড করতে পারবে কিনা তা কন্ট্রোল করে।

  • স্বীকৃত মান হল ENTITY_STATUS_ACTIVE, ENTITY_STATUS_ARCHIVED এবং ENTITY_STATUS_PAUSED।
  • campaigns.create পদ্ধতির জন্য, ENTITY_STATUS_ARCHIVED অনুমোদিত নয়।
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"।
campaignGoal

object (CampaignGoal)

প্রয়োজনীয়। ক্যাম্পেনের লক্ষ্য।
campaignFlight

object (CampaignFlight)

প্রয়োজনীয়। ক্যাম্পেনের জন্য পরিকল্পিত খরচ এবং সময়সীমা।
frequencyCap

object (FrequencyCap)

প্রয়োজনীয়। ক্যাম্পেনের ফ্রিকোয়েন্সি ক্যাপ সেটিং।
campaignBudgets[]

object (CampaignBudget)

এই ক্যাম্পেনের জন্য উপলভ্য বাজেটের তালিকা।

এই ফিল্ড সেট করা না থাকলে, ক্যাম্পেনটি আনলিমিটেড বাজেট ব্যবহার করে।

CampaignGoal

ক্যাম্পেনের লক্ষ্য নিয়ন্ত্রণ করে এমন সেটিংস।

JSON উপস্থাপনা 
{
  "campaignGoalType": enum (CampaignGoalType),
  "performanceGoal": {
    object (PerformanceGoal)
  }
}
ফিল্ড
campaignGoalType

enum (CampaignGoalType)

প্রয়োজনীয়। ক্যাম্পেনের লক্ষ্যের ধরন।
performanceGoal

object (PerformanceGoal)

প্রয়োজনীয়। ক্যাম্পেনের পারফর্ম্যান্স সংক্রান্ত লক্ষ্য।

performanceGoalType-এর জন্য গ্রহণযোগ্য ভ্যালু হল:

  • PERFORMANCE_GOAL_TYPE_CPM
  • PERFORMANCE_GOAL_TYPE_CPC
  • PERFORMANCE_GOAL_TYPE_CPA
  • PERFORMANCE_GOAL_TYPE_CPIAVC
  • PERFORMANCE_GOAL_TYPE_CTR
  • PERFORMANCE_GOAL_TYPE_VIEWABILITY
  • PERFORMANCE_GOAL_TYPE_OTHER

CampaignGoalType

ক্যাম্পেন লক্ষ্যের সম্ভাব্য ধরন।

Enums
CAMPAIGN_GOAL_TYPE_UNSPECIFIED এই ভার্সনে লক্ষ্যের ভ্যালু উল্লেখ করা নেই বা অজানা।
CAMPAIGN_GOAL_TYPE_APP_INSTALL অ্যাপ ইনস্টল বা এনগেজমেন্ট বাড়ান।
CAMPAIGN_GOAL_TYPE_BRAND_AWARENESS কোনও ব্র্যান্ড বা প্রোডাক্ট সম্পর্কে সচেতনতা বাড়ানো।
CAMPAIGN_GOAL_TYPE_OFFLINE_ACTION অফলাইন বা ইন-স্টোর বিক্রি বাড়ান।
CAMPAIGN_GOAL_TYPE_ONLINE_ACTION অনলাইন অ্যাকশন বা ভিজিট বাড়ান।

PerformanceGoal

ক্যাম্পেনের পারফর্ম্যান্স লক্ষ্য নিয়ন্ত্রণ করে এমন সেটিংস।

JSON উপস্থাপনা 
{
  "performanceGoalType": enum (PerformanceGoalType),

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "performanceGoalAmountMicros": string,
  "performanceGoalPercentageMicros": string,
  "performanceGoalString": string
  // End of mutually exclusive fields.
}
ফিল্ড
performanceGoalType

enum (PerformanceGoalType)

প্রয়োজনীয়। পারফর্ম্যান্সের লক্ষ্যের ধরন।
প্রয়োজনীয়। প্রদত্ত performance_goal_type-এর সাথে সম্পর্কিত পারফর্ম্যান্স লক্ষ্যের ভ্যালু। নিচে পারস্পরিকভাবে এক্সক্লুসিভ ফিল্ডের তালিকা দেওয়া হল। উত্তরে সর্বাধিক একটি ফিল্ড সেট করা হবে:
performanceGoalAmountMicros

string (int64 format)

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

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

  • PERFORMANCE_GOAL_TYPE_CPM
  • PERFORMANCE_GOAL_TYPE_CPC
  • PERFORMANCE_GOAL_TYPE_CPA
  • PERFORMANCE_GOAL_TYPE_CPIAVC
  • PERFORMANCE_GOAL_TYPE_VCPM

যেমন, ১৫০০০০০ বলতে কারেন্সির ১.৫ স্ট্যান্ডার্ড ইউনিট বোঝায়।
performanceGoalPercentageMicros

string (int64 format)

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

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

  • PERFORMANCE_GOAL_TYPE_CTR
  • PERFORMANCE_GOAL_TYPE_VIEWABILITY
  • PERFORMANCE_GOAL_TYPE_CLICK_CVR
  • PERFORMANCE_GOAL_TYPE_IMPRESSION_CVR
  • PERFORMANCE_GOAL_TYPE_VTR
  • PERFORMANCE_GOAL_TYPE_AUDIO_COMPLETION_RATE
  • PERFORMANCE_GOAL_TYPE_VIDEO_COMPLETION_RATE

যেমন, ৭০০০০ বলতে ৭% (দশমিক ০.০৭) বোঝায়।
performanceGoalString

string

একটি মূল অবদান সূচক (KPI) স্ট্রিং, যা খালি থাকতে পারে। UTF-8 এনকোড করা হতে হবে এবং ১০০ অক্ষরের বেশি হওয়া চলবে না।

performanceGoalType-এর মান PERFORMANCE_GOAL_TYPE_OTHER-এ সেট করা থাকলে প্রযোজ্য।
মিউচুয়ালি এক্সক্লুসিভ ফিল্ডের শেষ।

PerformanceGoalType

পারফর্ম্যান্সের লক্ষ্যের সম্ভাব্য ধরন।

Enums
PERFORMANCE_GOAL_TYPE_UNSPECIFIED এই ভার্সনে পারফর্ম্যান্স লক্ষ্যের ধরন উল্লেখ করা নেই বা অজানা।
PERFORMANCE_GOAL_TYPE_CPM পারফর্ম্যান্সের লক্ষ্য CPM (প্রতি হাজার ইম্প্রেশনের খরচ)-এ সেট করা হয়।
PERFORMANCE_GOAL_TYPE_CPC পারফর্ম্যান্সের লক্ষ্য CPC (কস্ট-পার-ক্লিক)-এ সেট করা হয়।
PERFORMANCE_GOAL_TYPE_CPA পারফর্ম্যান্স সংক্রান্ত লক্ষ্য CPA (প্রতি অ্যাকশনের খরচ) হিসেবে সেট করা হয়।
PERFORMANCE_GOAL_TYPE_CTR পারফর্ম্যান্সের লক্ষ্য CTR (ক্লিক-থ্রু রেট) শতাংশে সেট করা হয়।
PERFORMANCE_GOAL_TYPE_VIEWABILITY পারফর্ম্যান্সের লক্ষ্য ভিউয়েবিলিটি শতাংশে সেট করা হয়।
PERFORMANCE_GOAL_TYPE_CPIAVC পারফর্ম্যান্সের লক্ষ্য CPIAVC (ইম্প্রেশন পিছু খরচ যা সম্পূর্ণ হওয়ার সময় শোনা ও দেখা যায়) হিসেবে সেট করা হয়।
PERFORMANCE_GOAL_TYPE_CPE পারফর্ম্যান্সের লক্ষ্য CPE (এনগেজমেন্ট প্রতি খরচ) হিসেবে সেট করা হয়।
PERFORMANCE_GOAL_TYPE_CPV পারফর্ম্যান্সের লক্ষ্য CPV (ভিউ প্রতি খরচ)-তে সেট করা হয়।
PERFORMANCE_GOAL_TYPE_CLICK_CVR পারফর্ম্যান্স লক্ষ্য ক্লিক কনভার্সন রেট (ক্লিক প্রতি কনভার্সন) শতাংশে সেট করা হয়।
PERFORMANCE_GOAL_TYPE_IMPRESSION_CVR পারফর্ম্যান্স লক্ষ্য ইম্প্রেশন কনভার্সন রেট (ইম্প্রেশন প্রতি কনভার্সন) শতাংশে সেট করা হয়।
PERFORMANCE_GOAL_TYPE_VCPM পারফর্ম্যান্সের লক্ষ্য VCPM (প্রতি হাজার ভিউয়েবল ইম্প্রেশনের খরচ) হিসেবে সেট করা হয়।
PERFORMANCE_GOAL_TYPE_VTR পারফর্ম্যান্সের লক্ষ্য YouTube ভিউ রেট (প্রতি ইম্প্রেশনে YouTube ভিউ) শতাংশে সেট করা হয়।
PERFORMANCE_GOAL_TYPE_AUDIO_COMPLETION_RATE পারফর্ম্যান্সের লক্ষ্য অডিও সম্পূর্ণ করার হার (প্রতি ইম্প্রেশনে সম্পূর্ণ অডিও শোনা) শতাংশে সেট করা হয়।
PERFORMANCE_GOAL_TYPE_VIDEO_COMPLETION_RATE ভিডিও সম্পূর্ণ করার হার (প্রতি ইম্প্রেশনে সম্পূর্ণ ভিডিও ভিউ) শতাংশে পারফর্ম্যান্স লক্ষ্য সেট করা হয়।
PERFORMANCE_GOAL_TYPE_OTHER পারফর্ম্যান্সের লক্ষ্য 'অন্যান্য' হিসেবে সেট করা হয়েছে।

CampaignFlight

এমন সেটিংস যা ক্যাম্পেনের পরিকল্পিত খরচ ও সময়সীমা ট্র্যাক করে।

JSON উপস্থাপনা 
{
  "plannedSpendAmountMicros": string,
  "plannedDates": {
    object (DateRange)
  }
}
ফিল্ড
plannedSpendAmountMicros

string (int64 format)

প্রদত্ত plannedDates-এর জন্য ক্যাম্পেনে যে পরিমাণ অর্থ খরচ হতে পারে। এটি পরিবেশন সীমাবদ্ধ করবে না, তবে DV360 UI-তে খরচ ট্র্যাক করার জন্য ব্যবহার করা হবে।

পরিমাণটি মাইক্রোতে আছে। ০-এর থেকে বড় বা সমান হতে হবে। যেমন, 500000000 বলতে কারেন্সির ৫০০ স্ট্যান্ডার্ড ইউনিট বোঝায়।
plannedDates

object (DateRange)

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

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

CampaignBudget

ক্যাম্পেনের বাজেট কীভাবে বরাদ্দ করা হবে তা নিয়ন্ত্রণ করার সেটিংস।

JSON উপস্থাপনা 
{
  "budgetId": string,
  "displayName": string,
  "budgetUnit": enum (BudgetUnit),
  "budgetAmountMicros": string,
  "dateRange": {
    object (DateRange)
  },
  "externalBudgetSource": enum (ExternalBudgetSource),
  "externalBudgetId": string,
  "invoiceGroupingId": string,
  "prismaConfig": {
    object (PrismaConfig)
  }
}
ফিল্ড
budgetId

string (int64 format)

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

campaignBudgets-এ বাজেট আপডেট বা যোগ করার সময় অবশ্যই অন্তর্ভুক্ত করতে হবে। অন্যথায়, একটি নতুন আইডি তৈরি করে অ্যাসাইন করা হবে।
displayName

string

প্রয়োজনীয়। বাজেটের ডিসপ্লে নাম।

সর্বাধিক ২৪০ বাইট সাইজের UTF-8 এনকোডেড হতে হবে।
budgetUnit

enum (BudgetUnit)

প্রয়োজনীয়। পরিবর্তন করা যাবে না। বাজেট মুদ্রা নাকি ইম্প্রেশনে পরিমাপ করা হয় তা উল্লেখ করে।
budgetAmountMicros

string (int64 format)

প্রয়োজনীয়। লিঙ্ক করা ইনসার্শন অর্ডার সেগমেন্টের মোট বাজেট।

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

object (DateRange)

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

startDate এবং endDate, দুটিই ২০৩৭ সালের আগের হতে হবে।
externalBudgetSource

enum (ExternalBudgetSource)

প্রয়োজনীয়। বাজেটের এক্সটার্নাল সোর্স।
externalBudgetId

string

পরিবর্তন করা যাবে না। এক্সটার্নাল সোর্সে এই বাজেট শনাক্ত করার আইডি।

এই ফিল্ড সেট করা থাকলে এবং সংশ্লিষ্ট বিলিং প্রোফাইলের ইনভয়েস বিবরণ লেভেল "বাজেট লেভেল PO" হিসেবে সেট করা থাকলে, এই বাজেটের জন্য দেখানো সব ইম্প্রেশনের ইনভয়েসে এই আইডি অন্তর্ভুক্ত থাকবে।

ক্যাম্পেনের অধীনে অনন্য হতে হবে।
invoiceGroupingId

string

পরিবর্তন করা যাবে না। একই ইনভয়েসে অন্তর্ভুক্ত করার জন্য বাজেট গ্রুপ করতে ব্যবহৃত আইডি।

এই ফিল্ড সেট করা থাকলে এবং সংশ্লিষ্ট বিলিং প্রোফাইলের ইনভয়েস লেভেল "বাজেট ইনভয়েস গ্রুপিং আইডি" হিসেবে সেট করা থাকলে, একই invoiceGroupingId শেয়ার করা সব externalBudgetId একই ইনভয়েসে গ্রুপ করা হবে।
prismaConfig

object (PrismaConfig)

Mediaocean Prisma টুলের ব্যবহারের জন্য অতিরিক্ত মেটাডেটা।

Mediaocean বাজেটের জন্য প্রয়োজন।

শুধুমাত্র prismaEnabled বিজ্ঞাপনদাতার ক্ষেত্রে প্রযোজ্য।

ExternalBudgetSource

ক্যাম্পেন বাজেট সেগমেন্টের জন্য এক্সটার্নাল সোর্স।

Enums
EXTERNAL_BUDGET_SOURCE_UNSPECIFIED এই ভার্সনে এক্সটার্নাল বাজেট সোর্স ভ্যালু উল্লেখ করা নেই বা অজানা।
EXTERNAL_BUDGET_SOURCE_NONE বাজেটের কোনও এক্সটার্নাল সোর্স নেই।
EXTERNAL_BUDGET_SOURCE_MEDIA_OCEAN বাজেটের সোর্স হল Mediaocean।

PrismaConfig

Mediaocean Prisma টুলের জন্য নির্দিষ্ট সেটিংস।

JSON উপস্থাপনা 
{
  "prismaType": enum (PrismaType),
  "prismaCpeCode": {
    object (PrismaCpeCode)
  },
  "supplier": string
}
ফিল্ড
prismaType

enum (PrismaType)

প্রয়োজনীয়। Prisma-র ধরন।
prismaCpeCode

object (PrismaCpeCode)

প্রয়োজনীয়। Mediaocean Prisma টুল থেকে প্রাসঙ্গিক ক্লায়েন্ট, প্রোডাক্ট এবং আনুমানিক কোড।
supplier

string

প্রয়োজনীয়। এই বাজেট বরাদ্দ করা এন্টিটি (DSP, সাইট ইত্যাদি)।

PrismaType

Prisma বাজেটের সম্ভাব্য ধরন।

Enums
PRISMA_TYPE_UNSPECIFIED এই ভার্সনে ধরন উল্লেখ করা নেই বা অজানা।
PRISMA_TYPE_DISPLAY ডিসপ্লের ধরন।
PRISMA_TYPE_VIDEO ভিডিওর ধরন।
PRISMA_TYPE_AUDIO অডিওর ধরন।
PRISMA_TYPE_SOCIAL সামাজিক ধরন।
PRISMA_TYPE_FEE ফিয়ের ধরন।

PrismaCpeCode

Google Payments Center এই কোডের কম্পোনেন্ট ফিল্ডে সার্চ ও ফিল্টার করার সুবিধা দেয়।

JSON উপস্থাপনা 
{
  "prismaClientCode": string,
  "prismaProductCode": string,
  "prismaEstimateCode": string
}
ফিল্ড
prismaClientCode

string

Prisma ক্লায়েন্ট কোড।
prismaProductCode

string

Prisma প্রোডাক্ট কোড।
prismaEstimateCode

string

Prisma এস্টিমেট কোড।

পদ্ধতি

create

 নতুন ক্যাম্পেন তৈরি করে।

delete

 স্থায়ীভাবে ক্যাম্পেন মুছে দেয়।

get

 একটি ক্যাম্পেন পায়।

list

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

patch

 আগে থেকে থাকা ক্যাম্পেন আপডেট করে।