معیارهای YouTube

BenchmarksService به آگهی‌دهندگان و آژانس‌ها امکان می‌دهد عملکرد آگهی YouTube خود را با معیارهای صنعت مقایسه کنند. بااستفاده از این سرویس، می‌توانید عملکرد پویش‌هایتان را نسبت به حوزه‌های صنعت یا در بین همه تبلیغ‌کنندگان در دسته‌های محصول و خدمات خاص ارزیابی کنید.

قابلیت‌های کلیدی

با BenchmarksService می‌توانید:

  • مقایسه عملکرد: سنجه‌های نرخ میانگین مشتری (مانند CPM،‏ CPV،‏ CTR، و رؤیت‌پذیری) را با میانگین‌های تجمیعی صنعت ارزیابی کنید.
  • تحلیل سهم بازار: درک حضور نسبی مشتری در بازار ازطریق سهم صدا (ظهورهای نسبی) و سهم هزینه.
  • ارزیابی جایگاه رقابتی: جایگاه رقابتی مشتری را بااستفاده از سنجه‌های صدک اندازه‌گیری کنید که عملکرد را در ابعاد کلیدی به سطوح رقابتی (مانند پیشرو بازار یا رقیب) طبقه‌بندی می‌کنند.
  • بخش‌بندی براساس زمان: سنجه‌های محک را براساس جزئیات زمانی هفتگی، ماهانه، یا فصلی گروه‌بندی کنید.
  • کاوش ابعاد محک پشتیبانی‌شده: پرسمان محدوده تاریخ‌های دردسترس، مکان‌های جغرافیایی، محصولات تبلیغاتی، و منابع محک (حوزه‌های صنعت یا دسته‌های محصول و خدمات).

روش‌های کاوش

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

فهرست کردن تاریخ‌های دردسترس

روش ListBenchmarksAvailableDates محدوده‌های تاریخ گذشته را که از داده‌های محک در ListBenchmarksAvailableDatesResponse پشتیبانی می‌کنند برمی‌گرداند.

پاسخ دو محدوده تاریخ متمایز ارائه می‌دهد:

  • supported_dates: محدوده تاریخ کلی که سنجه‌های محک در آن پشتیبانی می‌شود (شامل). درخواست‌های محک می‌توانند تاریخ‌های درون این محدوده را پُرسمان کنند.
  • supported_dates_for_all_metrics (در نسخه ۲۵ و جدیدتر): زیرمجموعه‌ای از supported_dates که از مجموعه کامل سنجه‌های محک پشتیبانی می‌کند. برخی سنجه‌ها—به‌ویژه سنجه‌های سهم مشتری (share_of_voice و share_of_spend) و سنجه‌های نرخ میانگین منبع محک—به‌دلیل دردسترس بودن محدود داده‌ها، فقط در این محدوده تاریخ دردسترس هستند. اگر date_range درخواست‌شده کاملاً در supported_dates_for_all_metrics قرار نگیرد، این سنجه‌ها از پاسخ حذف می‌شوند.

فهرست کردن مکان‌ها

روش ListBenchmarksLocations فهرست مکان‌های جغرافیایی (مانند کشورها) را که از داده‌های محک پشتیبانی می‌کنند برمی‌گرداند.

هر BenchmarksLocation در پاسخ شامل موارد زیر است:

  • location_name: نام مکان منحصربه‌فرد به انگلیسی (برای مثال، "United States").
  • location_type: نوع مکان مربوط به target_type در Google Ads API (برای مثال، "Country").
  • location_info: شیء LocationInfo حاوی ثابت هدف جغرافیایی (مانند geo_target_constant: "geoTargetConstants/2840").

فهرست کردن محصولات

روش ListBenchmarksProducts فهرست محصولات و اهداف بازاریابی دردسترس برای محک‌زنی را برمی‌گرداند.

