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
}
फ़ील्ड
name

string

सिर्फ़ आउटपुट के लिए. क्रिएटिव का संसाधन नाम.

advertiserId

string (int64 format)

सिर्फ़ आउटपुट के लिए. विज्ञापन देने वाले उस व्यक्ति या कंपनी का यूनीक आईडी जिससे क्रिएटिव जुड़ा है.

creativeId

string (int64 format)

सिर्फ़ आउटपुट के लिए. क्रिएटिव का यूनीक आईडी. सिस्टम की ओर से असाइन किया जाता है.

cmPlacementId

string (int64 format)

सिर्फ़ आउटपुट के लिए. क्रिएटिव से जुड़े Campaign Manager 360 प्लेसमेंट का यूनीक आईडी. यह फ़ील्ड सिर्फ़ उन क्रिएटिव के लिए लागू होता है जिन्हें Campaign Manager से सिंक किया गया है.

displayName

string

ज़रूरी है. क्रिएटिव का डिसप्ले नेम.

यह UTF-8 में एन्कोड होना चाहिए और इसका साइज़ ज़्यादा से ज़्यादा 240 बाइट होना चाहिए.

entityStatus

enum (EntityStatus)

ज़रूरी है. इस कुकी से यह कंट्रोल किया जाता है कि क्रिएटिव दिखाया जा सकता है या नहीं.

इन वैल्यू का इस्तेमाल किया जा सकता है:

  • ENTITY_STATUS_ACTIVE
  • ENTITY_STATUS_ARCHIVED
  • ENTITY_STATUS_PAUSED
updateTime

string (Timestamp format)

सिर्फ़ आउटपुट के लिए. वह टाइमस्टैंप, जब क्रिएटिव को आखिरी बार अपडेट किया गया था. इसे उपयोगकर्ता या सिस्टम (जैसे, क्रिएटिव की समीक्षा) ने अपडेट किया था. सिस्टम की ओर से असाइन किया जाता है.

यह RFC 3339 का इस्तेमाल करता है. इसमें जनरेट किया गया आउटपुट हमेशा Z-नॉर्मलाइज़ किया जाएगा और इसमें 0, 3, 6 या 9 फ़्रैक्शनल अंक इस्तेमाल किए जाएंगे. "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-नॉर्मलाइज़ किया जाएगा और इसमें 0, 3, 6 या 9 फ़्रैक्शनल अंक इस्तेमाल किए जाएंगे. "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, दोनों की वैल्यू देना ज़रूरी है. साथ ही, इनकी वैल्यू 0 से ज़्यादा या उसके बराबर होनी चाहिए.

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" नाम का JavaScript वैरिएबल तय करें.
  • रिच मीडिया फ़ॉर्मैट में एग्ज़िट को ट्रैक करने के लिए, चालू करने वाले टूल (Enabler.exit()) का इस्तेमाल करें.
timerEvents[]

object (TimerEvent)

ज़रूरी नहीं. रिच मीडिया क्रिएटिव के लिए टाइमर वाले कस्टम इवेंट. टाइमर, उस समय को ट्रैक करते हैं जब कोई उपयोगकर्ता किसी रिच मीडिया क्रिएटिव का कोई हिस्सा देखता है और उससे इंटरैक्ट करता है. किसी क्रिएटिव में एक से ज़्यादा टाइमर इवेंट हो सकते हैं, जिनका समय अलग-अलग हो सकता है. सिर्फ़ इमेज ऐसेट वाले क्रिएटिव के लिए, इसे खाली छोड़ दें या अनसेट करें.

counterEvents[]

object (CounterEvent)

ज़रूरी नहीं. रिच मीडिया क्रिएटिव के लिए काउंटर इवेंट. काउंटर, इस बात को ट्रैक करते हैं कि किसी उपयोगकर्ता ने रिच मीडिया क्रिएटिव के किसी हिस्से से किसी खास तरीके (माउस-ओवर, माउस-आउट, क्लिक, टैप, डेटा लोड करना, कीबोर्ड एंट्री वगैरह) से कितनी बार इंटरैक्ट किया. क्रिएटिव में कैप्चर किए जा सकने वाले किसी भी इवेंट को काउंटर के तौर पर रिकॉर्ड किया जा सकता है. सिर्फ़ इमेज ऐसेट वाले क्रिएटिव के लिए, इसे खाली छोड़ दें या अनसेट करें.

