REST Resource: curators.curatedPackages

संसाधन: CuratedPackage

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

JSON के काेड में दिखाना
{
  "name": string,
  "displayName": string,
  "description": string,
  "createTime": string,
  "updateTime": string,
  "floorPriceCpm": {
    object (Money)
  },
  "state": enum (State),
  "accessSettings": {
    object (AccessControlSettings)
  },
  "targeting": {
    object (PackageTargeting)
  },
  "curationFeeVisibility": enum (CurationFeeVisibility),

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "feeCpm": {
    object (Money)
  },
  "millipercentOfMediaFee": string
  // End of mutually exclusive fields.
}
फ़ील्ड
name

string

आइडेंटिफ़ायर. क्यूरेट किए गए पैकेज के लिए यूनीक रिसॉर्स नेम. फ़ॉर्मैट: curators/{accountId}/curatedPackages/{curatedPackageId}

displayName

string

ज़रूरी है. क्यूरेटर ने क्यूरेट किए गए पैकेज को जो डिसप्ले नेम असाइन किया है. इसका इस्तेमाल, curatedPackages.list तरीके के रिस्पॉन्स को फ़िल्टर करने के लिए किया जा सकता है.

description

string

ज़रूरी नहीं. क्यूरेटर की ओर से उपलब्ध कराए गए क्यूरेट किए गए पैकेज की जानकारी.

createTime

string (Timestamp format)

सिर्फ़ आउटपुट के लिए. वह टाइमस्टैंप जब क्यूरेट किया गया पैकेज बनाया गया था. इसका इस्तेमाल, curatedPackages.list तरीके के रिस्पॉन्स को फ़िल्टर करने के लिए किया जा सकता है.

यह आरएफ़सी 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".

updateTime

string (Timestamp format)

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

यह आरएफ़सी 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".

floorPriceCpm

object (Money)

ज़रूरी नहीं. इस क्यूरेट किए गए पैकेज में मौजूद इन्वेंट्री की नीलामियों में हिस्सा लेने के लिए, खरीदार को कम से कम कितना सीपीएम बिड करना होगा. इसका इस्तेमाल, curatedPackages.list तरीके के रिस्पॉन्स को फ़िल्टर करने के लिए किया जा सकता है.

state

enum (State)

सिर्फ़ आउटपुट के लिए. चुनिंदा पैकेज की स्थिति. इसका इस्तेमाल, curatedPackages.list तरीके के रिस्पॉन्स को फ़िल्टर करने के लिए किया जा सकता है.

accessSettings

object (AccessControlSettings)

ज़रूरी है. क्यूरेट किए गए पैकेज का ऐक्सेस कंट्रोल करने की सेटिंग.

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

targeting

object (PackageTargeting)

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

curationFeeVisibility

enum (CurationFeeVisibility)

ज़रूरी नहीं. इम्यूटेबल. चुने गए पैकेज की फ़ीस और डेटा सेगमेंट की फ़ीस (कुल क्यूरेशन फ़ीस) की जानकारी.

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

object (Money)

ज़रूरी नहीं. इस क्यूरेट किए गए पैकेज का इस्तेमाल करने वाले खरीदारों से, क्यूरेटर की ओर से लिया जाने वाला सीपीएम शुल्क. इसका इस्तेमाल, curatedPackages.list तरीके के रिस्पॉन्स को फ़िल्टर करने के लिए किया जा सकता है.

millipercentOfMediaFee

string (int64 format)

ज़रूरी नहीं. शुल्क, इंप्रेशन की लागत के प्रतिशत के तौर पर लिया जाएगा. इसे मिली प्रतिशत में दिखाया जाएगा. उदाहरण के लिए, 1% को 1000 के तौर पर दिखाया जाता है.

एक-दूसरे से अलग फ़ील्ड का अंत.

राज्य

चुनिंदा पैकेज की स्थिति.

Enums
STATE_UNSPECIFIED डिफ़ॉल्ट मान.
ACTIVE चुनिंदा पैकेज चालू है.
INACTIVE क्यूरेट किया गया पैकेज चालू नहीं है.

AccessControlSettings

चुनिंदा पैकेज के ऐक्सेस को कंट्रोल करने की सेटिंग.

JSON के काेड में दिखाना
{
  "allowlistedMediaPlanners": [
    string
  ]
}
फ़ील्ड
allowlistedMediaPlanners[]

string

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

फ़ॉर्मैट: mediaPlanners/{mediaPlannerAccountId}

PackageTargeting

क्यूरेट किए गए और नीलामी वाले पैकेज के लिए टारगेटिंग की ज़रूरी शर्तें.

JSON के काेड में दिखाना
{
  "includedDeviceTypes": [
    enum (DeviceType)
  ],
  "includedEnvironment": enum (Environment),
  "includedCreativeFormat": enum (CreativeFormat),
  "includedAcceleratedMobilePageType": enum (AcceleratedMobilePageType),
  "includedAuthorizedSellerStatuses": [
    enum (AuthorizedSellerStatus)
  ],
  "includedNativeInventoryTypes": [
    enum (NativeInventoryType)
  ],
  "includedOpenMeasurementTypes": [
    enum (OpenMeasurementType)
  ],
  "includedRestrictedCategories": [
    enum (RestrictedCategory)
  ],
  "includedRewardedType": enum (RewardedType),
  "videoTargeting": {
    object (PackageVideoTargeting)
  },
  "minimumPredictedViewabilityPercentage": string,
  "languageTargeting": {
    object (StringTargetingDimension)
  },
  "includedAdSizes": [
    {
      object (AdSize)
    }
  ],
  "publisherTargeting": {
    object (StringTargetingDimension)
  },
  "minimumPredictedClickThroughRatePercentageMillis": string,
  "verticalTargeting": {
    object (CriteriaTargeting)
  },
  "geoTargeting": {
    object (CriteriaTargeting)
  },
  "includedDataSegments": [
    string
  ],
  "placementTargeting": {
    object (PackagePlacementTargeting)
  },
  "publisherProvidedSignalsTargeting": {
    object (PackagePublisherProvidedSignalsTargeting)
  }
}
फ़ील्ड
includedDeviceTypes[]