هر ورودی BenchmarksProductMetadata شامل موارد زیر است:

  • ‫product_name: نام کاربرپسند محصول.
  • ‫product_code: رشته شناسه یکتا برای محصول، که هنگام ساختن ProductFilter استفاده می‌شود.
  • marketing_objective: هدف بازاریابی مرتبط (BenchmarksMarketingObjective):
    • AWARENESS: پویش‌هایی که برای افزایش آگاهی از نمانام یا محصول طراحی شده‌اند.
    • CONSIDERATION: پویش‌هایی که برای تشویق مشتریان بالقوه به درنظر گرفتن نمانام یا محصولات طراحی شده‌اند.
    • ACTION: پویش‌هایی که برای هدایت کنش تبدیل خاصی طراحی شده‌اند.

فهرست کردن منابع محک‌ها

روش ListBenchmarksSources منابع محک دردسترس را بازیابی می‌کند. انواع منبع را برای بازیابی بااستفاده از BenchmarksSourceType مشخص کنید:

  • INDUSTRY_VERTICAL: طبقه‌بندی بخش‌های صنعت (برای مثال، "Technology" یا "Finance").
  • CATEGORY (در نسخه ۲۵ و جدیدتر): دسته‌های محصول و سرویس (برای مثال، "/Apparel/Clothing"). دسته‌ها می‌توانند به‌عنوان فیلتر برای تعیین محدوده محک‌زنی هنگام مقایسه با همه تبلیغ‌کنندگان استفاده شوند.

پاسخ فهرستی از اشیاء BenchmarksSourceMetadata را برمی‌گرداند که حاوی یکی از موارد زیر است:

  • IndustryVerticalInfo: حاوی industry_vertical_name،‏ industry_vertical_id، و parent_industry_vertical_id (درصورت وجود).
  • CategoryInfo (در نسخه ۲۵ و جدیدتر): حاوی category_name، category_id، و category_path (سلسله‌مراتب کامل دسته) است.

تولید سنجه‌های محک‌زنی

با GenerateBenchmarksMetrics تماس بگیرید تا سنجه‌های آگهی YouTube مشتری را با معیارهای صنعت مقایسه کنید.

پارامترهای درخواست

GenerateBenchmarksMetricsRequest دامنه تحلیل را مشخص می‌کند. حداقل باید customer_id مشتری، location جغرافیایی (LocationInfo)، benchmarks_source (industry_vertical_id یا، در نسخه ۲۵ و جدیدتر، all_advertisers با محدوده category_filter)، و product_filter را مشخص کنید. می‌توانید به‌صورت اختیاری:

  • date_range را ارائه دهید (اگر حذف شود، داده‌ها برای جدیدترین سه‌ماهه با داده‌های دردسترس برگردانده می‌شود).
  • سنجه‌های گروه با breakdown_definition.
  • currency_code سه‌نویسه‌ای ISO 4217 را مشخص کنید (اگر حذف شود، سنجه‌های پولی مانند CPM و هزینه به‌طور پیش‌فرض روی USD تنظیم می‌شوند).
  • نام customer_benchmarks_group تعریف‌شده توسط کاربر را برای مشتری‌ای که برایش برنامه‌ریزی می‌شود مشخص کنید.
  • درخواست ویژگی‌های اضافی مثل PERCENTILE_DATA ازطریق supplemental_data (در نسخه ۲۵ و جدیدتر).

برای اطلاع از تعریف‌ها و الزامات کامل پارامتر، به سند مرجع GenerateBenchmarksMetricsRequest مراجعه کنید.

تفکیک تاریخ

می‌توانید سنجه‌ها را با تنظیم breakdown_definition.date_breakdown بااستفاده از BenchmarksTimeGranularity گروه‌بندی کنید. وقتی date_breakdown تنظیم شده باشد، date_range در GenerateBenchmarksMetricsRequest الزامی است و باید با مرزهای دانه‌بندی انتخاب‌شده مطابقت داشته باشد:

  • ‫WEEK: سنجه‌ها را براساس هفته تجمیع می‌کند. date_range باید در یکشنبه شروع شود و در شنبه پایان یابد (توجه داشته باشید که این با ISO 8601 متفاوت است).
  • ‫MONTH: سنجه‌ها را براساس ماه تجمیع می‌کند. date_range باید در اولین روز ماه شروع شود و در آخرین روز ماه پایان یابد.
  • QUARTER: سنجه‌ها را براساس فصل تقویمی تجمیع می‌کند. date_range باید در اولین روز سه‌ماهه شروع شود و در آخرین روز سه‌ماهه به‌پایان برسد.

