คู่มือนี้ครอบคลุมทรัพยากรการแก้ปัญหา 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 เนื้อหาการตอบกลับจะรวมทรัพยากรชุดตัวกรองที่สร้างขึ้น ซึ่งจะเหมือนกับชุดตัวกรองที่ส่งในคำขอ
รับชุดตัวกรอง
เมธอดการรับจะรับชุดตัวกรองได้ในระดับเดียวกับที่สร้างขึ้นเท่านั้น เช่น บัญชีผู้เสนอราคาควรใช้ 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
ใช้เพื่อเรียกข้อมูลเมตริกที่วัดในจำนวนราคาเสนอ ตัวอย่างเช่น คุณใช้ราคาเสนอนี้เพื่อกําหนดจํานวนราคาเสนอทั้งหมดใน
ช่วงเวลาที่ระบุ และจํานวนราคาเสนอที่ไม่ได้ถูกกรองออกจากการประมูล ชนะการแสดงผลได้
เช่นเดียวกับทรัพยากรการแก้ปัญหา 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