enum (DeviceType)

ज़रूरी नहीं. टारगेट किए जाने वाले डिवाइस टाइप की सूची. अगर यह फ़ील्ड खाली है, तो सभी तरह के डिवाइसों को टारगेट किया जाता है.

includedEnvironment

enum (Environment)

ज़रूरी नहीं. टारगेट करने के लिए एनवायरमेंट. अगर कोई एनवायरमेंट तय नहीं किया जाता है, तो सभी एनवायरमेंट को टारगेट किया जाता है.

includedCreativeFormat

enum (CreativeFormat)

ज़रूरी नहीं. टारगेट करने के लिए क्रिएटिव फ़ॉर्मैट. अगर इसे सेट नहीं किया जाता है, तो सभी क्रिएटिव मार्कअप टाइप को टारगेट किया जाता है.

includedAcceleratedMobilePageType

enum (AcceleratedMobilePageType)

ज़रूरी नहीं. टारगेट किया गया Accelerated Mobile Page टाइप. अगर इसे सेट नहीं किया जाता है, तो एएमपी स्टेटस के बावजूद इन्वेंट्री को टारगेट किया जाएगा.

includedAuthorizedSellerStatuses[]

enum (AuthorizedSellerStatus)

ज़रूरी नहीं. टारगेट किए गए अधिकृत विक्रेता की स्थितियों की सूची. अगर यह फ़ील्ड खाली है, तो सेलर की स्थिति के बावजूद इन्वेंट्री को टारगेट किया जाएगा.

includedNativeInventoryTypes[]

enum (NativeInventoryType)

ज़रूरी नहीं. टारगेट की गई नेटिव इन्वेंट्री के टाइप. अगर यह फ़ील्ड खाली है, तो नेटिव इन्वेंट्री के टाइप पर ध्यान दिए बिना, इन्वेंट्री को टारगेट किया जाएगा.

includedOpenMeasurementTypes[]

enum (OpenMeasurementType)

ज़रूरी नहीं. टारगेट किए गए ओपन मेज़रमेंट टाइप की सूची. अगर यह फ़ील्ड खाली है, तो इन्वेंट्री को टारगेट किया जाएगा. भले ही, ओपन मेज़रमेंट की सुविधा काम करती हो या नहीं.

includedRestrictedCategories[]

enum (RestrictedCategory)

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

includedRewardedType

enum (RewardedType)

ज़रूरी नहीं. टारगेट किया गया इनाम का टाइप. अगर यह नीति सेट नहीं है, तो इनाम के टाइप पर ध्यान दिए बिना इन्वेंट्री को टारगेट किया जाएगा.

videoTargeting

object (PackageVideoTargeting)

ज़रूरी नहीं. वीडियो के लिए टारगेटिंग की ज़रूरी शर्तें.

minimumPredictedViewabilityPercentage

string (int64 format)

ज़रूरी नहीं. विज्ञापन दिखने की संभावना का टारगेट किया गया कम से कम अनुमानित प्रतिशत.

यह वैल्यू, 10 से 90 के बीच की कोई संख्या होनी चाहिए. हालांकि, इन दोनों में से भी कोई संख्या हो सकती है. साथ ही, यह संख्या 10 का गुणज होनी चाहिए. उदाहरण के लिए, 10 मान्य है, लेकिन 0, 15, और 100 मान्य नहीं हैं. अगर वैल्यू 10 है, तो इसका मतलब है कि कॉन्फ़िगरेशन सिर्फ़ उन विज्ञापन स्लॉट से मैच करेगा जिनके लिए हम कम से कम 10% विज्ञापन दिखने की संभावना का अनुमान लगाते हैं.

अगर कोई वैल्यू सेट नहीं की गई है, तो इसका मतलब है कि इन्वेंट्री को टारगेट किया जाएगा. भले ही, विज्ञापन दिखने की अनुमानित दर कुछ भी हो.

languageTargeting

object (StringTargetingDimension)

ज़रूरी नहीं. टारगेट की जाने वाली भाषाएं. अगर इसे सेट नहीं किया जाता है, तो इन्वेंट्री को भाषा के आधार पर टारगेट नहीं किया जाएगा. इस्तेमाल किए जा सकने वाले भाषा कोड की सूची देखने के लिए, https://developers.google.com/google-ads/api/data/codes-formats#languages पर जाएं.

includedAdSizes[]

object (AdSize)

ज़रूरी नहीं. टारगेट किए जाने वाले विज्ञापन साइज़ की सूची. अगर यह नीति सेट नहीं है, तो विज्ञापन के साइज़ पर ध्यान दिए बिना इन्वेंट्री को टारगेट किया जाएगा.

क्यूरेट किए गए पैकेज, PIXEL और INTERSTITIAL विज्ञापन साइज़ के साथ काम करते हैं.

publisherTargeting

object (StringTargetingDimension)

ज़रूरी नहीं. टारगेट किए गए पब्लिशर. अगर इसे सेट नहीं किया जाता है, तो इन्वेंट्री को टारगेट किया जाएगा. इससे कोई फ़र्क़ नहीं पड़ता कि पब्लिशर कौन है. पब्लिशर की पहचान, ads.txt / app-ads.txt फ़ाइल में मौजूद उनके पब्लिशर आईडी से की जाती है. ज़्यादा जानकारी के लिए, https://iabtechlab.com/ads-txt/ और https://iabtechlab.com/app-ads-txt/ पर जाएं.

minimumPredictedClickThroughRatePercentageMillis

string (int64 format)

