การแก้ปัญหา RTB

คู่มือนี้ครอบคลุมแหล่งข้อมูลการแก้ปัญหา RTB ซึ่งช่วยให้คุณเข้าถึงแบบเป็นโปรแกรมได้ เมตริกแคมเปญการเสนอราคาแบบเรียลไทม์ที่แสดงผ่าน เครื่องมือรายละเอียด RTB ที่พบใน UI ของ Authorized Buyers ซึ่งรวมถึง bidders.filterSets, bidders.accounts.filterSets และ ทรัพยากรทั้งหมดภายใต้ลำดับชั้น

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

การปรับเปลี่ยนโครงสร้างและรูปแบบของ API

แหล่งข้อมูลการแก้ปัญหา RTB มีการเปลี่ยนแปลงเล็กน้อยเพื่อบ่งชี้การเป็นเจ้าของและ มอบการควบคุมที่ละเอียดยิ่งขึ้นสำหรับข้อมูลที่แสดงผลโดย API และปรับให้สอดคล้องกับ การออกแบบของ Google API

แหล่งข้อมูลระดับผู้เสนอราคาและระดับบัญชี

ทรัพยากรมีโครงสร้างภายใต้ bidders และ bidders.accounts ซึ่งคุณสามารถระบุ การเรียก API กำหนดเป้าหมายไปยังผู้เสนอราคา (หรือที่เรียกว่าบัญชีหลัก) และเชื่อมโยงทั้งหมดหรือไม่ บัญชีย่อย หรือบัญชี Authorized Buyers แต่ละบัญชี ในบริบทของ RTB การแก้ปัญหา ทรัพยากรที่มีโครงสร้างภายใต้ bidders.filterSets จะแสดงเมตริกรวม สำหรับผู้เสนอราคาที่กำหนดและบัญชีย่อยที่เชื่อมโยงทั้งหมด ในทางกลับกัน บริษัทที่อยู่ภายใต้ bidders.accounts.filterSets จะแสดงผลเฉพาะเมตริกสำหรับบัญชีที่ระบุโดยไม่คำนึงถึง ไม่ว่าจะเป็นผู้เสนอราคาหรือบัญชีย่อย

หมายเหตุ: บัญชีที่มอบสิทธิ์การเสนอราคาให้กับผู้ซื้อรายอื่นไม่ใช่บัญชีผู้เสนอราคา และ จึงเข้าถึงทรัพยากรระดับผู้เสนอราคาไม่ได้ นอกจากนี้ บัญชีของผู้ที่ไม่ได้เป็นผู้เสนอราคาไม่สามารถ เข้าถึง impressionMetrics, filteredBidResponses, bidResponseErrors และระดับบัญชี ทรัพยากร bidResponsesWithoutBids รายการ

ขอแนะนำชื่อทรัพยากรเป็นตัวระบุที่ไม่ซ้ำกัน

ชื่อทรัพยากรจะใช้เป็น ตัวระบุที่ไม่ซ้ำกันมากกว่าจำนวนเต็มหรือรหัสสตริง เมื่อสร้างอินสแตนซ์ใหม่ ประเภททรัพยากร คุณต้องระบุ สัมพัทธ์ ชื่อทรัพยากร โดยใช้เส้นทาง URI ของทรัพยากร ตามด้วยรหัสทรัพยากรที่ต้องการ ต่อไปนี้เป็นตัวอย่างของชื่อที่เกี่ยวข้องกับทรัพยากรการแก้ปัญหา RTB:

ทรัพยากร	ตัวอย่างชื่อ
bidders.filterSets	bidders/12345678/filterSets/fset_1
bidders.accounts.filterSets	bidders/12345678/accounts/87654321/filterSets/fset_2

หมายเหตุ: รหัสทรัพยากรที่ระบุสำหรับ bidders ในชื่อต้องเป็นรหัสของผู้เสนอราคา รหัสบัญชี Authorized Buyers สำหรับ accounts รหัสทรัพยากรต้องเป็นรหัสบัญชีของ ผู้เสนอราคาหรือบัญชีย่อยที่จัดการโดยผู้เสนอราคา หากไม่ทราบว่า Authorized Buyers รายใด บัญชีจะเชื่อมโยงกับบัญชี Google ของคุณ คุณสามารถใช้ accounts.list เพื่อค้นหาบัญชีได้

