Method: advertisers.reachForecast.generateReachForecast

প্রদত্ত বিজ্ঞাপনদাতা এবং টার্গেটিং কনফিগারেশনের জন্য একটি রিচ পূর্বাভাস তৈরি করে।

HTTP অনুরোধ

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

URL-টিতে 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 । অভিযানের সময়কাল নির্বাচনের সুযোগ। 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 )

ঐচ্ছিক। ইউটিউব সেটিংস নির্বাচন করুন।

dateRange

object ( DateRange )

ঐচ্ছিক। লক্ষ্য করার জন্য তারিখের পরিসর।

plannableLocationIds[]

string ( int64 format)

ঐচ্ছিক। লক্ষ্য করার জন্য পরিকল্পনাযোগ্য অবস্থান আইডিসমূহ।

network

enum ( PlannableNetwork )

ঐচ্ছিক। যে নেটওয়ার্কটিকে লক্ষ্য করতে হবে।

সারফেস টার্গেটিং সেটিংস

পৃষ্ঠতল লক্ষ্যবস্তু নির্বাচন।

JSON উপস্থাপনা 
{
  "surfaces": [
    enum (PlannableSurface)
  ]
}
ক্ষেত্র
surfaces[]

enum ( PlannableSurface )

ঐচ্ছিক। যে পৃষ্ঠতলগুলোকে লক্ষ্যবস্তু করতে হবে।

ইউটিউব নির্বাচন সেটিংস

ইউটিউব সিলেক্ট লাইনআপের জন্য সেটিংস।

JSON উপস্থাপনা 
{
  "lineupId": string
}
ক্ষেত্র
lineupId

string ( int64 format)

ঐচ্ছিক। ইউটিউব সিলেক্ট লাইনআপের আইডি।

OnTargetAudienceMetrics

একটি নির্দিষ্ট ভৌগোলিক অঞ্চলের জন্য আনুমানিক দর্শক সংখ্যা।

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)

সহ-দর্শকদের সহ মোট ইম্প্রেশনের সংখ্যা।