ज़रूरी नहीं. क्लिक मिलने की अनुमानित दर का टारगेट किया गया कम से कम प्रतिशत. इसकी वैल्यू [10, 10000] (0.01% - 10%) के बीच होती है. 50 की वैल्यू का मतलब है कि कॉन्फ़िगरेशन सिर्फ़ उन विज्ञापन स्लॉट से मैच करेगा जिनके लिए हम कम से कम 0.05% क्लिक मिलने की दर का अनुमान लगाते हैं.

अगर कोई वैल्यू सेट नहीं की जाती है, तो इसका मतलब है कि क्लिक मिलने की अनुमानित दर (सीटीआर) के बावजूद, इन्वेंट्री को टारगेट किया जाएगा.

verticalTargeting

object (CriteriaTargeting)

ज़रूरी नहीं. https://developers.google.com/authorized-buyers/rtb/downloads/publisher-verticals में दी गई परिभाषा के मुताबिक, शामिल या बाहर रखे गए वर्टिकल. अगर इसे सेट नहीं किया जाता है, तो इन्वेंट्री को वर्टिकल के हिसाब से टारगेट नहीं किया जाएगा.

geoTargeting

object (CriteriaTargeting)

ज़रूरी नहीं. https://storage.googleapis.com/adx-rtb-dictionaries/geo-table.csv में बताए गए, शामिल या बाहर किए जाने वाले जियो क्राइटेरिया आईडी. अगर इसे सेट नहीं किया जाता है, तो इन्वेंट्री को भौगोलिक जगह के हिसाब से टारगेट नहीं किया जाएगा.

includedDataSegments[]

string

ज़रूरी नहीं. टारगेट किए जाने वाले ऐक्टिव डेटा सेगमेंट. अगर यह नीति सेट नहीं है, तो डेटा सेगमेंट के बावजूद इन्वेंट्री को टारगेट किया जाएगा. फ़ॉर्मैट: curators/{accountId}/dataSegments/{data_segment_id}

placementTargeting

object (PackagePlacementTargeting)

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

publisherProvidedSignalsTargeting

object (PackagePublisherProvidedSignalsTargeting)

ज़रूरी नहीं. टारगेट करने के लिए, पब्लिशर से मिले सिग्नल. अगर इसे सेट नहीं किया जाता है, तो पब्लिशर से मिले सिग्नल के बावजूद इन्वेंट्री को टारगेट किया जाएगा.

DeviceType

टारगेट किए जाने वाले डिवाइस का सामान्य टाइप.

Enums
DEVICE_TYPE_UNSPECIFIED डिफ़ॉल्ट मान. टारगेटिंग की खास बातों में इसका इस्तेमाल नहीं किया जाना चाहिए.
DEVICE_TYPE_PERSONAL_COMPUTER डेस्कटॉप या लैपटॉप कंप्यूटर को टारगेट करता है.
DEVICE_TYPE_CONNECTED_TV कनेक्टेड टीवी को टारगेट करता है: टीवी का कॉन्टेंट स्ट्रीम करने वाले डिवाइस, जैसे कि स्मार्ट टीवी, गेमिंग कंसोल, और स्ट्रीमिंग बॉक्स/स्टिक.
DEVICE_TYPE_PHONE ऐडवांस सुविधाओं वाले फ़ोन या टैबलेट को टारगेट करता है.
DEVICE_TYPE_TABLET टैबलेट डिवाइसों को टारगेट करता है.

परिवेश

टारगेट करने के लिए एनवायरमेंट.

Enums
ENVIRONMENT_UNSPECIFIED डिफ़ॉल्ट मान. टारगेटिंग की खास बातों में इसका इस्तेमाल नहीं किया जाना चाहिए.
ENVIRONMENT_SITE यह विज्ञापन दिखाने वाली वेबसाइट पर रेंडर की गई इन्वेंट्री को टारगेट करता है.
ENVIRONMENT_APP यह मोबाइल ऐप्लिकेशन में मौजूद इन्वेंट्री को टारगेट करता है.

CreativeFormat

वह क्रिएटिव फ़ॉर्मैट जिसे टारगेट किया जा सकता है.

Enums
CREATIVE_FORMAT_UNSPECIFIED डिफ़ॉल्ट मान. टारगेटिंग की खास बातों में इसका इस्तेमाल नहीं किया जाना चाहिए.
CREATIVE_FORMAT_DISPLAY यह एचटीएमएल डिसप्ले क्रिएटिव के लिए बनाए गए विज्ञापन स्लॉट को टारगेट करता है.
CREATIVE_FORMAT_VIDEO यह वीडियो क्रिएटिव के लिए बनाए गए विज्ञापन स्लॉट को टारगेट करता है.
CREATIVE_FORMAT_AUDIO यह ऑडियो क्रिएटिव के लिए बनाए गए विज्ञापन स्लॉट को टारगेट करता है.

AcceleratedMobilePageType

Accelerated Mobile Page (एएमपी) को लागू करने का वह टाइप जिसे टारगेट करना है.

Enums
ACCELERATED_MOBILE_PAGE_TYPE_UNSPECIFIED डिफ़ॉल्ट मान. टारगेटिंग की खास बातों में इसका इस्तेमाल नहीं किया जाना चाहिए.
ACCELERATED_MOBILE_PAGE_TYPE_NON_AMP यह एएमपी फ़्रेमवर्क का इस्तेमाल न करने वाले स्टैंडर्ड वेब पेजों पर मौजूद इन्वेंट्री को टारगेट करता है.
ACCELERATED_MOBILE_PAGE_TYPE_AMP यह मुख्य एएमपी एचटीएमएल फ़्रेमवर्क का इस्तेमाल करके बनाए गए पेजों पर मौजूद इन्वेंट्री को टारगेट करता है.
ACCELERATED_MOBILE_PAGE_TYPE_AMP_STORY यह एएमपी स्टोरी (एसटीएएमपी) फ़ॉर्मैट का इस्तेमाल करने वाले पेजों पर मौजूद इन्वेंट्री को टारगेट करता है.इस फ़ॉर्मैट को विज़ुअल स्टोरीटेलिंग के लिए ऑप्टिमाइज़ किया गया है. जैसे, टैप करके फ़ुल-स्क्रीन अनुभव पाना.