appendedTag

string

ज़रूरी नहीं. तीसरे पक्ष का एचटीएमएल ट्रैकिंग टैग, जिसे क्रिएटिव टैग में जोड़ा जाना है.

integrationCode

string

ज़रूरी नहीं. इस क्रिएटिव को किसी बाहरी सिस्टम से लिंक करने के लिए इस्तेमाल की गई आईडी की जानकारी. यह UTF-8 कोड में होना चाहिए. साथ ही, इसमें 10,000 से ज़्यादा वर्ण नहीं होने चाहिए.

notes

string

ज़रूरी नहीं. इस क्रिएटिव के लिए उपयोगकर्ता के नोट. यह UTF-8 कोड में होना चाहिए. साथ ही, इसमें 20,000 से ज़्यादा वर्ण नहीं होने चाहिए.

iasCampaignMonitoring

boolean

ज़रूरी नहीं. इससे पता चलता है कि Integral Ad Science (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 को 'सही' पर सेट करने के बाद, इस फ़ील्ड को भरना ज़रूरी है.

इस फ़ील्ड का इस्तेमाल, सिर्फ़ इन 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)

ज़रूरी नहीं. तीसरे पक्षों के ट्रैकिंग यूआरएल, ताकि वीडियो क्रिएटिव के साथ हुए इंटरैक्शन को ट्रैक किया जा सके.

इस फ़ील्ड का इस्तेमाल, सिर्फ़ इन 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

ज़रूरी नहीं. ऐनलिटिक्स की सेवा देने वाली कंपनियों या विज्ञापन टेक्नोलॉजी की सेवा देने वाले तीसरे पक्ष के वेंडर के लिए ट्रैकिंग यूआरएल.

यूआरएल, https: से शुरू होने चाहिए. हालांकि, जिन इन्वेंट्री के लिए एसएसएल का पालन करना ज़रूरी नहीं है उनके लिए ऐसा करना ज़रूरी नहीं है. अगर आपको अपने यूआरएल में मैक्रो का इस्तेमाल करना है, तो सिर्फ़ Display & Video 360 के साथ काम करने वाले मैक्रो का इस्तेमाल करें.

सिर्फ़ स्टैंडर्ड यूआरएल, कोई IMG या SCRIPT टैग नहीं.

इस फ़ील्ड में सिर्फ़ इन creativeType में वैल्यू लिखी जा सकती है:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
jsTrackerUrl

string

ज़रूरी नहीं. तीसरे पक्ष के उन पुष्टि करने वाले प्लैटफ़ॉर्म से मिला JavaScript मेज़रमेंट यूआरएल जिनके साथ काम किया जा सकता है. जैसे, ComScore, DoubleVerify, IAS, और Moat. एचटीएमएल स्क्रिप्ट टैग काम नहीं करते.

इस फ़ील्ड में सिर्फ़ इन 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)

ज़रूरी नहीं. यह किसी वीडियो क्रिएटिव के लिए ओबीए आइकॉन तय करता है.

यह फ़ील्ड, सिर्फ़ इन 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

तीसरे पक्ष के वीएएसटी टैग क्रिएटिव, ऐसे क्रिएटिव होते हैं जिनमें ये 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 टैग का यूआरएल.

यह ज़रूरी है और सिर्फ़ तीसरे पक्ष के VAST टैग क्रिएटिव के लिए मान्य है.

तीसरे पक्ष के वीएएसटी टैग क्रिएटिव, ऐसे क्रिएटिव होते हैं जिनमें ये hostingSource शामिल होते हैं:

  • HOSTING_SOURCE_THIRD_PARTY

इन creativeType के साथ जोड़ा गया:

  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_VIDEO
vpaid

boolean

सिर्फ़ आउटपुट के लिए. इससे पता चलता है कि तीसरे पक्ष के VAST टैग क्रिएटिव के लिए, VPAID (डिजिटल वीडियो प्लेयर-ऐड इंटरफ़ेस) की ज़रूरत है.