ชุดตัวกรอง

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

ตัวกรองที่ใช้เมื่อดึงข้อมูลเมตริกคือจุดตัดของตัวกรองแต่ละตัวในข้อมูลที่ระบุ ชุดตัวกรอง ตัวกรองรายการ เช่น platforms จะถูกตีความว่าเป็นการรวมของแต่ละรายการในลิสต์

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

	bidders.filterSets	bidders.accounts.filterSets
บัญชีผู้เสนอราคา	การเรียก API ที่จะส่งผลต่อชุดตัวกรองระดับผู้เสนอราคาเท่านั้น	การเรียก API ที่จะส่งผลกระทบต่อชุดตัวกรองระดับบัญชีเท่านั้น
บัญชีย่อย	การเรียก API นี้จะแสดงการตอบกลับข้อผิดพลาด	การเรียก API ที่จะส่งผลกระทบต่อชุดตัวกรองระดับบัญชีเท่านั้น

สร้างชุดตัวกรอง

เมื่อสร้างชุดตัวกรอง คุณต้องระบุช่วงเวลาเป็น relativeDateRange absoluteDateRange หรือ realtimeTimeRange เมื่อดึงข้อมูลเมตริก พารามิเตอร์ ลักษณะการทํางานเริ่มต้นคือ การแสดงข้อมูลทั้งหมดสําหรับทั้งช่วงเวลา หากคุณต้องการรับ รายละเอียดอนุกรมเวลาตามช่วงเวลา คุณอาจระบุ timeSeriesGranularity เพื่อระบุช่วง HOURLY หรือ DAILY

หากต้องการใช้ตัวกรองเป็นระยะเวลาสั้นๆ คุณก็สามารถตั้งค่าisTransient พารามิเตอร์การค้นหาไปยัง true ซึ่งเป็นการระบุว่าชุดตัวกรองเป็นแบบชั่วคราว ซึ่งหมายความว่าจะไม่คงอยู่ตลอดไป ชุดตัวกรองชั่วคราวจะพร้อมใช้งานอย่างน้อย 1 ชั่วโมงหลังจากการสร้าง แต่ในที่สุดระบบจะลบออก โดยค่าเริ่มต้น ชุดตัวกรองจะไม่เป็นแบบชั่วคราว

ตัวอย่างระดับผู้เสนอราคา

หากต้องการสร้างชุดตัวกรองระดับผู้เสนอราคาใหม่ ให้ส่งคำขอ POST ไปยัง URI ทรัพยากร bidders.filterSets ซึ่งมีรูปแบบต่อไปนี้

https://adexchangebuyer.googleapis.com/v2beta1/bidders/{bidder resource ID}/filterSets

คำเตือน: ชุดตัวกรองระดับผู้เสนอราคาไม่สามารถกรองตามครีเอทีฟโฆษณาหรือรหัสดีลได้ หากคุณระบุตัวกรองเหล่านี้เมื่อสร้างชุดตัวกรองระดับผู้เสนอราคา คุณจะได้รับการตอบกลับข้อผิดพลาด

คำขอ

ต่อไปนี้คือตัวอย่างของคำขอ POST ที่สร้างชุดตัวกรองระดับผู้เสนอราคาที่ไม่ใช่แบบชั่วคราวชุดใหม่

POST https://adexchangebuyer.googleapis.com/v2beta1/bidders/12345678/filterSets
Authorization: Bearer access token here
Content-Type: application/json

{
  "name": "bidders/12345678/filterSets/bidder-fs",
  "format": "DISPLAY",
  "environment": "APP",
  "platforms": ["TABLET", "MOBILE"],
  "absoluteDateRange": {
    "startDate": {
      "month": 11,
      "day": 26,
      "year": 2017
    },
    "endDate": {
      "month": 12,
      "day": 3,
      "year": 2017
    }
  },
  "timeSeriesGranularity": "DAILY"
}

