REST Resource: advertisers.creatives

রিসোর্স: ক্রিয়েটিভ

একটি ক্রিয়েটিভ।

JSON উপস্থাপনা 
{
  "name": string,
  "advertiserId": string,
  "creativeId": string,
  "cmPlacementId": string,
  "displayName": string,
  "entityStatus": enum (EntityStatus),
  "updateTime": string,
  "createTime": string,
  "creativeType": enum (CreativeType),
  "hostingSource": enum (HostingSource),
  "dynamic": boolean,
  "dimensions": {
    object (Dimensions)
  },
  "additionalDimensions": [
    {
      object (Dimensions)
    }
  ],
  "mediaDuration": string,
  "creativeAttributes": [
    enum (CreativeAttribute)
  ],
  "reviewStatus": {
    object (ReviewStatusInfo)
  },
  "assets": [
    {
      object (AssetAssociation)
    }
  ],
  "exitEvents": [
    {
      object (ExitEvent)
    }
  ],
  "timerEvents": [
    {
      object (TimerEvent)
    }
  ],
  "counterEvents": [
    {
      object (CounterEvent)
    }
  ],
  "appendedTag": string,
  "integrationCode": string,
  "notes": string,
  "iasCampaignMonitoring": boolean,
  "companionCreativeIds": [
    string
  ],
  "skippable": boolean,
  "skipOffset": {
    object (AudioVideoOffset)
  },
  "progressOffset": {
    object (AudioVideoOffset)
  },
  "universalAdId": {
    object (UniversalAdId)
  },
  "thirdPartyUrls": [
    {
      object (ThirdPartyUrl)
    }
  ],
  "transcodes": [
    {
      object (Transcode)
    }
  ],
  "trackerUrls": [
    string
  ],
  "jsTrackerUrl": string,
  "cmTrackingAd": {
    object (CmTrackingAd)
  },
  "obaIcon": {
    object (ObaIcon)
  },
  "thirdPartyTag": string,
  "requireMraid": boolean,
  "requireHtml5": boolean,
  "requirePingForAttribution": boolean,
  "expandingDirection": enum (ExpandingDirection),
  "expandOnHover": boolean,
  "vastTagUrl": string,
  "vpaid": boolean,
  "html5Video": boolean,
  "lineItemIds": [
    string
  ],
  "mp3Audio": boolean,
  "oggAudio": boolean,
  "syntheticContentAttestationStatus": enum (SyntheticContentAttestationStatus)
}
ফিল্ড
name

string

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

string (int64 format)

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

string (int64 format)

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

string (int64 format)

শুধু আউটপুট। ক্রিয়েটিভের সাথে যুক্ত Campaign Manager 360 প্লেসমেন্টের অনন্য আইডি। এই ফিল্ডটি শুধুমাত্র Campaign Manager থেকে সিঙ্ক করা ক্রিয়েটিভের ক্ষেত্রে প্রযোজ্য।
displayName

string

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

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

enum (EntityStatus)

প্রয়োজনীয়। ক্রিয়েটিভ দেখানো যাবে কিনা তা কন্ট্রোল করে।

গ্রহণযোগ্য ভ্যালু হল:

  • ENTITY_STATUS_ACTIVE
  • ENTITY_STATUS_ARCHIVED
  • ENTITY_STATUS_PAUSED
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"।
createTime

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"।
creativeType

enum (CreativeType)

প্রয়োজনীয়। পরিবর্তন করা যাবে না। ক্রিয়েটিভের ধরন।
hostingSource

enum (HostingSource)

প্রয়োজনীয়। ক্রিয়েটিভ কোথায় হোস্ট করা হয়েছে তা দেখায়।
dynamic

boolean

শুধু আউটপুট। ক্রিয়েটিভটি ডায়নামিক কিনা তা দেখায়।
dimensions

object (Dimensions)

প্রয়োজনীয়। ক্রিয়েটিভের প্রাথমিক ডাইমেনশন। সব ধরনের ক্রিয়েটিভের ক্ষেত্রে প্রযোজ্য। creativeType এগুলির মধ্যে একটি হলে, widthPixels ও heightPixels-এর ভ্যালু ডিফল্ট হিসেবে 0 হয়:

  • CREATIVE_TYPE_VIDEO
  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_NATIVE_VIDEO
additionalDimensions[]

object (Dimensions)

ঐচ্ছিক। অতিরিক্ত পরিমাপ। creativeType এর মধ্যে একটি হলে প্রযোজ্য:

  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_EXPANDABLE
  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_LIGHTBOX
  • CREATIVE_TYPE_PUBLISHER_HOSTED

এই ফিল্ড নির্দিষ্ট করা থাকলে, widthPixels এবং heightPixels দুটিই প্রয়োজন এবং ০-এর বেশি বা সমান হতে হবে।
mediaDuration

string (Duration format)

শুধু আউটপুট। ক্রিয়েটিভের মিডিয়া ডিউরেশন। creativeType এর মধ্যে একটি হলে প্রযোজ্য:

  • CREATIVE_TYPE_VIDEO
  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_NATIVE_VIDEO
  • CREATIVE_TYPE_PUBLISHER_HOSTED

's' দিয়ে শেষ হওয়া নয়টি পর্যন্ত ভগ্নাংশ সংখ্যা সহ সেকেন্ডে সময়সীমা। উদাহরণ: "3.5s"।
creativeAttributes[]

enum (CreativeAttribute)

শুধু আউটপুট। সিস্টেমের মাধ্যমে জেনারেট করা ক্রিয়েটিভের অ্যাট্রিবিউটের তালিকা।
reviewStatus

object (ReviewStatusInfo)

শুধু আউটপুট। ক্রিয়েটিভ পর্যালোচনা প্রক্রিয়ার বর্তমান স্ট্যাটাস।
assets[]

object (AssetAssociation)

প্রয়োজনীয়। এই ক্রিয়েটিভের সাথে যুক্ত অ্যাসেট।
exitEvents[]

object (ExitEvent)

প্রয়োজনীয়। এই ক্রিয়েটিভের জন্য এক্সিট ইভেন্ট। এক্সিট (ক্লিক ট্যাগ নামেও পরিচিত) হল আপনার ক্রিয়েটিভের এমন একটি জায়গা যেখানে ক্লিক বা ট্যাপ করে বিজ্ঞাপনদাতার ল্যান্ডিং পৃষ্ঠা খোলা যায়। প্রতিটি ক্রিয়েটিভে অন্তত একটি এক্সিট থাকতে হবে। আপনি নিম্নলিখিত যেকোনও উপায়ে আপনার ক্রিয়েটিভে এক্সিট যোগ করতে পারবেন:

  • Google Web Designer-এর ট্যাপ এরিয়া ব্যবহার করুন।
  • "clickTag" নামে একটি জাভাস্ক্রিপ্ট ভেরিয়েবেল সংজ্ঞায়িত করুন।
  • রিচ মিডিয়া ফর্ম্যাটে এক্সিট ট্র্যাক করতে, Enabler (Enabler.exit()) ব্যবহার করুন।
timerEvents[]

object (TimerEvent)

ঐচ্ছিক। রিচ মিডিয়া ক্রিয়েটিভের জন্য টাইমার কাস্টম ইভেন্ট। টাইমার সেই সময় ট্র্যাক করে যে সময় কোনও ব্যবহারকারী রিচ মিডিয়া ক্রিয়েটিভের নির্দিষ্ট অংশ দেখেন এবং সেটির সাথে ইন্টার‍্যাক্ট করেন। একটি ক্রিয়েটিভে একাধিক টাইমার ইভেন্ট থাকতে পারে, যার প্রত্যেকটি আলাদাভাবে সময় নির্ধারণ করে। শুধুমাত্র ইমেজ অ্যাসেট আছে এমন ক্রিয়েটিভের জন্য এটি খালি রাখুন বা সেট করবেন না।
counterEvents[]

