بنچمارک‌های یوتیوب

مهم: این ویژگی فقط برای حساب‌های موجود در یک فهرست مجاز در دسترس است. در صورت نیاز به دسترسی به این ویژگی، با نماینده گوگل خود تماس بگیرید.

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

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

با استفاده از 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 در 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 : طبقه‌بندی بخش‌های صنعت (برای مثال، «فناوری» یا «مالی» ).
• CATEGORY : دسته بندی محصولات و خدمات (برای مثال، "/پوشاک/لباس" ). دسته بندی ها می توانند به عنوان فیلتر برای محک زدن محدوده هنگام مقایسه با همه تبلیغ کنندگان استفاده شوند.

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

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

معیارهای معیار را ایجاد کنید

برای مقایسه معیارهای تبلیغات یوتیوب مشتری با معیارهای صنعت، با GenerateBenchmarksMetrics تماس بگیرید.

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

یک GenerateBenchmarksMetricsRequest دامنه تحلیل را مشخص می‌کند. حداقل باید یک customer_id مشتری، location جغرافیایی، یک benchmarks_source (مانند یک صنعت خاص یا همه تبلیغ‌کنندگان که توسط category_filter محدوده‌بندی شده‌اند) و یک product_filter مشخص کنید. می‌توانید به صورت اختیاری یک date_range ارائه دهید، معیارها را با breakdown_definition گروه‌بندی کنید، یک currency_code مشخص کنید یا از طریق supplemental_data ویژگی‌های اضافی مانند PERCENTILE_DATA را درخواست کنید.

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

تفکیک تاریخ

شما می‌توانید با تنظیم breakdown_definition.date_breakdown با استفاده از BenchmarksTimeGranularity معیارها را گروه‌بندی کنید:

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

معیارهای پاسخ

تابع GenerateBenchmarksMetricsResponse مقدار زیر را برمی‌گرداند:

• customer_metrics : معیارهایی که عملکرد تبلیغات یوتیوب مشتری را نشان می‌دهند، شامل average_rate_metrics ، share_metrics ، aggregate_metrics و 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 برای رده‌های پایین‌تر تا MARKET_LEADER برای تبلیغ‌کنندگان با عملکرد بالا). برای شرح هر رده و مرزهای صدک آن، به مستندات مرجع BenchmarksCustomerPercentileTier مراجعه کنید.

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

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

{
  "customer_id": "1234567890",
  "location": {
    "geo_target_constant": "geoTargetConstants/2840"
  },
  "benchmarks_source": {
    "all_advertisers": true
  },
  "category_filter": {
    "category_ids": ["10176"]
  },
  "product_filter": {
    "marketing_objective_list": {
      "marketing_objectives": ["AWARENESS", "CONSIDERATION"]
    }
  },
  "supplemental_data": [
    "PERCENTILE_DATA"
  ]
}

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

{
  "customer_metrics": {
    "average_rate_metrics": {
      "average_cpm": 5.42,
      "click_through_rate": 0.0185
    },
    "share_metrics": {
      "share_of_voice": 0.0345,
      "share_of_spend": 0.0410
    },
    "aggregate_metrics": {
      "cost": 15200.0,
      "impressions": 2800000.0,
      "clicks": 51800.0
    },
    "percentile_metrics": {
      "cost_percentile_tier": "STRONG_COMPETITOR",
      "impressions_percentile_tier": "STRONG_COMPETITOR",
      "clicks_percentile_tier": "MARKET_LEADER",
      "video_trueview_views_percentile_tier": "COMPETITOR",
      "viewable_impressions_percentile_tier": "STRONG_COMPETITOR",
      "interactions_percentile_tier": "MARKET_LEADER",
      "engagements_percentile_tier": "COMPETITOR"
    }
  },
  "average_benchmarks_metrics": {
    "average_rate_metrics": {
      "average_cpm": 6.15,
      "click_through_rate": 0.0142
    }
  }
}

مدیریت خطا

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

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

برای مدیریت خطاهای عمومی API و بهترین شیوه‌ها، به راهنمای مدیریت خطا مراجعه کنید.