سنجه‌های پاسخ

GenerateBenchmarksMetricsResponse برمی‌گرداند:

  • customer_metrics (از نوع CustomerMetrics در نسخه ۲۵ و جدیدتر؛ از نوع Metrics که فقط حاوی average_rate_metrics در نسخه ۲۴ و قدیمی‌تر است): سنجه‌هایی که عملکرد آگهی YouTube مشتری را نشان می‌دهند، ازجمله:
    • average_rate_metrics: سنجه‌های میانگین نرخ برای مشتری.
    • share_metrics (در نسخه ۲۵ و جدیدتر): سنجه‌های حضور نسبی در بازار (share_of_voice و share_of_spend). فقط زمانی تکمیل می‌شود که benchmarks_source، all_advertisers = true را انتخاب کند (با تنظیم category_filter) و date_range در supported_dates_for_all_metrics قرار گیرد.
    • aggregate_metrics (در نسخه ۲۵ و جدیدتر): مجموع انبوهشی برای مشتری (مثل cost، impressions، clicks، و video_trueview_views).
    • percentile_metrics (در نسخه ۲۵ و جدیدتر): ردیف‌های صدک جایگاه رقابتی در ابعاد کلیدی.
  • average_benchmarks_metrics: سنجه‌های نرخ تجمیع‌شده (RateMetrics) در سراسر منبع محک انتخاب‌شده.
  • breakdown_metrics: فهرستی از سنجه‌ها که براساس تفکیک‌های تعریف‌شده در breakdown_definition بخش‌بندی شده‌اند.

برای مشخصات کامل فیلد، به GenerateBenchmarksMetricsResponse اسناد مرجع مراجعه کنید.

سنجه‌های صدک

سنجه‌های صدک نشان‌دهنده جایگاه رقابتی مشتری به‌عنوان ردیف‌های صدک در میان سایر تبلیغ‌کنندگان در محدوده تحلیل است.

پیش‌نیازها

برای بازیابی سنجه‌های صدک، درخواست شما باید شرایط زیر را داشته باشد:

  1. منبع محک‌ها: benchmarks_source باید all_advertisers = true را انتخاب کند.
  2. فیلتر دسته: category_filter باید ارائه شود، که شامل یک یا چند category_ids معتبر بازیابی‌شده از ListBenchmarksSources باشد.
  3. داده‌های تکمیلی: باید PERCENTILE_DATA را به فیلد supplemental_data در GenerateBenchmarksMetricsRequest اضافه کنید.

رده‌های صدک

عملکرد مشتری در یکی از مقادیر شمارشی BenchmarksCustomerPercentileTier زیر طبقه‌بندی می‌شود:

  • ‫DEVELOPING: زیر صدک دهم ([0%, 10%)).
  • ENTRY_LEVEL: صدک ۱۰ تا ۲۵ ([10%, 25%)).
  • EMERGING_PLAYER: صدک ۲۵ تا ۵۰ ([25%, 50%)).
  • COMPETITOR: پنجاهمین تا هفتادوپنجمین صدک ([50%, 75%)).
  • STRONG_COMPETITOR: صدک ۷۵ تا ۹۰ ([75%, 90%)).
  • MARKET_LEADER: در صدک نودم یا بالاتر ([90%, 100%]).

درخواست نمونه

مثال زیر بار داده درخواست REST JSON را برای تولید سنجه‌های محک با رده‌های صدک برای کاربری نشان می‌دهد که عملکرد آگهی‌های YouTube مشتری خود را با سایر تبلیغ‌کنندگانی که در دسته /Apparel/Clothing آگهی اجرا می‌کنند مقایسه می‌کند:

