REST Resource: advertisers.lineItems

संसाधन: LineItem

एक लाइन आइटम.

जेएसओएन के काेड में दिखाना 
{
  "name": string,
  "advertiserId": string,
  "campaignId": string,
  "insertionOrderId": string,
  "lineItemId": string,
  "displayName": string,
  "lineItemType": enum (LineItemType),
  "entityStatus": enum (EntityStatus),
  "updateTime": string,
  "partnerCosts": [
    {
      object (PartnerCost)
    }
  ],
  "flight": {
    object (LineItemFlight)
  },
  "budget": {
    object (LineItemBudget)
  },
  "pacing": {
    object (Pacing)
  },
  "frequencyCap": {
    object (FrequencyCap)
  },
  "partnerRevenueModel": {
    object (PartnerRevenueModel)
  },
  "conversionCounting": {
    object (ConversionCountingConfig)
  },
  "creativeIds": [
    string
  ],
  "bidStrategy": {
    object (BiddingStrategy)
  },
  "integrationDetails": {
    object (IntegrationDetails)
  },
  "targetingExpansion": {
    object (TargetingExpansionConfig)
  },
  "warningMessages": [
    enum (LineItemWarningMessage)
  ],
  "mobileApp": {
    object (MobileApp)
  },
  "reservationType": enum (ReservationType),
  "excludeNewExchanges": boolean,
  "youtubeAndPartnersSettings": {
    object (YoutubeAndPartnersSettings)
  }
}
फ़ील्ड
name

string

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

string (int64 format)

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

string (int64 format)

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

string (int64 format)

ज़रूरी है. इम्यूटेबल. उस इंसर्शन ऑर्डर का यूनीक आईडी जिससे लाइन आइटम जुड़ा है.
lineItemId

string (int64 format)

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

string

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

इसे UTF-8 कोड में बदला गया होना चाहिए. साथ ही, इसका साइज़ 240 बाइट से ज़्यादा नहीं होना चाहिए.
lineItemType

enum (LineItemType)

ज़रूरी है. इम्यूटेबल. लाइन आइटम का टाइप.
entityStatus

enum (EntityStatus)

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

  • lineItems.create तरीके में सिर्फ़ ENTITY_STATUS_DRAFT इस्तेमाल किए जा सकते हैं. किसी लाइन आइटम को चालू करने के लिए, lineItems.patch तरीके का इस्तेमाल करें. इसके बाद, लाइन आइटम बनाने के बाद स्टेटस को ENTITY_STATUS_ACTIVE पर अपडेट करें.
  • लाइन आइटम को किसी अन्य स्थिति से वापस ENTITY_STATUS_DRAFT स्थिति में नहीं बदला जा सकता.
  • अगर लाइन आइटम का पैरंट इंसर्शन ऑर्डर चालू नहीं है, तो लाइन आइटम अपना बजट खर्च नहीं कर सकता, भले ही उसका स्टेटस ENTITY_STATUS_ACTIVE हो.
updateTime

string (Timestamp format)

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

RFC3339 यूटीसी "ज़ुलु" फ़ॉर्मैट में एक टाइमस्टैंप, जिसमें नैनोसेकंड का रिज़ॉल्यूशन और नौ फ़्रैक्शनल अंक हो सकते हैं. उदाहरण: "2014-10-02T15:01:23Z" और "2014-10-02T15:01:23.045123456Z".
partnerCosts[]

object (PartnerCost)

लाइन आइटम के लिए पार्टनर की लागत.

अगर lineItems.create तरीके में यह वैल्यू मौजूद नहीं है या खाली है, तो नया बनाया गया लाइन आइटम, अपने पैरंट इंसर्शन ऑर्डर से पार्टनर की लागत का हिसाब लगाएगा.
flight

object (LineItemFlight)

ज़रूरी है. लाइन आइटम की फ़्लाइट के शुरू और खत्म होने का समय.
budget

object (LineItemBudget)

ज़रूरी है. लाइन आइटम के लिए बजट के बंटवारे की सेटिंग.
pacing

object (Pacing)

ज़रूरी है. लाइन आइटम के लिए, बजट खर्च करने की स्पीड की सेटिंग.
frequencyCap

object (FrequencyCap)

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

अगर सीमित कैप असाइन किया जा रहा है, तो इस सेटिंग ऑब्जेक्ट में maxImpressions फ़ील्ड का इस्तेमाल किया जाना चाहिए.
partnerRevenueModel

object (PartnerRevenueModel)

ज़रूरी है. लाइन आइटम के लिए, पार्टनर की आय के मॉडल की सेटिंग.
conversionCounting

object (ConversionCountingConfig)

लाइन आइटम की कन्वर्ज़न ट्रैकिंग सेटिंग.
creativeIds[]

string (int64 format)

लाइन आइटम से जुड़े क्रिएटिव के आईडी.
bidStrategy

object (BiddingStrategy)

ज़रूरी है. लाइन आइटम के लिए बिडिंग की रणनीति.
integrationDetails

object (IntegrationDetails)

लाइन आइटम के इंटिग्रेशन की जानकारी.
targetingExpansion

object (TargetingExpansionConfig)

लाइन आइटम की ऑप्टिमाइज़ की गई टारगेटिंग सेटिंग.