object (CounterEvent)

ঐচ্ছিক। রিচ মিডিয়া ক্রিয়েটিভের জন্য কাউন্টার ইভেন্ট। কোনও ব্যবহারকারী নির্দিষ্ট উপায়ে (মাউস-ওভার, মাউস-আউট, ক্লিক, ট্যাপ, ডেটা লোডিং, কীবোর্ড এন্ট্রি ইত্যাদি) রিচ মিডিয়া ক্রিয়েটিভের কোনও অংশের সাথে কতবার ইন্টার‍্যাক্ট করেছেন তা কাউন্টার ট্র্যাক করে। ক্রিয়েটিভে ক্যাপচার করা যায় এমন যেকোনও ইভেন্ট কাউন্টার হিসেবে রেকর্ড করা যেতে পারে। শুধুমাত্র ইমেজ অ্যাসেট আছে এমন ক্রিয়েটিভের জন্য এটি খালি রাখুন বা সেট করবেন না।
appendedTag

string

ঐচ্ছিক। ক্রিয়েটিভ ট্যাগের সাথে থার্ড-পার্টি HTML ট্র্যাকিং ট্যাগ যোগ করতে হবে।
integrationCode

string

ঐচ্ছিক। এই ক্রিয়েটিভকে এক্সটার্নাল সিস্টেমের সাথে লিঙ্ক করতে আইডি সংক্রান্ত তথ্য ব্যবহার করা হয়। UTF-8 এনকোড করা হতে হবে এবং দৈর্ঘ্য ১০,০০০ অক্ষরের বেশি হওয়া চলবে না।
notes

string

ঐচ্ছিক। এই ক্রিয়েটিভের জন্য ব্যবহারকারীর নোট। UTF-8 এনকোড করা হতে হবে এবং ২০,০০০ অক্ষরের বেশি হওয়া চলবে না।
iasCampaignMonitoring

boolean

ঐচ্ছিক। Integral Ad Science (IAS) ক্যাম্পেন মনিটর করার সুবিধা চালু আছে কিনা তা দেখায়। ক্রিয়েটিভের জন্য এটি চালু করতে, আপনার IAS ক্লায়েন্ট আইডিতে Advertiser.creative_config.ias_client_id সেট করা আছে কিনা তা নিশ্চিত করুন।
companionCreativeIds[]

string (int64 format)

ঐচ্ছিক। ভিডিও ক্রিয়েটিভের জন্য কম্প্যানিয়ন ক্রিয়েটিভের আইডি।

প্রকাশকের ভিডিও প্লেয়ারের চারপাশে দেখানোর জন্য আপনি আগে থেকে থাকা ডিসপ্লে ক্রিয়েটিভ (ছবি বা HTML5 অ্যাসেট সহ) অ্যাসাইন করতে পারবেন। ভিডিও চলাকালীন ভিডিও প্লেয়ারের চারপাশে কম্প্যানিয়ন বিজ্ঞাপন দেখানো হয় এবং ভিডিও শেষ হওয়ার পরেও তা থেকে যায়।

additional dimensions সহ ক্রিয়েটিভ কম্প্যানিয়ন ক্রিয়েটিভ হতে পারে না।

এই ফিল্ডটি শুধুমাত্র নিম্নলিখিত creativeType-এর জন্য কাজ করে:

  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_VIDEO
skippable

boolean

ঐচ্ছিক। ব্যবহারকারী কোনও ভিডিও ক্রিয়েটিভ এড়িয়ে যাওয়ার বিকল্প বেছে নিতে পারবেন কিনা।

এই ফিল্ডটি শুধুমাত্র নিম্নলিখিত creativeType-এর জন্য কাজ করে:

  • CREATIVE_TYPE_VIDEO
skipOffset

object (AudioVideoOffset)

ঐচ্ছিক। 'এড়িয়ে যান' বোতামটি দেখানোর আগে ভিডিওটি কতক্ষণ চলবে।

skippable সঠিক হলে এই ফিল্ডটি পূরণ করতে হবে।

এই ফিল্ডটি শুধুমাত্র নিম্নলিখিত creativeType-এর জন্য কাজ করে:

  • CREATIVE_TYPE_VIDEO
progressOffset

object (AudioVideoOffset)

ঐচ্ছিক। ভিউ গণনা করার আগে ভিডিওটি কতক্ষণ চালাতে হবে।

skippable সঠিক হলে এই ফিল্ডটি পূরণ করতে হবে।

এই ফিল্ডটি শুধুমাত্র নিম্নলিখিত creativeType-এর জন্য কাজ করে:

  • CREATIVE_TYPE_VIDEO
universalAdId

object (UniversalAdId)

ঐচ্ছিক। রেজিস্ট্রির মাধ্যমে প্রদান করা একটি ঐচ্ছিক ক্রিয়েটিভ শনাক্তকারী যা সব প্ল্যাটফর্ম জুড়ে অনন্য।

ইউনিভার্সাল বিজ্ঞাপন আইডি হল VAST 4.0 স্ট্যান্ডার্ডের অংশ। ক্রিয়েটিভ তৈরি করার পরে এটি পরিবর্তন করা যাবে।

এই ফিল্ডটি শুধুমাত্র নিম্নলিখিত creativeType-এর জন্য কাজ করে:

  • CREATIVE_TYPE_VIDEO
thirdPartyUrls[]

object (ThirdPartyUrl)

ঐচ্ছিক। ভিডিও ক্রিয়েটিভের সাথে ইন্টার‍্যাকশন ট্র্যাক করার জন্য থার্ড-পার্টির ট্র্যাকিং URL।

এই ফিল্ডটি শুধুমাত্র নিম্নলিখিত creativeType-এর জন্য কাজ করে:

  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_VIDEO
  • CREATIVE_TYPE_NATIVE_VIDEO
transcodes[]

object (Transcode)

শুধু আউটপুট। অডিও/ভিডিও ট্রান্সকোড।

Display & Video 360 মূল অ্যাসেটকে বিভিন্ন বিকল্প ভার্সনে ট্রান্সকোড করে, যেগুলি বিভিন্ন ফাইলের ফরম্যাট ব্যবহার করে বা বিভিন্ন প্রপার্টি (রেজোলিউশন, অডিও বিট রেট এবং ভিডিও বিট রেট) থাকে, প্রতিটি নির্দিষ্ট ভিডিও প্লেয়ার বা ব্যান্ডউইথের জন্য ডিজাইন করা হয়েছে।

এই ট্রান্সকোডগুলি প্রকাশকের সিস্টেমকে আপনার ভিডিওর প্রতিটি ইম্প্রেশনের জন্য বেছে নেওয়ার জন্য আরও বিকল্প দেয় এবং দর্শকের কানেকশন এবং স্ক্রিনের সাইজের উপর ভিত্তি করে উপযুক্ত ফাইল পরিবেশন করা নিশ্চিত করে।

এই ফিল্ডটি শুধুমাত্র নিম্নলিখিত creativeType-এ কাজ করে:

  • CREATIVE_TYPE_VIDEO
  • CREATIVE_TYPE_NATIVE_VIDEO
  • CREATIVE_TYPE_AUDIO
trackerUrls[]

string

ঐচ্ছিক। অ্যানালিটিক্স প্রদানকারী বা থার্ড-পার্টি বিজ্ঞাপন প্রযুক্তি ভেন্ডরদের জন্য URL ট্র্যাক করা।