การตอบกลับ

หากคำขอประสบความสำเร็จ เซิร์ฟเวอร์จะตอบสนองด้วยรหัสสถานะ 200 OK เนื้อหาการตอบกลับจะรวมทรัพยากรชุดตัวกรองที่สร้างขึ้น ซึ่งจะเหมือนกับชุดตัวกรองที่ส่งในคำขอ

ตัวอย่างระดับบัญชี

หากต้องการสร้างชุดตัวกรองระดับบัญชีใหม่ ให้ส่งคำขอ POST ไปที่ URI ทรัพยากร bidders.accounts.filterSets ซึ่งมีรูปแบบต่อไปนี้

https://adexchangebuyer.googleapis.com/v2beta1/bidders/{bidder resource ID}/accounts/{account resource ID}/filterSets

หมายเหตุ: รหัสทรัพยากรที่ระบุสำหรับ accounts สามารถ เป็นรหัสบัญชีของบัญชี Authorized Buyers ใดก็ตามที่ผู้เสนอราคาเข้าถึงได้ ที่ระบุไว้ใน URI ซึ่งรวมถึงตัวบัญชีผู้เสนอราคาเองด้วย

คำขอ

ต่อไปนี้คือตัวอย่างของคำขอ POST ที่สร้างชุดตัวกรองระดับบัญชีที่ไม่ใช่แบบชั่วคราว

POST https://adexchangebuyer.googleapis.com/v2beta1/bidders/12345678/accounts/87654321/filterSets
Authorization: Bearer access token here
Content-Type: application/json

{
  "name": "bidders/12345678/accounts/87654321/filterSets/account-fs",
  "format": "VIDEO",
  "environment": "WEB",
  "platforms": ["DESKTOP"],
  "absoluteDateRange": {
    "startDate": {
      "month": 11,
      "day": 26,
      "year": 2017
    },
    "endDate": {
      "month": 12,
      "day": 3,
      "year": 2017
    }
  },
  "timeSeriesGranularity": "DAILY"
}

การตอบกลับ

หากคำขอประสบความสำเร็จ เซิร์ฟเวอร์จะตอบกลับด้วยรหัสสถานะ 200 OK เนื้อหาการตอบกลับจะ รวมทรัพยากรชุดตัวกรองที่สร้างขึ้น ซึ่งจะเหมือนกับชุดตัวกรองที่ส่งใน คำขอ

รับชุดตัวกรอง

เมธอด Get จะสามารถรับชุดตัวกรองที่ระดับเดียวกันกับที่สร้างเท่านั้น ตัวอย่างเช่น ผู้เสนอราคา บัญชีควรใช้ bidders.accounts.filterSets.get เพื่อดึงข้อมูลชุดตัวกรองที่สร้างขึ้นในบัญชีนี้ ระดับแทนที่จะเป็นเมธอด bidders.filterSets.get

ระดับผู้เสนอราคา

คุณเรียกข้อมูลตัวกรองระดับผู้เสนอราคาที่ตั้งค่าได้โดยการส่งคำขอ HTTP GET ไปยัง URI ทรัพยากรของ bidders.filterSets ซึ่งมีรูปแบบต่อไปนี้

GET https://adexchangebuyer.googleapis.com/v2beta1/bidders/{bidder resource ID}/filterSets/{filter set resource ID}

คำขอ

เช่น

GET https://adexchangebuyer.googleapis.com/v2beta1/bidders/12345678/filterSets/bidder-fs

การตอบกลับ

หากคำขอประสบความสำเร็จ เซิร์ฟเวอร์จะตอบสนองด้วยรหัสสถานะ HTTP 200 OK และชุดตัวกรองที่ดึงข้อมูลมาดังนี้

