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

ชุดตัวกรอง

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

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

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

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

เมื่อสร้างชุดตัวกรอง คุณต้องระบุช่วงเวลาเป็น 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