URL অবশ্যই https: দিয়ে শুরু হতে হবে (ইনভেনটরি ছাড়া, যার জন্য SSL মেনে চলার প্রয়োজন নেই)। আপনার URL-এ ম্যাক্রো ব্যবহার করলে, শুধুমাত্র Display & Video 360-এর সাথে কাজ করে এমন ম্যাক্রো ব্যবহার করুন।

শুধুমাত্র স্ট্যান্ডার্ড URL, কোনও IMG বা SCRIPT ট্যাগ নয়।

এই ফিল্ডে শুধুমাত্র নিম্নলিখিত creativeType-এ লেখা যাবে:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
jsTrackerUrl

string

ঐচ্ছিক। কাজ করে এমন থার্ড-পার্টি যাচাইকরণ প্রদানকারীর (ComScore, DoubleVerify, IAS, Moat) থেকে জাভাস্ক্রিপ্ট পরিমাপ URL। HTML স্ক্রিপ্ট ট্যাগ কাজ করে না।

এই ফিল্ডে শুধুমাত্র নিম্নলিখিত creativeType-এ লেখা যাবে:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
cmTrackingAd

object (CmTrackingAd)

ঐচ্ছিক। ক্রিয়েটিভের সাথে যুক্ত Campaign Manager 360 ট্র্যাকিং বিজ্ঞাপন।

Campaign Manager 360 এবং থার্ড-পার্টি বিজ্ঞাপন পরিষেবা, দুটিই ব্যবহার করেন এমন কোনও বিজ্ঞাপনদাতা নিম্নলিখিত creativeType তৈরি করলে, তার জন্য এটি ঐচ্ছিক:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE

শুধুমাত্র অন্যান্য কেসের জন্য আউটপুট।
obaIcon

object (ObaIcon)

ঐচ্ছিক। ভিডিও ক্রিয়েটিভের জন্য OBA আইকন নির্দিষ্ট করে।

এই ফিল্ডটি শুধুমাত্র নিম্নলিখিত creativeType-এ কাজ করে:

  • CREATIVE_TYPE_VIDEO
thirdPartyTag

string

ঐচ্ছিক। ক্রিয়েটিভের জন্য ব্যবহৃত আসল থার্ড-পার্টি ট্যাগ।

প্রয়োজনীয় এবং শুধুমাত্র থার্ড-পার্টি ট্যাগ ক্রিয়েটিভের জন্য প্রযোজ্য।

থার্ড-পার্টি ট্যাগ ক্রিয়েটিভ হল এমন ক্রিয়েটিভ যাতে নিম্নলিখিত hostingSource থাকে:

  • HOSTING_SOURCE_THIRD_PARTY

creativeType-এর সাথে যুক্ত করা হয়েছে:

  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_EXPANDABLE
requireMraid

boolean

ঐচ্ছিক। ক্রিয়েটিভের জন্য MRAID (মোবাইল রিচ মিডিয়া বিজ্ঞাপন ইন্টারফেস সংজ্ঞা সিস্টেম) প্রয়োজন কিনা তা নির্দেশ করে।

ইন্টার‍্যাক্টিভিটির জন্য ক্রিয়েটিভ যদি মোবাইল জেসচারের উপর নির্ভর করে, যেমন সোয়াইপ বা ট্যাপ করা, তাহলে এটি সেট করুন।

ঐচ্ছিক এবং শুধুমাত্র থার্ড-পার্টি ট্যাগ ক্রিয়েটিভের জন্য প্রযোজ্য।

থার্ড-পার্টি ট্যাগ ক্রিয়েটিভ হল এমন ক্রিয়েটিভ যাতে নিম্নলিখিত hostingSource থাকে:

  • HOSTING_SOURCE_THIRD_PARTY

creativeType-এর সাথে যুক্ত করা হয়েছে:

  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_EXPANDABLE
requireHtml5

boolean

ঐচ্ছিক। এটি দেখায় যে ক্রিয়েটিভ সঠিকভাবে রেন্ডার করার জন্য HTML5-এর উপর নির্ভর করে।

ঐচ্ছিক এবং শুধুমাত্র থার্ড-পার্টি ট্যাগ ক্রিয়েটিভের জন্য প্রযোজ্য। থার্ড-পার্টি ট্যাগ ক্রিয়েটিভ হল এমন ক্রিয়েটিভ যাতে নিম্নলিখিত hostingSource থাকে:

  • HOSTING_SOURCE_THIRD_PARTY

creativeType-এর সাথে যুক্ত করা হয়েছে:

  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_EXPANDABLE
requirePingForAttribution

boolean

ঐচ্ছিক। এটি দেখায় যে অ্যাট্রিবিউশনের জন্য রিটার্ন পিং না পাওয়া পর্যন্ত ক্রিয়েটিভ অপেক্ষা করবে।

থার্ড-পার্টি বিজ্ঞাপন সার্ভার প্যারামিটার এবং ${DC_DBM_TOKEN} ম্যাক্রো সহ Campaign Manager 360 ট্র্যাকিং বিজ্ঞাপন ব্যবহার করার সময়ই শুধু এটি প্রযোজ্য।

ঐচ্ছিক এবং শুধুমাত্র থার্ড-পার্টি ট্যাগ ক্রিয়েটিভ বা থার্ড-পার্টি VAST ট্যাগ ক্রিয়েটিভের জন্য প্রযোজ্য।

থার্ড-পার্টি ট্যাগ ক্রিয়েটিভ হল এমন ক্রিয়েটিভ যাতে নিম্নলিখিত hostingSource থাকে:

  • HOSTING_SOURCE_THIRD_PARTY

creativeType-এর সাথে যুক্ত করা হয়েছে:

  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_EXPANDABLE

থার্ড-পার্টি VAST ট্যাগ ক্রিয়েটিভ হল এমন ক্রিয়েটিভ যাতে নিম্নলিখিত hostingSource থাকে:

  • HOSTING_SOURCE_THIRD_PARTY

creativeType-এর সাথে যুক্ত করা হয়েছে:

  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_VIDEO
expandingDirection

enum (ExpandingDirection)

ঐচ্ছিক। ক্রিয়েটিভটি কোন দিকে বড় হবে তা নির্দিষ্ট করে।

থার্ড-পার্টি এক্সপ্যান্ডেবল ক্রিয়েটিভের জন্য প্রয়োজন এবং শুধু সেটির ক্ষেত্রেই প্রযোজ্য।

থার্ড-পার্টি এক্সপ্যান্ডেবল ক্রিয়েটিভ হল এমন ক্রিয়েটিভ যার হোস্টিং সোর্স নিম্নলিখিত:

  • HOSTING_SOURCE_THIRD_PARTY

creativeType-এর সাথে যুক্ত করা হয়েছে:

  • CREATIVE_TYPE_EXPANDABLE
expandOnHover

boolean

ঐচ্ছিক। হোভার করলে ক্রিয়েটিভ অটোমেটিক বড় হয়ে যাবে বলে দেখায়।

ঐচ্ছিক এবং শুধুমাত্র থার্ড-পার্টি এক্সপ্যান্ডেবল ক্রিয়েটিভের জন্য প্রযোজ্য। থার্ড-পার্টি এক্সপ্যান্ডেবল ক্রিয়েটিভ হল এমন ক্রিয়েটিভ যার হোস্টিং সোর্স নিম্নলিখিত:

  • HOSTING_SOURCE_THIRD_PARTY

creativeType-এর সাথে যুক্ত করা হয়েছে:

  • CREATIVE_TYPE_EXPANDABLE
vastTagUrl

string

ঐচ্ছিক। থার্ড-পার্টি VAST ট্যাগ ক্রিয়েটিভের জন্য VAST ট্যাগের URL।

প্রয়োজনীয় এবং শুধুমাত্র থার্ড-পার্টি VAST ট্যাগ ক্রিয়েটিভের জন্য প্রযোজ্য।