यह कॉन्फ़िगरेशन सिर्फ़ उन डिसप्ले, वीडियो या ऑडियो लाइन आइटम के लिए लागू होता है जो ऑटोमेटेड बिडिंग (बिड अपने-आप सेट होना) का इस्तेमाल करते हैं और सही ऑडियंस की सूचियों को टारगेट करते हैं.
warningMessages[]

enum (LineItemWarningMessage)

सिर्फ़ आउटपुट के लिए. लाइन आइटम से जनरेट हुए चेतावनी मैसेज. ये चेतावनियां लाइन आइटम को सेव होने से नहीं रोकती हैं, लेकिन कुछ लाइन आइटम को चलने से रोक सकती हैं.
mobileApp

object (MobileApp)

लाइन आइटम के ज़रिए प्रमोट किया गया मोबाइल ऐप्लिकेशन.

यह सिर्फ़ तब लागू होता है, जब lineItemType, LINE_ITEM_TYPE_DISPLAY_MOBILE_APP_INSTALL या LINE_ITEM_TYPE_VIDEO_MOBILE_APP_INSTALL हो.
reservationType

enum (ReservationType)

सिर्फ़ आउटपुट के लिए. लाइन आइटम का रिज़र्वेशन टाइप.
excludeNewExchanges

boolean

लाइन आइटम से नए एक्सचेंज को अपने-आप टारगेट होने से रोकना है या नहीं. यह फ़ील्ड डिफ़ॉल्ट रूप से गलत होता है.
youtubeAndPartnersSettings

object (YoutubeAndPartnersSettings)

सिर्फ़ आउटपुट के लिए. YouTube और पार्टनर लाइन आइटम के लिए खास सेटिंग.

LineItemType

लाइन आइटम के संभावित टाइप.

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

Enums
LINE_ITEM_TYPE_UNSPECIFIED

इस वर्शन में 'टाइप' वैल्यू के बारे में नहीं बताया गया है या उसकी जानकारी नहीं है.

इस तरह के लाइन आइटम और उनकी टारगेटिंग को एपीआई का इस्तेमाल करके बनाया या अपडेट नहीं किया जा सकता.
LINE_ITEM_TYPE_DISPLAY_DEFAULT इमेज, HTML5, नेटिव या रिच मीडिया विज्ञापन.
LINE_ITEM_TYPE_DISPLAY_MOBILE_APP_INSTALL डिसप्ले विज्ञापन, जिनसे किसी ऐप्लिकेशन को इंस्टॉल करने में मदद मिलती है.
LINE_ITEM_TYPE_VIDEO_DEFAULT कई तरह के एनवायरमेंट के लिए, सीपीएम के आधार पर बेचे जाने वाले वीडियो विज्ञापन.
LINE_ITEM_TYPE_VIDEO_MOBILE_APP_INSTALL किसी ऐप्लिकेशन को इंस्टॉल करने की संख्या बढ़ाने वाले वीडियो विज्ञापन.
LINE_ITEM_TYPE_DISPLAY_MOBILE_APP_INVENTORY

मोबाइल ऐप्लिकेशन इन्वेंट्री पर दिखाए जाने वाले डिसप्ले विज्ञापन.

इस तरह के लाइन आइटम और उनकी टारगेटिंग को एपीआई का इस्तेमाल करके बनाया या अपडेट नहीं किया जा सकता.
LINE_ITEM_TYPE_VIDEO_MOBILE_APP_INVENTORY

मोबाइल ऐप्लिकेशन इन्वेंट्री पर दिखाए जाने वाले वीडियो विज्ञापन.

इस तरह के लाइन आइटम और उनकी टारगेटिंग को एपीआई का इस्तेमाल करके बनाया या अपडेट नहीं किया जा सकता.
LINE_ITEM_TYPE_AUDIO_DEFAULT कई तरह के प्लैटफ़ॉर्म के लिए बेचे जाने वाले आरटीबी ऑडियो विज्ञापन.
LINE_ITEM_TYPE_VIDEO_OVER_THE_TOP ओवर-द-टॉप विज्ञापन, OTT इंसर्शन ऑर्डर में मौजूद होते हैं. यह टाइप सिर्फ़ insertionOrderType OVER_THE_TOP के इंसर्शन ऑर्डर वाले लाइन आइटम पर लागू होता है.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_ACTION

YouTube वीडियो विज्ञापन, जो कन्वर्ज़न को बढ़ावा देते हैं.

इस तरह के लाइन आइटम और उनकी टारगेटिंग को एपीआई का इस्तेमाल करके बनाया या अपडेट नहीं किया जा सकता.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE

YouTube वीडियो विज्ञापन (15 सेकंड तक), जिन्हें स्किप नहीं किया जा सकता.

इस तरह के लाइन आइटम और उनकी टारगेटिंग को एपीआई का इस्तेमाल करके बनाया या अपडेट नहीं किया जा सकता.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_VIDEO_SEQUENCE

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

इस तरह के लाइन आइटम और उनकी टारगेटिंग को एपीआई का इस्तेमाल करके बनाया या अपडेट नहीं किया जा सकता.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_AUDIO

YouTube ऑडियो विज्ञापन.

इस तरह के लाइन आइटम और उनकी टारगेटिंग को एपीआई का इस्तेमाल करके बनाया या अपडेट नहीं किया जा सकता.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_REACH

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