{
  "name": "bidders/12345678/filterSets/bidder-fs",
  "format": "DISPLAY",
  "environment": "APP",
  "platforms": ["TABLET", "MOBILE"],
  "absoluteDateRange": {
    "startDate": {
      "month": 11,
      "day": 26,
      "year": 2017
    },
    "endDate": {
      "month": 12,
      "day": 3,
      "year": 2017
    }
  },
  "timeSeriesGranularity": "DAILY"
}

ระดับบัญชี

คุณสามารถดึงข้อมูลชุดตัวกรองระดับบัญชีได้โดยการส่งคำขอ HTTP GET ไปยัง URI ทรัพยากร bidders.accounts.filterSets ซึ่งมีรูปแบบต่อไปนี้

GET https://adexchangebuyer.googleapis.com/v2beta1/bidders/{bidder resource ID}/accounts/{account resource ID}/filterSets/{filter set resource ID}

คำขอ

เช่น

GET https://adexchangebuyer.googleapis.com/v2beta1/bidders/12345678/accounts/87654321/filterSets/account-fs

การตอบกลับ

หากคำขอประสบความสำเร็จ เซิร์ฟเวอร์จะตอบสนองด้วยรหัสสถานะ HTTP 200 OK และชุดตัวกรองที่ดึงข้อมูลมาดังนี้

{
  "name": "bidders/12345678/accounts/87654321/filterSets/account-fs",
  "format": "VIDEO",
  "environment": "WEB",
  "platforms": ["DESKTOP"],
  "absoluteDateRange": {
    "startDate": {
      "month": 11,
      "day": 26,
      "year": 2017
    },
    "endDate": {
      "month": 12,
      "day": 3,
      "year": 2017
    }
  },
  "timeSeriesGranularity": "DAILY"
}

แสดงรายการชุดตัวกรอง

เมธอดแบบรายการจะแสดงผลชุดตัวกรองที่เข้าถึงได้จากระดับที่กำลังเรียกใช้เท่านั้น ตัวอย่างเช่น บัญชีผู้เสนอราคาจะไม่เห็นชุดตัวกรองที่สร้างขึ้นเองผ่าน bidders.accounts.filterSets.create เมื่อโทรหา bidders.filterSets.list

ระดับผู้เสนอราคา

คุณดึงข้อมูลชุดตัวกรองระดับผู้เสนอราคาทั้งหมดสำหรับผู้เสนอราคารายหนึ่งๆ ได้โดยการส่ง HTTP GET คำขอไปยัง URI ทรัพยากร bidders.filtersets ซึ่งมีรูปแบบต่อไปนี้

GET https://adexchangebuyer.googleapis.com/v2beta1/bidders/{bidder resource ID}/filterSets

คำขอ

ต่อไปนี้คือตัวอย่างที่แสดงชุดตัวกรองระดับผู้เสนอราคาทั้งหมดสำหรับผู้เสนอราคาที่มีรหัสบัญชี 12345678

GET https://adexchangebuyer.googleapis.com/v2beta1/bidders/12345678/filterSets

การตอบกลับ

{
  "filterSets": [{
      "filterSetId": "99994",
      "name": "bidders/12345678/filterSets/test-b-1",
      "relativeDateRange": {
        "durationDays": 30
      }
    },
    {
      "realtimeTimeRange": {
        "startTimeStamp": "2017-11-15T12:30:30.072831583Z"
      },
      "filterSetId": "99995",
      "name": "bidders/12345678/filterSets/test-b-2",
      "timeSeriesGranularity": "HOURLY"
    },
    {
      "absoluteDateRange": {
        "endDate": {
          "day": 12,
          "month": 3,
          "year": 2017
        },
        "startDate": {
          "day": 26,
          "month": 11,
          "year": 2017
        }
      },
      "filterSetId": "99996",
      "name": "bidders/12345678/filterSets/bidder-fs",
      "timeSeriesGranularity": "DAILY",
      "platforms": ["TABLET", "MOBILE"],
      "environment": "APP",
      "format": "DISPLAY"
    }
  ]
}

ระดับบัญชี

