การเปรียบเทียบ YouTube

สำคัญ: ฟีเจอร์นี้ใช้ได้เฉพาะกับบัญชีในรายการที่อนุญาตเท่านั้น โปรดติดต่อตัวแทนของ Google หากต้องการเข้าถึงฟีเจอร์นี้

BenchmarksService ช่วยให้ผู้ลงโฆษณาและเอเจนซี เปรียบเทียบประสิทธิภาพโฆษณา YouTube กับการเปรียบเทียบในอุตสาหกรรมได้ การใช้บริการนี้จะช่วยให้คุณประเมินประสิทธิภาพของแคมเปญเมื่อเทียบกับ อุตสาหกรรมเฉพาะทาง หรือผู้ลงโฆษณาทั้งหมดในหมวดหมู่ผลิตภัณฑ์และบริการที่เฉพาะเจาะจง ได้

ความสามารถหลัก

โดยBenchmarksServiceจะช่วยให้คุณทำสิ่งต่อไปนี้ได้

• เปรียบเทียบประสิทธิภาพ: ประเมินเมตริกอัตราเฉลี่ยของลูกค้า (เช่น CPM, CPV, CTR และการมองเห็น) กับค่าเฉลี่ยของอุตสาหกรรมที่รวบรวมไว้
• วิเคราะห์ส่วนแบ่งการตลาด: ทำความเข้าใจการแสดงตนในตลาดที่เกี่ยวข้องของลูกค้า ผ่านส่วนแบ่งของเสียงในตลาด (การแสดงผลที่เกี่ยวข้อง) และส่วนแบ่งของการใช้จ่าย
• ประเมินสถานะการแข่งขัน: วัดตําแหน่งการแข่งขันของลูกค้าโดยใช้เมตริกเปอร์เซ็นไทล์ที่จัดประเภทประสิทธิภาพในมิติข้อมูลหลักเป็นระดับการแข่งขัน (เช่น ผู้นําระดับตลาดหรือคู่แข่ง)
• แบ่งกลุ่มตามเวลา: จัดกลุ่มเมตริกการเปรียบเทียบตามรายละเอียดเวลาแบบรายสัปดาห์ รายเดือน หรือรายไตรมาส
• ค้นพบมิติข้อมูลการเปรียบเทียบที่รองรับ: ค้นหาช่วงวันที่ สถานที่ทางภูมิศาสตร์ ผลิตภัณฑ์โฆษณา และแหล่งที่มาของการเปรียบเทียบ (อุตสาหกรรม แนวดิ่ง หรือหมวดหมู่ผลิตภัณฑ์และบริการ) ที่พร้อมใช้งาน

หมายเหตุ: คุณต้องระบุรหัสลูกค้าของไคลเอ็นต์ในคำขอ รหัสลูกค้าของบัญชีดูแลจัดการจะไม่แสดงเมตริกลูกค้าเนื่องจากบัญชีดูแลจัดการไม่ได้เรียกใช้แคมเปญโฆษณาโดยตรง

วิธีการค้นพบ

ก่อนสร้างเมตริกการเปรียบเทียบ ให้ใช้วิธีการค้นพบเพื่อดึงพารามิเตอร์ที่ถูกต้องและเกณฑ์การกำหนดขอบเขตสำหรับคำขอ

แสดงวันที่ที่พร้อมให้บริการ

เมธอด ListBenchmarksAvailableDates จะแสดงผลช่วงวันที่ย้อนหลังที่รองรับข้อมูลเปรียบเทียบในListBenchmarksAvailableDatesResponse

คำตอบจะแสดงช่วงวันที่ 2 ช่วงที่แตกต่างกัน ดังนี้

• 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: แคมเปญที่ออกแบบมาเพื่อกระตุ้นการกระทำที่ถือเป็น Conversion ที่เฉพาะเจาะจง

แสดงรายการแหล่งที่มาของการเปรียบเทียบ