इस तरह के लाइन आइटम और उनकी टारगेटिंग को एपीआई का इस्तेमाल करके बनाया या अपडेट नहीं किया जा सकता.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_SIMPLE

YouTube वीडियो के लिए डिफ़ॉल्ट विज्ञापन.

इस तरह के लाइन आइटम और उनकी टारगेटिंग को एपीआई का इस्तेमाल करके बनाया या अपडेट नहीं किया जा सकता.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE_OVER_THE_TOP

कनेक्टेड टीवी के YouTube वीडियो विज्ञापन (15 सेकंड तक) जिन्हें स्किप नहीं किया जा सकता.

इस तरह के लाइन आइटम और उनकी टारगेटिंग को एपीआई का इस्तेमाल करके बनाया या अपडेट नहीं किया जा सकता.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_REACH_OVER_THE_TOP

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

इस तरह के लाइन आइटम और उनकी टारगेटिंग को एपीआई का इस्तेमाल करके बनाया या अपडेट नहीं किया जा सकता.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_SIMPLE_OVER_THE_TOP

कनेक्टेड टीवी के डिफ़ॉल्ट YouTube वीडियो विज्ञापन. सिर्फ़ इन-स्ट्रीम विज्ञापन फ़ॉर्मैट शामिल करें.

इस तरह के लाइन आइटम और उनकी टारगेटिंग को एपीआई का इस्तेमाल करके बनाया या अपडेट नहीं किया जा सकता.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_TARGET_FREQUENCY

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

इस तरह के लाइन आइटम और उनकी टारगेटिंग को एपीआई का इस्तेमाल करके बनाया या अपडेट नहीं किया जा सकता.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_VIEW

ऐसे YouTube वीडियो विज्ञापन जिनका मकसद अलग-अलग तरह के विज्ञापन फ़ॉर्मैट का इस्तेमाल करके ज़्यादा व्यू पाना है.

इस तरह के लाइन आइटम और उनकी टारगेटिंग को एपीआई का इस्तेमाल करके बनाया या अपडेट नहीं किया जा सकता.
LINE_ITEM_TYPE_DISPLAY_OUT_OF_HOME

घर से बाहर की डिजिटल इन्वेंट्री पर दिखाए जाने वाले डिसप्ले विज्ञापन.

इस तरह के लाइन आइटम और उनकी टारगेटिंग को एपीआई का इस्तेमाल करके बनाया या अपडेट नहीं किया जा सकता.
LINE_ITEM_TYPE_VIDEO_OUT_OF_HOME

घर से बाहर की डिजिटल इन्वेंट्री पर दिखाए जाने वाले वीडियो विज्ञापन.

इस तरह के लाइन आइटम और उनकी टारगेटिंग को एपीआई का इस्तेमाल करके बनाया या अपडेट नहीं किया जा सकता.

LineItemFlight

लाइन आइटम की सक्रिय अवधि को नियंत्रित करने वाली सेटिंग.

जेएसओएन के काेड में दिखाना 
{
  "flightDateType": enum (LineItemFlightDateType),
  "dateRange": {
    object (DateRange)
  }
}
फ़ील्ड
flightDateType

enum (LineItemFlightDateType)

ज़रूरी है. लाइन आइटम की फ़्लाइट की तारीखों का टाइप.
dateRange

object (DateRange)

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

  • यह तब ज़रूरी है, जब flightDateType, LINE_ITEM_FLIGHT_DATE_TYPE_CUSTOM हो. आउटपुट सिर्फ़ ऐसा ही कर सकता है.
  • नई फ़्लाइट बनाते समय, startDate और endDate, दोनों ही आने वाले समय की होनी चाहिए.
  • startDate वाली मौजूदा फ़्लाइट में, endDate में बदलाव किया जा सकता है, लेकिन startDate नहीं बदला जा सकता.
  • endDate, साल 2037 से पहले का startDate या उसके बाद का होना चाहिए.

LineItemFlightDateType

किसी लाइन आइटम की फ़्लाइट की तारीखों के संभावित टाइप.

Enums
LINE_ITEM_FLIGHT_DATE_TYPE_UNSPECIFIED इस वर्शन में 'टाइप' वैल्यू के बारे में नहीं बताया गया है या उसकी जानकारी नहीं है.
LINE_ITEM_FLIGHT_DATE_TYPE_INHERITED लाइन आइटम की फ़्लाइट की तारीखें, उसके पैरंट इंसर्शन ऑर्डर से ली जाती हैं.
LINE_ITEM_FLIGHT_DATE_TYPE_CUSTOM लाइन आइटम अपनी पसंद के मुताबिक फ़्लाइट की तारीखों का इस्तेमाल करता है.

LineItemBudget

बजट को बांटने का तरीका कंट्रोल करने वाली सेटिंग.

जेएसओएन के काेड में दिखाना 
{
  "budgetAllocationType": enum (LineItemBudgetAllocationType),
  "budgetUnit": enum (BudgetUnit),
  "maxAmount": string
}
फ़ील्ड
budgetAllocationType

enum (LineItemBudgetAllocationType)

ज़रूरी है. बजट के बंटवारे का टाइप.

