REST Resource: advertisers

রিসোর্স: বিজ্ঞাপনদাতা

Display & Video 360 (DV360)-এ একজন বিজ্ঞাপনদাতা।

JSON উপস্থাপনা 
{
  "name": string,
  "advertiserId": string,
  "partnerId": string,
  "displayName": string,
  "entityStatus": enum (EntityStatus),
  "updateTime": string,
  "generalConfig": {
    object (AdvertiserGeneralConfig)
  },
  "adServerConfig": {
    object (AdvertiserAdServerConfig)
  },
  "creativeConfig": {
    object (AdvertiserCreativeConfig)
  },
  "dataAccessConfig": {
    object (AdvertiserDataAccessConfig)
  },
  "integrationDetails": {
    object (IntegrationDetails)
  },
  "servingConfig": {
    object (AdvertiserTargetingConfig)
  },
  "prismaEnabled": boolean,
  "billingConfig": {
    object (AdvertiserBillingConfig)
  },
  "containsEuPoliticalAds": enum (EuPoliticalAdvertisingStatus),
  "defaultBusinessName": string,
  "defaultLogoAssetId": string
}
ফিল্ড
name

string

শুধু আউটপুট। বিজ্ঞাপনদাতার রিসোর্স নাম।
advertiserId

string (int64 format)

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

string (int64 format)

প্রয়োজনীয়। পরিবর্তন করা যাবে না। বিজ্ঞাপনদাতা যে পার্টনারের সাথে যুক্ত তার অনন্য আইডি।
displayName

string

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

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

enum (EntityStatus)

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

  • স্বীকৃত মান হল ENTITY_STATUS_ACTIVE, ENTITY_STATUS_PAUSED এবং ENTITY_STATUS_SCHEDULED_FOR_DELETION।
  • ENTITY_STATUS_SCHEDULED_FOR_DELETION-এ সেট করা হলে, বিজ্ঞাপনদাতা মুছে ফেলার জন্য প্রথম শিডিউল করার ৩০ দিন পরে মুছে ফেলা হবে।
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"।
generalConfig

object (AdvertiserGeneralConfig)

প্রয়োজনীয়। বিজ্ঞাপনদাতার সাধারণ সেটিংস।
adServerConfig

object (AdvertiserAdServerConfig)

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

object (AdvertiserCreativeConfig)

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

object (AdvertiserDataAccessConfig)

বিজ্ঞাপনদাতার ডেটা কীভাবে অ্যাক্সেস করা যেতে পারে তা নিয়ন্ত্রণ করার সেটিংস।
integrationDetails

object (IntegrationDetails)

বিজ্ঞাপনদাতার ইন্টিগ্রেশনের বিবরণ। বর্তমানে বিজ্ঞাপনদাতার জন্য শুধুমাত্র integrationCode প্রযোজ্য। IntegrationDetails-এর অন্যান্য ফিল্ড কাজ করে না এবং প্রদান করা হলে তা উপেক্ষা করা হবে।
servingConfig

object (AdvertiserTargetingConfig)

বিজ্ঞাপনদাতার বিজ্ঞাপন পরিষেবা সংক্রান্ত টার্গেটিং সেটিংস।
prismaEnabled

boolean

Mediaocean (Prisma)-এর সাথে ইন্টিগ্রেশন চালু করা আছে কিনা। এটি চালু করার অর্থ হল, আপনি নিম্নলিখিত বিষয়ে সম্মতি জানাচ্ছেন:

আমার কোম্পানির পক্ষ থেকে, আমি Mediaocean (Prisma)-কে Google-এ বাজেট সেগমেন্ট প্ল্যান পাঠানোর অনুমতি দিচ্ছি এবং আমি Google-কে এই বিজ্ঞাপনদাতার বাজেট প্ল্যানিং, বিলিং এবং রিকনসিলিয়েশনের উদ্দেশ্যে DV360 থেকে Mediaocean-এ সংশ্লিষ্ট রিপোর্টিং এবং ইনভয়েস পাঠানোর অনুমতি দিচ্ছি।
billingConfig

object (AdvertiserBillingConfig)

প্রয়োজনীয়। বিজ্ঞাপনদাতার বিলিং সম্পর্কিত সেটিংস।
containsEuPoliticalAds

enum (EuPoliticalAdvertisingStatus)

ঐচ্ছিক। এই বিজ্ঞাপনদাতার কাছে ইউরোপীয় ইউনিয়নের রাজনৈতিক বিজ্ঞাপন পরিবেশন করে এমন লাইন আইটেম আছে কিনা।

