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 จะใช้เขตเวลาของเครือข่ายของคุณโดยค่าเริ่มต้น ซึ่งต่างจาก REST API สำหรับผู้ขายของ Ad Exchange หากต้องการเปลี่ยนการตั้งค่านี้ ให้ตั้งค่าช่อง TimeZoneType
เมตริกและการแมปมิติข้อมูลจาก AdX ไปยัง Ad Manager
ตอนนี้มิติข้อมูลและเมตริก REST API สำหรับผู้ขายของ Ad Exchange ที่รองรับทั้งหมดแสดงอยู่ใน API การรายงานของ Ad Manager แล้ว บางชื่อมีการเปลี่ยนแปลง และบางรายการถูกเลิกใช้ โปรดดูรายละเอียดในตารางด้านล่าง
เมตริก / คอลัมน์
ตารางนี้แมปเมตริก 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 | ช่อง |
| วันที่ | 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 | กฎการกำหนดราคา |