LINE_ITEM_BUDGET_ALLOCATION_TYPE_AUTOMATIC का इस्तेमाल सिर्फ़ तब किया जा सकता है, जब पैरंट इंसर्शन ऑर्डर के लिए, अपने-आप बजट असाइन होने की सुविधा चालू हो.
budgetUnit

enum (BudgetUnit)

सिर्फ़ आउटपुट के लिए. बजट यूनिट से पता चलता है कि बजट, मुद्रा पर आधारित है या इंप्रेशन पर आधारित है. यह वैल्यू, पैरंट इंसर्शन ऑर्डर से इनहेरिट की जाती है.
maxAmount

string (int64 format)

लाइन आइटम के ज़रिए खर्च की जाने वाली ज़्यादा से ज़्यादा बजट रकम. 0 से ज़्यादा होना चाहिए.

जब budgetAllocationType:

  • LINE_ITEM_BUDGET_ALLOCATION_TYPE_AUTOMATIC में, इस फ़ील्ड में बदलाव नहीं किया जा सकता. इसे सिस्टम ने सेट किया है.
  • LINE_ITEM_BUDGET_ALLOCATION_TYPE_FIXED, अगर budgetUnit है:
    • BUDGET_UNIT_CURRENCY, यह फ़ील्ड विज्ञापन देने वाले की मुद्रा के माइक्रो में, खर्च की जाने वाली ज़्यादा से ज़्यादा बजट रकम दिखाता है. उदाहरण के लिए, 15,00,000, मुद्रा की 1.5 स्टैंडर्ड यूनिट दिखाता है.
    • BUDGET_UNIT_IMPRESSIONS, यह फ़ील्ड दिखाए जाने के लिए इंप्रेशन की ज़्यादा से ज़्यादा संख्या दिखाता है.
  • LINE_ITEM_BUDGET_ALLOCATION_TYPE_UNLIMITED, यह फ़ील्ड लागू नहीं है और सिस्टम इसे अनदेखा कर देगा.

LineItemBudgetAllocationType

बजट के बंटवारे के संभावित टाइप.

Enums
LINE_ITEM_BUDGET_ALLOCATION_TYPE_UNSPECIFIED इस वर्शन में 'टाइप' वैल्यू के बारे में नहीं बताया गया है या उसकी जानकारी नहीं है.
LINE_ITEM_BUDGET_ALLOCATION_TYPE_AUTOMATIC लाइन आइटम के लिए, अपने-आप बजट असाइन होने की सुविधा चालू है.
LINE_ITEM_BUDGET_ALLOCATION_TYPE_FIXED लाइन आइटम के लिए, तय किए गए ज़्यादा से ज़्यादा बजट की रकम तय की जाती है.
LINE_ITEM_BUDGET_ALLOCATION_TYPE_UNLIMITED लाइन आइटम पर बजट की कोई सीमा लागू नहीं होती.

PartnerRevenueModel

ऐसी सेटिंग जिनसे पार्टनर की आय का हिसाब लगाने के तरीके को कंट्रोल किया जाता है.

जेएसओएन के काेड में दिखाना 
{
  "markupType": enum (PartnerRevenueModelMarkupType),
  "markupAmount": string
}
फ़ील्ड
markupType

enum (PartnerRevenueModelMarkupType)

ज़रूरी है. पार्टनर की आय के मॉडल का मार्कअप टाइप.
markupAmount

string (int64 format)

ज़रूरी है. पार्टनर की आय के मॉडल के लिए मार्कअप रकम. वैल्यू 0 से ज़्यादा या इसके बराबर होनी चाहिए.

  • जब markupType को PARTNER_REVENUE_MODEL_MARKUP_TYPE_CPM पर सेट किया जाता है, तो यह फ़ील्ड, विज्ञापन देने वाले की मुद्रा के माइक्रो में सीपीएम मार्कअप को दिखाता है. उदाहरण के लिए, 15,00,000, मुद्रा की 1.5 स्टैंडर्ड यूनिट दिखाता है.
  • जब markupType को PARTNER_REVENUE_MODEL_MARKUP_TYPE_MEDIA_COST_MARKUP पर सेट किया जाता है, तो यह फ़ील्ड, मिलीसेकंड में मीडिया लागत के प्रतिशत मार्कअप को दिखाता है. उदाहरण के लिए, 100 का मतलब 0.1% (दशमलव 0.001) है.
  • जब markupType को PARTNER_REVENUE_MODEL_MARKUP_TYPE_TOTAL_MEDIA_COST_MARKUP पर सेट किया जाता है, तो यह फ़ील्ड, मिलीसेकंड में कुल मीडिया लागत का प्रतिशत मार्कअप दिखाता है. उदाहरण के लिए, 100 का मतलब 0.1% (दशमलव 0.001) है.

PartnerRevenueModelMarkupType

पार्टनर के रेवेन्यू मॉडल के संभावित मार्कअप टाइप.

Enums
PARTNER_REVENUE_MODEL_MARKUP_TYPE_UNSPECIFIED इस वर्शन में 'टाइप' वैल्यू के बारे में नहीं बताया गया है या उसकी जानकारी नहीं है.
PARTNER_REVENUE_MODEL_MARKUP_TYPE_CPM फ़िक्स्ड सीपीएम के आधार पर, पार्टनर की आय की गणना करें.
PARTNER_REVENUE_MODEL_MARKUP_TYPE_MEDIA_COST_MARKUP

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