এই ফিল্ড DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING-এ সেট করা থাকলে, নিম্নলিখিত ঘটনা ঘটবে:

  • এই বিজ্ঞাপনদাতার অধীনে তৈরি করা যেকোনও নতুন লাইন আইটেমকে DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING-এ অ্যাসাইন করা হবে, যদি না অন্যভাবে নির্দিষ্ট করা হয়।
  • এই বিজ্ঞাপনদাতার অধীনে থাকা যেকোনও বিদ্যমান লাইন আইটেম যার কোনও সেট ভ্যালু নেই, তা দিনের মধ্যে DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING-এ আপডেট করা হবে।
defaultBusinessName

string

ঐচ্ছিক। বিজ্ঞাপনদাতার জন্য ব্যবসার ডিফল্ট নাম।

কোনও ব্যবসার নাম প্রদান করা না হলে, এই বিজ্ঞাপনদাতার অধীনে YouTube এবং ডিমান্ড জেনারেশন বিজ্ঞাপনের মাধ্যমে এই ভ্যালু ব্যবহার করা হয়।
defaultLogoAssetId

string (int64 format)

ঐচ্ছিক। বিজ্ঞাপনদাতার জন্য ডিফল্ট লোগো ছবির অ্যাসেট আইডি।

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

API ব্যবহার করে এই অ্যাসেট আপলোড করতে আপনাকে অবশ্যই advertisers.adAssets.upload ব্যবহার করতে হবে।

AdvertiserGeneralConfig

বিজ্ঞাপনদাতার সাধারণ সেটিংস।

JSON উপস্থাপনা 
{
  "domainUrl": string,
  "timeZone": string,
  "currencyCode": string
}
ফিল্ড
domainUrl

string

প্রয়োজনীয়। বিজ্ঞাপনদাতার প্রাথমিক ওয়েবসাইটের ডোমেন URL। সিস্টেম এই তথ্য সেইসব প্রকাশকদের পাঠাবে যাদের কোনও বিজ্ঞাপনদাতার সাথে ক্যাম্পেন অ্যাসোসিয়েট করার জন্য ওয়েবসাইটের URL প্রয়োজন।

http: বা https: দিয়ে শুরু হয় এমন কোনও পাথ বা কোয়েরি স্ট্রিং ছাড়া URL দিন। যেমন, http://www.example.com
timeZone

string

শুধু আউটপুট। বিজ্ঞাপনদাতার টাইম জোনের স্ট্যান্ডার্ড TZ ডেটাবেসের নাম। যেমন, America/New_York

আরও জানতে এখানে দেখুন: https://en.wikipedia.org/wiki/List_of_tz_database_time_zones

CM360 হাইব্রিড বিজ্ঞাপনদাতাদের ক্ষেত্রে, টাইম জোন সংশ্লিষ্ট CM360 অ্যাকাউন্টের মতোই; শুধুমাত্র থার্ড-পার্টি বিজ্ঞাপনদাতাদের ক্ষেত্রে, টাইম জোন মূল পার্টনারের মতোই।
currencyCode

string

প্রয়োজনীয়। পরিবর্তন করা যাবে না। ISO 4217 ফর্ম্যাটে বিজ্ঞাপনদাতার মুদ্রা।

গ্রহণযোগ্য কোড এবং সেগুলি যে কারেন্সি দেখায় তা হল:

মুদ্রার কোড : মুদ্রার নাম

  • ARS : আর্জেন্টাইন পেসো
  • AUD : অস্ট্রেলিয়ান ডলার
  • BRL : ব্রাজিলিয়ান রিয়েল
  • CAD : কানাডিয়ান ডলার
  • CHF : সুইস ফ্রাঙ্ক
  • CLP : চিলির পেসো
  • CNY : চাইনিজ ইউয়ান
  • COP : কলম্বিয়ান পেসো
  • CZK : চেক করুনা
  • DKK : ড্যানিশ ক্রোন
  • EGP : মিশরীয় পাউন্ড
  • EUR : ইউরো
  • GBP : ব্রিটিশ পাউন্ড
  • HKD : হংকং ডলার
  • HUF : হাঙ্গেরিয়ান ফরিন্ট
  • IDR : ইন্দোনেশিয়ান রুপিয়াহ
  • ILS : ইসরায়েলি শেকেল
  • INR : ভারতীয় টাকা
  • JPY : জাপানি ইয়েন
  • KRW : দক্ষিণ কোরিয়ান ওন
  • MXN : মেক্সিকান পেসো
  • MYR : মালয়েশিয়ান রিঙ্গিত
  • NGN : নাইজেরিয়ান নায়রা
  • NOK : নরওয়েজিয়ান ক্রোন
  • NZD : নিউজিল্যান্ড ডলার
  • PEN : পেরুভিয়ান নিউভো সোল
  • PLN : পোলিশ জলোটি
  • RON : নতুন রোমানিয়ান লিউ
  • RUB : রাশিয়ান রুবেল
  • SEK : সুইডিশ ক্রোনা
  • TRY : তুর্কি লিরা
  • TWD : নিউ তাইওয়ান ডলার
  • USD : মার্কিন ডলার
  • ZAR : দক্ষিণ আফ্রিকান রেন্ড

