Method: advertisers.reachForecast.generateReachForecast

विज्ञापन देने वाले किसी व्यक्ति या कंपनी और टारगेटिंग कॉन्फ़िगरेशन के लिए, पहुंच का अनुमान जनरेट करता है.

एचटीटीपी अनुरोध

POST https://displayvideo.googleapis.com/v4/advertisers/{advertiserId}/reachForecast:generateReachForecast

यह यूआरएल, gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.

पाथ पैरामीटर

पैरामीटर
advertiserId

string (int64 format)

ज़रूरी है. विज्ञापन देने वाले उस व्यक्ति या कंपनी का आईडी जो प्लान किया गया कैंपेन चलाएगी.

अनुरोध का मुख्य भाग

अनुरोध के मुख्य हिस्से में, इस स्ट्रक्चर का डेटा शामिल होता है:

JSON के काेड में दिखाना 
{
  "targeting": {
    object (Targeting)
  },
  "campaignDuration": {
    object (CampaignDuration)
  },
  "currencyCode": string,
  "plannedProducts": [
    {
      object (PlannedProduct)
    }
  ],
  "minEffectiveFrequency": integer
}
फ़ील्ड
targeting

object (Targeting)

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

object (CampaignDuration)

ज़रूरी है. प्लान किए गए कैंपेन की अवधि.
currencyCode

string

ज़रूरी है. आईएसओ 4217 फ़ॉर्मैट में, प्लान के लिए मुद्रा कोड.
plannedProducts[]

object (PlannedProduct)

ज़रूरी है. अनुमान में शामिल करने के लिए लाइन आइटम की सूची.
minEffectiveFrequency

integer

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

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

जवाब का मुख्य भाग

ReachForecastService.GenerateReachForecast के लिए जवाब का मैसेज.

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

JSON फ़ॉर्मैट में दिखाया गया है 
{
  "onTargetAudienceMetrics": {
    object (OnTargetAudienceMetrics)
  },
  "reachCurve": {
    object (ReachCurve)
  }
}
फ़ील्ड
onTargetAudienceMetrics

object (OnTargetAudienceMetrics)

टारगेट किए गए देश/इलाके के हिसाब से ऑडियंस के अनुमानित साइज़.
reachCurve

object (ReachCurve)

जनरेट किया गया अनुमान से जुड़ा कर्व.

अनुमति पाने के लिंक

नीचे दिए गए OAuth अनुमति की ज़रूरत हाेती है:

  • https://www.googleapis.com/auth/display-video

ज़्यादा जानकारी के लिए, OAuth 2.0 Overview देखें.

टारगेटिंग (विज्ञापन के लिए सही दर्शक चुनना)

प्लान किए गए कैंपेन के लिए टारगेटिंग सेटिंग.

JSON के काेड में दिखाना 
{
  "plannableLocationIds": [
    string
  ],
  "ageRange": enum (PlannableAgeRange),
  "genders": [
    enum (Gender)
  ],
  "devices": [
    enum (DeviceType)
  ]
}
फ़ील्ड
plannableLocationIds[]

string (int64 format)

ज़रूरी है. टारगेट करने के लिए, प्लान की जा सकने वाली जगहों के आईडी.

reachForecast.retrievePlannableLocations तरीके का इस्तेमाल करके, प्लान की जा सकने वाली जगहों की जानकारी वापस पाई जा सकती है.
ageRange

enum (PlannableAgeRange)

ज़रूरी नहीं. टारगेट करने के लिए उम्र की सीमा.
genders[]

enum (Gender)

ज़रूरी नहीं. टारगेट करने के लिए लिंग के विकल्प.
devices[]

enum (DeviceType)

ज़रूरी नहीं. टारगेट किए जाने वाले डिवाइस.

CampaignDuration

रीच प्लान की अवधि.

JSON के काेड में दिखाना 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "durationDays": integer,
  "dateRange": {
    object (DateRange)
  }
  // End of mutually exclusive fields.
}
फ़ील्ड
कैंपेन की अवधि चुनने का विकल्प. यहां ऐसे फ़ील्ड की सूची दी गई है जिनमें से सिर्फ़ एक को चुना जा सकता है. जवाब में ज़्यादा से ज़्यादा एक फ़ील्ड सेट किया जाएगा:
durationDays

integer

ज़रूरी है. यह प्लान कितने दिनों के लिए है.
dateRange

object (DateRange)