คุณสามารถดึงข้อมูลชุดตัวกรองระดับบัญชีทั้งหมดสำหรับบัญชีที่ระบุได้โดยการส่ง HTTP GET คำขอไปยัง URI ทรัพยากร bidders.accounts.filtersets ซึ่งมีรูปแบบต่อไปนี้

GET https://adexchangebuyer.googleapis.com/v2beta1/bidders/{bidder resource ID}/accounts/{account resource ID}/filterSets

คำขอ

ต่อไปนี้คือตัวอย่างที่แสดงชุดตัวกรองระดับบัญชีทั้งหมดสำหรับบัญชีย่อยที่มีรหัสบัญชี 87654321

GET https://adexchangebuyer.googleapis.com/v2beta1/bidders/12345678/accounts/87654321/filterSets

การตอบกลับ

{
  "filterSets": [{
        "realtimeTimeRange": {
        "startTimeStamp": "2017-11-19T04:24:43.252893487Z"
      },
      "filterSetId": "99997",
      "name": "bidders/12345678/accounts/87654321/filterSets/test-a-1",
      "timeSeriesGranularity": "DAILY"
    },
    {
      "absoluteDateRange": {
        "endDate": {
          "day": 3,
          "month": 12,
          "year": 2017
        },
        "startDate": {
          "day": 26,
          "month": 11,
          "year": 2017
        }
      },
      "filterSetId": "99998",
      "name": "bidders/12345678/accounts/87654321/filterSets/account-fs",
      "timeSeriesGranularity": "DAILY",
      "platforms": ["DESKTOP"],
      "environment": "WEB",
      "format": "VIDEO"
    }
  ]
}

ลบชุดตัวกรอง

คุณสามารถใช้เมธอด delete เพื่อนำชุดตัวกรองที่ไม่ใช่แบบชั่วคราวออก ยิ่งไปกว่านั้น จะลบได้เฉพาะชุดตัวกรองที่เข้าถึงได้จากระดับที่มีการเรียกใช้เท่านั้น ตัวอย่างเช่น บัญชีผู้เสนอราคาไม่สามารถลบชุดตัวกรองที่สร้างด้วย bidders.accounts.filterSets.create ด้วย bidders.filterSets.delete

ระดับผู้เสนอราคา

คุณลบตัวกรองระดับผู้เสนอราคาที่ตั้งค่าสำหรับบัญชีหนึ่งๆ ได้โดยส่งคำขอ HTTP DELETE ไปยัง URI ทรัพยากร bidders.filtersets ซึ่งมีรูปแบบต่อไปนี้

DELETE https://adexchangebuyer.googleapis.com/v2beta1/bidders/{bidder resource ID}/filterSets/{filter set resource ID}

คำขอ

ต่อไปนี้คือตัวอย่างการลบชุดตัวกรองระดับผู้เสนอราคา

DELETE https://adexchangebuyer.googleapis.com/v2beta1/bidders/12345678/filterSets/test-b-2

การตอบกลับ

หากทำสำเร็จ เนื้อหาของคำขอจะว่างเปล่า ชุดตัวกรองที่ระบุจะไม่สามารถเข้าถึงได้อีกต่อไป

ระดับบัญชี

คุณลบชุดตัวกรองระดับบัญชีสำหรับบัญชีหนึ่งๆ ได้โดยส่ง HTTP DELETE คำขอไปยัง URI ทรัพยากร bidders.accounts.filtersets ซึ่งมีรูปแบบต่อไปนี้

DELETE https://adexchangebuyer.googleapis.com/v2beta1/bidders/{bidder resource ID}/accounts/{account resource ID}/filterSets/{filter set resource ID}

คำขอ

ต่อไปนี้เป็นตัวอย่างการลบชุดตัวกรองระดับบัญชี

DELETE https://adexchangebuyer.googleapis.com/v2beta1/bidders/12345678/accounts/87654321/filterSets/test-a-1

การตอบกลับ

หากทำสำเร็จ เนื้อหาของคำขอจะว่างเปล่า ชุดตัวกรองที่ระบุจะไม่สามารถเข้าถึงได้อีกต่อไป

เรียกข้อมูลเมตริกการแก้ปัญหา RTB

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

