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)

শুধুমাত্র আউটপুট। ক্রিয়েটিভটির সাথে যুক্ত ক্যাম্পেইন ম্যানেজার ৩৬০ প্লেসমেন্টের অনন্য আইডি। এই ফিল্ডটি শুধুমাত্র সেইসব ক্রিয়েটিভের জন্য প্রযোজ্য যেগুলো ক্যাম্পেইন ম্যানেজার থেকে সিঙ্ক করা হয়।

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 )

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

  • গুগল ওয়েব ডিজাইনারের ট্যাপ এরিয়া ব্যবহার করুন।
  • 'clickTag' নামে একটি জাভাস্ক্রিপ্ট ভেরিয়েবল তৈরি করুন।
  • রিচ মিডিয়া ফরম্যাটে প্রস্থান ট্র্যাক করতে এনাবলার (Enabler.exit()) ব্যবহার করুন।
timerEvents[]

object ( TimerEvent )

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

counterEvents[]

object ( CounterEvent )

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

appendedTag

string

ঐচ্ছিক। ক্রিয়েটিভ ট্যাগের সাথে তৃতীয় পক্ষের এইচটিএমএল ট্র্যাকিং ট্যাগ যুক্ত করা হবে।

integrationCode

string

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

notes

string

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

iasCampaignMonitoring

boolean

ঐচ্ছিক। এটি নির্দেশ করে যে ইন্টিগ্রাল অ্যাড সায়েন্স (IAS) ক্যাম্পেইন মনিটরিং সক্রিয় করা আছে কিনা। ক্রিয়েটিভটির জন্য এটি সক্রিয় করতে, নিশ্চিত করুন যে Advertiser.creative_config.ias_client_id কে আপনার IAS ক্লায়েন্ট আইডিতে সেট করা হয়েছে।

companionCreativeIds[]

string ( int64 format)

ঐচ্ছিক। একটি ভিডিও ক্রিয়েটিভের সহযোগী ক্রিয়েটিভগুলোর আইডি।

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

যেসব ক্রিয়েটিভে additional dimensions থাকে, সেগুলো সহযোগী ক্রিয়েটিভ হতে পারে না।

এই ক্ষেত্রটি শুধুমাত্র নিম্নলিখিত creativeType জন্য সমর্থিত:

  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_VIDEO
skippable

boolean

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

এই ক্ষেত্রটি শুধুমাত্র নিম্নলিখিত creativeType জন্য সমর্থিত:

  • CREATIVE_TYPE_VIDEO
skipOffset

object ( AudioVideoOffset )

ঐচ্ছিক। স্কিপ বাটনটি প্রদর্শিত হওয়ার আগে ভিডিওটি কতক্ষণ চলবে।

যখন skippable মান true হয়, তখন এই ফিল্ডটি পূরণ করা আবশ্যক।

এই ক্ষেত্রটি শুধুমাত্র নিম্নলিখিত creativeType জন্য সমর্থিত:

  • CREATIVE_TYPE_VIDEO
progressOffset

object ( AudioVideoOffset )

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

যখন skippable মান true হয়, তখন এই ফিল্ডটি পূরণ করা আবশ্যক।

এই ক্ষেত্রটি শুধুমাত্র নিম্নলিখিত creativeType জন্য সমর্থিত:

  • CREATIVE_TYPE_VIDEO
universalAdId

object ( UniversalAdId )

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

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

এই ক্ষেত্রটি শুধুমাত্র নিম্নলিখিত creativeType জন্য সমর্থিত:

  • CREATIVE_TYPE_VIDEO
thirdPartyUrls[]

object ( ThirdPartyUrl )

ঐচ্ছিক। কোনো ভিডিও ক্রিয়েটিভের সাথে হওয়া মিথস্ক্রিয়া ট্র্যাক করার জন্য তৃতীয় পক্ষের ট্র্যাকিং ইউআরএল।

এই ক্ষেত্রটি শুধুমাত্র নিম্নলিখিত creativeType জন্য সমর্থিত:

  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_VIDEO
  • CREATIVE_TYPE_NATIVE_VIDEO
transcodes[]

object ( Transcode )

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