থার্ড-পার্টি VAST ট্যাগ ক্রিয়েটিভ হল এমন ক্রিয়েটিভ যাতে নিম্নলিখিত hostingSource থাকে:

  • HOSTING_SOURCE_THIRD_PARTY

creativeType-এর সাথে যুক্ত করা হয়েছে:

  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_VIDEO
vpaid

boolean

শুধু আউটপুট। থার্ড-পার্টি VAST ট্যাগ ক্রিয়েটিভের জন্য VPAID (ডিজিটাল ভিডিও প্লেয়ার-বিজ্ঞাপন ইন্টারফেস) প্রয়োজন কিনা তা দেখায়।

শুধুমাত্র আউটপুট এবং শুধুমাত্র থার্ড-পার্টি VAST ট্যাগ ক্রিয়েটিভের জন্য প্রযোজ্য।

থার্ড-পার্টি VAST ট্যাগ ক্রিয়েটিভ হল এমন ক্রিয়েটিভ যাতে নিম্নলিখিত hostingSource থাকে:

  • HOSTING_SOURCE_THIRD_PARTY

creativeType-এর সাথে যুক্ত করা হয়েছে:

  • CREATIVE_TYPE_VIDEO
html5Video

boolean

শুধু আউটপুট। থার্ড-পার্টি VAST ট্যাগ ক্রিয়েটিভের জন্য HTML5 ভিডিওর প্রয়োজন আছে কিনা তা দেখায়।

শুধুমাত্র আউটপুট এবং শুধুমাত্র থার্ড-পার্টি VAST ট্যাগ ক্রিয়েটিভের জন্য প্রযোজ্য।

থার্ড-পার্টি VAST ট্যাগ ক্রিয়েটিভ হল এমন ক্রিয়েটিভ যাতে নিম্নলিখিত hostingSource থাকে:

  • HOSTING_SOURCE_THIRD_PARTY

creativeType-এর সাথে যুক্ত করা হয়েছে:

  • CREATIVE_TYPE_VIDEO
lineItemIds[]

string (int64 format)

শুধু আউটপুট। এই ক্রিয়েটিভের সাথে যুক্ত লাইন আইটেমের আইডি।

কোনও লাইন আইটেমের সাথে ক্রিয়েটিভ যুক্ত করতে, পরিবর্তে LineItem.creative_ids ব্যবহার করুন।
mp3Audio

boolean

শুধু আউটপুট। থার্ড-পার্টি অডিও ক্রিয়েটিভ MP3 ফর্ম্যাট সাপোর্ট করে কিনা তা দেখায়।

শুধুমাত্র আউটপুট এবং শুধুমাত্র থার্ড-পার্টি অডিও ক্রিয়েটিভের জন্য প্রযোজ্য।

থার্ড-পার্টি অডিও ক্রিয়েটিভ হল এমন ক্রিয়েটিভ যাতে নিম্নলিখিত hostingSource থাকে:

  • HOSTING_SOURCE_THIRD_PARTY

creativeType-এর সাথে যুক্ত করা হয়েছে:

  • CREATIVE_TYPE_AUDIO
oggAudio

boolean

শুধু আউটপুট। থার্ড-পার্টি অডিও ক্রিয়েটিভ OGG ফর্ম্যাট সাপোর্ট করে কিনা তা দেখায়।

শুধুমাত্র আউটপুট এবং শুধুমাত্র থার্ড-পার্টি অডিও ক্রিয়েটিভের জন্য প্রযোজ্য।

থার্ড-পার্টি অডিও ক্রিয়েটিভ হল এমন ক্রিয়েটিভ যাতে নিম্নলিখিত hostingSource থাকে:

  • HOSTING_SOURCE_THIRD_PARTY

creativeType-এর সাথে যুক্ত করা হয়েছে:

  • CREATIVE_TYPE_AUDIO
syntheticContentAttestationStatus

enum (SyntheticContentAttestationStatus)

ঐচ্ছিক। স্থানীয় AI লেবেলিং রেগুলেশন আছে এমন অঞ্চলে ক্রিয়েটিভ দেখানোর সময়, সেটি AI ব্যবহার করে তৈরি বা এডিট করা হয়েছে কিনা তা লেবেল করতে হবে কিনা।

HostingSource

ক্রিয়েটিভের জন্য সম্ভাব্য হোস্টিং সোর্স। ক্রিয়েটিভ কোথায় তৈরি ও হোস্ট করা হয়েছে তা দেখায়।

Enums
HOSTING_SOURCE_UNSPECIFIED এই ভার্সনে হোস্টিং সোর্স উল্লেখ করা নেই বা অজানা।
HOSTING_SOURCE_CM

Campaign Manager 360 থেকে সিঙ্ক করা ক্রিয়েটিভ।

এই ধরনের হোস্টিংয়ের ক্ষেত্রে তৈরি ও আপডেট করার পদ্ধতি কাজ করে না।
HOSTING_SOURCE_THIRD_PARTY

থার্ড-পার্টি বিজ্ঞাপন সার্ভার (3PAS) দ্বারা হোস্ট করা ক্রিয়েটিভ।

creativeType নিম্নলিখিতগুলির মধ্যে একটি হলে, এই হোস্টিংয়ের ধরনের জন্য তৈরি ও আপডেট করার পদ্ধতি কাজ করে:

  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_EXPANDABLE
  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_VIDEO
HOSTING_SOURCE_HOSTED

DV360-তে তৈরি করা এবং Campaign Manager 360-এর মাধ্যমে হোস্ট করা ক্রিয়েটিভ।

creativeType নিম্নলিখিতগুলির মধ্যে একটি হলে, এই হোস্টিংয়ের ধরনের জন্য তৈরি ও আপডেট করার পদ্ধতি কাজ করে:

  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_VIDEO
HOSTING_SOURCE_RICH_MEDIA

Studio-তে তৈরি এবং Campaign Manager 360-এর মাধ্যমে হোস্ট করা রিচ মিডিয়া ক্রিয়েটিভ।

এই ধরনের হোস্টিংয়ের ক্ষেত্রে তৈরি ও আপডেট করার পদ্ধতি কাজ করে না।

CreativeAttribute

ক্রিয়েটিভের সম্ভাব্য অ্যাট্রিবিউট।

Enums
CREATIVE_ATTRIBUTE_UNSPECIFIED এই ভার্সনে ক্রিয়েটিভ অ্যাট্রিবিউট উল্লেখ করা নেই বা সেটি অজানা।
CREATIVE_ATTRIBUTE_VAST ক্রিয়েটিভটি হল একটি VAST ক্রিয়েটিভ।
CREATIVE_ATTRIBUTE_VPAID_LINEAR ক্রিয়েটিভটি একটি লিনিয়ার VPAID ক্রিয়েটিভ।
CREATIVE_ATTRIBUTE_VPAID_NON_LINEAR ক্রিয়েটিভটি একটি নন-লিনিয়ার VPAID ক্রিয়েটিভ।

ReviewStatusInfo

ক্রিয়েটিভের জন্য পর্যালোচনার স্ট্যাটাস।

JSON উপস্থাপনা 
{
  "approvalStatus": enum (ApprovalStatus),
  "creativeAndLandingPageReviewStatus": enum (ReviewStatus),
  "contentAndPolicyReviewStatus": enum (ReviewStatus),
  "exchangeReviewStatuses": [
    {
      object (ExchangeReviewStatus)
    }
  ]
}
ফিল্ড
approvalStatus

enum (ApprovalStatus)

