Google Ad Manager มี SOAP API ทั้งสำหรับการรายงานและการจัดการเอนทิตีการดูแลการแสดงโฆษณา เช่น LineItems
ไลบรารีของไคลเอ็นต์มีให้บริการในหลายภาษา Ad Manager API ใช้ OAuth2 สำหรับการตรวจสอบสิทธิ์เช่นเดียวกับ AdX Seller API
ดูวิธีเริ่มต้นใช้งานคำขอ API แรกได้ที่เริ่มต้นใช้งาน
การรายงานใน Ad Manager API
ReportService ของ Ad Manager API มี 2 วิธีในการเรียกใช้และดาวน์โหลดรายงาน ดังนี้
- สร้างการค้นหาใน UI และเรียกใช้ตามรหัส
- สร้าง ReportQuery เฉพาะกิจ
ไม่ว่าจะเลือกตัวเลือกใด เวิร์กโฟลว์ของ API จะประกอบด้วย 4 ขั้นตอนต่อไปนี้
- เรียกใช้ runReportJob
- สำรวจสถานะรายงานโดยใช้ getReportJobStatus
- รับ URL ของรายงานที่เสร็จสมบูรณ์โดยใช้ getReportDownloadUrlWithOptions
- ดาวน์โหลดรายงานจาก URL ที่แสดงผล
ดูรายละเอียดเพิ่มเติมได้ที่คู่มือการรายงาน
เขตเวลาในการรายงาน
รายงานใน Ad Manager API จะใช้เขตเวลาของเครือข่ายโดยค่าเริ่มต้น ซึ่งแตกต่างจาก Ad Exchange Seller REST API
หากต้องการเปลี่ยนแปลง ให้ตั้งค่าฟิลด์
TimeZoneType
การแมปเมตริกและมิติข้อมูลจาก AdX ไปยัง Ad Manager
ตอนนี้เมตริกและมิติข้อมูล REST API ของผู้ขาย Ad Exchange ที่รองรับทั้งหมด อยู่ใน Ad Manager Reporting API แล้ว ชื่อบางชื่อมีการเปลี่ยนแปลง และชื่อบางชื่อเลิกใช้งานแล้ว โปรดดูรายละเอียดในตารางด้านล่าง
เมตริก / คอลัมน์
ตารางนี้จะแมปเมตริก AdX กับคอลัมน์ Ad Manager
| เมตริก AdX | คอลัมน์ Ad Manager | ชื่อเครื่องมือ Query ของ Ad Manager |
|---|---|---|
| ACTIVE_VIEW_ELIGIBLE_COUNT | AD_EXCHANGE_ACTIVE_VIEW_ENABLED_IMPRESSIONS | การแสดงผลที่เปิดใช้มุมมองแอ็กทีฟ |
| ACTIVE_VIEW_MEASURABLE_COUNT | AD_EXCHANGE_ACTIVE_VIEW_MEASURED_IMPRESSIONS | การแสดงผลที่วัดได้ในมุมมองแอ็กทีฟ |
| ACTIVE_VIEW_MEASURABLE_RATIO | (เลิกใช้งานแล้ว) | (เลิกใช้งานแล้ว) |
| ACTIVE_VIEW_VIEWABLE_COUNT | AD_EXCHANGE_ACTIVE_VIEW_VIEWED_IMPRESSIONS | การแสดงผลในมุมมองแอ็กทีฟที่มองเห็นได้ |
| ACTIVE_VIEW_VIEWABLE_RATIO | (เลิกใช้งานแล้ว) | (เลิกใช้งานแล้ว) |
| ACTIVE_VIEW_VIEWABLE_TIME | AD_EXCHANGE_AVERAGE_VIEWABLE_TIME | เวลาที่มองเห็นได้โดยเฉลี่ย (วินาที) |
| AD_IMPRESSIONS | AD_EXCHANGE_IMPRESSIONS | การแสดงโฆษณา |
| AD_IMPRESSIONS_RPM | AD_EXCHANGE_AD_ECPM | eCPM โฆษณา |
| AD_REQUESTS | AD_EXCHANGE_AD_REQUESTS | คำขอโฆษณา |
| AD_REQUESTS_COVERAGE | AD_EXCHANGE_COVERAGE | ความครอบคลุม |
| AD_REQUESTS_CTR | AD_EXCHANGE_AD_REQUEST_CTR | CTR คำขอโฆษณา |
| AD_REQUESTS_RPM | AD_EXCHANGE_AD_REQUEST_ECPM | eCPM คำขอโฆษณา |
| จำนวนคลิก | AD_EXCHANGE_CLICKS | การคลิก |
| COST_PER_CLICK | AD_EXCHANGE_CPC | CPC |
| DEALS_AD_REQUESTS | AD_EXCHANGE_DEALS_AD_REQUESTS | คำขอโฆษณาของดีล |
| DEALS_BID_RESPONSES | AD_EXCHANGE_DEALS_BID_RESPONSES | การเสนอราคาตอบของดีล |
| DEALS_MATCH_RATE | AD_EXCHANGE_DEALS_MATCH_RATE | อัตราการจับคู่ของดีล |
| DEALS_MATCHED_REQUESTS | AD_EXCHANGE_DEALS_MATCHED_REQUESTS | คำขอที่ตรงกันของดีล |
| รายได้ | AD_EXCHANGE_ESTIMATED_REVENUE | รายได้โดยประมาณ |
| INDIVIDUAL_AD_IMPRESSIONS | (เลิกใช้งานแล้ว) | (เลิกใช้งานแล้ว) |
| INDIVIDUAL_AD_IMPRESSIONS_CTR | AD_EXCHANGE_AD_CTR | CTR ของโฆษณา |
| INDIVIDUAL_AD_IMPRESSIONS_RPM | (คำแนะนำใหม่) AD_EXCHANGE_AD_ECPM | (คำแนะนำใหม่) eCPM โฆษณา |
| LIFT_RATE | AD_EXCHANGE_LIFT | การเพิ่ม |
| MATCHED_AD_REQUESTS | AD_EXCHANGE_MATCHED_REQUESTS | คำขอที่ตรงกัน |
| MATCHED_AD_REQUESTS_CTR | AD_EXCHANGE_CTR | CTR |
| MATCHED_AD_REQUESTS_RPM | AD_EXCHANGE_MATCHED_ECPM | eCPM ที่ตรงกัน |
| VIDEO_AD_ABANDONMENT_RATIO | AD_EXCHANGE_VIDEO_ABANDONMENT_RATE | อัตราการหยุดวิดีโอกลางคัน |
| VIDEO_AD_DROPOFF_RATIO | AD_EXCHANGE_VIDEO_DROPOFF_RATE | อัตราการออกจากวิดีโอ |
| VIDEO_AD_QUARTILE_ONE | AD_EXCHANGE_VIDEO_QUARTILE_1 | ควอร์ไทล์ที่ 1 ของวิดีโอ |
| VIDEO_AD_QUARTILE_THREE | AD_EXCHANGE_VIDEO_QUARTILE_3 | ควอร์ไทล์ที่ 3 ของวิดีโอ |
| VIDEO_AD_SKIPPABLE_SKIP_RATIO | AD_EXCHANGE_VIDEO_TRUEVIEW_SKIP_RATE | อัตราการข้าม TrueView |
| VIDEO_AD_SKIPPABLE_VIEWS | AD_EXCHANGE_VIDEO_TRUEVIEW_VIEWS | ยอดดู TrueView |
| VIDEO_AD_SKIPPABLE_VTR | AD_EXCHANGE_VIDEO_TRUEVIEW_VTR | VTR ของ TrueView |
ขนาด
ตารางนี้จะแมปมิติข้อมูล AdX กับมิติข้อมูล Ad Manager
| มิติข้อมูล AdX | มิติข้อมูล Ad Manager | ชื่อเครื่องมือ Query ของ Ad Manager |
|---|---|---|
| AD_CLIENT_ID | AD_EXCHANGE_WEB_PROPERTY_CODE | ผลิตภัณฑ์และบริการบนอินเทอร์เน็ต |
| AD_LOCATION | AD_EXCHANGE_AD_LOCATION | ตำแหน่งของโฆษณา |
| AD_TAG_NAME | AD_EXCHANGE_TAG_NAME | แท็ก |
| AD_UNIT_SIZE_CODE | AD_EXCHANGE_INVENTORY_SIZE_CODE | (ไม่พร้อมใช้งาน) |
| AD_UNIT_SIZE_NAME | AD_EXCHANGE_INVENTORY_SIZE | ขนาดพื้นที่โฆษณา |
| ADVERTISER_DOMAIN | AD_EXCHANGE_ADVERTISER_DOMAIN | โดเมนของผู้ลงโฆษณา |
| ADVERTISER_NAME | AD_EXCHANGE_ADVERTISER_NAME | ผู้ลงโฆษณา |
| ADVERTISER_VERTICAL | AD_EXCHANGE_ADVERTISER_VERTICAL | ประเภทธุรกิจของผู้ลงโฆษณา |
| AGENCY_NAME | AD_EXCHANGE_AGENCY | เอเจนซี |
| BID_TYPE_CODE | AD_EXCHANGE_BID_TYPE_CODE | (ไม่พร้อมใช้งาน) |
| BRAND_NAME | AD_EXCHANGE_BRAND_NAME | แบรนด์ |
| BRANDING_TYPE_CODE | AD_EXCHANGE_BRANDING_TYPE_CODE | (ไม่พร้อมใช้งาน) |
| BRANDING_TYPE_NAME | AD_EXCHANGE_BRANDING_TYPE | ประเภทการสร้างแบรนด์ |
| BUYER_NETWORK_ID | AD_EXCHANGE_BUYER_NETWORK_ID | (ไม่พร้อมใช้งาน) |
| BUYER_NETWORK_NAME | AD_EXCHANGE_BUYER_NETWORK_NAME | เครือข่ายของผู้ซื้อ |
| COUNTRY_CODE | AD_EXCHANGE_COUNTRY_CODE | (ไม่พร้อมใช้งาน) |
| COUNTRY_NAME | AD_EXCHANGE_COUNTRY_NAME | ประเทศ |
| CREATIVE_SIZE | AD_EXCHANGE_CREATIVE_SIZES | ขนาดโฆษณา |
| CUSTOM_CHANNEL_CODE | AD_EXCHANGE_CUSTOM_CHANNEL_CODE | (ไม่พร้อมใช้งาน) |
| CUSTOM_CHANNEL_ID | AD_EXCHANGE_CUSTOM_CHANNEL_ID | (ไม่พร้อมใช้งาน) |
| CUSTOM_CHANNEL_NAME | AD_EXCHANGE_CHANNEL_NAME | ช่อง |
| DATE | AD_EXCHANGE_DATE | วัน |
| DEAL_ID | AD_EXCHANGE_DEAL_ID | รหัสดีล |
| DEAL_NAME | AD_EXCHANGE_DEAL_NAME | ชื่อดีล |
| DFP_AD_UNIT_ID | AD_EXCHANGE_DFP_AD_UNIT_ID | (ไม่พร้อมใช้งาน) |
| DFP_AD_UNITS | AD_EXCHANGE_DFP_AD_UNIT | หน่วยโฆษณา DFP |
| DFP_REQUEST_SOURCE | AD_EXCHANGE_REQUEST_SOURCES | แหล่งที่มาของคำขอ |
| DOMAIN_NAME | AD_EXCHANGE_SITE_NAME | Sites |
| DSP_NAME | AD_EXCHANGE_DSP_BUYER_NETWORK_NAME | DSP |
| EXPANSION_TYPE_NAME | AD_EXCHANGE_EXPANSION_TYPE | ประเภทที่ขยายได้ |
| INVENTORY_OWNERSHIP | AD_EXCHANGE_INVENTORY_OWNERSHIP | การเป็นเจ้าของพื้นที่โฆษณา |
| INVENTORY_PARTNER_NAME | AD_EXCHANGE_NETWORK_PARTNER_NAME | ชื่อพาร์ทเนอร์เครือข่าย |
| MOBILE_APP_NAME | AD_EXCHANGE_MOBILE_APP_NAME | ชื่อแอป |
| MOBILE_CARRIER_NAME | AD_EXCHANGE_MOBILE_CARRIER_NAME | ชื่อผู้ให้บริการ |
| MOBILE_DEVICE_NAME | AD_EXCHANGE_MOBILE_DEVICE_NAME | อุปกรณ์ |
| MOBILE_INVENTORY_TYPE | AD_EXCHANGE_MOBILE_INVENTORY_TYPE | ประเภทพื้นที่โฆษณา |
| MOBILE_OS_VERSION | AD_EXCHANGE_OPERATING_SYSTEM | ระบบปฏิบัติการ |
| MOBILE_USER_BANDWIDTH | AD_EXCHANGE_USER_BANDWIDTH_NAME | แบนด์วิดท์ |
| เดือน | AD_EXCHANGE_MONTH | เดือน |
| PLATFORM_TYPE_NAME | AD_EXCHANGE_DEVICE_CATEGORY | หมวดหมู่ของอุปกรณ์ |
| PRODUCT_CODE | AD_EXCHANGE_PRODUCT_CODE | (ไม่พร้อมใช้งาน) |
| PRODUCT_NAME | AD_EXCHANGE_PRODUCT_NAME | ผลิตภัณฑ์ |
| TARGETING_TYPE_CODE | AD_EXCHANGE_TARGETING_TYPE_CODE | (ไม่พร้อมใช้งาน) |
| TARGETING_TYPE_NAME | AD_EXCHANGE_TARGETING_TYPE | ประเภทการกำหนดเป้าหมาย |
| TRANSACTION_TYPE_CODE | AD_EXCHANGE_TRANSACTION_TYPE_CODE | (ไม่พร้อมใช้งาน) |
| TRANSACTION_TYPE_NAME | AD_EXCHANGE_TRANSACTION_TYPE | ประเภทธุรกรรม |
| URL_CHANNEL_ID | AD_EXCHANGE_URL_ID | (ไม่พร้อมใช้งาน) |
| URL_CHANNEL_NAME | AD_EXCHANGE_URL | URL |
| VIDEO_AD_DURATION | AD_EXCHANGE_VIDEO_AD_DURATION | (ไม่พร้อมใช้งาน) |
| VIDEO_AD_DURATION_RAW | AD_EXCHANGE_VIDEO_AD_DURATION_RAW | ระยะเวลาของโฆษณาวิดีโอ |
| VIDEO_AD_FORMAT | AD_EXCHANGE_VIDEO_AD_TYPE | ประเภทโฆษณาวิดีโอ |
| สัปดาห์ | AD_EXCHANGE_WEEK | สัปดาห์ |
| WINNING_BID_RULE_ID | AD_EXCHANGE_PRICING_RULE_ID | (ไม่พร้อมใช้งาน) |
| WINNING_BID_RULE_NAME | AD_EXCHANGE_PRICING_RULE_NAME | กฎการกำหนดราคา |