ConversionCountingConfig

कन्वर्ज़न की गिनती करने के तरीके को कंट्रोल करने वाली सेटिंग.

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

जेएसओएन के काेड में दिखाना 
{
  "postViewCountPercentageMillis": string,
  "floodlightActivityConfigs": [
    {
      object (TrackingFloodlightActivityConfig)
    }
  ]
}
फ़ील्ड
postViewCountPercentageMillis

string (int64 format)

व्यू के बाद होने वाले कन्वर्ज़न का प्रतिशत, जिसे मिलीसेकंड में (प्रतिशत का 1/1,000) गिना जाएगा. संख्या 0 से 100000 के बीच होनी चाहिए.

उदाहरण के लिए, क्लिक के बाद होने वाले 50% कन्वर्ज़न ट्रैक करने के लिए, वैल्यू को 50,000 पर सेट करें.
floodlightActivityConfigs[]

object (TrackingFloodlightActivityConfig)

Floodlight गतिविधि कॉन्फ़िगरेशन, जिनका इस्तेमाल कन्वर्ज़न ट्रैक करने के लिए किया जाता है.

गिने गए कन्वर्ज़न की संख्या, इस फ़ील्ड में दिए गए सभी Floodlight गतिविधि आईडी के ज़रिए गिने गए सभी कन्वर्ज़न का कुल योग होती है.

TrackingFloodlightActivityConfig

ऐसी सेटिंग जो किसी एक Floodlight गतिविधि कॉन्फ़िगरेशन के व्यवहार को कंट्रोल करती हैं.

जेएसओएन के काेड में दिखाना 
{
  "floodlightActivityId": string,
  "postClickLookbackWindowDays": integer,
  "postViewLookbackWindowDays": integer
}
फ़ील्ड
floodlightActivityId

string (int64 format)

ज़रूरी है. Floodlight गतिविधि का आईडी.
postClickLookbackWindowDays

integer

ज़रूरी है. किसी विज्ञापन पर क्लिक होने के बाद के दिनों की संख्या, जिसमें कन्वर्ज़न की गिनती की जा सकती है. यह 0 से 90 के बीच होना चाहिए.
postViewLookbackWindowDays

integer

ज़रूरी है. किसी विज्ञापन को देखने के बाद दिनों की वह संख्या जिसमें कन्वर्ज़न की गिनती की जा सकती है. यह 0 से 90 के बीच होना चाहिए.

LineItemWarningMessage

किसी लाइन आइटम से जनरेट हुए चेतावनी मैसेज. इस तरह की चेतावनियां लाइन आइटम को सेव करने से नहीं रोकती, लेकिन किसी लाइन आइटम को चलने से रोक सकती हैं.

Enums
LINE_ITEM_WARNING_MESSAGE_UNSPECIFIED तय नहीं है या अज्ञात है.
INVALID_FLIGHT_DATES इस लाइन आइटम में फ़्लाइट की तारीखें गलत हैं. लाइन आइटम नहीं चलेगा.
EXPIRED इस लाइन आइटम के खत्म होने की तारीख बीत चुकी है.
PENDING_FLIGHT आगे जाकर यह लाइन आइटम काम करने लगेगा.
ALL_PARTNER_ENABLED_EXCHANGES_NEGATIVELY_TARGETED पार्टनर के चालू किए हुए सभी एक्सचेंज की नेगेटिव टारगेटिंग की गई है. लाइन आइटम नहीं चलेगा.
INVALID_INVENTORY_SOURCE कोई चालू इन्वेंट्री स्रोत, टारगेट नहीं किए जा रहे हैं. लाइन आइटम नहीं चलेगा.
APP_INVENTORY_INVALID_SITE_TARGETING इस लाइन आइटम की 'ऐप्लिकेशन और यूआरएल टारगेटिंग' में कोई मोबाइल ऐप्लिकेशन शामिल नहीं है. इस लाइन आइटम के टाइप के लिए, आपको अपने चैनल, साइट की सूची या ऐप्लिकेशन टारगेटिंग में मोबाइल ऐप्लिकेशन शामिल करने होंगे. लाइन आइटम नहीं चलेगा.
APP_INVENTORY_INVALID_AUDIENCE_LISTS यह लाइन आइटम, किसी मोबाइल उपयोगकर्ता को टारगेट नहीं कर रहा है. इस लाइन आइटम के टाइप के लिए आपको मोबाइल उपयोगकर्ताओं वाली उपयोगकर्ता सूची को टारगेट करना होगा. लाइन आइटम नहीं चलेगा.
NO_VALID_CREATIVE इस लाइन आइटम में कोई मान्य क्रिएटिव नहीं है. लाइन आइटम नहीं चलेगा.
PARENT_INSERTION_ORDER_PAUSED इस लाइन आइटम के लिए इंसर्ट करने का क्रम रोका गया है. लाइन आइटम नहीं चलेगा.
PARENT_INSERTION_ORDER_EXPIRED इस लाइन आइटम के इंसर्ट करने के क्रम की आखिरी तारीख बीत चुकी है. लाइन आइटम नहीं चलेगा.

MobileApp

ऐसा मोबाइल ऐप्लिकेशन जिसका प्रमोशन मोबाइल ऐप्लिकेशन इंस्टॉल लाइन आइटम से किया जाता है.