सिर्फ़ आउटपुट के लिए और सिर्फ़ तीसरे पक्ष के VAST टैग क्रिएटिव के लिए मान्य है.

तीसरे पक्ष के वीएएसटी टैग क्रिएटिव, ऐसे क्रिएटिव होते हैं जिनमें ये hostingSource शामिल होते हैं:

  • HOSTING_SOURCE_THIRD_PARTY

इन creativeType के साथ जोड़ा गया:

  • CREATIVE_TYPE_VIDEO
html5Video

boolean

सिर्फ़ आउटपुट के लिए. इससे पता चलता है कि तीसरे पक्ष के VAST टैग क्रिएटिव के लिए, HTML5 वीडियो की सुविधा ज़रूरी है.

सिर्फ़ आउटपुट के लिए और सिर्फ़ तीसरे पक्ष के 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

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)

क्रिएटिव के लिए एक्सचेंज की समीक्षा की स्थितियां.

स्वीकृति स्थिति

अनुमति की स्थिति के टाइप. यह 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)

अपलोड की गई ऐसेट का मीडिया आईडी. यह ऐसेट के लिए यूनीक आइडेंटिफ़ायर है. इस आईडी को अन्य एपीआई कॉल में पास किया जा सकता है. उदाहरण के लिए, creatives.create ऐसेट को क्रिएटिव से जोड़ने के लिए.

मीडिया आईडी स्पेस को 5 अप्रैल, 2023 को अपडेट किया गया था. 5 अप्रैल, 2023 से पहले कैश किए गए मीडिया आईडी अपडेट करें. इसके लिए, मीडिया आईडी से जुड़े क्रिएटिव संसाधनों से नया मीडिया आईडी पाएं या ऐसेट को फिर से अपलोड करें.

content

string

ऐसेट का कॉन्टेंट. अपलोड की गई ऐसेट के लिए, कॉन्टेंट वह पाथ होता है जहां ऐसेट को दिखाया जाता है.

AssetRole

क्रिएटिव के लिए इस ऐसेट की भूमिका.

Enums
ASSET_ROLE_UNSPECIFIED इस वर्शन में ऐसेट की भूमिका के बारे में नहीं बताया गया है या इसकी जानकारी नहीं है.
ASSET_ROLE_MAIN यह ऐसेट, क्रिएटिव की मुख्य ऐसेट होती है.
ASSET_ROLE_BACKUP यह ऐसेट, क्रिएटिव की बैकअप ऐसेट है.
ASSET_ROLE_POLITE_LOAD ऐसेट, क्रिएटिव की पोलाइट लोड ऐसेट है.
ASSET_ROLE_HEADLINE

नेटिव क्रिएटिव की हेडलाइन.

content को UTF-8 कोड में बदला जाना चाहिए. साथ ही, इसमें 25 से ज़्यादा वर्ण नहीं होने चाहिए.

यह भूमिका सिर्फ़ इन creativeType में काम करती है:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_LONG_HEADLINE

नेटिव क्रिएटिव की लंबी हेडलाइन.

content को UTF-8 कोड में बदला जाना चाहिए. साथ ही, इसमें 50 से ज़्यादा वर्ण नहीं होने चाहिए.

यह भूमिका सिर्फ़ इन creativeType में काम करती है:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_BODY

नेटिव क्रिएटिव का मुख्य हिस्सा.

content को UTF-8 कोड में बदला जाना चाहिए. साथ ही, इसकी लंबाई 90 वर्णों से ज़्यादा नहीं होनी चाहिए.

यह भूमिका सिर्फ़ इन creativeType में काम करती है:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_LONG_BODY

नेटिव क्रिएटिव का लंबा मुख्य लेख.

content को UTF-8 कोड में बदला जाना चाहिए. साथ ही, इसमें 150 से ज़्यादा वर्ण नहीं होने चाहिए.

यह भूमिका सिर्फ़ इन creativeType में काम करती है:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_CAPTION_URL

क्रिएटिव में दिखाने के लिए, लैंडिंग पेज यूआरएल का छोटा और आसान वर्शन. इस यूआरएल से लोगों को पता चलता है कि क्रिएटिव पर क्लिक करने के बाद वे किस वेबसाइट पर पहुंचेंगे.