เมตริกราคาเสนอ

ทรัพยากร bidMetrics ใช้เพื่อดึงเมตริกที่วัดในส่วน จำนวนราคาเสนอ ตัวอย่างเช่น คุณสามารถใช้ค่านี้เพื่อพิจารณาจำนวนการเสนอราคาทั้งหมดของคุณในช่วง ช่วงเวลาที่ระบุ และมีกี่รายการที่ไม่ได้กรองออกจากการประมูล ชนะแล้ว 1 ครั้ง ฯลฯ เช่นเดียวกับทรัพยากรการแก้ปัญหา RTB อื่นๆ ทั้งหมดที่ใช้ในการรวบรวมเมตริก เครื่องมือนี้มีเพียงเมธอด list เท่านั้น

แสดงรายการเมตริกการเสนอราคาระดับผู้เสนอราคา

คุณสามารถสร้างรายการเมตริกการเสนอราคาระดับผู้เสนอราคาสำหรับชุดตัวกรองหนึ่งๆ โดยการส่ง HTTP GET คำขอไปยัง URI ทรัพยากร bidders.filtersets.bidMetrics ซึ่งมีรูปแบบต่อไปนี้

GET https://adexchangebuyer.googleapis.com/v2beta1/bidders/{bidder resource ID}/filterSets/{filter set resource ID}/bidMetrics

คำขอ

ต่อไปนี้คือตัวอย่างเมตริกการเสนอราคาระดับผู้เสนอราคาที่แสดง

GET https://adexchangebuyer.googleapis.com/v2beta1/bidders/12345678/filterSets/bidder-fs/bidMetrics

การตอบกลับ

หากคำขอประสบความสำเร็จ เซิร์ฟเวอร์จะตอบสนองด้วยรหัสสถานะ 200 OK และเนื้อความที่มีแถวของเมตริกสำหรับมิติข้อมูลและรายละเอียดที่ระบุ

{
  "bidMetricsRows": [{
        "bids": {
        "value": "6160"
      },
      "bidsInAuction": {
        "value": "5698"
      },
      "billedImpressions": {
        "value": "1196"
      },
      "impressionsWon": {
        "value": "2920"
      },
      "measurableImpressions": {
        "value": "1160"
      },
      "rowDimensions": {
        "timeInterval": {
          "endTime": "2017-11-29T08:00:00Z",
          "startTime": "2017-11-28T08:00:00Z"
        }
      },
      "viewableImpressions": {
        "value": "683"
      }
    },
    {
      "bids": {
        "value": "104288"
      },
      "bidsInAuction": {
        "value": "94016"
      },
      "billedImpressions": {
        "value": "99"
      },
      "impressionsWon": {
        "value": "125"
      },
      "measurableImpressions": {
        "value": "94"
      },
      "rowDimensions": {
        "timeInterval": {
          "endTime": "2017-11-30T08:00:00Z",
          "startTime": "2017-11-29T08:00:00Z"
        }
      },
      "viewableImpressions": {
        "value": "87"
      }
    },
    {
      "bids": {
        "value": "3999"
      },
      "bidsInAuction": {
        "value": "3631"
      },
      "billedImpressions": {
        "value": "618"
      },
      "impressionsWon": {
        "value": "1819"
      },
      "measurableImpressions": {
        "value": "604"
      },
      "rowDimensions": {
        "timeInterval": {
          "endTime": "2017-12-01T08:00:00Z",
          "startTime": "2017-11-30T08:00:00Z"
        }
      },
      "viewableImpressions": {
        "value": "369"
      }
    },
    {
      "bids": {
        "value": "15"
      },
      "bidsInAuction": {
        "value": "3"
      },
      "billedImpressions": {},
      "impressionsWon": {
        "value": "3"
      },
      "measurableImpressions": {},
      "rowDimensions": {
        "timeInterval": {
          "endTime": "2017-12-02T08:00:00Z",
          "startTime": "2017-12-01T08:00:00Z"
        }
      },
      "viewableImpressions": {}
    }
  ]
}

