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

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

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

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

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

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

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

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

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

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

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

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

• supported_dates: ช่วงวันที่โดยรวมที่รองรับเมตริกการเปรียบเทียบ (รวม) คำขอการเปรียบเทียบสามารถค้นหาวันที่ภายในช่วงนี้ได้
• supported_dates_for_all_metrics (ใน v25 ขึ้นไป): ชุดย่อยของ 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: การแยกประเภทของกลุ่มอุตสาหกรรม (เช่น "Technology" หรือ "Finance")
• CATEGORY (ใน v25 ขึ้นไป): หมวดหมู่ผลิตภัณฑ์และบริการ (เช่น "/Apparel/Clothing") หมวดหมู่สามารถใช้เป็นตัวกรองเพื่อกำหนดขอบเขตการเปรียบเทียบเมื่อเปรียบเทียบกับผู้ลงโฆษณาทั้งหมด

การตอบกลับจะแสดงรายการออบเจ็กต์ BenchmarksSourceMetadata ซึ่งมีข้อมูลอย่างใดอย่างหนึ่งต่อไปนี้

• IndustryVerticalInfo: มี industry_vertical_name, industry_vertical_id และ parent_industry_vertical_id (หากมี)
• CategoryInfo (ใน v25 ขึ้นไป): มี category_name, category_id และ category_path (ลำดับชั้นหมวดหมู่แบบเต็ม)

สร้างเมตริกการเปรียบเทียบ

เรียกใช้ GenerateBenchmarksMetrics เพื่อเปรียบเทียบเมตริกโฆษณา YouTube ของลูกค้ากับการเปรียบเทียบในธุรกิจเดียวกัน

พารามิเตอร์คำขอ

GenerateBenchmarksMetricsRequest จะกำหนดขอบเขตการวิเคราะห์ อย่างน้อยที่สุด คุณต้องระบุ customer_id ของลูกค้า, location ทางภูมิศาสตร์ (LocationInfo), benchmarks_source (industry_vertical_id หรือใน v25 ขึ้นไป all_advertisers ที่กำหนดขอบเขตโดย category_filter) และ product_filter คุณเลือกดำเนินการต่อไปนี้ได้

• ระบุ date_range (หากไม่ระบุ ระบบจะแสดงข้อมูลของไตรมาสล่าสุดที่มีข้อมูล)
• จัดกลุ่มเมตริกด้วย breakdown_definition
• ระบุ currency_code ISO 4217 แบบ 3 อักขระ (หากไม่ระบุ เมตริกทางการเงิน เช่น CPM และค่าใช้จ่ายจะใช้ค่าเริ่มต้นเป็น USD)
• ระบุชื่อ customer_benchmarks_group ที่ผู้ใช้กำหนดสำหรับลูกค้าที่กำลังวางแผนให้
• ขอฟีเจอร์เพิ่มเติม เช่น PERCENTILE_DATA ผ่าน supplemental_data (ใน v25 ขึ้นไป)

ดูคำจำกัดความและข้อกำหนดของพารามิเตอร์ทั้งหมดได้ที่เอกสารอ้างอิง 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 ใน v25 ขึ้นไป ประเภท Metrics ที่มีเฉพาะ average_rate_metrics ใน v24 ลงไป): เมตริกที่แสดงประสิทธิภาพโฆษณา YouTube ของลูกค้า ซึ่งรวมถึง
  • average_rate_metrics: เมตริกอัตราเฉลี่ยสำหรับลูกค้า
  • share_metrics (ใน v25 ขึ้นไป): เมตริกการแสดงข้อมูลในตลาดที่เกี่ยวข้อง (share_of_voice และ share_of_spend) จะป้อนข้อมูลเมื่อ benchmarks_source เลือก all_advertisers = true (โดยตั้งค่า category_filter) และ date_range อยู่ใน supported_dates_for_all_metrics เท่านั้น
  • aggregate_metrics (ใน v25 ขึ้นไป): ผลรวมที่รวบรวมไว้สำหรับลูกค้า (เช่น cost, impressions, clicks และ video_trueview_views)
  • percentile_metrics (ใน v25 ขึ้นไป): ระดับเปอร์เซ็นไทล์ของสถานะการแข่งขันในมิติข้อมูลหลัก
