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

  // Union field duration can be only one of the following:
  "durationDays": integer,
  "dateRange": {
    object (DateRange)
  }
  // End of list of possible types for union field duration.
}
फ़ील्ड
यूनियन फ़ील्ड duration. कैंपेन की अवधि चुनने का विकल्प. duration इनमें से सिर्फ़ एक हो सकता है:
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)

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