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 সর্বাধিক 240 বাইটের আকারের সাথে এনকোড করা আবশ্যক৷

entityStatus

enum ( EntityStatus )

প্রয়োজন। এই প্রচারাভিযানের অধীনে সন্নিবেশ আদেশগুলি তাদের বাজেট এবং ইনভেন্টরিতে বিড করতে পারে কিনা তা নিয়ন্ত্রণ করে৷

  • স্বীকৃত মানগুলি হল ENTITY_STATUS_ACTIVE , ENTITY_STATUS_ARCHIVED , এবং ENTITY_STATUS_PAUSED ৷
  • campaigns.create পদ্ধতির জন্য, ENTITY_STATUS_ARCHIVED অনুমোদিত নয়৷
updateTime

string ( Timestamp format)

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

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

campaignGoal

object ( CampaignGoal )

প্রয়োজন। অভিযানের লক্ষ্য।

campaignFlight

object ( CampaignFlight )

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

frequencyCap

object ( FrequencyCap )

প্রয়োজন। ক্যাম্পেইনের ফ্রিকোয়েন্সি ক্যাপ সেটিং।

campaignBudgets[]

object ( CampaignBudget )

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

যদি এই ক্ষেত্রটি সেট করা না থাকে, প্রচারাভিযান একটি সীমাহীন বাজেট ব্যবহার করে।

প্রচারাভিযানের লক্ষ্য

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

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

ক্যাম্পেইনগোল টাইপ

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

এনামস
CAMPAIGN_GOAL_TYPE_UNSPECIFIED এই সংস্করণে লক্ষ্য মান নির্দিষ্ট বা অজানা নয়।
CAMPAIGN_GOAL_TYPE_APP_INSTALL ড্রাইভ অ্যাপ ইনস্টল বা ব্যস্ততা।
CAMPAIGN_GOAL_TYPE_BRAND_AWARENESS একটি ব্র্যান্ড বা পণ্য সচেতনতা বাড়ান.
CAMPAIGN_GOAL_TYPE_OFFLINE_ACTION অফলাইন বা ইন-স্টোর বিক্রয় চালান।
CAMPAIGN_GOAL_TYPE_ONLINE_ACTION অনলাইন অ্যাকশন বা ভিজিট চালান।

কর্মক্ষমতা লক্ষ্য

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

JSON প্রতিনিধিত্ব
{
  "performanceGoalType": enum (PerformanceGoalType),

  // Union field performance_goal_value can be only one of the following:
  "performanceGoalAmountMicros": string,
  "performanceGoalPercentageMicros": string,
  "performanceGoalString": string
  // End of list of possible types for union field performance_goal_value.
}
ক্ষেত্র
performanceGoalType

enum ( PerformanceGoalType )

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

ইউনিয়ন ক্ষেত্রের performance_goal_value । প্রয়োজন। একটি প্রদত্ত performance_goal_type সাথে সামঞ্জস্যপূর্ণ কর্মক্ষমতা লক্ষ্যের মান। performance_goal_value নিম্নলিখিতগুলির মধ্যে একটি হতে পারে:
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

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

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

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

performanceGoalString

string

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

performanceGoalType PERFORMANCE_GOAL_TYPE_OTHER এ সেট করা থাকলে প্রযোজ্য।

পারফরম্যান্স গোল টাইপ

সম্ভাব্য ধরনের কর্মক্ষমতা লক্ষ্য.

এনামস
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_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 কর্মক্ষমতা লক্ষ্য অন্য সেট করা হয়েছে.

ক্যাম্পেইনফ্লাইট

সেটিংস যা পরিকল্পিত ব্যয় এবং প্রচারের সময়কাল ট্র্যাক করে।

JSON প্রতিনিধিত্ব
{
  "plannedSpendAmountMicros": string,
  "plannedDates": {
    object (DateRange)
  }
}
ক্ষেত্র
plannedSpendAmountMicros

string ( int64 format)

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

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

plannedDates

