Method: advertisers.reachForecast.generateReachForecast

پیش‌بینی میزان دسترسی برای یک تبلیغ‌کننده و پیکربندی هدف‌گیری مشخص ایجاد می‌کند.

درخواست HTTP

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

این URL از سینتکس Transcoding در 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

الزامی. کد ارزی طرح با فرمت ISO 4217.

plannedProducts[]

object ( PlannedProduct )

الزامی. فهرست اقلام خطی که باید در پیش‌بینی لحاظ شوند.

minEffectiveFrequency

integer

اختیاری. حداقل تعداد دفعات مؤثر برای معیارهای دسترسی گزارش‌شده. این کمترین تعداد دفعاتی است که مشتری باید در معرض تبلیغ قرار گیرد تا مؤثر تلقی شود. این تنظیم فقط بر گزارش‌دهی تأثیر می‌گذارد.

باید بین ۱ تا ۱۰ باشد، شامل همه. اگر مشخص نشده باشد، مقدار پیش‌فرض ۱ اعمال می‌شود.

بدنه پاسخ

پیام پاسخ برای 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 )

اختیاری. دستگاه‌هایی که باید هدف قرار گیرند.

مدت زمان کمپین

مدت زمان طرح دسترسی.

نمایش 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 فیلد Union. انتخاب مدت زمان کمپین. duration می‌تواند فقط یکی از موارد زیر باشد:
durationDays

integer

الزامی. تعداد روزهایی که طرح پوشش می‌دهد.

dateRange

object ( DateRange )

الزامی. محدوده تاریخی که طرح پوشش می‌دهد.

محصول برنامه‌ریزی‌شده

پیکربندی برای یک محصول خاص در طرح.

نمایش JSON 
{
  "plannableProductCode": string,
  "budgetMicros": string,
  "advancedProductTargeting": {
    object (AdvancedProductTargeting)
  }
}
فیلدها
plannableProductCode

string

الزامی. کد محصول، مثلاً "VIDEO_REACH_CAMPAIGN".

budgetMicros

string ( int64 format)

مورد نیاز. بودجه برای این محصول به صورت میکرو.

advancedProductTargeting

object ( 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 )

اختیاری. شبکه مورد نظر برای هدف قرار دادن.

تنظیمات هدف‌گیری سطحی

انتخاب هدف‌گیری سطحی.

نمایش JSON 
{
  "surfaces": [
    enum (PlannableSurface)
  ]
}
فیلدها
surfaces[]

enum ( PlannableSurface )

اختیاری. سطوح مورد نظر برای هدف گیری.

تنظیمات YouTubeSelect

تنظیمات مربوط به لیست پخش منتخب یوتیوب.

نمایش JSON 
{
  "lineupId": string
}
فیلدها
lineupId

string ( int64 format)

اختیاری. شناسه‌ی گروه منتخب یوتیوب.

معیارهای مخاطب هدف

اندازه تخمینی مخاطبان برای یک منطقه جغرافیایی هدفمند.

نمایش JSON 
{
  "youtubeAudienceSize": string,
  "censusAudienceSize": string
}
فیلدها
youtubeAudienceSize

string ( int64 format)

تعداد تخمینی مخاطبان یوتیوب.

censusAudienceSize

string ( int64 format)

اندازه مخاطبان بر اساس داده‌های سرشماری از جغرافیای هدف.

ریچ‌کرو

منحنی دسترسی تولید شده.

نمایش JSON 
{
  "reachForecasts": [
    {
      object (ReachForecast)
    }
  ]
}
فیلدها
reachForecasts[]

object ( ReachForecast )

نقاط روی منحنی، بر اساس هزینه مرتب شده‌اند.

ریچ‌فورکست

یک نقطه واحد در منحنی دسترسی.

نمایش JSON 
{
  "costMicros": string,
  "plannedProductReachForecasts": [
    {
      object (PlannedProductReachForecast)
    }
  ],
  "forecast": {
    object (PlannedProductForecast)
  }
}
فیلدها
costMicros

string ( int64 format)

هزینه کل برای این نقطه بر حسب میکرو.

plannedProductReachForecasts[]

object ( PlannedProductReachForecast )

تفکیک محصولات به صورت جداگانه در این نقطه هزینه.

forecast

object ( PlannedProductForecast )

پیش‌بینی کلی برای کل طرح

برنامه ریزی شدهمحصولرسیدن به هدفپیش بینی

پیش‌بینی عملکرد برای یک محصول خاص

نمایش JSON 
{
  "costMicros": string,
  "plannableProductCode": string,
  "plannedProductForecast": {
    object (PlannedProductForecast)
  }
}
فیلدها
costMicros

string ( int64 format)

هزینه این محصول به میکرو.

plannableProductCode

string

کد مربوط به محصول.

plannedProductForecast

object ( 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)

تعداد کل نمایش‌ها شامل بینندگان مشترک.