AuthorizedSellerStatus

यह पब्लिशर और विक्रेता के बीच के संबंध को दिखाता है, जैसा कि ads.txt या app-ads.txt फ़ाइल में बताया गया है.

Enums
AUTHORIZED_SELLER_STATUS_UNSPECIFIED डिफ़ॉल्ट मान. टारगेटिंग की खास बातों में इसका इस्तेमाल नहीं किया जाना चाहिए.
AUTHORIZED_SELLER_STATUS_DIRECT यह उस इन्वेंट्री को टारगेट करता है जहां विक्रेता को 'डायरेक्ट' के तौर पर दिखाया गया है. इससे पता चलता है कि पब्लिशर (कॉन्टेंट का मालिक), सेलर खाते को सीधे तौर पर कंट्रोल करता है. साथ ही, इस खाते के लिए विज्ञापन सिस्टम के साथ उसका सीधा कारोबारी समझौता है.
AUTHORIZED_SELLER_STATUS_RESELLER यह उस इन्वेंट्री को टारगेट करता है जहां विक्रेता को 'रीसेलर' के तौर पर दिखाया गया है. इससे पता चलता है कि पब्लिशर ने किसी दूसरी इकाई को, लिस्ट किए गए दुकानदार के खाते को मैनेज करने और अपने विज्ञापन स्पेस को दोबारा बेचने की अनुमति दी है.

NativeInventoryType

यह विज्ञापन स्लॉट में रेंडर होने वाले क्रिएटिव के टाइप को दिखाता है. खास तौर पर, नेटिव विज्ञापनों के लिए.

Enums
NATIVE_INVENTORY_TYPE_UNSPECIFIED डिफ़ॉल्ट मान. टारगेटिंग की खास बातों में इसका इस्तेमाल नहीं किया जाना चाहिए.
NATIVE_INVENTORY_TYPE_NATIVE_ONLY यह उन विज्ञापन स्लॉट को टारगेट करता है जो सिर्फ़ नेटिव विज्ञापनों को स्वीकार और रेंडर करते हैं.
NATIVE_INVENTORY_TYPE_NATIVE_OR_BANNER यह उन विज्ञापन स्लॉट को टारगेट करता है जो नेटिव या बैनर विज्ञापनों को स्वीकार और रेंडर करते हैं.

OpenMeasurementType

टारगेट करने के लिए, ओपन मेज़रमेंट इंटरफ़ेस डेफ़िनिशन (ओएमआईडी) का टाइप.

Enums
OPEN_MEASUREMENT_TYPE_UNSPECIFIED डिफ़ॉल्ट मान. टारगेटिंग की खास बातों में इसका इस्तेमाल नहीं किया जाना चाहिए.
OPEN_MEASUREMENT_TYPE_OMID_V1 यह ऐसी इन्वेंट्री को टारगेट करता है जो v1 ओपन मेज़रमेंट इंटरफ़ेस डेफ़िनिशन (ओएमआईडी) के साथ काम करती है.

RestrictedCategory

यह विज्ञापनों की उन खास कैटगरी को दिखाता है जिन्हें नीति के तहत टारगेट करने पर पाबंदी है.

Enums
RESTRICTED_CATEGORY_UNSPECIFIED डिफ़ॉल्ट मान. टारगेटिंग की खास बातों में इसका इस्तेमाल नहीं किया जाना चाहिए.
RESTRICTED_CATEGORY_ALCOHOL यह ऐसी इन्वेंट्री को टारगेट करता है जहां पब्लिशर ने शराब के विज्ञापन दिखाने की अनुमति दी है.
RESTRICTED_CATEGORY_GAMBLING यह उस इन्वेंट्री को टारगेट करता है जहां पब्लिशर ने जुए के विज्ञापन दिखाने की अनुमति दी है.

RewardedType

इससे टारगेट करने की शर्तें तय होती हैं. ये शर्तें इस आधार पर तय होती हैं कि विज्ञापन इन्वेंट्री, विज्ञापन देखने के लिए उपयोगकर्ता को इनाम देती है या नहीं.

Enums
REWARDED_TYPE_UNSPECIFIED डिफ़ॉल्ट मान. टारगेटिंग की खास बातों में इसका इस्तेमाल नहीं किया जाना चाहिए.
REWARDED_TYPE_NON_REWARDED यह ऐसी इन्वेंट्री को टारगेट करता है जो विज्ञापन देखने या उससे इंटरैक्ट करने पर, उपयोगकर्ता को कोई इनाम नहीं देती.
REWARDED_TYPE_REWARDED यह ऐसी इन्वेंट्री को टारगेट करता है जो उपयोगकर्ता को विज्ञापन देखने या उससे इंटरैक्ट करने के बदले इनाम देती है.

PackageVideoTargeting

वीडियो के लिए टारगेटिंग की ज़रूरी शर्तें.

JSON के काेड में दिखाना
{
  "includedMimeTypes": [
    enum (VideoMimeType)
  ],
  "includedMaximumAdDurationTargeting": enum (MaximumVideoAdDuration),
  "includedPositionTypes": [
    enum (PositionType)
  ],
  "includedContentDeliveryMethod": enum (ContentDeliveryMethod),
  "plcmtTargeting": {
    object (VideoPlcmtTargeting)
  },
  "includedPlaybackMethods": [
    enum (PlaybackMethod)
  ],
  "minimumPredictedCompletionRatePercentage": string,
  "includedPlayerSizeTargeting": {
    object (VideoPlayerSizeTargeting)
  }
}
फ़ील्ड
includedMimeTypes[]

