REST Resource: advertisers.lineItems

रिसॉर्स: LineItem

एक लाइन आइटम.

JSON के काेड में दिखाना 
{
  "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)

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

आरएफ़सी3339 यूटीसी के "Zulu" फ़ॉर्मैट में एक टाइमस्टैंप, नैनोसेकंड रिज़ॉल्यूशन और नौ दशमलव अंकों के साथ. उदाहरण के लिए: "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 ओटीटी इंसर्शन ऑर्डर में मौजूद ओवर-द-टॉप विज्ञापन. यह टाइप सिर्फ़ उन लाइन आइटम पर लागू होता है जिनका इंसर्शन ऑर्डर 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

ऐसी सेटिंग जो किसी लाइन आइटम की चालू अवधि को कंट्रोल करती हैं.

JSON के काेड में दिखाना 
{
  "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, startDate या उसके बाद का होना चाहिए. हालांकि, दोनों तारीखें 2037 से पहले की होनी चाहिए.

LineItemFlightDateType

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

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

LineItemBudget

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

JSON के काेड में दिखाना 
{
  "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, यह फ़ील्ड विज्ञापन देने वाले की मुद्रा के माइक्रो में, खर्च करने के लिए तय किए गए बजट की ज़्यादा से ज़्यादा रकम दिखाता है. उदाहरण के लिए, 1500000 वैल्यू का मतलब है कि मुद्रा की 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

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

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

enum (PartnerRevenueModelMarkupType)

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

string (int64 format)

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

  • जब markupType को PARTNER_REVENUE_MODEL_MARKUP_TYPE_CPM पर सेट किया जाता है, तो यह फ़ील्ड विज्ञापन देने वाले की मुद्रा के माइक्रो में सीपीएम मार्कअप दिखाता है. उदाहरण के लिए, 1500000 वैल्यू का मतलब है कि मुद्रा की 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

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

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

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

string (int64 format)

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

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

object (TrackingFloodlightActivityConfig)

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

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

TrackingFloodlightActivityConfig

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

JSON के काेड में दिखाना 
{
  "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

मोबाइल ऐप्लिकेशन इंस्टॉल करने वाले लाइन आइटम से प्रमोट किया गया मोबाइल ऐप्लिकेशन.

JSON के काेड में दिखाना 
{
  "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 और पार्टनर लाइन आइटम की सेटिंग.

JSON के काेड में दिखाना 
{
  "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 और पार्टनर के विज्ञापन दिखाए जाएंगे.
effectiveContentCategory

enum (YoutubeAndPartnersContentCategory)

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

object (TargetFrequency)

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

string (int64 format)

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

string

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

string (int64 format)

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

object (VideoAdSequenceSettings)

ज़रूरी नहीं. VideoAdSequence से जुड़ी सेटिंग.

ThirdPartyMeasurementConfigs

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

JSON के काेड में दिखाना 
{
  "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

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

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

enum (ThirdPartyVendor)

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

string

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

ThirdPartyVendor

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

Enums
THIRD_PARTY_VENDOR_UNSPECIFIED तीसरे पक्ष का कोई वेंडर.
THIRD_PARTY_VENDOR_MOAT 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 Meetrics.
THIRD_PARTY_VENDOR_ZEFR ज़ेडईएफ़आर.
THIRD_PARTY_VENDOR_NIELSEN Nielsen.
THIRD_PARTY_VENDOR_KANTAR Kantar.
THIRD_PARTY_VENDOR_DYNATA Dynata.

YoutubeAndPartnersInventorySourceConfig

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

JSON के काेड में दिखाना 
{
  "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

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

JSON के काेड में दिखाना 
{
  "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 से जुड़ी सेटिंग.

JSON के काेड में दिखाना 
{
  "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 में किसी एक चरण की जानकारी.

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

string (int64 format)

चरण का आईडी.
adGroupId

string (int64 format)

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

string (int64 format)

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

enum (InteractionType)

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

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

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