ডিসপ্লে অ্যান্ড ভিডিও ৩৬০ মূল অ্যাসেটটিকে একাধিক বিকল্প সংস্করণে ট্রান্সকোড করে, যেগুলো ভিন্ন ভিন্ন ফাইল ফরম্যাট ব্যবহার করে অথবা ভিন্ন ভিন্ন বৈশিষ্ট্য (রেজোলিউশন, অডিও বিট রেট এবং ভিডিও বিট রেট) ধারণ করে এবং প্রতিটিই নির্দিষ্ট ভিডিও প্লেয়ার বা ব্যান্ডউইথের জন্য ডিজাইন করা হয়।

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

এই ফিল্ডটি শুধুমাত্র নিম্নলিখিত creativeType এ সমর্থিত:

  • CREATIVE_TYPE_VIDEO
  • CREATIVE_TYPE_NATIVE_VIDEO
  • CREATIVE_TYPE_AUDIO
trackerUrls[]

string

ঐচ্ছিক। অ্যানালিটিক্স প্রদানকারী বা তৃতীয় পক্ষের বিজ্ঞাপন প্রযুক্তি বিক্রেতাদের জন্য ট্র্যাকিং ইউআরএল।

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 )

ঐচ্ছিক। ক্রিয়েটিভটির সাথে যুক্ত ক্যাম্পেইন ম্যানেজার ৩৬০ ট্র্যাকিং বিজ্ঞাপন।

যেসব বিজ্ঞাপনদাতা ক্যাম্পেইন ম্যানেজার ৩৬০ এবং থার্ড-পার্টি অ্যাড সার্ভিং উভয়ই ব্যবহার করেন, তাদের দ্বারা তৈরি নিম্নলিখিত 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

ঐচ্ছিক। এর দ্বারা বোঝানো হয় যে, অ্যাট্রিবিউশনের জন্য ক্রিয়েটিভ একটি ফিরতি পিং-এর অপেক্ষা করবে।

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

ঐচ্ছিক এবং শুধুমাত্র তৃতীয় পক্ষের ট্যাগ ক্রিয়েটিভ বা তৃতীয় পক্ষের 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 )

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

হোস্টিংসোর্স

একটি ক্রিয়েটিভের সম্ভাব্য হোস্টিং উৎসসমূহ। এটি নির্দেশ করে যে ক্রিয়েটিভটি কোথায় তৈরি এবং হোস্ট করা হয়েছে।

এনাম
HOSTING_SOURCE_UNSPECIFIED এই সংস্করণে হোস্টিং উৎস নির্দিষ্ট করা নেই বা অজানা।
HOSTING_SOURCE_CM

ক্যাম্পেইন ম্যানেজার ৩৬০ থেকে সিঙ্ক করা একটি ক্রিয়েটিভ।

এই হোস্টিং টাইপের জন্য ক্রিয়েট এবং আপডেট মেথড সমর্থিত নয়

HOSTING_SOURCE_THIRD_PARTY

তৃতীয় পক্ষের বিজ্ঞাপন সার্ভার (3PAS) দ্বারা হোস্ট করা একটি ক্রিয়েটিভ।

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

  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_EXPANDABLE
  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_VIDEO
HOSTING_SOURCE_HOSTED

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

এই হোস্টিং টাইপের জন্য Create এবং update মেথডগুলো সমর্থিত হবে, যদি 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

স্টুডিওতে তৈরি এবং ক্যাম্পেইন ম্যানেজার ৩৬০ দ্বারা হোস্ট করা একটি রিচ মিডিয়া ক্রিয়েটিভ।

এই হোস্টিং টাইপের জন্য ক্রিয়েট এবং আপডেট মেথড সমর্থিত নয়

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

একজন সৃজনশীল ব্যক্তির সম্ভাব্য বৈশিষ্ট্যসমূহ।

এনাম
CREATIVE_ATTRIBUTE_UNSPECIFIED এই সংস্করণে ক্রিয়েটিভ অ্যাট্রিবিউটটি নির্দিষ্ট করা নেই অথবা এটি অজানা।
CREATIVE_ATTRIBUTE_VAST সৃজনশীলতা বিশাল এবং সৃজনশীল।
CREATIVE_ATTRIBUTE_VPAID_LINEAR ক্রিয়েটিভটি একটি লিনিয়ার ভিপিএআইডি ক্রিয়েটিভ।
CREATIVE_ATTRIBUTE_VPAID_NON_LINEAR ক্রিয়েটিভটি একটি নন-লিনিয়ার VPAID ক্রিয়েটিভ।

পর্যালোচনা স্থিতি তথ্য

সৃজনশীলদের জন্য স্ট্যাটাস পর্যালোচনা করুন।

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 )