जेएसओएन के काेड में दिखाना 
{
  "appId": string,
  "platform": enum (Platform),
  "displayName": string,
  "publisher": string
}
फ़ील्ड
appId

string

ज़रूरी है. ऐप्लिकेशन का आईडी, जो प्लैटफ़ॉर्म स्टोर से मिला है.

Android ऐप्लिकेशन की पहचान, Android के Play Store में इस्तेमाल किए जाने वाले बंडल आईडी से की जाती है, जैसे कि com.google.android.gm.

iOS ऐप्लिकेशन की पहचान, Apple के App Store जैसे नौ अंकों वाले ऐप्लिकेशन आईडी से की जाती है, जैसे कि 422689480.
platform

enum (Platform)

सिर्फ़ आउटपुट के लिए. ऐप्लिकेशन का प्लैटफ़ॉर्म.
displayName

string

सिर्फ़ आउटपुट के लिए. ऐप्लिकेशन का नाम.
publisher

string

सिर्फ़ आउटपुट के लिए. ऐप्लिकेशन पब्लिशर.

प्लैटफ़ॉर्म

संभावित मोबाइल ऐप्लिकेशन प्लैटफ़ॉर्म.

Enums
PLATFORM_UNSPECIFIED प्लैटफ़ॉर्म की जानकारी नहीं दी गई है.
IOS iOS प्लैटफ़ॉर्म.
ANDROID Android प्लैटफ़ॉर्म.

YoutubeAndPartnersSettings

YouTube और पार्टनर लाइन आइटम की सेटिंग.

जेएसओएन के काेड में दिखाना 
{
  "viewFrequencyCap": {
    object (FrequencyCap)
  },
  "thirdPartyMeasurementConfigs": {
    object (ThirdPartyMeasurementConfigs)
  },
  "inventorySourceSettings": {
    object (YoutubeAndPartnersInventorySourceConfig)
  },
  "contentCategory": enum (YoutubeAndPartnersContentCategory),
  "effectiveContentCategory": enum (YoutubeAndPartnersContentCategory),
  "targetFrequency": {
    object (TargetFrequency)
  },
  "linkedMerchantId": string,
  "relatedVideoIds": [
    string
  ],
  "leadFormId": string,
  "videoAdSequenceSettings": {
    object (VideoAdSequenceSettings)
  }
}
फ़ील्ड
viewFrequencyCap

object (FrequencyCap)

लाइन आइटम के लिए व्यू फ़्रीक्वेंसी कैप सेटिंग.

अगर सीमित कैप असाइन किया जा रहा है, तो इस सेटिंग ऑब्जेक्ट में maxViews फ़ील्ड का इस्तेमाल किया जाना चाहिए.
thirdPartyMeasurementConfigs

object (ThirdPartyMeasurementConfigs)

ज़रूरी नहीं. लाइन आइटम के तीसरे पक्ष के मेज़रमेंट कॉन्फ़िगरेशन.
inventorySourceSettings

object (YoutubeAndPartnersInventorySourceConfig)

सेटिंग से कंट्रोल होता है कि लाइन आइटम, YouTube और पार्टनर इन्वेंट्री को किन इन्वेंट्री को टारगेट करेगा.
contentCategory

enum (YoutubeAndPartnersContentCategory)

कॉन्टेंट का वह टाइप जिस पर YouTube और Partners के विज्ञापन दिखाए जाएंगे.
effectiveContentCategory

enum (YoutubeAndPartnersContentCategory)

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

object (TargetFrequency)

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

string (int64 format)

व्यापारी/कंपनी का आईडी, जिसे प्रॉडक्ट फ़ीड के लाइन आइटम से जोड़ा गया है.
relatedVideoIds[]

string

जब मोबाइल डिवाइस पर YouTube ऐप्लिकेशन में विज्ञापन चलता है, तब वीडियो का आईडी मुख्य वीडियो विज्ञापन के नीचे दिखता है.
leadFormId

string (int64 format)

लीड जनरेट करने के लिए फ़ॉर्म का आईडी.
videoAdSequenceSettings

object (VideoAdSequenceSettings)

VideoAdSequence से जुड़ी सेटिंग.

ThirdPartyMeasurementConfigs

ऐसी सेटिंग जो यह कंट्रोल करती हैं कि तीसरे पक्ष के कौनसे वेंडर किसी लाइन आइटम की मेट्रिक को मेज़र कर रहे हैं.

जेएसओएन के काेड में दिखाना 
{
  "viewabilityVendorConfigs": [
    {
      object (ThirdPartyVendorConfig)
    }
  ],
  "brandSafetyVendorConfigs": [
    {
      object (ThirdPartyVendorConfig)
    }
  ],
  "reachVendorConfigs": [
    {
      object (ThirdPartyVendorConfig)
    }
  ],
  "brandLiftVendorConfigs": [
    {
      object (ThirdPartyVendorConfig)
    }
  ]
}
फ़ील्ड
viewabilityVendorConfigs[]

object (ThirdPartyVendorConfig)

ज़रूरी नहीं. तीसरे पक्ष के वेंडर, विज्ञापन दिखने से जुड़े आंकड़ों को मेज़र कर रहे हैं.

