คู่มือนี้ครอบคลุมทรัพยากรการแก้ปัญหา 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