หมายเหตุ: ฟิลด์ที่ตั้งค่าเป็น 0 สำหรับเมตริกหนึ่งๆ จะไม่ปรากฏในการตอบกลับ เมตริก billedImpressions และ measurableImpressions ที่ว่างเปล่าด้านบน ระบุว่าทั้งค่าและความแปรปรวนของค่าเหล่านี้กำหนดไว้เป็น 0

คำเตือน: สำหรับการแจกแจงข้อมูลในคำตอบ คำตอบจะไม่ รวมแถวหากไม่มีเมตริกที่ไม่ใช่ 0 อย่างน้อย 1 รายการ ตัวอย่างเช่น เมื่อ ระบุ timeSeriesGranularity แล้ว การตอบกลับจะไม่มีแถวสำหรับ timeInterval ในช่วงเวลาที่ระบุของชุดตัวกรองซึ่งเมตริกทั้งหมดเป็น 0

แสดงรายการเมตริกการเสนอราคาระดับบัญชี

คุณสามารถสร้างรายการเมตริกการเสนอราคาระดับบัญชีสำหรับชุดตัวกรองหนึ่งๆ โดยการส่ง HTTP GET คำขอไปยัง URI ทรัพยากร bidders.accounts.filtersets.bidMetrics ซึ่งมีพารามิเตอร์ รูปแบบต่อไปนี้:

GET https://adexchangebuyer.googleapis.com/v2beta1/bidders/{bidder resource ID}/accounts/{account resource ID}/filterSets/{filter set resource ID}/bidMetrics

คำขอ

ต่อไปนี้เป็นตัวอย่างที่แสดงเมตริกการเสนอราคาระดับบัญชี

GET https://adexchangebuyer.googleapis.com/v2beta1/bidders/12345678/accounts/87654321/filterSets/account-fs/bidMetrics

การตอบกลับ

หากคำขอประสบความสำเร็จ เซิร์ฟเวอร์จะตอบสนองด้วยรหัสสถานะ 200 OK และเนื้อความที่มีแถวของเมตริกสำหรับมิติข้อมูลและรายละเอียดที่ระบุ

{
  "bidMetricsRows": [{
      "bids": {
        "value": "1748"
      },
      "bidsInAuction": {
        "value": "1421"
      },
      "billedImpressions": {
        "value": "301"
      },
      "impressionsWon": {
        "value": "915"
      },
      "measurableImpressions": {
        "value": "298"
      },
      "rowDimensions": {
        "timeInterval": {
          "endTime": "2017-12-01T08:00:00Z",
          "startTime": "2017-11-30T08:00:00Z"
        }
      },
      "viewableImpressions": {
        "value": "172"
      }
    },
    {
      "bids": {
        "value": "6"
      },
      "bidsInAuction": {
        "value": "2"
      },
      "billedImpressions": {},
      "impressionsWon": {
        "value": "1"
      },
      "measurableImpressions": {},
      "rowDimensions": {
        "timeInterval": {
          "endTime": "2017-12-02T08:00:00Z",
          "startTime": "2017-12-01T08:00:00Z"
        }
      },
      "viewableImpressions": {}
    }
  ]
}

หมายเหตุ: ฟิลด์ที่ตั้งค่าเป็น 0 สำหรับเมตริกหนึ่งๆ จะไม่ปรากฏในการตอบกลับ ว่างเปล่า billedImpressions และ measurableImpressions เมตริกด้านบนหมายถึง กำหนดให้ทั้งค่าและความแปรปรวนเหล่านี้เป็น 0

คำเตือน: สำหรับการแจกแจงข้อมูลในคำตอบ คำตอบนั้นจะไม่รวม หากไม่มีเมตริกที่ไม่ใช่ 0 อย่างน้อย 1 แถว ตัวอย่างเช่น เมื่อ ระบุ timeSeriesGranularity แล้ว การตอบกลับจะไม่มีแถวสำหรับ timeInterval ในช่วงเวลาที่ระบุของชุดตัวกรองซึ่งเมตริกทั้งหมดเป็น 0