तीसरे पक्ष के ये वेंडर लागू होते हैं:

  • THIRD_PARTY_VENDOR_MOAT
  • THIRD_PARTY_VENDOR_DOUBLE_VERIFY
  • THIRD_PARTY_VENDOR_INTEGRAL_AD_SCIENCE
  • THIRD_PARTY_VENDOR_COMSCORE
  • THIRD_PARTY_VENDOR_TELEMETRY
  • THIRD_PARTY_VENDOR_MEETRICS
brandSafetyVendorConfigs[]

object (ThirdPartyVendorConfig)

ज़रूरी नहीं. तीसरे पक्ष के वेंडर, जो ब्रैंड की सुरक्षा की जांच कर रहे हैं.

तीसरे पक्ष के ये वेंडर लागू होते हैं:

  • THIRD_PARTY_VENDOR_ZERF
  • THIRD_PARTY_VENDOR_DOUBLE_VERIFY
  • THIRD_PARTY_VENDOR_INTEGRAL_AD_SCIENCE
reachVendorConfigs[]

object (ThirdPartyVendorConfig)

ज़रूरी नहीं. तीसरे पक्ष के वेंडर, जो पहुंच का आकलन कर रहे हैं.

तीसरे पक्ष के ये वेंडर लागू होते हैं:

  • THIRD_PARTY_VENDOR_NIELSEN
  • THIRD_PARTY_VENDOR_COMSCORE
  • THIRD_PARTY_VENDOR_KANTAR
brandLiftVendorConfigs[]

object (ThirdPartyVendorConfig)

ज़रूरी नहीं. तीसरे पक्ष के वेंडर, जो ब्रैंड पर असर को मेज़र कर रहे हैं.

तीसरे पक्ष के ये वेंडर लागू होते हैं:

  • THIRD_PARTY_VENDOR_DYNATA
  • THIRD_PARTY_VENDOR_KANTAR

ThirdPartyVendorConfig

ऐसी सेटिंग जो तीसरे पक्ष के मेज़रमेंट वेंडर के कॉन्फ़िगर होने के तरीके को कंट्रोल करती हैं.

जेएसओएन के काेड में दिखाना 
{
  "vendor": enum (ThirdPartyVendor),
  "placementId": string
}
फ़ील्ड
vendor

enum (ThirdPartyVendor)

तीसरे पक्ष का मेज़रमेंट वेंडर.
placementId

string

इस आईडी का इस्तेमाल लाइन आइटम की पहचान करने के लिए, तीसरे पक्ष का वेंडर प्लैटफ़ॉर्म पर करता है.

ThirdPartyVendor

ऐसे वेंडर जो तीसरे पक्ष का मेज़रमेंट करते हैं.

Enums
THIRD_PARTY_VENDOR_UNSPECIFIED तीसरे पक्ष का अज्ञात वेंडर.
THIRD_PARTY_VENDOR_MOAT खाई.
THIRD_PARTY_VENDOR_DOUBLE_VERIFY DoubleVerify.
THIRD_PARTY_VENDOR_INTEGRAL_AD_SCIENCE Integral Ad Science.
THIRD_PARTY_VENDOR_COMSCORE Comscore.
THIRD_PARTY_VENDOR_TELEMETRY टेलीमेट्री.
THIRD_PARTY_VENDOR_MEETRICS मेट्रिक.
THIRD_PARTY_VENDOR_ZEFR ZEFR.
THIRD_PARTY_VENDOR_NIELSEN Nielsen.
THIRD_PARTY_VENDOR_KANTAR Kantar.
THIRD_PARTY_VENDOR_DYNATA डायनाटा.

YoutubeAndPartnersInventorySourceConfig

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

जेएसओएन के काेड में दिखाना 
{
  "includeYoutube": boolean,
  "includeGoogleTv": boolean,
  "includeYoutubeVideoPartners": boolean
}
फ़ील्ड
includeYoutube

boolean

ज़रूरी नहीं. YouTube पर इन्वेंट्री को टारगेट करना है या नहीं. इसमें वीडियो खोजने के साथ-साथ, चैनल, और वीडियो भी शामिल हैं.
includeGoogleTv

boolean

ज़रूरी नहीं. Google TV पर उपलब्ध वीडियो ऐप्लिकेशन में इन्वेंट्री को टारगेट करना है या नहीं.
includeYoutubeVideoPartners

boolean

ऐसी पार्टनर साइटों और ऐप्लिकेशन की इन्वेंट्री को टारगेट करना है या नहीं जो YouTube ब्रैंड के सुरक्षा मानकों का पालन करते हैं.

YoutubeAndPartnersContentCategory

YouTube और पार्टनर कॉन्टेंट के लिए ब्रैंड की सुरक्षा की कैटगरी.