AdvertiserAdServerConfig

বিজ্ঞাপনদাতার বিজ্ঞাপন সার্ভার সম্পর্কিত সেটিংস।

JSON উপস্থাপনা 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "thirdPartyOnlyConfig": {
    object (ThirdPartyOnlyConfig)
  },
  "cmHybridConfig": {
    object (CmHybridConfig)
  }
  // End of mutually exclusive fields.
}
ফিল্ড
প্রয়োজনীয়। নিচে পারস্পরিকভাবে এক্সক্লুসিভ ফিল্ডের তালিকা দেওয়া হল। উত্তরে সর্বাধিক একটি ফিল্ড সেট করা হবে:
thirdPartyOnlyConfig

object (ThirdPartyOnlyConfig)

শুধুমাত্র থার্ড-পার্টি বিজ্ঞাপন সার্ভার ব্যবহার করে এমন বিজ্ঞাপনদাতাদের জন্য কনফিগারেশন।
cmHybridConfig

object (CmHybridConfig)

Campaign Manager 360 (CM360) এবং থার্ড-পার্টি বিজ্ঞাপন সার্ভার, দুটিই ব্যবহার করেন এমন বিজ্ঞাপনদাতাদের জন্য কনফিগারেশন।
মিউচুয়ালি এক্সক্লুসিভ ফিল্ডের শেষ।

ThirdPartyOnlyConfig

শুধুমাত্র থার্ড-পার্টি বিজ্ঞাপন সার্ভার ব্যবহার করে এমন বিজ্ঞাপনদাতাদের জন্য সেটিংস।

JSON উপস্থাপনা 
{
  "pixelOrderIdReportingEnabled": boolean
}
ফিল্ড
pixelOrderIdReportingEnabled

boolean

পিক্সেলের জন্য অর্ডার আইডি রিপোর্টিং চালু আছে কিনা। true-এ সেট করা হয়ে গেলে এই ভ্যালু আর পরিবর্তন করা যাবে না।

CmHybridConfig

Campaign Manager 360 (CM360) এবং থার্ড-পার্টি বিজ্ঞাপন সার্ভার, দুটিই ব্যবহার করেন এমন বিজ্ঞাপনদাতাদের জন্য সেটিংস।

JSON উপস্থাপনা 
{
  "cmAccountId": string,
  "cmFloodlightConfigId": string,
  "cmAdvertiserIds": [
    string
  ],
  "cmSyncableSiteIds": [
    string
  ],
  "dv360ToCmDataSharingEnabled": boolean,
  "dv360ToCmCostReportingEnabled": boolean,
  "cmFloodlightLinkingAuthorized": boolean
}
ফিল্ড
cmAccountId

string (int64 format)

প্রয়োজনীয়। পরিবর্তন করা যাবে না। DV360 বিজ্ঞাপনদাতার সাথে লিঙ্ক করা CM360 Floodlight কনফিগারেশনের অ্যাকাউন্ট আইডি।
cmFloodlightConfigId

string (int64 format)

প্রয়োজনীয়। পরিবর্তন করা যাবে না। DV360 বিজ্ঞাপনদাতার সাথে লিঙ্ক করা CM360 Floodlight কনফিগারেশনের আইডি।
cmAdvertiserIds[]

string (int64 format)

শুধু আউটপুট। CM360 Floodlight কনফিগারেশন শেয়ার করা CM360 বিজ্ঞাপনদাতার আইডির সেট।
cmSyncableSiteIds[]

string (int64 format)

CM360 সাইটের একটি তালিকা যার প্লেসমেন্ট ক্রিয়েটিভ হিসেবে DV360-তে সিঙ্ক করা হবে।

advertisers.create পদ্ধতিতে অনুপস্থিত বা খালি থাকলে, সিস্টেম অটোমেটিক একটি CM360 সাইট তৈরি করবে।

