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 ओवर–द–टॉप (सीधे ग्राहक को) विज्ञापन, 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

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

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

enum (LineItemFlightDateType)

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

object (DateRange)

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

  • flightDateType के LINE_ITEM_FLIGHT_DATE_TYPE_CUSTOM होने पर ज़रूरी है. सिर्फ़ आउटपुट के लिए.
  • नई फ़्लाइट बनाते समय, startDate और endDate, दोनों आने वाले समय की होनी चाहिए.
  • किसी मौजूदा फ़्लाइट के लिए, पहले startDate था, लेकिन अब endDate है.
  • 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 इस लाइन आइटम के इंसर्शन ऑर्डर की खत्म होने की तारीख बीत चुकी है. लाइन आइटम नहीं चलेगा.
DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION

यह लाइन आइटम, excludeFirstPartyAudience सेटिंग का इस्तेमाल करता है. इस सेटिंग का इस्तेमाल बंद कर दिया गया है और इसे 25 मार्च, 2023 के बाद बंद कर दिया जाएगा.

excludeFirstPartyAudience फ़ील्ड के बंद होने को ध्यान में रखते हुए, 25 मार्च, 2023 से पहले ऑडियंस टारगेटिंग का इस्तेमाल करके, किसी भी फ़र्स्ट पार्टी ऑडियंस को सीधे तौर पर बाहर रखने के लिए, अपने एपीआई इंटिग्रेशन को अपडेट करें.

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 के काेड में दिखाना 
{
  "biddingStrategy": {
    object (YoutubeAndPartnersBiddingStrategy)
  },
  "viewFrequencyCap": {
    object (FrequencyCap)
  },
  "thirdPartyMeasurementSettings": {
    object (YoutubeAndPartnersThirdPartyMeasurementSettings)
  },
  "inventorySourceSettings": {
    object (YoutubeAndPartnersInventorySourceConfig)
  },
  "contentCategory": enum (YoutubeAndPartnersContentCategory),
  "effectiveContentCategory": enum (YoutubeAndPartnersContentCategory),
  "targetFrequency": {
    object (TargetFrequency)
  },
  "linkedMerchantId": string,
  "relatedVideoIds": [
    string
  ],
  "leadFormId": string,
  "videoAdSequenceSettings": {
    object (VideoAdSequenceSettings)
  }
}
फ़ील्ड
biddingStrategy

object (YoutubeAndPartnersBiddingStrategy)

ज़रूरी है. YouTube और पार्टनर लाइन आइटम की बिडिंग की रणनीति.
viewFrequencyCap

object (FrequencyCap)

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

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

object (YoutubeAndPartnersThirdPartyMeasurementSettings)

ज़रूरी नहीं. लाइन आइटम की तीसरे पक्ष की मेज़रमेंट सेटिंग.
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 से जुड़ी सेटिंग.

YoutubeAndPartnersThirdPartyMeasurementSettings

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

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 Meetट्रिक.
THIRD_PARTY_VENDOR_ZEFR ZEFR.
THIRD_PARTY_VENDOR_NIELSEN Nielsen.
THIRD_PARTY_VENDOR_KANTAR Kantar.
THIRD_PARTY_VENDOR_DYNATA Dynata.

YoutubeAndPartnersInventorySourceConfig

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

JSON के काेड में दिखाना 
{
  "includeYoutubeSearch": boolean,
  "includeYoutubeVideos": boolean,
  "includeGoogleTv": boolean,
  "includeYoutubeVideoPartners": boolean
}
फ़ील्ड
includeYoutubeVideos

boolean

YouTube पर मौजूद चैनलों और वीडियो की इन्वेंट्री को टारगेट करना है या नहीं. साथ ही, यह भी तय करना है कि दूसरी साइटों पर एम्बेड किए गए 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)

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

InteractionType

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

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

तरीके

bulkEditAssignedTargetingOptions

 एक से ज़्यादा लाइन आइटम में मौजूद टारगेटिंग के विकल्पों में, एक साथ कई बदलाव करने की सुविधा.

bulkListAssignedTargetingOptions

 टारगेटिंग के अलग-अलग टाइप में, कई लाइन आइटम के लिए असाइन किए गए टारगेटिंग विकल्प की सूची बनाता है.

bulkUpdate

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

create

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

delete

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

duplicate

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

generateDefault

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

get

 इससे एक लाइन आइटम मिलता है.

list

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

patch

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