• average_benchmarks_metrics: เมตริกอัตราแบบรวม (RateMetrics) ในแหล่งที่มาของการเปรียบเทียบที่เลือก
• breakdown_metrics: รายการเมตริกที่แบ่งกลุ่มตามรายละเอียดที่กำหนดไว้ใน breakdown_definition

ดูข้อกำหนดของฟิลด์ทั้งหมดได้ในเอกสารอ้างอิง GenerateBenchmarksMetricsResponse

เมตริกเปอร์เซ็นไทล์

หมายเหตุ: supplemental_data (BenchmarksSupplementalData) และ percentile_metrics พร้อมใช้งานใน v25 ขึ้นไป

เมตริกเปอร์เซ็นไทล์แสดงสถานะการแข่งขันของลูกค้าเป็นระดับเปอร์เซ็นไทล์เทียบกับผู้ลงโฆษณารายอื่นๆ ภายในขอบเขตการวิเคราะห์

ข้อกำหนดเบื้องต้น

หากต้องการดึงข้อมูลเมตริกเปอร์เซ็นไทล์ คำขอของคุณต้องเป็นไปตามข้อกำหนดต่อไปนี้

1. แหล่งที่มาของการเปรียบเทียบ: benchmarks_source ต้องเลือก all_advertisers = true
2. ตัวกรองหมวดหมู่: ต้องระบุ category_filter ซึ่งมี category_ids ที่ถูกต้องอย่างน้อย 1 รายการที่ดึงมาจาก ListBenchmarksSources
3. ข้อมูลเสริม: คุณต้องเพิ่ม PERCENTILE_DATA ลงในช่อง supplemental_data ใน GenerateBenchmarksMetricsRequest

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

ประสิทธิภาพของลูกค้าจะจัดอยู่ในค่า enum BenchmarksCustomerPercentileTier ค่าใดค่าหนึ่งต่อไปนี้

• DEVELOPING: ต่ำกว่าเปอร์เซ็นไทล์ที่ 10 ([0%, 10%))
• ENTRY_LEVEL: เปอร์เซ็นไทล์ที่ 10 ถึง 25 ([10%, 25%))
• EMERGING_PLAYER: เปอร์เซ็นไทล์ที่ 25 ถึง 50 ([25%, 50%))
• COMPETITOR: เปอร์เซ็นไทล์ที่ 50 ถึง 75 ([50%, 75%))
• STRONG_COMPETITOR: เปอร์เซ็นไทล์ที่ 75 ถึง 90 ([75%, 90%))
• MARKET_LEADER: อยู่ที่หรือสูงกว่าเปอร์เซ็นไทล์ที่ 90 ([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 (ใน v25 ขึ้นไป): ไม่พบเมตริกสำหรับชุดค่าผสมของอินพุตที่ขอ (เช่น หมวดหมู่เฉพาะในสถานที่ตั้งและช่วงวันที่ที่ไม่มีผู้ลงโฆษณาเรียกใช้แคมเปญ) ลองปรับหมวดหมู่ สถานที่ ช่วงวันที่ หรือผลิตภัณฑ์

ดูการจัดการข้อผิดพลาดของ API ทั่วไปและแนวทางปฏิบัติแนะนำได้ที่คู่มือการจัดการข้อผิดพลาด

Google Issue Tracker

ใช้ Issue Tracker ของ Google เพื่อถามคำถามเกี่ยวกับการสนับสนุน รายงานข้อบกพร่อง หรือส่งคำขอฟีเจอร์ Google จะติดตาม จัดลำดับความสำคัญ และโพสต์ข้อมูลอัปเดตเกี่ยวกับคำขอของคุณใน Issue Tracker โดยตรง ดูข้อมูลเพิ่มเติมได้ที่สร้างปัญหาใน Issue Tracker ของ Google

สร้างปัญหาโดยใช้เทมเพลต Issue Tracker อย่างใดอย่างหนึ่งต่อไปนี้

• ถามคำถามเกี่ยวกับการสนับสนุนทั่วไปหรือส่งความคิดเห็นเกี่ยวกับเอกสารประกอบ
• รายงานข้อบกพร่องทางเทคนิค
• ส่งคำขอฟีเจอร์ API

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