এই তালিকা থেকে সাইট সরিয়ে দিলে, CM360 থেকে সিঙ্ক করা DV360 ক্রিয়েটিভ মুছে যেতে পারে। অন্তত একটি সাইট উল্লেখ করতে হবে।
dv360ToCmDataSharingEnabled

boolean

CM360 ডেটা ট্রান্সফার রিপোর্টে DV360 ডেটা অন্তর্ভুক্ত করা হবে কিনা।
dv360ToCmCostReportingEnabled

boolean

CM360-এ DV360 খরচ রিপোর্ট করা হবে কিনা।
cmFloodlightLinkingAuthorized

boolean

প্রয়োজনীয়। পরিবর্তন করা যাবে না। এই ফিল্ড true-এ সেট করার মাধ্যমে, আপনি, আপনার কোম্পানির হয়ে, প্রদত্ত ফ্লাডলাইট কনফিগারেশন থেকে এই Display & Video 360 বিজ্ঞাপনদাতার সাথে তথ্য শেয়ার করার অনুমতি দিচ্ছেন।

AdvertiserCreativeConfig

কোনও বিজ্ঞাপনদাতার ক্রিয়েটিভ সম্পর্কিত সেটিংস।

JSON উপস্থাপনা 
{
  "iasClientId": string,
  "obaComplianceDisabled": boolean,
  "dynamicCreativeEnabled": boolean,
  "videoCreativeDataSharingAuthorized": boolean
}
ফিল্ড
iasClientId

string (int64 format)

Integral Ad Service (IAS)-এর মাধ্যমে প্রদান করা ক্যাম্পেন মনিটরিং কনফিগার করার আইডি। DV360 সিস্টেম ক্রিয়েটিভ ট্যাগে এই আইডি সহ একটি IAS "ক্যাম্পেন মনিটর" ট্যাগ যোগ করবে।
obaComplianceDisabled

boolean

অনলাইন বিহেভিয়েরাল বিজ্ঞাপন (OBA) এবং রেগুলেশন সংক্রান্ত প্রয়োজনীয়তার জন্য আপনার বিজ্ঞাপনে ব্যাজিং (কন্টেন্টকে বিজ্ঞাপন হিসেবে শনাক্ত করার জন্য) এবং ট্রান্সপারেন্সি সংক্রান্ত তথ্য (এই বিজ্ঞাপন সম্পর্কে ফিচারের সাথে ইন্টার‍্যাকশনের সময়) যোগ করে এমন Google-এর এই বিজ্ঞাপন সম্পর্কে ফিচার বন্ধ করা হবে কিনা। 'এই বিজ্ঞাপন সম্পর্কে' ফিচার ব্যবহারকারীদের তাদের দেখা বিজ্ঞাপনের উপর আরও বেশি নিয়ন্ত্রণ দেয় এবং কেন তারা আপনার বিজ্ঞাপন দেখছে তা ব্যাখ্যা করতে আপনাকে সাহায্য করে। আরও জানুন।

আপনি এই ফিল্ড true-এ সেট করার সিদ্ধান্ত নিলে, মনে রাখবেন যে Display & Video 360-এর মাধ্যমে দেখানো বিজ্ঞাপনকে নিম্নলিখিত শর্ত মেনে চলতে হবে:

  • Google Marketing Platform-এর সাথে আপনার চুক্তি অনুযায়ী অনলাইন বিহেভিয়েরাল বিজ্ঞাপন (OBA) সংক্রান্ত নীতি মেনে চলুন।
  • ইউরোপীয় অর্থনৈতিক অঞ্চলে (EEA), বিজ্ঞাপনে বেআইনি কন্টেন্ট সম্পর্কে অভিযোগ জানানোর জন্য ব্যবহারকারীদের স্বচ্ছতা সংক্রান্ত তথ্য ও একটি মেকানিজম অন্তর্ভুক্ত করুন। আপনি যদি বিকল্প বিজ্ঞাপন ব্যাজিং, ট্রান্সপারেন্সি এবং রিপোর্টিং সমাধান ব্যবহার করেন, তাহলে আপনাকে অবশ্যই নিশ্চিত করতে হবে যে এতে প্রয়োজনীয় ট্রান্সপারেন্সি তথ্য এবং বেআইনি কন্টেন্ট ফ্ল্যাগিং মেকানিজম অন্তর্ভুক্ত রয়েছে এবং আপনি উপযুক্ত ফর্ম ব্যবহার করে যেকোনও বেআইনি কন্টেন্টের ব্যাপারে Google-এর কাছে অভিযোগ জানান।