enum (VideoMimeType)

ज़रूरी नहीं. आईएएनए की पब्लिश की गई एमआईएमई टाइप स्ट्रिंग (https://www.iana.org/assignments/media-types/media-types.xhtml) का इस्तेमाल करके, टारगेट किए गए वीडियो के एमआईएमई टाइप की सूची. अगर यह फ़ील्ड खाली है, तो इन्वेंट्री को टारगेट किया जाएगा. भले ही, वीडियो का एमआईएमई टाइप कुछ भी हो.

includedMaximumAdDurationTargeting

enum (MaximumVideoAdDuration)

ज़रूरी नहीं. टारगेट किए गए वीडियो विज्ञापन की ज़्यादा से ज़्यादा अवधि. अगर इसे सेट नहीं किया जाता है, तो वीडियो विज्ञापन की ज़्यादा से ज़्यादा अवधि के बावजूद, इन्वेंट्री को टारगेट किया जाएगा.

includedPositionTypes[]

enum (PositionType)

ज़रूरी नहीं. टारगेट किए गए वीडियो विज्ञापन की पोज़िशन के टाइप. अगर यह फ़ील्ड खाली है, तो इन्वेंट्री को टारगेट किया जाएगा. भले ही, वीडियो विज्ञापन की पोज़िशन का टाइप कुछ भी हो.

includedContentDeliveryMethod

enum (ContentDeliveryMethod)

ज़रूरी नहीं. वीडियो डिलीवरी का टारगेट किया गया तरीका. अगर इसे सेट नहीं किया जाता है, तो वीडियो डिलीवरी के तरीके पर ध्यान दिए बिना इन्वेंट्री को टारगेट किया जाएगा.

plcmtTargeting

object (VideoPlcmtTargeting)

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

includedPlaybackMethods[]

enum (PlaybackMethod)

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

minimumPredictedCompletionRatePercentage

string (int64 format)

ज़रूरी नहीं. सर्वे पूरा होने की अनुमानित दर का टारगेट किया गया कम से कम प्रतिशत.

यह वैल्यू, 10 से 90 के बीच की कोई संख्या होनी चाहिए. हालांकि, इन दोनों में से भी कोई संख्या हो सकती है. साथ ही, यह संख्या 10 का गुणज होनी चाहिए. उदाहरण के लिए, 10 मान्य है, लेकिन 0, 15, और 100 मान्य नहीं हैं. अगर वैल्यू 10 है, तो इसका मतलब है कि कॉन्फ़िगरेशन सिर्फ़ उन विज्ञापन स्लॉट से मैच करेगा जिनके लिए हम अनुमान लगाते हैं कि पूरा होने की दर कम से कम 10% होगी.

वैल्यू सेट न होने का मतलब है कि इन्वेंट्री को टारगेट किया जाएगा. भले ही, पूरा होने की अनुमानित दर कुछ भी हो.

includedPlayerSizeTargeting

object (VideoPlayerSizeTargeting)

ज़रूरी नहीं. टारगेट किया गया वीडियो प्लेयर साइज़. अगर यह नीति सेट नहीं है, तो वीडियो प्लेयर के साइज़ पर ध्यान दिए बिना इन्वेंट्री को टारगेट किया जाएगा.

VideoMimeType

टारगेट करने के लिए वीडियो के एमआईएमई टाइप.

Enums
VIDEO_MIME_TYPE_UNSPECIFIED डिफ़ॉल्ट मान. टारगेटिंग की खास बातों में इसका इस्तेमाल नहीं किया जाना चाहिए.
VIDEO_MIME_TYPE_THREEGPP 3GPP कंटेनर फ़ॉर्मैट, जिसका इस्तेमाल 3G फ़ोन पर किया जाता है.
VIDEO_MIME_TYPE_APPLICATION_MPEGURL HLS/M3U8
VIDEO_MIME_TYPE_MP4 आम तौर पर, H.264 कोडेक वाला MPEG-4 कंटेनर.
VIDEO_MIME_TYPE_APPLICATION_MPEGDASH DASH.
VIDEO_MIME_TYPE_APPLICATION_JAVASCRIPT JavaScript (VPAID विज्ञापनों के लिए इस्तेमाल किया जाता है).
VIDEO_MIME_TYPE_WEBM WebM कंटेनर, जिसमें VP9 कोडेक का इस्तेमाल किया गया हो.

MaximumVideoAdDuration

टारगेट करने के लिए, वीडियो विज्ञापन क्रिएटिव की अवधि की ऊपरी सीमा. enum वैल्यू, बकेट तय करती हैं. कोई वैल्यू चुनने का मतलब है कि क्रिएटिव की अवधि, तय किए गए समय से कम या उसके बराबर होनी चाहिए.

Enums
MAXIMUM_VIDEO_AD_DURATION_UNSPECIFIED डिफ़ॉल्ट मान. टारगेटिंग की खास बातों में इसका इस्तेमाल नहीं किया जाना चाहिए.
MAXIMUM_VIDEO_AD_DURATION_FIFTEEN_SECONDS यह 15 सेकंड तक की अवधि वाले वीडियो विज्ञापनों पर लागू होता है (0 < अवधि <= 15 सेकंड).
MAXIMUM_VIDEO_AD_DURATION_TWENTY_SECONDS यह 20 सेकंड तक की अवधि वाले वीडियो विज्ञापनों पर लागू होता है (0 < अवधि <= 20 सेकंड).
MAXIMUM_VIDEO_AD_DURATION_THIRTY_SECONDS यह 30 सेकंड तक की अवधि वाले वीडियो विज्ञापनों पर लागू होता है (0 < अवधि <= 30 सेकंड).
MAXIMUM_VIDEO_AD_DURATION_SIXTY_SECONDS यह 60 सेकंड तक की अवधि वाले वीडियो विज्ञापनों पर लागू होता है (0 < अवधि <= 60 सेकंड).
MAXIMUM_VIDEO_AD_DURATION_NINETY_SECONDS यह 90 सेकंड तक की अवधि वाले वीडियो विज्ञापनों पर लागू होता है (0 < अवधि <= 90 सेकंड).
MAXIMUM_VIDEO_AD_DURATION_ONE_HUNDRED_TWENTY_SECONDS यह 120 सेकंड तक की अवधि वाले वीडियो विज्ञापनों पर लागू होता है (0 < अवधि <= 120 सेकंड).

PositionType

वीडियो में विज्ञापन की वह पोज़िशन जिसे टारगेट किया जा सकता है.

Enums
POSITION_TYPE_UNSPECIFIED डिफ़ॉल्ट मान. टारगेटिंग की खास बातों में इसका इस्तेमाल नहीं किया जाना चाहिए.
POSITION_TYPE_MIDROLL विज्ञापन, वीडियो कॉन्टेंट के बीच में दिखाया जाता है.
POSITION_TYPE_POSTROLL वीडियो वाला कॉन्टेंट खत्म होने के बाद विज्ञापन दिखाया जाता है.
POSITION_TYPE_PREROLL विज्ञापन, वीडियो कॉन्टेंट से पहले दिखाया जाता है.

ContentDeliveryMethod

वीडियो वाले कॉन्टेंट की डिलीवरी के तरीके के आधार पर टारगेटिंग की शर्तें.

Enums
CONTENT_DELIVERY_METHOD_UNSPECIFIED डिफ़ॉल्ट मान. टारगेटिंग की खास बातों में इसका इस्तेमाल नहीं किया जाना चाहिए.
CONTENT_DELIVERY_METHOD_STREAMING लाइव ब्रॉडकास्ट किए जा रहे वीडियो कॉन्टेंट को टारगेट करता है.
CONTENT_DELIVERY_METHOD_PROGRESSIVE यह वीडियो वाले कॉन्टेंट को टारगेट करता है. यह कॉन्टेंट, क्लाइंट के प्लेबैक की ज़रूरत के हिसाब से धीरे-धीरे ट्रांसफ़र होता है.

VideoPlcmtTargeting

वीडियो प्लेसमेंट के टाइप के आधार पर, टारगेटिंग की शर्तें तय करता है. आम तौर पर, यह IAB OpenRTB 'plcmt' फ़ील्ड से जुड़ा होता है.

JSON के काेड में दिखाना
{
  "selectionType": enum (SelectionType),
  "videoPlcmtTypes": [
    enum (VideoPlcmtType)
  ]
}
फ़ील्ड
selectionType

enum (SelectionType)

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

videoPlcmtTypes[]

enum (VideoPlcmtType)

ज़रूरी है. टारगेट किए गए वीडियो प्लेसमेंट के टाइप की सूची. अगर यह फ़ील्ड खाली है, तो इन्वेंट्री को टारगेट किया जाएगा. भले ही, वीडियो प्लेसमेंट का टाइप कुछ भी हो.

SelectionType

टारगेटिंग डाइमेंशन के लिए इस्तेमाल किए जाने वाले संभावित सिलेक्शन टाइप के लिए Enum.

Enums
SELECTION_TYPE_UNSPECIFIED चयन के टाइप की जानकारी नहीं है. इसका इस्तेमाल नहीं किया जाना चाहिए.
SELECTION_TYPE_INCLUDE टारगेटिंग डाइमेंशन में मौजूद वैल्यू शामिल की जाती हैं.
SELECTION_TYPE_EXCLUDE टारगेटिंग डाइमेंशन में मौजूद वैल्यू को बाहर रखा जाता है.

VideoPlcmtType

यह OpenRTB स्टैंडर्ड के मुताबिक, वीडियो प्लेसमेंट टाइप को दिखाता है.

Enums
VIDEO_PLCMT_TYPE_UNSPECIFIED डिफ़ॉल्ट मान. टारगेटिंग की खास बातों में इसका इस्तेमाल नहीं किया जाना चाहिए.
INSTREAM प्री-रोल, मिड-रोल, और पोस्ट-रोल विज्ञापन, जो उपभोक्ता के अनुरोध किए गए वीडियो कॉन्टेंट की स्ट्रीमिंग से पहले, उसके दौरान या उसके बाद दिखाए जाते हैं. इन-स्ट्रीम वीडियो के लिए, प्लेयर शुरू होने पर डिफ़ॉल्ट रूप से “साउंड चालू है” पर सेट होना चाहिए. इसके अलावा, वीडियो वाला कॉन्टेंट देखने के लिए उपयोगकर्ता का मकसद साफ़ तौर पर पता होना चाहिए. प्लेयर के आस-पास अन्य कॉन्टेंट हो सकता है, लेकिन वीडियो वाला कॉन्टेंट ही उपयोगकर्ता की विज़िट का मुख्य फ़ोकस होना चाहिए. यह पेज पर मुख्य कॉन्टेंट के तौर पर दिखना चाहिए. साथ ही, यह व्यू में मौजूद एकमात्र ऐसा वीडियो प्लेयर होना चाहिए जो वीडियो चलाते समय ऑडियो सुना सके. अगर प्लेयर, फ़्लोटिंग/स्टिकी प्लेयर में बदल जाता है, तो बाद के विज्ञापन कॉल में प्लेयर के अपडेट किए गए साइज़ की सटीक जानकारी होनी चाहिए.
ACCOMPANYING_CONTENT प्री-रोल, वीडियो के बीच में दिखने वाले विज्ञापन, और पोस्ट-रोल विज्ञापन, जो वीडियो वाले कॉन्टेंट की स्ट्रीमिंग से पहले, उसके दौरान या उसके बाद दिखाए जाते हैं. वीडियो प्लेयर, टेक्स्ट या ग्राफ़िक कॉन्टेंट के पैराग्राफ़ से पहले, उनके बीच में या उनके बाद लोड होता है और चलता है. साथ ही, यह सिर्फ़ तब चलना शुरू होता है, जब यह व्यूपोर्ट में दिखता है. साथ में दिखने वाला कॉन्टेंट, व्यूपोर्ट में दिखने पर ही चलना चाहिए. पेज से स्क्रोल होने पर, यह फ़्लोटिंग/स्टिकी प्लेयर में बदल सकता है.
INTERSTITIAL ऐसे वीडियो विज्ञापन जो वीडियो कॉन्टेंट के बिना चलाए जाते हैं. वीडियो चलने के दौरान, पेज का मुख्य फ़ोकस वीडियो पर होना चाहिए. साथ ही, यह व्यूपोर्ट के बड़े हिस्से में दिखना चाहिए और इसे स्क्रोल करके स्क्रीन से बाहर नहीं किया जा सकता. यह इन-ऐप्लिकेशन वीडियो या स्लाइड शो जैसे प्लेसमेंट में हो सकता है.
NO_CONTENT ऐसे वीडियो विज्ञापन जो वीडियो वाला कॉन्टेंट स्ट्रीम किए बिना चलाए जाते हैं. यह स्लाइड शो, नेटिव फ़ीड, कॉन्टेंट में या स्टिकी/फ़्लोटिंग जैसे प्लेसमेंट में हो सकता है.

PlaybackMethod

टारगेट करने के लिए, वीडियो चलाने का तरीका.

Enums
PLAYBACK_METHOD_UNSPECIFIED वीडियो चलाने का तरीका नहीं बताया गया है. इसका इस्तेमाल नहीं किया जाना चाहिए.
PLAYBACK_METHOD_AUTO_PLAY_SOUND_ON पेज/कॉन्टेंट लोड होने पर, वीडियो अपने-आप चलने लगता है.
PLAYBACK_METHOD_AUTO_PLAY_SOUND_OFF पेज/कॉन्टेंट लोड होने पर, वीडियो अपने-आप चलने लगता है. हालांकि, इसमें आवाज़ नहीं होती.
PLAYBACK_METHOD_CLICK_TO_PLAY प्लेबैक, उपयोगकर्ता की किसी कार्रवाई से शुरू होता है. जैसे, 'चलाएं' बटन पर क्लिक करना.

VideoPlayerSizeTargeting

यह वीडियो प्लेयर के उस साइज़ को दिखाता है जिसे टारगेट किया जा सकता है. चौड़ाई और ऊंचाई, दोनों को शून्य के अलावा किसी अन्य वैल्यू पर सेट करना ज़रूरी है.

JSON के काेड में दिखाना
{
  "minimumWidth": string,
  "minimumHeight": string
}
फ़ील्ड
minimumWidth

string (int64 format)

ज़रूरी है. पिक्सल में, वीडियो प्लेयर की कम से कम चौड़ाई.

minimumHeight

string (int64 format)

ज़रूरी है. पिक्सल में, वीडियो प्लेयर की कम से कम लंबाई.

StringTargetingDimension

स्ट्रिंग वैल्यू के साथ सामान्य टारगेटिंग.

JSON के काेड में दिखाना
{
  "selectionType": enum (SelectionType),
  "values": [
    string
  ]
}
फ़ील्ड
selectionType

enum (SelectionType)

ज़रूरी है. इस सूची में मौजूद आइटम को कैसे टारगेट किया जाना चाहिए.

values[]

string

ज़रूरी है. तय की गई वैल्यू.

AdSize

यह किसी विज्ञापन स्लॉट या क्रिएटिव का साइज़ दिखाता है.

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

string (int64 format)

पिक्सल में विज्ञापन स्लॉट की चौड़ाई. यह फ़ील्ड सिर्फ़ तब दिखेगा, जब साइज़ टाइप PIXEL होगा.

height

string (int64 format)

पिक्सल में विज्ञापन स्लॉट की लंबाई. यह फ़ील्ड सिर्फ़ तब दिखेगा, जब साइज़ टाइप PIXEL होगा.

type

enum (Type)

विज्ञापन स्लॉट के साइज़ का टाइप.

टाइप

यह विज्ञापन स्लॉट/क्रिएटिव के अलग-अलग साइज़ को दिखाता है.

Enums
TYPE_UNSPECIFIED साइज़ के ऐसे टाइप के लिए प्लेसहोल्डर जिसकी जानकारी नहीं दी गई है.
PIXEL पिक्सल में लंबाई और चौड़ाई के हिसाब से तय किए गए साइज़ वाला विज्ञापन स्लॉट.
INTERSTITIAL इंटरस्टीशियल विज्ञापन स्लॉट के बारे में बताने के लिए खास साइज़.
NATIVE पब्लिशर की ओर से रेंडर किए गए नेटिव (मोबाइल) विज्ञापन.
FLUID फ़्लूइड साइज़ (रिस्पॉन्सिव साइज़) को बाहरी माहौल में बदलाव के साथ, अपने-आप बदला जा सकता है.

CriteriaTargeting

जेनरिक टारगेटिंग का इस्तेमाल, उन डाइमेंशन को टारगेट करने के लिए किया जाता है जिनमें शामिल किए गए और बाहर रखे गए न्यूमेरिक आईडी की सूची होती है. इसे सूची के फ़िल्टर सिंटैक्स का इस्तेमाल करके फ़िल्टर नहीं किया जा सकता.

JSON के काेड में दिखाना
{
  "targetedCriteriaIds": [
    string
  ],
  "excludedCriteriaIds": [
    string
  ]
}
फ़ील्ड
targetedCriteriaIds[]

string (int64 format)

शामिल किए जाने वाले अंकों वाले आईडी की सूची.

excludedCriteriaIds[]

string (int64 format)

अंकों वाले उन आईडी की सूची जिन्हें शामिल नहीं करना है.

PackagePlacementTargeting

इससे पता चलता है कि विज्ञापन कहां दिखाए जा सकते हैं. उदाहरण के लिए, कुछ साइटों या मोबाइल ऐप्लिकेशन पर. प्लेसमेंट टारगेटिंग के अलग-अलग टाइप, लॉजिकल OR के तौर पर काम करेंगे.

JSON के काेड में दिखाना
{
  "uriTargeting": {
    object (StringTargetingDimension)
  },
  "mobileAppTargeting": {
    object (StringTargetingDimension)
  },
  "includedMobileAppCategoryTargeting": [
    string
  ]
}
फ़ील्ड
uriTargeting

object (StringTargetingDimension)

ज़रूरी नहीं. टारगेट किए गए या बाहर रखे गए यूआरएल की सूची. डोमेन में http/https नहीं होना चाहिए (उदाहरण के लिए, google.com). साथ ही, हर यूआरएल में ज़्यादा से ज़्यादा पांच पाथ हो सकते हैं.

mobileAppTargeting

object (StringTargetingDimension)

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

Android ऐप्लिकेशन आईडी, जैसे कि com.google.android.apps.maps, Google Play Store के यूआरएल में मिल सकता है. iOS ऐप्लिकेशन आईडी (जो कि एक नंबर होता है), iTunes Store के यूआरएल के आखिर में मिल सकता है. पहले पक्ष के मोबाइल ऐप्लिकेशन को शामिल किया गया है या बाहर रखा गया है.

includedMobileAppCategoryTargeting[]

string (int64 format)

ज़रूरी नहीं. टारगेट की गई मोबाइल ऐप्लिकेशन कैटगरी की सूची.

PackagePublisherProvidedSignalsTargeting

यह पब्लिशर से मिले सिग्नल की टारगेटिंग को दिखाता है. पब्लिशर से मिले अलग-अलग तरह के सिग्नल, लॉजिकल OR के तौर पर काम करेंगे.

JSON के काेड में दिखाना
{
  "audienceTargeting": {
    object (TaxonomyTargeting)
  },
  "contentTargeting": {
    object (TaxonomyTargeting)
  },
  "videoAndAudioSignalsTargeting": {
    object (StringTargetingDimension)
  }
}
फ़ील्ड
audienceTargeting

object (TaxonomyTargeting)

ज़रूरी नहीं. टारगेट की गई या बाहर रखी गई ऑडियंस के आईडी की सूची. IAB ऑडियंस टैक्सनॉमी के वर्शन 1.1 पर आधारित (https://github.com/InteractiveAdvertisingBureau/Taxonomies/blob/main/Audience%20Taxonomies/Audience%20Taxonomy%201.1.tsv)

contentTargeting

object (TaxonomyTargeting)

ज़रूरी नहीं. टारगेट किए गए या बाहर रखे गए कॉन्टेंट आईडी की सूची. IAB कॉन्टेंट टैक्सनॉमी के वर्शन 2.2 (https://github.com/InteractiveAdvertisingBureau/Taxonomies/blob/main/Content%20Taxonomies/Content%20Taxonomy%202.2.tsv) के आधार पर

videoAndAudioSignalsTargeting

object (StringTargetingDimension)

ज़रूरी नहीं. टारगेट किए गए और बाहर रखे गए वीडियो और ऑडियो सिग्नल आईडी की सूची. ये अतिरिक्त सिग्नल हैं, जो पब्लिशर से मिले सिग्नल की सुविधा के साथ काम करते हैं.

TaxonomyTargeting

IAB ऑडियंस और कॉन्टेंट टैक्सनॉमी आईडी स्पेस को मैनेज करने के लिए, टारगेटिंग की शर्तें तय करता है.

JSON के काेड में दिखाना
{
  "targetedTaxonomyIds": [
    string
  ],
  "excludedTaxonomyIds": [
    string
  ]
}
फ़ील्ड
targetedTaxonomyIds[]

string

ज़रूरी नहीं. टारगेट किए गए कॉन्टेंट टैक्सोनॉमी आईडी की सूची.

excludedTaxonomyIds[]

string

ज़रूरी नहीं. बाहर रखे गए कॉन्टेंट की टैक्सनॉमी के आईडी की सूची.

CurationFeeVisibility

चुने गए पैकेज की फ़ीस और डेटा सेगमेंट की फ़ीस (कुल क्यूरेशन फ़ीस) की जानकारी. पैकेज बनाने वाले व्यक्ति को शुल्क हमेशा दिखता है.

Enums
CURATION_FEE_VISIBILITY_UNSPECIFIED क्यूरेशन के लिए लगने वाले कुल शुल्क की जानकारी नहीं दी गई है.
DISCLOSED क्यूरेशन की कुल फ़ीस सभी खरीदारों को दिखती है. अगर इसे सेट नहीं किया जाता है, तो यह डिफ़ॉल्ट वैल्यू होती है.
NON_DISCLOSED क्यूरेशन की कुल फ़ीस, सभी खरीदारों को नहीं दिखती.

तरीके

activate

पहले से मौजूद क्यूरेट किए गए पैकेज को चालू करता है.

create

इससे एक नया क्यूरेट किया गया पैकेज बनता है.

deactivate

यह किसी मौजूदा क्यूरेट किए गए पैकेज को बंद कर देता है.

get

संसाधन के नाम के आधार पर, चुने गए पैकेज की जानकारी मिलती है.

list

इससे, चुने गए क्यूरेटर के मालिकाना हक वाले क्यूरेट किए गए पैकेज की सूची मिलती है.

patch

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