সৃজনশীল কাজের জন্য পর্যালোচনার অবস্থা বিনিময় করুন।

অনুমোদন স্থিতি

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

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

পর্যালোচনার অবস্থা

পর্যালোচনা স্থিতির সম্ভাব্য প্রকারভেদ।

এনাম
REVIEW_STATUS_UNSPECIFIED এই সংস্করণে টাইপের মান নির্দিষ্ট করা নেই অথবা তা অজানা।
REVIEW_STATUS_APPROVED সৃজনশীল কাজটি অনুমোদিত হয়েছে।
REVIEW_STATUS_REJECTED সৃজনশীল কাজটি প্রত্যাখ্যাত হয়েছে।
REVIEW_STATUS_PENDING সৃজনশীল কাজটি পর্যালোচনার অপেক্ষায় রয়েছে।

বিনিময় পর্যালোচনা স্থিতি

সৃজনশীল কাজের জন্য পর্যালোচনার অবস্থা বিনিময় করুন।

JSON উপস্থাপনা
{
  "exchange": enum (Exchange),
  "status": enum (ReviewStatus)
}
ক্ষেত্র
exchange

enum ( Exchange )

সৃজনশীলতা পর্যালোচনা সংক্রান্ত আলোচনা।

status

enum ( ReviewStatus )

বিনিময় পর্যালোচনার অবস্থা।

অ্যাসেট অ্যাসোসিয়েশন

সৃজনশীলদের জন্য সম্পদ সংগঠন।

JSON উপস্থাপনা
{
  "asset": {
    object (Asset)
  },
  "role": enum (AssetRole)
}
ক্ষেত্র
asset

object ( Asset )

ঐচ্ছিক। সংশ্লিষ্ট সম্পদ।

role

enum ( AssetRole )

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

সম্পদ

একটি একক সম্পদ।

JSON উপস্থাপনা
{
  "mediaId": string,
  "content": string
}
ক্ষেত্র
mediaId

string ( int64 format)

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

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

content

string

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

অ্যাসেটরোল

সৃজনশীলদের জন্য এই সম্পদের ভূমিকা।

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

ক্রিয়েটিভে দেখানোর জন্য ল্যান্ডিং পেজ ইউআরএল-এর একটি সংক্ষিপ্ত ও ব্যবহার-বান্ধব সংস্করণ। এই ইউআরএলটি ব্যবহারকারীদের একটি ধারণা দেয় যে, ক্রিয়েটিভটিতে ক্লিক করার পর তারা কোথায় পৌঁছাবে।

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

গুগল প্লে স্টোর বা আইওএস অ্যাপ স্টোরে আপনার অ্যাপের ক্রয়মূল্য (উদাহরণস্বরূপ, $৫.৯৯)।

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

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

এই পদের সম্পদসমূহ শুধুমাত্র পঠনযোগ্য।

ASSET_ROLE_ANDROID_APP_ID

গুগল প্লে স্টোরে থাকা একটি অ্যান্ড্রয়েড অ্যাপের আইডি।

আপনি অ্যাপটির গুগল প্লে স্টোর ইউআরএল-এ 'id'-এর পরে এই আইডিটি খুঁজে পাবেন। উদাহরণস্বরূপ, https://play.google.com/store/apps/details?id=com.company.appname এ আইডেন্টিফায়ারটি হলো com.company.appname।

এই পদের সম্পদসমূহ শুধুমাত্র পঠনযোগ্য।

ASSET_ROLE_IOS_APP_ID

অ্যাপল অ্যাপ স্টোরে থাকা একটি iOS অ্যাপের আইডি।

এই আইডি নম্বরটি অ্যাপল অ্যাপ স্টোরের ইউআরএল-এ "id"-এর ঠিক পরেই সংখ্যার সারি হিসেবে পাওয়া যায়। উদাহরণস্বরূপ, https://apps.apple.com/us/app/gmail-email-by-google/id422689480 এ আইডিটি হলো 422689480।

এই পদের সম্পদসমূহ শুধুমাত্র পঠনযোগ্য।

ASSET_ROLE_RATING

গুগল প্লে স্টোর বা আইওএস অ্যাপ স্টোরে কোনো অ্যাপের রেটিং।

মনে রাখবেন যে এই মানটি স্টোরের প্রকৃত রেটিং-এর সাথে স্বয়ংক্রিয়ভাবে সিঙ্ক হয় না। ক্রিয়েটিভটি সেভ করার সময় প্রদত্ত মানটিই সর্বদা এখানে থাকবে।