পরিবেশন শুরু করার জন্য ক্রিয়েটিভের যে প্রাথমিক অনুমোদন প্রয়োজন তা দেখায়। creativeAndLandingPageReviewStatus ও contentAndPolicyReviewStatus-এর সারসংক্ষেপ।
creativeAndLandingPageReviewStatus

enum (ReviewStatus)

ক্রিয়েটিভের জন্য ক্রিয়েটিভ ও ল্যান্ডিং পৃষ্ঠা পর্যালোচনার স্ট্যাটাস।
contentAndPolicyReviewStatus

enum (ReviewStatus)

ক্রিয়েটিভের জন্য কন্টেন্ট ও নীতি পর্যালোচনার স্ট্যাটাস।
exchangeReviewStatuses[]

object (ExchangeReviewStatus)

ক্রিয়েটিভের জন্য এক্সচেঞ্জ পর্যালোচনার স্ট্যাটাস।

ApprovalStatus

অনুমোদনের স্ট্যাটাসের সম্ভাব্য ধরন। এটি creativeAndLandingPageReviewStatus ও contentAndPolicyReviewStatus-এর সারাংশ।

Enums
APPROVAL_STATUS_UNSPECIFIED এই ভার্সনে টাইপ ভ্যালু উল্লেখ করা নেই বা অজানা।
APPROVAL_STATUS_PENDING_NOT_SERVABLE ক্রিয়েটিভ এখনও পর্যালোচনা করা হচ্ছে এবং দেখানো যাবে না।
APPROVAL_STATUS_PENDING_SERVABLE ক্রিয়েটিভটি ক্রিয়েটিভ ও ল্যান্ডিং পৃষ্ঠা পর্যালোচনা পাস করেছে এবং পরিবেশনযোগ্য, তবে অতিরিক্ত কন্টেন্ট ও নীতি পর্যালোচনার জন্য অপেক্ষা করছে।
APPROVAL_STATUS_APPROVED_SERVABLE ক্রিয়েটিভ ও ল্যান্ডিং পৃষ্ঠা পর্যালোচনা এবং কন্টেন্ট ও নীতি পর্যালোচনা, দুটিই অনুমোদিত হয়েছে। ক্রিয়েটিভটি দেখানো যাবে।
APPROVAL_STATUS_REJECTED_NOT_SERVABLE ক্রিয়েটিভে কোনও সমস্যা আছে যা দেখানোর আগে সমাধান করতে হবে।

ReviewStatus

রিভিউ স্ট্যাটাসের সম্ভাব্য ধরন।

Enums
REVIEW_STATUS_UNSPECIFIED এই ভার্সনে টাইপ ভ্যালু উল্লেখ করা নেই বা অজানা।
REVIEW_STATUS_APPROVED ক্রিয়েটিভটি অনুমোদিত হয়েছে।
REVIEW_STATUS_REJECTED ক্রিয়েটিভটি বাতিল করা হয়েছে।
REVIEW_STATUS_PENDING ক্রিয়েটিভ পর্যালোচনা করা বাকি আছে।

ExchangeReviewStatus

ক্রিয়েটিভের জন্য এক্সচেঞ্জ পর্যালোচনার স্ট্যাটাস।

JSON উপস্থাপনা 
{
  "exchange": enum (Exchange),
  "status": enum (ReviewStatus)
}
ফিল্ড
exchange

enum (Exchange)

এক্সচেঞ্জ ক্রিয়েটিভ পর্যালোচনা করছে।
status

enum (ReviewStatus)

এক্সচেঞ্জ পর্যালোচনার স্ট্যাটাস।

AssetAssociation

ক্রিয়েটিভের জন্য অ্যাসেট অ্যাসোসিয়েশন।

JSON উপস্থাপনা 
{
  "asset": {
    object (Asset)
  },
  "role": enum (AssetRole)
}
ফিল্ড
asset

object (Asset)

ঐচ্ছিক। সংশ্লিষ্ট অ্যাসেট।
role

enum (AssetRole)

ঐচ্ছিক। ক্রিয়েটিভের জন্য এই অ্যাসেটের ভূমিকা।

অ্যাসেট

একটি অ্যাসেট।

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

string (int64 format)

আপলোড করা অ্যাসেটের মিডিয়া আইডি। এটি অ্যাসেটের জন্য একটি অনন্য শনাক্তকারী। এই আইডি অন্যান্য API কলে পাস করা যেতে পারে, যেমন, ক্রিয়েটিভের সাথে অ্যাসেট যুক্ত করতে creatives.create।

৫ এপ্রিল, ২০২৩-এ মিডিয়া আইডি স্পেস আপডেট করা হয়েছে। ৫ এপ্রিল, ২০২৩-এর আগে ক্যাশে করা মিডিয়া আইডি আপডেট করুন। এর জন্য, সংশ্লিষ্ট ক্রিয়েটিভ রিসোর্স থেকে নতুন মিডিয়া আইডি পুনরুদ্ধার করুন বা অ্যাসেট আবার আপলোড করুন।
content

string

অ্যাসেট কন্টেন্ট। আপলোড করা অ্যাসেটের ক্ষেত্রে, কন্টেন্ট হল সার্ভিং পাথ।

AssetRole

ক্রিয়েটিভের জন্য এই অ্যাসেটের ভূমিকা।

Enums
ASSET_ROLE_UNSPECIFIED এই ভার্সনে অ্যাসেট রোল উল্লেখ করা নেই বা জানা নেই।
ASSET_ROLE_MAIN অ্যাসেটটি ক্রিয়েটিভের প্রধান অ্যাসেট।
ASSET_ROLE_BACKUP অ্যাসেটটি ক্রিয়েটিভের ব্যাক-আপ অ্যাসেট।
ASSET_ROLE_POLITE_LOAD অ্যাসেটটি ক্রিয়েটিভের একটি পোলাইট লোড অ্যাসেট।
ASSET_ROLE_HEADLINE

নেটিভ ক্রিয়েটিভের শিরোনাম।

content-এর দৈর্ঘ্য ২৫ অক্ষরের বেশি হওয়া চলবে না এবং এটি UTF-8 এনকোডেড হতে হবে।

এই ভূমিকা শুধুমাত্র নিম্নলিখিত creativeType-এ কাজ করে:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_LONG_HEADLINE

নেটিভ ক্রিয়েটিভের দীর্ঘ শিরোনাম।

content UTF-8 এনকোড করা হতে হবে এবং এর দৈর্ঘ্য ৫০ অক্ষরের বেশি হওয়া চলবে না।

এই ভূমিকা শুধুমাত্র নিম্নলিখিত creativeType-এ কাজ করে:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_BODY

নেটিভ ক্রিয়েটিভের বডি টেক্সট।

content-এর দৈর্ঘ্য ৯০ অক্ষরের বেশি হওয়া চলবে না এবং এটি UTF-8 এনকোডেড হতে হবে।

এই ভূমিকা শুধুমাত্র নিম্নলিখিত creativeType-এ কাজ করে:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_LONG_BODY

নেটিভ ক্রিয়েটিভের দীর্ঘ বডি টেক্সট।

content-এ UTF-8 এনকোডিং থাকতে হবে এবং দৈর্ঘ্য ১৫০ অক্ষরের বেশি হওয়া চলবে না।

এই ভূমিকা শুধুমাত্র নিম্নলিখিত creativeType-এ কাজ করে:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_CAPTION_URL

ক্রিয়েটিভে দেখানোর জন্য ল্যান্ডিং পেজ URL-এর একটি ছোট, বন্ধুত্বপূর্ণ ভার্সন। এই URL থেকে লোকজন বুঝতে পারেন যে ক্রিয়েটিভে ক্লিক করলে তারা কোথায় পৌঁছাবেন।

content-এর দৈর্ঘ্য ৩০ অক্ষরের বেশি হওয়া চলবে না এবং এটি UTF-8 এনকোডেড হতে হবে।