content को UTF-8 कोड में बदला जाना चाहिए. साथ ही, इसकी लंबाई 30 वर्णों से ज़्यादा नहीं होनी चाहिए.

उदाहरण के लिए, अगर लैंडिंग पेज का यूआरएल 'http://www.example.com/page' है, तो कैप्शन का यूआरएल 'example.com' हो सकता है. प्रोटोकॉल (http://) का इस्तेमाल करना ज़रूरी नहीं है. हालांकि, यूआरएल में स्पेस या खास वर्ण नहीं होने चाहिए.

यह भूमिका सिर्फ़ इन creativeType में काम करती है:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_CALL_TO_ACTION

नेटिव क्रिएटिव के कॉल-टू-ऐक्शन बटन पर इस्तेमाल किया जाने वाला टेक्स्ट.

content को UTF-8 कोड में बदला जाना चाहिए. साथ ही, इसकी लंबाई 15 वर्णों से ज़्यादा नहीं होनी चाहिए.

यह भूमिका सिर्फ़ इन creativeType में काम करती है:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_ADVERTISER_NAME

वह टेक्स्ट जिससे विज्ञापन देने वाले व्यक्ति या कंपनी या ब्रैंड के नाम की पहचान होती है.

content को UTF-8 कोड में बदला जाना चाहिए. साथ ही, इसमें 25 से ज़्यादा वर्ण नहीं होने चाहिए.

यह भूमिका सिर्फ़ इन creativeType में काम करती है:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_PRICE

Google Play Store या iOS App Store में आपके ऐप्लिकेशन की खरीदारी की कीमत (उदाहरण के लिए, 5.99 डॉलर).

ध्यान दें कि यह वैल्यू, स्टोर में दी गई असल वैल्यू के साथ अपने-आप सिंक नहीं होती. यह हमेशा वही होगा जो क्रिएटिव को सेव करते समय दिया गया था.

content को UTF-8 कोड में बदला जाना चाहिए. साथ ही, इसकी लंबाई 15 वर्णों से ज़्यादा नहीं होनी चाहिए.

इस भूमिका की ऐसेट को सिर्फ़ पढ़ा जा सकता है.

ASSET_ROLE_ANDROID_APP_ID

Google Play Store में मौजूद किसी Android ऐप्लिकेशन का आईडी.

यह आईडी, ऐप्लिकेशन के Google Play Store के यूआरएल में ‘id’ के बाद देखा जा सकता है. उदाहरण के लिए, https://play.google.com/store/apps/details?id=com.company.appname में आइडेंटिफ़ायर com.company.appname है.

इस भूमिका की ऐसेट को सिर्फ़ पढ़ा जा सकता है.

ASSET_ROLE_IOS_APP_ID

Apple App Store में मौजूद किसी iOS ऐप्लिकेशन का आईडी.

यह आईडी नंबर, Apple App Store के यूआरएल में "id" के ठीक बाद मौजूद संख्याओं की स्ट्रिंग के तौर पर देखा जा सकता है. उदाहरण के लिए, https://apps.apple.com/us/app/gmail-email-by-google/id422689480 में आईडी 422689480 है.

इस भूमिका की ऐसेट को सिर्फ़ पढ़ा जा सकता है.

ASSET_ROLE_RATING

Google Play Store या iOS App Store में किसी ऐप्लिकेशन की रेटिंग.

ध्यान दें कि यह वैल्यू, स्टोर में मौजूद असल रेटिंग के साथ अपने-आप सिंक नहीं होती. यह हमेशा वही होगा जो क्रिएटिव को सेव करते समय दिया गया था.

इस भूमिका की ऐसेट को सिर्फ़ पढ़ा जा सकता है.

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

ज़रूरी है. एग्ज़िट इवेंट का क्लिक थ्रू यूआरएल. इसकी ज़रूरत तब होती है, जब 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 के काेड में दिखाना
{

  // 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)

ज़रूरी नहीं. ऑडियो या वीडियो की शुरुआत से ऑफ़सेट, सेकंड में.

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 Universal Ad ID देने के लिए, clearcast.co.uk का इस्तेमाल करें.
UNIVERSAL_AD_REGISTRY_DV360 यूनिवर्सल विज्ञापन आईडी देने के लिए, Display & Video 360 का इस्तेमाल करें.
UNIVERSAL_AD_REGISTRY_CM यूनिवर्सल विज्ञापन आईडी देने के लिए, Campaign Manager 360 का इस्तेमाल करें.

ThirdPartyUrl

तीसरे पक्षों के ट्रैकिंग यूआरएल, ऑडियो या वीडियो क्रिएटिव के साथ इंटरैक्शन को ट्रैक करने के लिए.

JSON के काेड में दिखाना
{
  "type": enum (ThirdPartyUrlType),
  "url": string
}
फ़ील्ड
type

enum (ThirdPartyUrlType)

ज़रूरी नहीं. ट्रैकिंग यूआरएल को इंटरैक्शन के टाइप को ट्रैक करना चाहिए

url

string

ज़रूरी नहीं. इंटरैक्शन को ट्रैक करने के लिए इस्तेमाल किया गया ट्रैकिंग यूआरएल.

https: से शुरू होने वाला यूआरएल डालें. इसमें पाथ या क्वेरी स्ट्रिंग डालना ज़रूरी नहीं है. उदाहरण के लिए, https://www.example.com/path

ThirdPartyUrlType

तीसरे पक्ष के ट्रैकिंग यूआरएल से, इंटरैक्शन के टाइप को ट्रैक किया जाना चाहिए.

Enums
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 इस कुकी का इस्तेमाल यह ट्रैक करने के लिए किया जाता है कि ऑडियो या वीडियो को कितनी बार उसकी कुल अवधि के 25% तक चलाया गया.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_MIDPOINT इस कुकी का इस्तेमाल यह ट्रैक करने के लिए किया जाता है कि ऑडियो या वीडियो को कितनी बार उसकी अवधि के 50% तक चलाया गया.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_THIRD_QUARTILE इस कुकी का इस्तेमाल यह ट्रैक करने के लिए किया जाता है कि ऑडियो या वीडियो को कितनी बार 75% तक चलाया गया.
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

क्रिएटिव के लिए ओबीए आइकॉन

JSON के काेड में दिखाना
{
  "resourceUrl": string,
  "resourceMimeType": string,
  "position": enum (ObaIconPosition),
  "dimensions": {
    object (Dimensions)
  },
  "program": string,
  "landingPageUrl": string,
  "clickTrackingUrl": string,
  "viewTrackingUrl": string
}
फ़ील्ड
resourceUrl

string

ज़रूरी नहीं. ओबीए आइकॉन संसाधन का यूआरएल.

resourceMimeType

string

ज़रूरी नहीं. ओबीए आइकॉन रिसॉर्स का MIME टाइप.

position

enum (ObaIconPosition)

ज़रूरी नहीं. क्रिएटिव पर ओबीए आइकॉन की जगह.

dimensions

object (Dimensions)

ज़रूरी नहीं. ओबीए आइकॉन के डाइमेंशन.

program

string

ज़रूरी नहीं. ओबीए आइकॉन का प्रोग्राम. उदाहरण के लिए: “AdChoices”.

landingPageUrl

string

ज़रूरी है. ओबीए आइकॉन का लैंडिंग पेज यूआरएल.

सिर्फ़ इन डोमेन के यूआरएल इस्तेमाल किए जा सकते हैं:

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

string

ज़रूरी है. यह OBA आइकॉन का क्लिक ट्रैकिंग यूआरएल है.

सिर्फ़ इन डोमेन के यूआरएल इस्तेमाल किए जा सकते हैं:

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

string

ज़रूरी है. OBA आइकॉन का व्यू ट्रैकिंग यूआरएल.

सिर्फ़ इन डोमेन के यूआरएल इस्तेमाल किए जा सकते हैं:

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

ObaIconPosition

क्रिएटिव पर ओबीए आइकॉन की जगह.

Enums
OBA_ICON_POSITION_UNSPECIFIED ओबीए आइकॉन की पोज़िशन के बारे में जानकारी नहीं दी गई है.
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

इस तरीके का इस्तेमाल करके, किसी मौजूदा क्रिएटिव को अपडेट किया जा सकता है.