ज़रूरी है. तारीख की वह सीमा जिसके लिए प्लान बनाया गया है.
एक-दूसरे से अलग फ़ील्ड के आखिर में.

PlannedProduct

प्लान में मौजूद किसी खास प्रॉडक्ट के लिए कॉन्फ़िगरेशन.

JSON के काेड में दिखाना 
{
  "plannableProductCode": string,
  "budgetMicros": string,
  "advancedProductTargeting": {
    object (AdvancedProductTargeting)
  }
}
फ़ील्ड
plannableProductCode

string

ज़रूरी है. प्रॉडक्ट का कोड, जैसे कि "VIDEO_REACH_CAMPAIGN".
budgetMicros

string (int64 format)

ज़रूरी है. माइक्रो में इस प्रॉडक्ट का बजट.
advancedProductTargeting

object (AdvancedProductTargeting)

ज़रूरी नहीं. लाइन आइटम के लेवल पर टारगेटिंग को ओवरराइड करने की सुविधा.

AdvancedProductTargeting

प्रॉडक्ट के हिसाब से टारगेटिंग में किए गए बदलाव.

JSON के काेड में दिखाना 
{
  "surfaceTargetingSettings": {
    object (SurfaceTargetingSettings)
  },
  "targetFrequency": {
    object (TargetFrequency)
  },
  "frequencyCap": {
    object (FrequencyCap)
  },
  "ageRange": enum (PlannableAgeRange),
  "genders": [
    enum (Gender)
  ],
  "devices": [
    enum (DeviceType)
  ],
  "userInterestIds": [
    string
  ],
  "userListIds": [
    string
  ],
  "youtubeSelectSettings": {
    object (YouTubeSelectSettings)
  },
  "dateRange": {
    object (DateRange)
  },
  "plannableLocationIds": [
    string
  ],
  "network": enum (PlannableNetwork)
}
फ़ील्ड
surfaceTargetingSettings

object (SurfaceTargetingSettings)

ज़रूरी नहीं. टारगेट करने के लिए, प्लान की जा सकने वाली जगहें.
targetFrequency

object (TargetFrequency)

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

object (FrequencyCap)

ज़रूरी नहीं. किसी खास प्रॉडक्ट के लिए फ़्रीक्वेंसी कैप.
ageRange

enum (PlannableAgeRange)

ज़रूरी नहीं. टारगेट करने के लिए उम्र की सीमा.
genders[]

enum (Gender)

ज़रूरी नहीं. टारगेट करने के लिए लिंग के विकल्प.
devices[]

enum (DeviceType)

ज़रूरी नहीं. टारगेट किए जाने वाले डिवाइस.
userInterestIds[]

string

ज़रूरी नहीं. टारगेट करने के लिए उपयोगकर्ता की दिलचस्पी के आईडी.

reachForecast.retrievePlannableUserInterests तरीके का इस्तेमाल करके, उपयोगकर्ता की उन रुचियों को वापस पाया जा सकता है जिनके लिए प्लान बनाया जा सकता है.
userListIds[]

string

ज़रूरी नहीं. टारगेट करने के लिए उपयोगकर्ता सूची के आईडी.

प्लान की जा सकने वाली उपयोगकर्ता सूचियों को reachForecast.retrievePlannableUserInterests तरीके का इस्तेमाल करके वापस पाया जा सकता है.
youtubeSelectSettings

object (YouTubeSelectSettings)

ज़रूरी नहीं. YouTube Select की सेटिंग.
dateRange

object (DateRange)

ज़रूरी नहीं. टारगेट करने के लिए तारीख की सीमा.
plannableLocationIds[]

string (int64 format)

ज़रूरी नहीं. टारगेट करने के लिए, प्लान की जा सकने वाली जगहों के आईडी.
network

enum (PlannableNetwork)

ज़रूरी नहीं. टारगेट करने के लिए नेटवर्क.

SurfaceTargetingSettings

प्लैटफ़ॉर्म टारगेटिंग चुनने की सुविधा.

JSON के काेड में दिखाना 
{
  "surfaces": [
    enum (PlannableSurface)
  ]
}
फ़ील्ड
surfaces[]

enum (PlannableSurface)

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

YouTubeSelectSettings

YouTube Select लाइनअप के लिए सेटिंग.

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

string (int64 format)

ज़रूरी नहीं. YouTube Select लाइनअप का आईडी.