যেমন, ল্যান্ডিং পৃষ্ঠার URL 'http://www.example.com/page' হলে, ক্যাপশন URL 'example.com' হতে পারে। প্রোটোকল (http://) ঐচ্ছিক, তবে URL-এ স্পেস বা বিশেষ অক্ষর থাকলে চলবে না।

এই ভূমিকা শুধুমাত্র নিম্নলিখিত creativeType-এ কাজ করে:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_CALL_TO_ACTION

নেটিভ ক্রিয়েটিভের কল-টু-অ্যাকশন বোতামে ব্যবহার করার জন্য টেক্সট।

content অবশ্যই UTF-8 এনকোড করা হতে হবে এবং এর দৈর্ঘ্য ১৫ অক্ষরের বেশি হবে না।

এই ভূমিকা শুধুমাত্র নিম্নলিখিত creativeType-এ কাজ করে:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_ADVERTISER_NAME

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

content-এর দৈর্ঘ্য ২৫ অক্ষরের বেশি হওয়া চলবে না এবং এটি UTF-8 এনকোডেড হতে হবে।

এই ভূমিকা শুধুমাত্র নিম্নলিখিত creativeType-এ কাজ করে:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_PRICE

Google Play Store বা iOS অ্যাপ স্টোরে আপনার অ্যাপের কেনাকাটার মূল্য (যেমন, $৫.৯৯)।

মনে রাখবেন যে এই ভ্যালু স্টোরে তালিকাভুক্ত আসল ভ্যালুর সাথে অটোমেটিক সিঙ্ক হয় না। ক্রিয়েটিভ সেভ করার সময় যে নাম দেওয়া হয়, সেটিই সবসময় ব্যবহার করা হবে।

content অবশ্যই UTF-8 এনকোড করা হতে হবে এবং এর দৈর্ঘ্য ১৫ অক্ষরের বেশি হবে না।

এই ভূমিকার অ্যাসেট শুধু পড়া যাবে।
ASSET_ROLE_ANDROID_APP_ID

Google Play Store-এ Android অ্যাপের আইডি।

আপনি এই আইডি অ্যাপের Google Play Store URL-এ ‘id’-এর পরে দেখতে পাবেন। যেমন, https://play.google.com/store/apps/details?id=com.company.appname-এ আইডেন্টিফায়ার হল com.company.appname।

এই ভূমিকার অ্যাসেট শুধু পড়া যাবে।
ASSET_ROLE_IOS_APP_ID

Apple অ্যাপ স্টোরে iOS অ্যাপের আইডি।

এই আইডি নম্বরটি Apple App Store URL-এ "id"-এর ঠিক পরে সংখ্যার স্ট্রিং হিসেবে পাওয়া যাবে। যেমন, https://apps.apple.com/us/app/gmail-email-by-google/id422689480-এ আইডি হল ৪২২৬৮৯৪৮০।

এই ভূমিকার অ্যাসেট শুধু পড়া যাবে।
ASSET_ROLE_RATING

Google Play Store বা iOS অ্যাপ স্টোরে কোনও অ্যাপের রেটিং।

মনে রাখবেন যে এই ভ্যালু স্টোরে থাকা আসল রেটিংয়ের সাথে অটোমেটিক সিঙ্ক হয় না। ক্রিয়েটিভ সেভ করার সময় যে নাম দেওয়া হয়, সেটিই সবসময় ব্যবহার করা হবে।

এই ভূমিকার অ্যাসেট শুধু পড়া যাবে।
ASSET_ROLE_ICON

ক্রিয়েটিভের আইকন।

এই ভূমিকা শুধুমাত্র নিম্নলিখিত creativeType-এ কাজ করে এবং প্রয়োজন হয়:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
ASSET_ROLE_COVER_IMAGE

নেটিভ ভিডিও ক্রিয়েটিভের কভার ছবি।

এই ভূমিকা শুধুমাত্র নিম্নলিখিত creativeType-এ কাজ করে এবং প্রয়োজন হয়:

  • CREATIVE_TYPE_VIDEO
ASSET_ROLE_BACKGROUND_COLOR

ক্রিয়েটিভে ব্যবহার করার জন্য প্রধান রঙ।

এই ভূমিকা শুধুমাত্র নিম্নলিখিত creativeType-এ কাজ করে এবং প্রয়োজন হয়:

  • CREATIVE_TYPE_ASSET_BASED_CREATIVE
ASSET_ROLE_ACCENT_COLOR

ক্রিয়েটিভে ব্যবহার করার জন্য অ্যাকসেন্ট কালার।

এই ভূমিকা শুধুমাত্র নিম্নলিখিত creativeType-এ কাজ করে এবং প্রয়োজন হয়:

  • CREATIVE_TYPE_ASSET_BASED_CREATIVE
ASSET_ROLE_REQUIRE_IMAGE

ক্রিয়েটিভে কোনও ইমেজ অ্যাসেট ব্যবহার করতে হবে কিনা।

এই ভূমিকা শুধুমাত্র নিম্নলিখিত creativeType-এ কাজ করে এবং প্রয়োজন হয়:

  • CREATIVE_TYPE_ASSET_BASED_CREATIVE
ASSET_ROLE_ENABLE_ASSET_ENHANCEMENTS

ক্রিয়েটিভে অ্যাসেটের উন্নতি প্রয়োগ করা যাবে কিনা।

এই ভূমিকা শুধুমাত্র নিম্নলিখিত creativeType-এ কাজ করে এবং প্রয়োজন হয়:

  • CREATIVE_TYPE_ASSET_BASED_CREATIVE

ExitEvent

ক্রিয়েটিভের এক্সিট ইভেন্ট।

JSON উপস্থাপনা 
{
  "type": enum (ExitEventType),
  "url": string,
  "name": string,
  "reportingName": string
}
ফিল্ড
type

enum (ExitEventType)

প্রয়োজনীয়। এক্সিট ইভেন্টের ধরন।
url

string

প্রয়োজনীয়। এক্সিট ইভেন্টের ক্লিক-থ্রু URL। type-এর ক্ষেত্রে এটি প্রয়োজন:

  • EXIT_EVENT_TYPE_DEFAULT
  • EXIT_EVENT_TYPE_BACKUP
name

string

ঐচ্ছিক। এক্সিট ইভেন্টের ক্লিক ট্যাগের নাম।

একটি ক্রিয়েটিভের মধ্যে নাম অনন্য হতে হবে।

শুধুমাত্র ইমেজ অ্যাসেট আছে এমন ক্রিয়েটিভের জন্য এটি ফাঁকা রাখুন বা সেট করবেন না।
reportingName

string

ঐচ্ছিক। রিপোর্টে এই ইভেন্ট শনাক্ত করার জন্য ব্যবহৃত নাম। শুধুমাত্র ইমেজ অ্যাসেট আছে এমন ক্রিয়েটিভের জন্য এটি ফাঁকা রাখুন বা সেট করবেন না।

ExitEventType

এক্সিট ইভেন্টের ধরন।

Enums
EXIT_EVENT_TYPE_UNSPECIFIED এই ভার্সনে এক্সিট ইভেন্টের ধরন উল্লেখ করা নেই বা অজানা।
EXIT_EVENT_TYPE_DEFAULT এক্সিট ইভেন্টটি ডিফল্ট।
EXIT_EVENT_TYPE_BACKUP এক্সিট ইভেন্ট হল ব্যাক-আপ এক্সিট ইভেন্ট। একটি ক্রিয়েটিভে একাধিক ব্যাক-আপ এক্সিট ইভেন্ট থাকতে পারে।

TimerEvent

ক্রিয়েটিভের টাইমার ইভেন্ট।

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

string

প্রয়োজনীয়। টাইমার ইভেন্টের নাম।
reportingName

string

প্রয়োজনীয়। রিপোর্টে এই টাইমার ইভেন্ট শনাক্ত করার জন্য ব্যবহৃত নাম।

CounterEvent

ক্রিয়েটিভের কাউন্টার ইভেন্ট।

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

string

প্রয়োজনীয়। কাউন্টার ইভেন্টের নাম।
reportingName

string

প্রয়োজনীয়। রিপোর্টে এই কাউন্টার ইভেন্ট শনাক্ত করতে ব্যবহৃত নাম।

AudioVideoOffset

অডিও বা ভিডিও কতক্ষণ চালানো হয়েছে।

JSON উপস্থাপনা 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "percentage": string,
  "seconds": string
  // End of mutually exclusive fields.
}
ফিল্ড
অফসেটের ভ্যালু। নিচে পারস্পরিকভাবে এক্সক্লুসিভ ফিল্ডের তালিকা দেওয়া হল। উত্তরে সর্বাধিক একটি ফিল্ড সেট করা হবে:
percentage