เมธอด ListBenchmarksSources จะดึงแหล่งข้อมูลการเปรียบเทียบที่ใช้ได้ ระบุประเภทแหล่งข้อมูลที่จะดึงข้อมูลโดยใช้ BenchmarksSourceType

• INDUSTRY_VERTICAL: การจัดประเภทกลุ่มอุตสาหกรรม (เช่น "เทคโนโลยี" หรือ "การเงิน")
• 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 ทางภูมิศาสตร์ benchmarks_source (เช่น ประเภทธุรกิจเฉพาะทางหรือผู้ลงโฆษณาทั้งหมดที่กำหนดขอบเขตโดย category_filter) และ product_filter อย่างน้อย คุณเลือกที่จะระบุdate_range จัดกลุ่มเมตริกด้วยbreakdown_definition ระบุcurrency_code หรือขอฟีเจอร์เพิ่มเติม เช่น PERCENTILE_DATA ผ่าน supplemental_data ได้

ดูคําจํากัดความและข้อกําหนดของพารามิเตอร์ทั้งหมดได้ที่เอกสารประกอบอ้างอิง GenerateBenchmarksMetricsRequest

รายละเอียดวันที่

คุณจัดกลุ่มเมตริกได้โดยตั้งค่า breakdown_definition.date_breakdown using BenchmarksTimeGranularity ดังนี้

• WEEK: รวบรวมเมตริกตามสัปดาห์ date_range ต้องเริ่มต้นในวันอาทิตย์และสิ้นสุดในวันเสาร์ (โปรดทราบว่ารูปแบบนี้แตกต่างจาก ISO 8601)
• MONTH: รวบรวมเมตริกตามเดือน date_range ต้องเริ่มต้นในวันแรกของเดือนและสิ้นสุดในวันสุดท้ายของเดือน
• QUARTER: รวบรวมเมตริกตามไตรมาสของปฏิทิน date_range ต้อง เริ่มต้นในวันแรกของไตรมาสและสิ้นสุดในวันสุดท้ายของ ไตรมาส

เมตริกการตอบกลับ

GenerateBenchmarksMetricsResponse จะแสดงผลดังนี้

• customer_metrics: เมตริกที่แสดงถึงประสิทธิภาพโฆษณา YouTube ของลูกค้า ซึ่งรวมถึง 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 ที่ถูกต้องอย่างน้อย 1 รายการซึ่งดึงมาจาก ListBenchmarksSources
3. ข้อมูลเสริม: คุณต้องเพิ่ม PERCENTILE_DATA ลงในช่อง supplemental_data ใน GenerateBenchmarksMetricsRequest

ระดับเปอร์เซ็นไทล์

ประสิทธิภาพของลูกค้าจะจัดอยู่ในค่า enum BenchmarksCustomerPercentileTier อย่างใดอย่างหนึ่ง (ตั้งแต่ DEVELOPING สำหรับระดับล่างไปจนถึง MARKET_LEADER สำหรับผู้ลงโฆษณาที่มีประสิทธิภาพสูงสุด) ดูคำอธิบายของแต่ละระดับและขอบเขตเปอร์เซ็นไทล์ได้ที่เอกสารประกอบBenchmarksCustomerPercentileTierอ้างอิง

ตัวอย่างคำขอ

ตัวอย่างต่อไปนี้แสดงเพย์โหลดคำขอ JSON ของ REST เพื่อสร้าง เมตริกการเปรียบเทียบกับเปอร์เซ็นไทล์สำหรับผู้ใช้ที่เปรียบเทียบ ประสิทธิภาพโฆษณา YouTube ของลูกค้ากับผู้ลงโฆษณารายอื่นๆ ที่ลงโฆษณาในหมวดหมู่ /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 ทั่วไปและแนวทางปฏิบัติแนะนำได้ที่ คู่มือการจัดการข้อผิดพลาด