এই পদের সম্পদসমূহ শুধুমাত্র পঠনযোগ্য।

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

প্রস্থান ইভেন্ট

সৃজনশীল কাজের সমাপ্তি পর্ব।

JSON উপস্থাপনা
{
  "type": enum (ExitEventType),
  "url": string,
  "name": string,
  "reportingName": string
}
ক্ষেত্র
type

enum ( ExitEventType )

আবশ্যক। প্রস্থান ইভেন্টের ধরণ।

url

string

আবশ্যক। প্রস্থান ইভেন্টের ক্লিক-থ্রু ইউআরএল। type ক্ষেত্রে এটি আবশ্যক:

  • EXIT_EVENT_TYPE_DEFAULT
  • EXIT_EVENT_TYPE_BACKUP
name

string

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

একটি সৃজনশীল কাজের মধ্যে নামটি অবশ্যই অনন্য হতে হবে।

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

reportingName

string

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

প্রস্থান ইভেন্টের ধরণ

প্রস্থান ইভেন্টের ধরণ।

এনাম
EXIT_EVENT_TYPE_UNSPECIFIED এই সংস্করণে প্রস্থান ইভেন্টের ধরণ নির্দিষ্ট করা নেই বা অজানা।
EXIT_EVENT_TYPE_DEFAULT প্রস্থান ইভেন্টটি হলো ডিফল্ট ইভেন্ট।
EXIT_EVENT_TYPE_BACKUP এক্সিট ইভেন্টটি একটি ব্যাকআপ এক্সিট ইভেন্ট। একটি ক্রিয়েটিভে একাধিক ব্যাকআপ এক্সিট ইভেন্ট থাকতে পারে।

টাইমারইভেন্ট

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

JSON উপস্থাপনা
{
  "name": string,
  "reportingName": string
}
ক্ষেত্র
name

string

আবশ্যক। টাইমার ইভেন্টের নাম।

reportingName

string

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

পাল্টা ঘটনা

সৃজনশীলতার পাল্টা ঘটনা।

JSON উপস্থাপনা
{
  "name": string,
  "reportingName": string
}
ক্ষেত্র
name

string

আবশ্যক। কাউন্টার ইভেন্টের নাম।

reportingName

string

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

অডিওভিডিওঅফসেট

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

JSON উপস্থাপনা
{

  // Union field offset can be only one of the following:
  "percentage": string,
  "seconds": string
  // End of list of possible types for union field offset.
}
ক্ষেত্র
ইউনিয়ন ফিল্ড offset । অফসেটের মান। offset নিম্নলিখিতগুলির মধ্যে কেবল একটি হতে পারে:
percentage

string ( int64 format)

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

seconds

string ( int64 format)

ঐচ্ছিক। অডিও বা ভিডিও শুরু থেকে সেকেন্ডের ব্যবধান।

ইউনিভার্সাল অ্যাডআইডি

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

JSON উপস্থাপনা
{
  "id": string,
  "registry": enum (UniversalAdRegistry)
}
ক্ষেত্র
id

string

ঐচ্ছিক। অনন্য সৃজনশীল শনাক্তকারী।

registry

enum ( UniversalAdRegistry )

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

ইউনিভার্সাল অ্যাডরেজিস্ট্রি

রেজিস্ট্রিটি একটি ইউনিভার্সাল অ্যাড আইডি-র মাধ্যমে অনন্য ক্রিয়েটিভ আইডেন্টিফায়ার প্রদান করে।

এনাম
UNIVERSAL_AD_REGISTRY_UNSPECIFIED এই সংস্করণে ইউনিভার্সাল অ্যাড রেজিস্ট্রিটি অনির্দিষ্ট বা অজানা।
UNIVERSAL_AD_REGISTRY_OTHER ইউনিভার্সাল অ্যাড আইডি প্রদানের জন্য একটি কাস্টম প্রোভাইডার ব্যবহার করুন।
UNIVERSAL_AD_REGISTRY_AD_ID ইউনিভার্সাল অ্যাড আইডি প্রদান করতে অ্যাড-আইডি ব্যবহার করুন।
UNIVERSAL_AD_REGISTRY_CLEARCAST ইউনিভার্সাল অ্যাড আইডি প্রদান করতে clearcast.co.uk ব্যবহার করুন।
UNIVERSAL_AD_REGISTRY_DV360 ইউনিভার্সাল অ্যাড আইডি প্রদান করতে ডিসপ্লে অ্যান্ড ভিডিও ৩৬০ ব্যবহার করুন।
UNIVERSAL_AD_REGISTRY_CM ইউনিভার্সাল অ্যাড আইডি প্রদান করতে ক্যাম্পেইন ম্যানেজার ৩৬০ ব্যবহার করুন।