{
  "customerId": "1234567890",
  "location": {
    "geoTargetConstant": "geoTargetConstants/2840"
  },
  "benchmarksSource": {
    "allAdvertisers": true
  },
  "categoryFilter": {
    "categoryIds": ["10176"]
  },
  "productFilter": {
    "marketingObjectiveList": {
      "marketingObjectives": ["AWARENESS", "CONSIDERATION"]
    }
  },
  "supplementalData": [
    "PERCENTILE_DATA"
  ]
}

پاسخ شامل داده‌های صدک اضافی درخواست‌شده:

{
  "customerMetrics": {
    "averageRateMetrics": {
      "averageCpm": 5.42,
      "clickThroughRate": 0.0185
    },
    "shareMetrics": {
      "shareOfVoice": 0.0345,
      "shareOfSpend": 0.0410
    },
    "aggregateMetrics": {
      "cost": 15200.0,
      "impressions": 2800000.0,
      "clicks": 51800.0
    },
    "percentileMetrics": {
      "costPercentileTier": "STRONG_COMPETITOR",
      "impressionsPercentileTier": "STRONG_COMPETITOR",
      "clicksPercentileTier": "MARKET_LEADER",
      "videoTrueviewViewsPercentileTier": "COMPETITOR",
      "viewableImpressionsPercentileTier": "STRONG_COMPETITOR",
      "interactionsPercentileTier": "MARKET_LEADER",
      "engagementsPercentileTier": "COMPETITOR"
    }
  },
  "averageBenchmarksMetrics": {
    "averageRateMetrics": {
      "averageCpm": 6.15,
      "clickThroughRate": 0.0142
    }
  }
}

مدیریت کردن خطا

هنگام فراخوانی BenchmarksService، ممکن است با خطاهای خاصی در پُرسمان‌های محک در BenchmarksError مواجه شوید:

  • MAX_QUERY_COMPLEXITY_EXCEEDED: ترکیب ورودی‌های درخواست‌شده برای پردازش بسیار پیچیده است. برای کاهش پیچیدگی پُرسمان:
    • منبع محک یا فیلتر دسته دقیق‌تر یا جزئی‌تری را انتخاب کنید.
    • date_range درخواست‌شده را کوتاه کنید.
    • تعداد محصولات را در product_filter کاهش دهید.
  • NO_METRICS_FOUND (در نسخه ۲۵ و جدیدتر): هیچ سنجه‌ای برای ترکیب ورودی‌های درخواست‌شده پیدا نشد (برای مثال، دسته خاصی در مکان و محدوده تاریخ مشخصی که هیچ آگهی‌دهنده‌ای پویشی اجرا نکرده است). دسته، مکان، محدوده تاریخ، یا محصولات را اصلاح کنید.

برای روال‌های مطلوب و رسیدگی به خطای API عمومی، به راهنمای رسیدگی به خطا مراجعه کنید.

سامانه پیگیری Google

از Google Issue Tracker برای پرسیدن سؤالات پشتیبانی، گزارش اشکالات، یا ارسال درخواست‌های ویژگی استفاده کنید. Google درخواست‌های شما را مستقیماً در Issue Tracker پیگیری، اولویت‌بندی، و به‌روزرسانی می‌کند. برای اطلاعات بیشتر، ایجاد مشکل در Google Issue Tracker را ببینید.

بااستفاده از یکی از الگوهای Issue Tracker زیر، مشکلی ایجاد کنید:

همه فیلدهای الگو را با اطلاعات دقیق تکمیل کنید تا Google بتواند درخواستتان را بازتولید و اولویت‌بندی کند. Google ممکن است گزارش‌های ناقص را ببندد و از شما بخواهد مشکل جدیدی را با جزئیات جاافتاده ارسال کنید.

قبلی
اطلاعات آماری محتواساز YouTube