Enums
YOUTUBE_AND_PARTNERS_CONTENT_CATEGORY_UNSPECIFIED इस वर्शन में कॉन्टेंट की कैटगरी के बारे में नहीं बताया गया है या इसकी जानकारी नहीं है.
YOUTUBE_AND_PARTNERS_CONTENT_CATEGORY_STANDARD ऐसी कैटगरी जिसमें कई ब्रैंड का कॉन्टेंट शामिल होता है. यह वीडियो YouTube के विज्ञापन देने वालों के लिहाज़ से अच्छे वीडियो बनाने के दिशा-निर्देशों के हिसाब से बनाया गया है.
YOUTUBE_AND_PARTNERS_CONTENT_CATEGORY_EXPANDED ऐसी कैटगरी जिसमें YouTube और वीडियो पार्टनर के ऐसे सभी कॉन्टेंट शामिल हैं जो कमाई करने के मानकों का पालन करते हैं.
YOUTUBE_AND_PARTNERS_CONTENT_CATEGORY_LIMITED ऐसी कैटगरी जिसमें कॉन्टेंट की कम रेंज से जुड़ी शर्तें पूरी होती हों. खास तौर पर, आपत्तिजनक भाषा और सेक्शुअल ऐक्ट दिखाने वाला कॉन्टेंट.

TargetFrequency

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

जेएसओएन के काेड में दिखाना 
{
  "targetCount": string,
  "timeUnit": enum (TimeUnit),
  "timeUnitCount": integer
}
फ़ील्ड
targetCount

string (int64 format)

timeUnit और timeUnitCount की तय की गई समयावधि में, एक ही व्यक्ति को औसतन कितनी बार विज्ञापन दिखाए जाएंगे.
timeUnit

enum (TimeUnit)

समय की वह इकाई जिसमें टारगेट फ़्रीक्वेंसी लागू की जाएगी.

नीचे दी गई समय इकाई लागू है:

  • TIME_UNIT_WEEKS
timeUnitCount

integer

खत्म होने की टारगेट फ़्रीक्वेंसी timeUnit की संख्या.

timeUnit की वैल्यू के आधार पर ये पाबंदियां लागू होती हैं:

  • TIME_UNIT_WEEKS - 1 होना चाहिए

VideoAdSequenceSettings

VideoAdSequence से जुड़ी सेटिंग.

जेएसओएन के काेड में दिखाना 
{
  "minimumDuration": enum (VideoAdSequenceMinimumDuration),
  "steps": [
    {
      object (VideoAdSequenceStep)
    }
  ]
}
फ़ील्ड
minimumDuration

enum (VideoAdSequenceMinimumDuration)

किसी उपयोगकर्ता को यह क्रम फिर से देखने से पहले का कम से कम समय अंतराल.
steps[]

object (VideoAdSequenceStep)

वे चरण जिनमें क्रम शामिल है.

VideoAdSequenceMinimumDuration

एक ही उपयोगकर्ता को VideoAdSequence को फिर से देखने से पहले, कम से कम कितने समय अंतराल का विकल्प दिखता है, इसकी सूची.

Enums
VIDEO_AD_SEQUENCE_MINIMUM_DURATION_UNSPECIFIED तय नहीं है या अज्ञात है.
VIDEO_AD_SEQUENCE_MINIMUM_DURATION_WEEK सात दिन.
VIDEO_AD_SEQUENCE_MINIMUM_DURATION_MONTH 30 दिन.

VideoAdSequenceStep

VideoAdSequence में एक चरण की जानकारी.

जेएसओएन के काेड में दिखाना 
{
  "stepId": string,
  "adGroupId": string,
  "previousStepId": string,
  "interactionType": enum (InteractionType)
}
फ़ील्ड
stepId

string (int64 format)

चरण का आईडी.
adGroupId

string (int64 format)

चरण से जुड़े विज्ञापन ग्रुप का आईडी.
previousStepId

string (int64 format)

पिछले चरण का आईडी. पहले चरण में पिछला चरण नहीं है.
interactionType

enum (InteractionType)

पिछले चरण पर हुआ इंटरैक्शन, जो दर्शक को इस चरण पर ले जाएगा. पहले चरण में engagementType नहीं है.

InteractionType

किसी चरण पर होने वाले इंटरैक्शन के टाइप.

Enums
INTERACTION_TYPE_UNSPECIFIED तय नहीं या अज्ञात
INTERACTION_TYPE_PAID_VIEW पेड व्यू.
INTERACTION_TYPE_SKIP दर्शक ने स्किप कर दिया.
INTERACTION_TYPE_IMPRESSION A (देखा गया) विज्ञापन इंप्रेशन.
INTERACTION_TYPE_ENGAGED_IMPRESSION ऐसा विज्ञापन इंप्रेशन जिसे दर्शक ने तुरंत स्किप नहीं किया, लेकिन वह बिलिंग करने लायक इवेंट तक नहीं पहुंचा.

तरीके

bulkEditAssignedTargetingOptions

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

bulkListAssignedTargetingOptions

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

bulkUpdate

 एक से ज़्यादा लाइन आइटम अपडेट करता है.

create

 एक नया लाइन आइटम बनाता है.

delete

 लाइन आइटम को मिटाता है.

duplicate

 लाइन आइटम का डुप्लीकेट बनाता है.

generateDefault

 इंसर्शन ऑर्डर और ENTITY_STATUS_DRAFT entity_status से इनहेरिट की गई सेटिंग (इसमें टारगेटिंग भी शामिल है) के साथ एक नया लाइन आइटम बनाता है.

get

 लाइन आइटम मिलता है.

list

 यह क्लिक, विज्ञापन देने वाले व्यक्ति या कंपनी में लाइन आइटम की सूची बनाता है.

patch

 किसी मौजूदा लाइन आइटम को अपडेट करता है.