string (int64 format)

ঐচ্ছিক। অডিও বা ভিডিওর সময়সীমার শতাংশে অফসেট।
seconds

string (int64 format)

ঐচ্ছিক। অডিও বা ভিডিওর শুরু থেকে সেকেন্ডে অফসেট।
মিউচুয়ালি এক্সক্লুসিভ ফিল্ডের শেষ।

UniversalAdId

রেজিস্ট্রির মাধ্যমে প্রদান করা ক্রিয়েটিভ শনাক্তকারী যা সব প্ল্যাটফর্ম জুড়ে অনন্য। এটি VAST 4.0 স্ট্যান্ডার্ডের অংশ।

JSON উপস্থাপনা 
{
  "id": string,
  "registry": enum (UniversalAdRegistry)
}
ফিল্ড
id

string

ঐচ্ছিক। অনন্য ক্রিয়েটিভ শনাক্তকারী।
registry

enum (UniversalAdRegistry)

ঐচ্ছিক। রেজিস্ট্রি অনন্য ক্রিয়েটিভ শনাক্তকারী প্রদান করে।

UniversalAdRegistry

রেজিস্ট্রি ইউনিভার্সাল বিজ্ঞাপন আইডিতে অনন্য ক্রিয়েটিভ শনাক্তকারী প্রদান করে।

Enums
UNIVERSAL_AD_REGISTRY_UNSPECIFIED এই ভার্সনে ইউনিভার্সাল বিজ্ঞাপন রেজিস্ট্রি উল্লেখ করা নেই বা অজানা।
UNIVERSAL_AD_REGISTRY_OTHER ইউনিভার্সাল বিজ্ঞাপন আইডি প্রদান করতে কাস্টম পরিষেবা প্রদানকারী ব্যবহার করুন।
UNIVERSAL_AD_REGISTRY_AD_ID ইউনিভার্সাল বিজ্ঞাপন আইডি প্রদান করতে বিজ্ঞাপন আইডি ব্যবহার করুন।
UNIVERSAL_AD_REGISTRY_CLEARCAST ইউনিভার্সাল বিজ্ঞাপন আইডি প্রদান করতে clearcast.co.uk ব্যবহার করুন।
UNIVERSAL_AD_REGISTRY_DV360 ইউনিভার্সাল বিজ্ঞাপন আইডি প্রদান করতে Display & Video 360 ব্যবহার করুন।
UNIVERSAL_AD_REGISTRY_CM ইউনিভার্সাল বিজ্ঞাপন আইডি প্রদান করতে Campaign Manager 360 ব্যবহার করুন।

ThirdPartyUrl

অডিও বা ভিডিও ক্রিয়েটিভের সাথে ইন্টার‍্যাকশন ট্র্যাক করার জন্য থার্ড-পার্টির ট্র্যাকিং URL।

JSON উপস্থাপনা 
{
  "type": enum (ThirdPartyUrlType),
  "url": string
}
ফিল্ড
type

enum (ThirdPartyUrlType)

ঐচ্ছিক। ট্র্যাকিং URL-এর মাধ্যমে ইন্টার‍্যাকশনের ধরন ট্র্যাক করতে হবে
url

string

ঐচ্ছিক। ইন্টার‍্যাকশন ট্র্যাক করার জন্য ট্র্যাকিং URL ব্যবহার করা হয়।

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

ThirdPartyUrlType

থার্ড-পার্টি ট্র্যাকিং URL-এর মাধ্যমে ইন্টার‍্যাকশনের ধরন ট্র্যাক করতে হবে।

Enums
THIRD_PARTY_URL_TYPE_UNSPECIFIED থার্ড-পার্টি URL-এর ধরন এই ভার্সনে উল্লেখ করা নেই বা অজানা।
THIRD_PARTY_URL_TYPE_IMPRESSION অডিও বা ভিডিও বাফারিং সম্পূর্ণ হওয়ার পরে ক্রিয়েটিভের ইমপ্রেশন গণনা করতে ব্যবহার করা হয়।
THIRD_PARTY_URL_TYPE_CLICK_TRACKING অডিও বা ভিডিওতে ব্যবহারকারীর ক্লিক ট্র্যাক করতে ব্যবহার করা হয়।
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_START ব্যবহারকারী কতবার অডিও বা ভিডিও চালু করেছেন তা ট্র্যাক করতে ব্যবহার করা হয়।
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_FIRST_QUARTILE অডিও বা ভিডিও তার দৈর্ঘ্যের ২৫% পর্যন্ত কতবার চালানো হয়েছে তা ট্র্যাক করতে ব্যবহৃত হয়।
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_MIDPOINT অডিও বা ভিডিও তার দৈর্ঘ্যের ৫০% পর্যন্ত কতবার চালানো হয়েছে তা ট্র্যাক করতে ব্যবহৃত হয়।
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_THIRD_QUARTILE অডিও বা ভিডিও তার দৈর্ঘ্যের ৭৫% পর্যন্ত কতবার চালানো হয়েছে তা ট্র্যাক করতে ব্যবহৃত হয়।
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_COMPLETE অডিও বা ভিডিও কতবার শেষ পর্যন্ত চালানো হয়েছে তা ট্র্যাক করতে ব্যবহার করা হয়।
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_MUTE ব্যবহারকারী কতবার অডিও বা ভিডিও মিউট করেছেন তা ট্র্যাক করতে ব্যবহার করা হয়।
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_PAUSE ব্যবহারকারী কতবার অডিও বা ভিডিও পজ করেছেন তা ট্র্যাক করতে ব্যবহার করা হয়।
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_REWIND ব্যবহারকারী কতবার অডিও বা ভিডিও রিপ্লে করেছেন তা ট্র্যাক করতে ব্যবহার করা হয়।
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_FULLSCREEN ব্যবহারকারী কতবার প্লেয়ারকে ফুল-স্ক্রিন সাইজে বড় করেছেন তা ট্র্যাক করতে ব্যবহার করা হয়।
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_STOP ব্যবহারকারী কতবার অডিও বা ভিডিও বন্ধ করেছেন তা ট্র্যাক করতে ব্যবহার করা হয়।
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_CUSTOM ব্যবহারকারী কতবার কাস্টম ক্লিক করেছেন তা ট্র্যাক করতে ব্যবহার করা হয়, যেমন ভিডিও হট স্পটে ক্লিক করা।
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_SKIP অডিও বা ভিডিও কতবার স্কিপ করা হয়েছে তা ট্র্যাক করতে ব্যবহার করা হয়।
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_PROGRESS progressOffset-এর মাধ্যমে নির্ধারিত অফসেট অনুযায়ী অডিও বা ভিডিও কতবার চালানো হয়েছে তা ট্র্যাক করতে ব্যবহার করা হয়।

