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 প্রতিনিধিত্ব
{
  "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

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

পদ্ধতি

bulkListCampaignAssignedTargetingOptions

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

create

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

delete

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

get

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

list

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

patch

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