OnTargetAudienceMetrics

टारगेट किए गए देश/इलाके के लिए, ऑडियंस के अनुमानित साइज़.

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

string (int64 format)

YouTube ऑडियंस का अनुमानित साइज़.
censusAudienceSize

string (int64 format)

टारगेट किए गए देश/इलाके की जनगणना के डेटा के आधार पर, दर्शकों की संख्या.

ReachCurve

जनरेट किया गया रीच कर्व.

JSON के काेड में दिखाना 
{
  "reachForecasts": [
    {
      object (ReachForecast)
    }
  ]
}
फ़ील्ड
reachForecasts[]

object (ReachForecast)

कर्व पर मौजूद पॉइंट, कीमत के हिसाब से क्रम में लगाए गए हैं.

ReachForecast

रीच कर्व में मौजूद कोई डेटा पॉइंट.

JSON के काेड में दिखाना 
{
  "costMicros": string,
  "plannedProductReachForecasts": [
    {
      object (PlannedProductReachForecast)
    }
  ],
  "forecast": {
    object (PlannedProductForecast)
  }
}
फ़ील्ड
costMicros

string (int64 format)

माइक्रो में इस पॉइंट की कुल लागत.
plannedProductReachForecasts[]

object (PlannedProductReachForecast)

इस कीमत पर अलग-अलग प्रॉडक्ट के लिए ब्रेकडाउन.
forecast

object (PlannedProductForecast)

पूरे प्लान के लिए कुल अनुमान.

PlannedProductReachForecast

किसी प्रॉडक्ट की परफ़ॉर्मेंस का पूर्वानुमान.

JSON के काेड में दिखाना 
{
  "costMicros": string,
  "plannableProductCode": string,
  "plannedProductForecast": {
    object (PlannedProductForecast)
  }
}
फ़ील्ड
costMicros

string (int64 format)

इस प्रॉडक्ट के लिए माइक्रो में कीमत.
plannableProductCode

string

प्रॉडक्ट का कोड.
plannedProductForecast

object (PlannedProductForecast)

प्रॉडक्ट की परफ़ॉर्मेंस मेट्रिक.

PlannedProductForecast

पूर्वानुमान के किसी पॉइंट के लिए परफ़ॉर्मेंस मेट्रिक.

JSON के काेड में दिखाना 
{
  "onTargetReach": string,
  "onTargetImpressions": string,
  "trueviewViews": string,
  "totalReach": string,
  "totalImpressions": string,
  "viewableImpressions": string,
  "onTargetCoviewReach": string,
  "totalCoviewReach": string,
  "onTargetCoviewImpressions": string,
  "totalCoviewImpressions": string
}
फ़ील्ड
onTargetReach

string (int64 format)

टारगेट की गई डेफ़िनिशन से मेल खाने वाले उन यूनीक लोगों की संख्या जिन तक विज्ञापन पहुंचा.
onTargetImpressions

string (int64 format)

चुनी हुई टारगेट ऑडियंस से मिले इंप्रेशन की संख्या.
trueviewViews

string (int64 format)

TrueView व्यू की संख्या.
totalReach

string (int64 format)

विज्ञापन देखने वाले अलग-अलग लोगों की कुल संख्या.
totalImpressions

string (int64 format)

इंप्रेशन की कुल संख्या.
viewableImpressions

string (int64 format)

देखने-योग्य इंप्रेशन की संख्या.
onTargetCoviewReach

string (int64 format)

टारगेट की गई डेफ़िनिशन से मेल खाने वाले उन लोगों की संख्या जिन तक विज्ञापन पहुंचा. इसमें टीवी पर साथ मिलकर कॉन्टेंट देखने वाले लोग भी शामिल हैं.
totalCoviewReach

string (int64 format)

टीवी पर साथ मिलकर कॉन्टेंट देखने वाले लोगों के साथ-साथ, उन यूनीक लोगों की कुल संख्या जिन्हें विज्ञापन दिखाया गया.
onTargetCoviewImpressions

string (int64 format)

टारगेट किए गए दर्शकों को मिले इंप्रेशन की संख्या. इसमें टीवी पर साथ मिलकर कॉन्टेंट देखने वाले लोग भी शामिल हैं.
totalCoviewImpressions

string (int64 format)

इंप्रेशन की कुल संख्या. इसमें साथ मिलकर वीडियो देखने वाले लोग भी शामिल होते हैं.