তৃতীয় পক্ষের ইউআরএল

কোনো অডিও বা ভিডিও ক্রিয়েটিভের সাথে হওয়া মিথস্ক্রিয়া ট্র্যাক করার জন্য তৃতীয় পক্ষের ট্র্যাকিং ইউআরএল ব্যবহার করা।

JSON উপস্থাপনা
{
  "type": enum (ThirdPartyUrlType),
  "url": string
}
ক্ষেত্র
type

enum ( ThirdPartyUrlType )

ঐচ্ছিক। ট্র্যাকিং ইউআরএল দ্বারা ইন্টারঅ্যাকশনের ধরন ট্র্যাক করা প্রয়োজন।

url

string

ঐচ্ছিক। মিথস্ক্রিয়া ট্র্যাক করতে ব্যবহৃত ট্র্যাকিং ইউআরএল।

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

থার্ডপার্টিইউআরএলটাইপ

তৃতীয় পক্ষের ট্র্যাকিং ইউআরএল দ্বারা ইন্টারঅ্যাকশনের ধরনটি ট্র্যাক করা প্রয়োজন।

এনাম
THIRD_PARTY_URL_TYPE_UNSPECIFIED এই সংস্করণে তৃতীয় পক্ষের ইউআরএল-এর ধরন অনির্দিষ্ট বা অজানা।
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)

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

সিএমট্র্যাকিংঅ্যাড

ক্যাম্পেইন ম্যানেজার ৩৬০-এর একটি ট্র্যাকিং বিজ্ঞাপন।

JSON উপস্থাপনা
{
  "cmPlacementId": string,
  "cmCreativeId": string,
  "cmAdId": string
}
ক্ষেত্র
cmPlacementId

string ( int64 format)

ঐচ্ছিক। ক্যাম্পেইন ম্যানেজার ৩৬০ ট্র্যাকিং অ্যাডের প্লেসমেন্ট আইডি।

cmCreativeId

string ( int64 format)

ঐচ্ছিক। ক্যাম্পেইন ম্যানেজারের ৩৬০ ট্র্যাকিং অ্যাডের ক্রিয়েটিভ আইডি।

cmAdId

string ( int64 format)

ঐচ্ছিক। ক্যাম্পেইন ম্যানেজারের ৩৬০ ট্র্যাকিং বিজ্ঞাপনের বিজ্ঞাপন আইডি।

ওবাইকন

একজন সৃজনশীলের জন্য ওবিএ আইকন

JSON উপস্থাপনা
{
  "resourceUrl": string,
  "resourceMimeType": string,
  "position": enum (ObaIconPosition),
  "dimensions": {
    object (Dimensions)
  },
  "program": string,
  "landingPageUrl": string,
  "clickTrackingUrl": string,
  "viewTrackingUrl": string
}
ক্ষেত্র
resourceUrl

string

ঐচ্ছিক। ওবিএ আইকন রিসোর্সের ইউআরএল।

resourceMimeType

string

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

position

enum ( ObaIconPosition )

ঐচ্ছিক। ক্রিয়েটিভে ওবিএ আইকনের অবস্থান।

dimensions

object ( Dimensions )

ঐচ্ছিক। ওবিএ আইকনের মাত্রা।

program

string

ঐচ্ছিক। OBA আইকনের প্রোগ্রাম। উদাহরণস্বরূপ: “AdChoices”।

landingPageUrl

string

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

শুধুমাত্র নিম্নলিখিত ডোমেইনগুলোর ইউআরএল অনুমোদিত:

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

string

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

শুধুমাত্র নিম্নলিখিত ডোমেইনগুলোর ইউআরএল অনুমোদিত:

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

string

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

শুধুমাত্র নিম্নলিখিত ডোমেইনগুলোর ইউআরএল অনুমোদিত:

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

ওবা আইকন পজিশন

সৃজনশীল অংশে ওবিএ আইকনের অবস্থান।

এনাম
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 ক্রিয়েটিভের নিচের বাম দিকে।

সম্প্রসারণের দিক

তৃতীয় পক্ষের সম্প্রসারণযোগ্য সৃজনশীলতার প্রসারিত দিক।

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

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