dynamicCreativeEnabled

boolean

বিজ্ঞাপনদাতার জন্য ডায়নামিক ক্রিয়েটিভ চালু আছে কিনা।
videoCreativeDataSharingAuthorized

boolean

এই ফিল্ড true-এ সেট করার মাধ্যমে, আপনি নিজের কোম্পানির হয়ে, Google-কে এই Display & Video 360 বিজ্ঞাপনদাতার সাথে যুক্ত ভিডিও ক্রিয়েটিভ ব্যবহার করার অনুমতি দিচ্ছেন যাতে বিজ্ঞাপনদাতার টেলিভিশন ক্যাম্পেন সম্পর্কিত রিপোর্টিং ও ফিচার প্রদান করা যায়।

বিজ্ঞাপনদাতার CM360 hybrid বিজ্ঞাপন সার্ভার কনফিগারেশন থাকলে তবেই এটি প্রযোজ্য।

AdvertiserDataAccessConfig

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

JSON উপস্থাপনা 
{
  "sdfConfig": {
    object (AdvertiserSdfConfig)
  }
}
ফিল্ড
sdfConfig

object (AdvertiserSdfConfig)

বিজ্ঞাপনদাতার জন্য স্ট্রাকচার্ড ডেটা ফাইল (SDF) সেটিংস।

উল্লেখ করা না থাকলে, মূল পার্টনারের SDF সেটিংস ব্যবহার করা হয়।

AdvertiserSdfConfig

কোনও বিজ্ঞাপনদাতার স্ট্রাকচার্ড ডেটা ফাইল (SDF) সেটিংস।

JSON উপস্থাপনা 
{
  "overridePartnerSdfConfig": boolean,
  "sdfConfig": {
    object (SdfConfig)
  }
}
ফিল্ড
overridePartnerSdfConfig

boolean

এই বিজ্ঞাপনদাতা তার পেরেন্ট পার্টনারের SDF কনফিগারেশন ওভাররাইড করে কিনা।

ডিফল্ট হিসেবে, কোনও বিজ্ঞাপনদাতা পেরেন্ট পার্টনার থেকে SDF কনফিগারেশন ইনহেরিট করে। পার্টনার কনফিগারেশন ওভাররাইড করতে, এই ফিল্ডটি true-এ সেট করুন এবং sdfConfig-এ নতুন কনফিগারেশন প্রদান করুন।
sdfConfig

object (SdfConfig)

বিজ্ঞাপনদাতার জন্য SDF কনফিগারেশন।

AdvertiserTargetingConfig

বিজ্ঞাপনদাতার বিজ্ঞাপন পরিবেশন সম্পর্কিত টার্গেটিং সেটিংস।

JSON উপস্থাপনা 
{
  "exemptTvFromViewabilityTargeting": boolean
}
ফিল্ড
exemptTvFromViewabilityTargeting

boolean

বিজ্ঞাপনদাতার অধীনে থাকা সব ভিডিও লাইন আইটেমের জন্য কানেক্ট করা টিভি ডিভাইস ভিউয়েবিলিটি টার্গেটিং থেকে অব্যাহতি পেয়েছে কিনা।

AdvertiserBillingConfig

বিজ্ঞাপনদাতার বিলিং সম্পর্কিত সেটিংস।

JSON উপস্থাপনা 
{
  "billingProfileId": string
}
ফিল্ড
billingProfileId

string (int64 format)

প্রয়োজনীয়। বিজ্ঞাপনদাতার জন্য অ্যাসাইন করা বিলিং প্রোফাইলের আইডি।

পদ্ধতি

audit

 বিজ্ঞাপনদাতাকে অডিট করে।

create

 নতুন বিজ্ঞাপনদাতা তৈরি করে।

delete

 বিজ্ঞাপনদাতাকে মুছে দেয়।

editAssignedTargetingOptions

 একটি বিজ্ঞাপনদাতার অধীনে টার্গেটিং বিকল্প এডিট করে।

get

 বিজ্ঞাপনদাতা পায়।

list

 বর্তমান ব্যবহারকারীর অ্যাক্সেস আছে এমন বিজ্ঞাপনদাতাদের তালিকা দেখায়।

listAssignedTargetingOptions

 টার্গেটিংয়ের ধরন জুড়ে বিজ্ঞাপনদাতার অ্যাসাইন করা টার্গেটিং বিকল্পের তালিকা দেখায়।

patch

 আগে থেকে থাকা বিজ্ঞাপনদাতা আপডেট করে।