ট্রান্সকোড

ট্রান্সকোড করা অডিও বা ভিডিও ফাইল সম্পর্কে তথ্য দেখায়।

JSON উপস্থাপনা 
{
  "name": string,
  "mimeType": string,
  "transcoded": boolean,
  "dimensions": {
    object (Dimensions)
  },
  "bitRateKbps": string,
  "frameRate": number,
  "audioBitRateKbps": string,
  "audioSampleRateHz": string,
  "fileSizeBytes": string
}
ফিল্ড
name

string

ঐচ্ছিক। ট্রান্সকোড করা ফাইলের নাম।
mimeType

string

ঐচ্ছিক। ট্রান্সকোড করা ফাইলের MIME-এর ধরন।
transcoded

boolean

ঐচ্ছিক। ট্রান্সকোডিং সফল হয়েছে কিনা তা দেখায়।
dimensions

object (Dimensions)

ঐচ্ছিক। ট্রান্সকোড করা ভিডিওর ডাইমেনশন।
bitRateKbps

string (int64 format)

ঐচ্ছিক। ট্রান্সকোড করা ভিডিওর ট্রান্সকোডিং বিট রেট, প্রতি সেকেন্ডে কিলোবিটে।
frameRate

number

ঐচ্ছিক। ট্রান্সকোড করা ভিডিওর ফ্রেম রেট, প্রতি সেকেন্ডে ফ্রেমের সংখ্যা হিসেবে।
audioBitRateKbps

string (int64 format)

ঐচ্ছিক। ট্রান্সকোড করা ভিডিওর অডিও স্ট্রিমের বিট রেট বা ট্রান্সকোড করা অডিওর বিট রেট, প্রতি সেকেন্ডে কিলোবিটে।
audioSampleRateHz

string (int64 format)

ঐচ্ছিক। ট্রান্সকোড করা ভিডিওর অডিও স্ট্রিমের স্যাম্পেল রেট অথবা ট্রান্সকোড করা অডিওর স্যাম্পেল রেট, হার্টজে।
fileSizeBytes

string (int64 format)

ঐচ্ছিক। ট্রান্সকোড করা ফাইলের সাইজ, বাইটে।

CmTrackingAd

Campaign Manager 360 ট্র্যাকিং বিজ্ঞাপন।

JSON উপস্থাপনা 
{
  "cmPlacementId": string,
  "cmCreativeId": string,
  "cmAdId": string
}
ফিল্ড
cmPlacementId

string (int64 format)

ঐচ্ছিক। Campaign Manager 360 ট্র্যাকিং বিজ্ঞাপনের প্লেসমেন্ট আইডি।
cmCreativeId

string (int64 format)

ঐচ্ছিক। Campaign Manager 360 ট্র্যাকিং বিজ্ঞাপনের ক্রিয়েটিভ আইডি।
cmAdId

string (int64 format)

ঐচ্ছিক। Campaign Manager 360 ট্র্যাকিং বিজ্ঞাপনের বিজ্ঞাপন আইডি।

ObaIcon

ক্রিয়েটিভের জন্য OBA আইকন

JSON উপস্থাপনা 
{
  "resourceUrl": string,
  "resourceMimeType": string,
  "position": enum (ObaIconPosition),
  "dimensions": {
    object (Dimensions)
  },
  "program": string,
  "landingPageUrl": string,
  "clickTrackingUrl": string,
  "viewTrackingUrl": string
}
ফিল্ড
resourceUrl

string

ঐচ্ছিক। OBA আইকন রিসোর্সের URL।
resourceMimeType

string

ঐচ্ছিক। OBA আইকন রিসোর্সের MIME-এর প্রকার।
position

enum (ObaIconPosition)

ঐচ্ছিক। ক্রিয়েটিভে OBA আইকনের পজিশন।
dimensions

object (Dimensions)

ঐচ্ছিক। OBA আইকনের ডাইমেনশন।
program

string

ঐচ্ছিক। OBA আইকনের প্রোগ্রাম। যেমন: “AdChoices”।
landingPageUrl

string

প্রয়োজনীয়। OBA আইকনের ল্যান্ডিং পৃষ্ঠার URL।

শুধুমাত্র নিম্নলিখিত ডোমেনের URL অনুমোদিত:

  • https://info.evidon.com
  • https://l.betrad.com
clickTrackingUrl

string

প্রয়োজনীয়। OBA আইকনের ক্লিক ট্র্যাকিং URL।

শুধুমাত্র নিম্নলিখিত ডোমেনের URL অনুমোদিত:

  • https://info.evidon.com
  • https://l.betrad.com
viewTrackingUrl

string

প্রয়োজনীয়। OBA আইকনের ভিউ ট্র্যাকিং URL।

শুধুমাত্র নিম্নলিখিত ডোমেনের URL অনুমোদিত:

  • https://info.evidon.com
  • https://l.betrad.com

ObaIconPosition

ক্রিয়েটিভে OBA আইকনের পজিশন।

Enums
OBA_ICON_POSITION_UNSPECIFIED OBA আইকনের পজিশন নির্দিষ্ট করা নেই।
OBA_ICON_POSITION_UPPER_RIGHT ক্রিয়েটিভের উপরের ডানদিকে।
OBA_ICON_POSITION_UPPER_LEFT ক্রিয়েটিভের উপরের বাঁদিকে।
OBA_ICON_POSITION_LOWER_RIGHT ক্রিয়েটিভের নিচে ডানদিকে।
OBA_ICON_POSITION_LOWER_LEFT ক্রিয়েটিভের নিচে বাঁদিকে।

ExpandingDirection

থার্ড-পার্টি এক্সপ্যান্ডেবল ক্রিয়েটিভের এক্সপ্যান্ডিং ডিরেকশন।

Enums
EXPANDING_DIRECTION_UNSPECIFIED এক্সপ্যান্ড করার দিক নির্দিষ্ট করা নেই।
EXPANDING_DIRECTION_NONE কোনও দিকেই প্রসারিত হয় না।
EXPANDING_DIRECTION_UP উপরের দিকে বড় করে।
EXPANDING_DIRECTION_DOWN নিচের দিকে বড় করে।
EXPANDING_DIRECTION_LEFT বাঁদিকে বড় করে।
EXPANDING_DIRECTION_RIGHT ডানদিকে বড় করে।
EXPANDING_DIRECTION_UP_AND_LEFT উপরে ও বাঁদিকে বড় করে।
EXPANDING_DIRECTION_UP_AND_RIGHT উপরের দিকে এবং ডানদিকে বড় হয়।
EXPANDING_DIRECTION_DOWN_AND_LEFT নিচে ও বাঁদিকে বড় করে।
EXPANDING_DIRECTION_DOWN_AND_RIGHT নিচে ও ডানদিকে বড় করে।
EXPANDING_DIRECTION_UP_OR_DOWN উপরে বা নিচে প্রসারিত হয়।
EXPANDING_DIRECTION_LEFT_OR_RIGHT বাঁদিকে বা ডানদিকে প্রসারিত হয়।
EXPANDING_DIRECTION_ANY_DIAGONAL যেকোনও কোণাকুণি দিকে চাল দেওয়া যায়।

পদ্ধতি

create

 নতুন ক্রিয়েটিভ তৈরি করে।

delete

 ক্রিয়েটিভ মুছে দেয়।

get

 ক্রিয়েটিভ পায়।

list

 বিজ্ঞাপনদাতার ক্রিয়েটিভের তালিকা তৈরি করে।

patch

 আগে থেকে থাকা ক্রিয়েটিভ আপডেট করে।