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

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

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 और 100,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 मोट.
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 डायनाटा.

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 7 दिन.
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

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