object ( DateRange )

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

  • এখানে উল্লেখিত তারিখগুলি পরিবেশনকে প্রভাবিত করবে না। এগুলি সতর্কতা এবং সতর্কতা তৈরি করতে ব্যবহৃত হয়। উদাহরণস্বরূপ, যদি কোনো শিশু সন্নিবেশ আদেশের ফ্লাইট তারিখ এই তারিখের সীমার বাইরে হয়, তাহলে ব্যবহারকারী ইন্টারফেস একটি সতর্কতা দেখাবে।
  • startDate আবশ্যক এবং বর্তমান তারিখ বা তার পরে হতে হবে।
  • endDate ঐচ্ছিক। যদি নির্দিষ্ট করা থাকে, তাহলে এটি অবশ্যই startDate বা তার পরে হতে হবে।
  • যে কোনো নির্দিষ্ট তারিখ 2037 সালের আগে হতে হবে।

ক্যাম্পেইন বাজেট

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

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 সর্বাধিক 240 বাইটের আকারের সাথে এনকোড করা আবশ্যক৷

budgetUnit

enum ( BudgetUnit )

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

budgetAmountMicros

string ( int64 format)

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

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

dateRange

object ( DateRange )

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

startDate এবং endDate উভয়ই 2037 সালের আগে হতে হবে।

externalBudgetSource

enum ( ExternalBudgetSource )

প্রয়োজন। বাজেটের বাহ্যিক উৎস।

externalBudgetId

string

অপরিবর্তনীয়। বাহ্যিক উত্স থেকে এই বাজেট সনাক্তকারী ID.

যদি এই ক্ষেত্রটি সেট করা হয় এবং সংশ্লিষ্ট বিলিং প্রোফাইলের চালানের বিশদ স্তরটি "বাজেট স্তর PO" তে সেট করা হয়, তবে এই বাজেটের বিপরীতে পরিবেশিত সমস্ত ইম্প্রেশন চালানে এই ID অন্তর্ভুক্ত করবে৷

প্রচারণার অধীনে অনন্য হতে হবে।

invoiceGroupingId

string

অপরিবর্তনীয়। একই চালান অন্তর্ভুক্ত করার জন্য গ্রুপ বাজেটের জন্য ব্যবহৃত ID।

যদি এই ক্ষেত্রটি সেট করা থাকে এবং সংশ্লিষ্ট বিলিং প্রোফাইলের চালান স্তরটি "বাজেট চালান গ্রুপিং আইডি" তে সেট করা হয়, তবে একই invoiceGroupingId ভাগ করে নেওয়া সমস্ত externalBudgetId বাজেট আইডি একই চালানে গোষ্ঠীবদ্ধ হবে৷

prismaConfig

object ( PrismaConfig )

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

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

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

বাহ্যিক বাজেট উৎস

একটি প্রচারাভিযান বাজেট অংশের জন্য বাহ্যিক উৎস।

এনামস
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 )

প্রয়োজন। প্রিজমা টাইপ।

prismaCpeCode

object ( PrismaCpeCode )

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

supplier

string

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

প্রিজমা টাইপ

প্রিজমা বাজেটের জন্য সম্ভাব্য প্রকার।

এনামস
PRISMA_TYPE_UNSPECIFIED এই সংস্করণে প্রকার নির্দিষ্ট বা অজানা নয়।
PRISMA_TYPE_DISPLAY প্রদর্শনের ধরন।
PRISMA_TYPE_VIDEO ভিডিও টাইপ।
PRISMA_TYPE_AUDIO অডিও প্রকার।
PRISMA_TYPE_SOCIAL সামাজিক ধরন।
PRISMA_TYPE_FEE ফি টাইপ।

PrismaCpeCode

Google পেমেন্ট সেন্টার এই কোডের উপাদান ক্ষেত্রগুলিতে অনুসন্ধান এবং ফিল্টারিং সমর্থন করে৷

JSON প্রতিনিধিত্ব
{
  "prismaClientCode": string,
  "prismaProductCode": string,
  "prismaEstimateCode": string
}
ক্ষেত্র
prismaClientCode

string

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

prismaProductCode

string

প্রিজমা পণ্য কোড।

prismaEstimateCode

string

প্রিজমা অনুমান কোড।

পদ্ধতি

create

 একটি নতুন প্রচারণা তৈরি করে।

delete

 একটি প্রচারাভিযান স্থায়ীভাবে মুছে দেয়।

get

 প্রচারণা পায়।

list

 একটি বিজ্ঞাপনদাতা প্রচারাভিযান তালিকা.

listAssignedTargetingOptions

 টার্গেটিং প্রকার জুড়ে একটি প্রচারাভিযানের নির্ধারিত টার্গেটিং বিকল্পের তালিকা করে।

patch

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