หมายเหตุ
การเข้าถึงหน้านี้ต้องได้รับการอนุญาต คุณสามารถลอง ลงชื่อเข้าใช้หรือเปลี่ยนไดเรกทอรีได้
การเข้าถึงหน้านี้ต้องได้รับการอนุญาต คุณสามารถลองเปลี่ยนไดเรกทอรีได้
บริการการรายงานประกอบด้วยการดําเนินการที่คุณใช้ในการส่งคําขอรายงานและสํารวจความคิดเห็นสําหรับสถานะ รายงานมีสถิติโดยละเอียดเกี่ยวกับบัญชี แคมเปญ และกลุ่มโฆษณาของ Microsoft Advertising ข้อมูลนี้สามารถช่วยคุณติดตามการเงิน วัดประสิทธิภาพโฆษณา และปรับการตั้งค่าเพื่อปรับงบประมาณหรือแคมเปญของคุณให้เหมาะสม ตัวอย่างเช่น คุณสามารถใช้รายงานประสิทธิภาพของคําสําคัญเพื่อดูว่าคําหลักใดทํางานได้ดีและคําใดไม่มีประสิทธิภาพ
ภาพรวมบริการการรายงาน
เมื่อส่งคําขอรายงาน คุณจะเลือก แอตทริบิวต์ของรายงานและสถิติประสิทธิภาพเพื่อ กําหนดเนื้อหาของรายงาน ตัวอย่างเช่น คุณอาจต้องการรวมการแสดงผล การคลิก และอัตราการคลิกผ่าน รายงานจะใช้ชื่อคอลัมน์เป็นส่วนหัวของคอลัมน์ รายงานจะรวมคอลัมน์ตามลําดับเดียวกับที่คุณรวมไว้ในองค์ประกอบ คอลัมน์ ของการร้องขอรายงาน สําหรับข้อมูลเกี่ยวกับวิธีที่คอลัมน์มีผลต่อผลลัพธ์ข้อมูล ให้ดู คอลัมน์ที่จัดกลุ่มข้อมูล ทางด้านล่าง สําหรับข้อมูลเพิ่มเติมเกี่ยวกับข้อจํากัดของการรวมคอลัมน์ในคําขอรายงานเดียวกัน ให้ดูที่ ข้อจํากัดของคอลัมน์ ด้านล่าง
นอกจากนี้ คุณจะต้องระบุพารามิเตอร์รายงานที่จํากัดหรือจํากัดชุดข้อมูลที่ส่งกลับ ตัวอย่างเช่น คุณสามารถตั้งค่าระดับการรวมเพื่อจัดกลุ่มข้อมูลตามวันหรือเดือน ระบุช่วงเวลาของข้อมูลที่จะรวมอยู่ในรายงานโดยใช้วันที่ที่เฉพาะเจาะจงหรือช่วงวันที่ที่กําหนดไว้ล่วงหน้า เช่น วันนี้หรือเจ็ดวันที่ผ่านมา ระบุขอบเขตของข้อมูลโดยการระบุบัญชี แคมเปญ และกลุ่มโฆษณาที่จะรวมอยู่ในรายงาน และตั้งค่าเกณฑ์การกรองเพื่อกรองข้อมูลรายงาน สําหรับข้อมูลเกี่ยวกับช่วงเวลาที่คุณสามารถระบุสําหรับแต่ละค่าของการรวม ให้ดูที่ การรวมและเวลา ทางด้านล่าง
สําหรับรายการของรายงานที่คุณสามารถร้องขอได้ ให้ดูที่ ชนิดรายงาน สําหรับรายการพารามิเตอร์รายงานทั้งหมดที่คุณสามารถตั้งค่าได้ ให้ดูวัตถุการร้องขอรายงานแต่ละรายการและวัตถุฐาน ReportRequest
สําหรับข้อมูลเกี่ยวกับวิธีการร้องขอและดาวน์โหลดรายงาน ให้ดูที่ ร้องขอและดาวน์โหลดรายงานเมื่อรายงานเสร็จสมบูรณ์ คุณสามารถดาวน์โหลดรายงานจาก URL ที่บริการส่งกลับมา ไฟล์รายงานถูกบีบอัด ดังนั้นคุณต้อง unzip ไฟล์เพื่ออ่านรายงาน ไม่มีการจํากัดจํานวนรายงานที่ระบบสามารถจัดเก็บได้ อย่างไรก็ตาม ระยะเวลาในการจัดเก็บรายงานนั้นจะไม่มีการกําหนดไว้ บริการจะไม่ตรวจหาคําขอรายงานซ้ํา
สําหรับข้อมูลเกี่ยวกับสิ่งที่โซนเวลามีผลต่อความพร้อมใช้งานของรายงาน ให้ดูที่ โซนเวลาในการรายงาน ทางด้านล่าง
Schema ไฟล์รายงาน
คุณสามารถร้องขอข้อมูลรายงาน Csv, Tsv หรือ XML ได้ ตามค่าเริ่มต้น ถ้าคุณไม่ได้เลือก รูปแบบ อื่น ข้อมูลที่ดาวน์โหลดจะถูกแบ่งด้วยจุลภาค (Csv)
"Report Name: My Keyword Performance Report"
"Report Time: 2/7/2020"
"Time Zone: (GMT-08:00) Pacific Time (US & Canada); Tijuana"
"Last Completed Available Day: 2/8/2020 10:15:00 PM (GMT)"
"Last Completed Available Hour: 2/8/2020 10:15:00 PM (GMT)"
"Report Aggregation: Summary"
"Report Filter: "
"Potential Incomplete Data: true"
"Rows: 5"
"AccountId","CampaignId","Keyword","KeywordId","DeviceType","Clicks"
"YourAccountId","YourCampaignId","red shoes","123","Computer","35"
"YourAccountId","YourCampaignId","red shoes","123","Smartphone","50"
"YourAccountId","YourCampaignId","shoes delivered","234","Computer","1"
"YourAccountId","YourCampaignId","shoe sale","345","Computer","80"
"YourAccountId","YourCampaignId","shoe sale","345","Smartphone","5"
"@2020 Microsoft Corporation. All rights reserved. "
Metadata ส่วนหัวรายงานต่อไปนี้จะถูกรวมด้วยตามค่าเริ่มต้น ถ้าคุณไม่ต้องการให้เมตาดาต้าส่วนหัว ให้ตั้งค่า ExcludeReportHeader เป็น true
| Metadata ส่วนหัว | คำอธิบาย |
|---|---|
| ชื่อรายงาน | ชื่อรายงานที่คุณเลือกเมื่อส่งรายงาน |
| เวลารายงาน | เวลาของรายงานที่คุณเลือกเมื่อส่งรายงาน หากมีการร้องขอหลายวัน วันที่เริ่มต้นและวันที่สิ้นสุดจะถูกคั่นด้วยเครื่องหมายจุลภาค เช่น "เวลารายงาน: 1/2/2020, 7/2/2020" |
| โซนเวลา | ระบุว่าโซนเวลาใดที่ใช้ในการกําหนดจุดสิ้นสุดของวันสุดท้ายของเวลารายงานที่ร้องขอ สําหรับข้อมูลเกี่ยวกับสิ่งที่โซนเวลามีผลต่อความพร้อมใช้งานของรายงาน ให้ดูที่ โซนเวลาในการรายงาน ทางด้านล่าง |
| วันที่พร้อมใช้งานเสร็จสมบูรณ์ล่าสุด | วันที่และเวลาล่าสุดที่ Microsoft Advertising ประมวลผลข้อมูลสําหรับชนิดรายงานนี้เสร็จแล้ว เวลาจะถูกรายงานโดยสัมพันธ์กับ UTC เสมอ ดังนั้นโปรดละเว้นคําต่อท้าย (GMT) ที่เขียนไว้ในรายงาน |
| ชั่วโมงที่พร้อมใช้งานเสร็จสมบูรณ์ล่าสุด | วันที่และเวลาล่าสุดที่ Microsoft Advertising ประมวลผลข้อมูลสําหรับชนิดรายงานนี้เสร็จแล้ว เวลาจะถูกรายงานโดยสัมพันธ์กับ UTC เสมอ ดังนั้นโปรดละเว้นคําต่อท้าย (GMT) ที่เขียนไว้ในรายงาน |
| การรวมรายงาน | แสดงชนิดการรวมที่ตั้งค่าไว้ในคําขอรายงาน สําหรับข้อมูล โปรดดู การรวมและเวลา ด้านล่าง |
| ตัวกรองรายงาน | สงวนไว้สําหรับใช้ในอนาคต |
| ข้อมูลที่ไม่สมบูรณ์ที่อาจเกิดขึ้น | ถ้าถูกตั้งค่าเป็น true ข้อมูลรายงานอาจไม่ได้รับการประมวลผลอย่างสมบูรณ์สําหรับวันสุดท้ายของเวลารายงานที่ร้องขอ องค์ประกอบการร้องขอ ReturnOnlyCompleteData จะระบุว่าบริการต้องตรวจสอบให้แน่ใจว่าข้อมูลทั้งหมดได้รับการประมวลผลและพร้อมใช้งานหรือไม่ สําหรับข้อมูลเกี่ยวกับสิ่งที่โซนเวลามีผลต่อความพร้อมใช้งานของรายงาน ให้ดูที่ โซนเวลาในการรายงาน ทางด้านล่าง |
| แถว | จํานวนของข้อมูลระเบียนรายงาน ไม่รวมบรรทัดว่าง ส่วนหัว ชื่อคอลัมน์ และส่วนท้าย Metadata Metadata นี้ไม่มีอยู่ในรายงาน XML |
ชื่อคอลัมน์รายงาน เช่น "AccountId","CampaignId","Keyword","KeywordId","DeviceType","Clicks" จะถูก รวมไว้ตามค่าเริ่มต้น ถ้าคุณไม่ต้องการให้คอลัมน์รายงาน ให้ตั้งค่า ExcludeColumnHeaders เป็น true
เมตาดาต้าส่วนท้ายของรายงาน เช่น @2020 Microsoft Corporation All rights reserved. จะถูกรวมตามค่าเริ่มต้น ถ้าคุณไม่ต้องการให้เมตาดาต้าส่วนท้าย ให้ตั้งค่า ExcludeReportFooter เป็น true
เวอร์ชันของรูปแบบรายงาน
รูปแบบข้อมูลสําหรับบางฟิลด์สามารถอัปเดตได้ภายใน API เวอร์ชันปัจจุบันโดยไม่ทําให้แอปพลิเคชันไคลเอ็นต์ที่มีอยู่เสียหาย คุณสามารถรับรูปแบบข้อมูลล่าสุดโดยการตั้งค่าเขตข้อมูลคําขอ FormatVersion เพิ่มเติม ตารางด้านล่างจะสรุปความแตกต่างระหว่างรูปแบบเวอร์ชัน 1.0 และ 2.0
| คำอธิบาย | คอลัมน์รายงาน | ตัวอย่าง FormatVersion 1.0 | ตัวอย่าง FormatVersion 2.0 |
|---|---|---|---|
| ตัวคั่นกลุ่มหลักพัน (จุลภาค) ถูกเอาออก | AllRevenue แอสซิสต์ ExtendedCost รายได้ |
1,000.00 | 1000.00 |
| ความแม่นยําได้รับการอัปเดตจาก 4 หลักเป็น 2 หลัก | คุณภาพต่ําคลิกเปอร์เซ็นต์ คุณภาพต่ําเปอร์เซ็นต์การแสดงผล พีทีอาร์ |
12.3400 | 12.34 |
| ความแม่นยําได้รับการอัปเดตจาก 0 หลักเป็น 2 หลัก | AbsoluteTopImpressionShareLostToBudgetPercent AbsoluteTopImpressionShareLostToRankPercent ExactMatchImpressionSharePercent ImpressionLostToBudgetPercent ImpressionLostToRankAggPercent เปอร์เซ็นต์ความประทับใจแชร์ TopImpressionShareLostToBudgetPercent TopImpressionShareLostToRankPercent |
12 | 12.34 |
| รูปแบบรายงานรายชั่วโมงที่อัปเดตจาก "mm/dd/yyyy 12:00:00 AM|hour" เป็น "yyyy-mm-dd|hour" รูปแบบนี้ใช้ได้กับคอลัมน์ TimePeriod เท่านั้น ถ้าการรวมรายงานถูกตั้งค่าเป็นรายชั่วโมง | ระยะเวลา | "15/3/2020 12:00:00 AM|7" | "2020-03-15|7" |
คอลัมน์ที่จัดกลุ่มข้อมูล
คอลัมน์แอตทริบิวต์ที่คุณรวมไว้ในรายงานจะมีผลต่อค่าภายในคอลัมน์สถิติ เช่นเดียวกับจํานวนหรือแถว ตัวอย่างเช่น หากคุณร้องขอรายงานสรุปที่มีเฉพาะ AccountId,CampaignId, Keyword, KeywordId และ Clicks คอลัมน์การคลิกจะมีจํานวนการคลิกคําสําคัญโดยไม่คํานึงถึงแอตทริบิวต์ที่แยกออก เช่น อุปกรณ์ ประเภทการจับคู่ และเครือข่าย
"Report Name: My Keyword Performance Report"
"Report Time: 2/7/2020"
"Time Zone: (GMT-08:00) Pacific Time (US & Canada); Tijuana"
"Last Completed Available Day: 2/8/2020 2:55:00 PM (GMT)"
"Last Completed Available Hour: 2/8/2020 2:55:00 PM (GMT)"
"Report Aggregation: Summary"
"Report Filter: "
"Potential Incomplete Data: true"
"Rows: 3"
"AccountId","CampaignId","Keyword","KeywordId","Clicks"
"YourAccountId","YourCampaignId","red shoes","123","95"
"YourAccountId","YourCampaignId","shoes delivered","234","1"
"YourAccountId","YourCampaignId","shoe sale","345","98"
"@2020 Microsoft Corporation. All rights reserved. "
ถ้าคุณรวมคอลัมน์ DeviceType ไว้ รายงานจะมีแถวสําหรับการรวมกันของแต่ละค่าคําสําคัญและชนิดอุปกรณ์ และค่าในคอลัมน์การคลิกสําหรับแต่ละแถวจะถูกแบ่งย่อยตามนั้น
"Report Name: My Keyword Performance Report"
"Report Time: 2/7/2020"
"Time Zone: (GMT-08:00) Pacific Time (US & Canada); Tijuana"
"Last Completed Available Day: 2/8/2020 2:55:00 PM (GMT)"
"Last Completed Available Hour: 2/8/2020 2:55:00 PM (GMT)"
"Report Aggregation: Summary"
"Report Filter: "
"Potential Incomplete Data: true"
"Rows: 7"
"AccountId","CampaignId","Keyword","KeywordId","DeviceType","Clicks"
"YourAccountId","YourCampaignId","red shoes","123","Computer","35"
"YourAccountId","YourCampaignId","red shoes","123","Smartphone","50"
"YourAccountId","YourCampaignId","red shoes","123","Tablet","10"
"YourAccountId","YourCampaignId","shoes delivered","234","Computer","1"
"YourAccountId","YourCampaignId","shoe sale","345","Computer","80"
"YourAccountId","YourCampaignId","shoe sale","345","Smartphone","5"
"YourAccountId","YourCampaignId","shoe sale","345","Tablet","13"
"@2020 Microsoft Corporation. All rights reserved. "
สําหรับข้อมูลเพิ่มเติมเกี่ยวกับคอลัมน์ที่พร้อมใช้งานแต่ละชนิด ให้ดูที่ แอตทริบิวต์รายงานและสถิติประสิทธิภาพ
แอตทริบิวต์ TimePeriod เป็นสิ่งจําเป็นสําหรับรายงานส่วนใหญ่ ดังนั้นคุณควรพิจารณาด้วยว่าการระบุระยะเวลาของการรวมที่ละเอียดยิ่งขึ้น ตัวอย่างเช่น รายเดือนในองค์ประกอบ การรวม ของคําขอรายงาน จะแบ่งข้อมูลการคลิกตามเดือนเพิ่มเติม ตัวอย่างเช่น รายงานจะมีแถวสําหรับการรวมกันของคําสําคัญ อุปกรณ์ และเดือนที่ไม่ซ้ํากัน แถวนี้จะรวมเฉพาะเดือนที่มีการคลิกเท่านั้น
ข้อจํากัดของคอลัมน์
สําหรับรายงานที่มีคอลัมน์สถิติประสิทธิภาพส่วนแบ่งการแสดงผล คุณจะไม่สามารถรวมแอตทริบิวต์ที่มีข้อจํากัดในคําขอรายงานเดียวกันได้ หากคุณรวมคอลัมน์สถิติประสิทธิภาพส่วนแบ่งการแสดงโฆษณาใดๆ ไว้ คุณจะต้องไม่รวมคอลัมน์แอตทริบิวต์ด้านล่างทั้งหมด ในทํานองเดียวกัน หากคุณรวมคอลัมน์แอตทริบิวต์ด้านล่างใดๆ ไว้ด้วย คุณจะต้องไม่รวมคอลัมน์สถิติประสิทธิภาพส่วนแบ่งการแสดงผลทั้งหมด
คอลัมน์ประสิทธิภาพแอตทริบิวต์และส่วนแบ่งการแสดงผลต่อไปนี้จะแยกไม่เหมือนกันเมื่อส่ง AccountPerformanceReportRequest และ AdGroupPerformanceReportRequest
หมายเหตุ
นอกจากนี้ ถ้าคุณรวมคอลัมน์ AudienceImpressionLostToBudgetPercent, AudienceImpressionLostToRankPercent, AudienceImpressionSharePercent หรือ RelativeCtr ใดๆ ไว้ด้วย คุณจะต้องแยกคอลัมน์แอตทริบิวต์ CustomerId, CustomerName และ DeliveredMatchType ออกไป และในทางกลับกันด้วย
| แอตทริบิวต์ | สถิติประสิทธิภาพส่วนแบ่งการแสดงโฆษณา |
|---|---|
| BidMatchType DeviceOS เป้าหมาย GoalType TopVs อื่นๆ |
AbsoluteTopImpressionRatePercent AbsoluteTopImpressionShareLostToBudgetPercent AbsoluteTopImpressionShareLostToRankPercent AbsoluteTopImpressionSharePercent AudienceImpressionLostToBudgetPercent AudienceImpressionLostToRankPercent AudienceImpressionSharePercent ClickSharePercent ExactMatchImpressionSharePercent ImpressionLostToBudgetPercent ImpressionLostToRankAggPercent เปอร์เซ็นต์ความประทับใจแชร์ RelativeCtr |
แอตทริบิวต์และคอลัมน์สถิติประสิทธิภาพส่วนแบ่งการแสดงผลต่อไปนี้ไม่เหมือนกันเมื่อส่ง CampaignPerformanceReportRequest
หมายเหตุ
นอกจากนี้ ถ้าคุณรวมคอลัมน์ AudienceImpressionLostToBudgetPercent, AudienceImpressionLostToRankPercent, AudienceImpressionSharePercent หรือ RelativeCtr ใดๆ ไว้ด้วย คุณจะต้องแยกคอลัมน์แอตทริบิวต์ CustomerId, CustomerName และ DeliveredMatchType ออกไป และในทางกลับกันด้วย
| แอตทริบิวต์ | สถิติประสิทธิภาพส่วนแบ่งการแสดงโฆษณา |
|---|---|
| BidMatchType BudgetAssociationStatus BudgetName BudgetStatus DeviceOS เป้าหมาย GoalType TopVs อื่นๆ |
AbsoluteTopImpressionRatePercent AbsoluteTopImpressionShareLostToBudgetPercent AbsoluteTopImpressionShareLostToRankPercent AbsoluteTopImpressionSharePercent AudienceImpressionLostToBudgetPercent AudienceImpressionLostToRankPercent AudienceImpressionSharePercent ClickSharePercent ExactMatchImpressionSharePercent ImpressionLostToBudgetPercent ImpressionLostToRankAggPercent เปอร์เซ็นต์ความประทับใจแชร์ RelativeCtr TopImpressionRatePercent TopImpressionShareLostToBudgetPercent TopImpressionShareLostToRankPercent TopImpressionSharePercent |
แอตทริบิวต์ต่อไปนี้ถูกจํากัดเมื่อส่ง HotelDimensionPerformanceReportRequest
| แอตทริบิวต์ |
|---|
| AdId |
แอตทริบิวต์ต่อไปนี้จะถูกจํากัดเมื่อส่ง HotelGroupPerformanceReportRequest
| แอตทริบิวต์ |
|---|
| AdId |
แอตทริบิวต์และคอลัมน์สถิติประสิทธิภาพส่วนแบ่งการแสดงผลต่อไปนี้จะไม่เหมือนกันเมื่อส่ง ProductDimensionPerformanceReportRequest
| แอตทริบิวต์ | สถิติประสิทธิภาพส่วนแบ่งการแสดงโฆษณา |
|---|---|
| AdDistribution AdId AdStatus ClickType ClickTypeId เป้าหมาย GoalType ภาษา LocalStoreCode เครือข่าย TopVs อื่นๆ |
AbsoluteTopImpressionShareLostToBudgetPercent AbsoluteTopImpressionShareLostToRankPercent AbsoluteTopImpressionSharePercent BenchmarkBid BenchmarkCtr ClickSharePercent ImpressionLostToBudgetPercent ImpressionLostToRankPercent เปอร์เซ็นต์ความประทับใจแชร์ TopImpressionShareLostToBudgetPercent TopImpressionShareLostToRankPercent TopImpressionSharePercent |
แอตทริบิวต์และคอลัมน์สถิติประสิทธิภาพการแบ่งการแสดงผลต่อไปนี้จะไม่เหมือนกันเมื่อส่ง ProductPartitionPerformanceReportRequest
| แอตทริบิวต์ | สถิติประสิทธิภาพส่วนแบ่งการแสดงโฆษณา |
|---|---|
| AdDistribution AdId AdStatus BidMatchType ClickType ClickTypeId DeliveredMatchType เป้าหมาย GoalType ภาษา LocalStoreCode เครือข่าย TopVs อื่นๆ |
AbsoluteTopImpressionSharePercent BenchmarkBid BenchmarkCtr ClickSharePercent ImpressionLostToBudgetPercent ImpressionLostToRankPercent เปอร์เซ็นต์ความประทับใจแชร์ |
คอลัมน์ ช่วงเวลา
ถ้าคุณรวมคอลัมน์ TimePeriod รูปแบบของค่าในรายงานที่ดาวน์โหลดจะแตกต่างกัน โดยขึ้นอยู่กับระดับ การรวมรายงานที่คุณ ระบุไว้ในคําขอรายงาน ตัวอย่างเช่น ถ้าระดับการรวมคือรายวัน แต่ละเขตข้อมูลในคอลัมน์ TimePeriod จะมีวันที่จัดรูปแบบเป็น yyyy-mm-dd
หมายเหตุ
เราไม่สนับสนุนการรวมข้อมูลบางส่วนสําหรับคอลัมน์ช่วงเวลารายสัปดาห์ รายเดือน และรายปี ถ้าวันที่ที่เลือกไม่ใช่สัปดาห์/เดือน/ปีแบบเต็ม และคอลัมน์ช่วงเวลารายสัปดาห์/รายเดือน/รายปีที่สอดคล้องกันมีการร้องขอ วันที่ที่เลือกจะถูกแปลงเป็นสัปดาห์/เดือน/ปี แบบเต็ม
| การรวม | คำอธิบาย |
|---|---|
| รายวัน | แต่ละแถวของรายงานจะระบุเดือน วัน และปีที่ธุรกรรมเกิดขึ้น ข้อมูลรายงานจะถูกรวมเข้าในแต่ละวัน ระยะเวลาจะถูกจัดรูปแบบเป็น yyyy-mm-dd |
| วันของสัปดาห์ | แต่ละแถวของรายงานจะระบุวันของสัปดาห์ที่ธุรกรรมเกิดขึ้น ข้อมูลรายงานจะถูกรวมตามแต่ละเจ็ดวันในหนึ่งสัปดาห์ ค่าข้อมูลที่เป็นไปได้คือ 1 - ,7 โดย 1 หมายถึงวันอาทิตย์และ 7 หมายถึงวันเสาร์ ถ้าเวลารายงานครอบคลุมหลายสัปดาห์ ข้อมูลประสิทธิภาพการทํางานในทุกสัปดาห์สําหรับวันใดวันหนึ่งของสัปดาห์จะถูกรวมไว้ในแถวเดียว ตัวอย่างเช่น หาก แคมเปญ A มีการแสดงผล 5 ครั้งทุกวันจันทร์ (วันที่ 2) ตลอด 3 สัปดาห์ที่รวมอยู่ในช่วงเวลาของรายงาน รายงานจะมีแถวหนึ่งโดยมี 2 ในคอลัมน์ช่วงเวลา และการแสดงผลในแถวนั้นรวมเป็น 15 |
| รายชั่วโมง | แต่ละแถวของรายงานจะระบุชั่วโมงที่ธุรกรรมเกิดขึ้น ข้อมูลรายงานจะถูกรวมตามแต่ละชั่วโมงของวัน ตามค่าเริ่มต้น ช่วงเวลาจะถูกจัดรูปแบบด้วยวันที่และชั่วโมง (ค่า int) ที่คั่นด้วยไปป์เดียว เช่น "mm/dd/yyyy 12:00:00 AM|hour" โดยที่ 12:00:00 AM สามารถละเว้นได้ ตัวอย่างเช่น ถ้าการคลิกเกิดขึ้นในวันที่ 15 มีนาคม 2020 ระหว่าง 07:00 และ 08:00 น. เขตข้อมูลในรายงานที่ดาวน์โหลดจะเป็น "3/15/2020 12:00:00 AM|7" ถ้าคุณตั้งค่ารายงาน FormatVersion เป็น "2.0" ระยะเวลาจะถูกจัดรูปแบบเป็น "yyyy-mm-dd|ชั่วโมง" ตัวอย่างเช่น ถ้าการคลิกเกิดขึ้นในวันที่ 15 มีนาคม 2020 ระหว่าง 07:00 และ 08:00 น. เขตข้อมูลในรายงานที่ดาวน์โหลดจะเป็น "2020-03-15|7" ค่าที่เป็นไปได้สําหรับคอมโพเนนต์ชั่วโมงคือ 0 - ,23 ถ้าเวลาของรายงานครอบคลุมหลายวัน ข้อมูลประสิทธิภาพสําหรับชั่วโมงที่ระบุจะถูกจัดให้แยกกันในหลายแถว กล่าวคือ รายงานจะมีหนึ่งแถวต่อวันและชั่วโมงที่ไม่ซ้ํากัน ตัวอย่างเช่น หาก แคมเปญ A มีการแสดงผล 5 ครั้งในช่วง ชั่วโมงที่ 7 ในแต่ละ 3 วันที่รวมอยู่ในช่วงเวลาของรายงาน รายงานจะมีแถวสามแถว แต่ละแถว โดยมีการแสดงโฆษณา 5 ครั้งสําหรับ ชั่วโมง ที่ 7 |
| ชั่วโมงของวัน | แต่ละแถวของรายงานจะระบุชั่วโมงของวันที่มีธุรกรรมเกิดขึ้น ข้อมูลรายงานจะถูกรวมตามแต่ละ 24 ชั่วโมงในทุกวัน ค่าที่เป็นไปได้คือ 0 - ,23 ถ้าเวลารายงานครอบคลุมหลายวัน ข้อมูลประสิทธิภาพการทํางานในทุกวันสําหรับชั่วโมงที่ระบุจะถูกรวมไว้ในแถวเดียว ตัวอย่างเช่นหาก แคมเปญ A มีการแสดงผล 5 ครั้งในระหว่างชั่วโมง ที่ 7 ในแต่ละ 3 วันที่รวมอยู่ในช่วงเวลาของรายงาน รายงานจะมีแถวหนึ่งที่มีการแสดงผลสําหรับ HourOfDay รวม 15 ครั้ง |
| รายเดือน | แต่ละแถวของรายงานจะระบุเดือนที่ธุรกรรมเกิดขึ้น ข้อมูลรายงานจะถูกรวมเป็นแบบของแต่ละเดือน ช่วงเวลาที่มีวันแรกของเดือนจะถูกจัดรูปแบบเป็น yyyy-mm-dd |
| รายสัปดาห์ | แต่ละแถวของรายงานจะระบุสัปดาห์ที่ธุรกรรมเกิดขึ้น ข้อมูลรายงานจะถูกรวมตามสัปดาห์ ช่วงเวลาที่มีวันที่ของวันอาทิตย์สําหรับแต่ละสัปดาห์จะถูกจัดรูปแบบเป็น yyyy-mm-dd |
| รายปี | แต่ละแถวของรายงานจะระบุปีที่ธุรกรรมเกิดขึ้น ข้อมูลรายงานจะถูกรวมตามแต่ละปี ช่วงเวลาที่มีปีจะถูกจัดรูปแบบเป็น yyyy |
การรวมและเวลา
สําหรับการร้องขอรายงานส่วนใหญ่ คุณต้องตั้งค่าองค์ประกอบ การรวม และ เวลา ต่อไปนี้คือช่วงเวลาที่คุณสามารถระบุสําหรับแต่ละค่าการรวม
| ค่าการรวม | ช่วงเวลา |
|---|---|
| รายวัน | วันนี้ เมื่อวานนี้ LastSevenDays เดือนนี้ เดือนที่แล้ว ช่วงวันที่แบบกําหนดเอง |
| วันของสัปดาห์ | วันนี้ เมื่อวานนี้ LastSevenDays เดือนนี้ เดือนที่แล้ว สามเดือนที่ผ่านมา LastSixMonths |
| รายชั่วโมง | วันนี้ เมื่อวานนี้ ช่วงวันที่แบบกําหนดเอง |
| ชั่วโมงของวัน | วันนี้ เมื่อวานนี้ LastSevenDays เดือนนี้ เดือนที่แล้ว สามเดือนที่ผ่านมา LastSixMonths |
| รายเดือน | เดือนนี้ เดือนที่แล้ว สามเดือนที่ผ่านมา LastSixMonths ปีนี้ ปีที่แล้ว ช่วงวันที่แบบกําหนดเอง |
| สรุป | วันนี้ เมื่อวานนี้ LastSevenDays เดือนนี้ เดือนที่แล้ว ช่วงวันที่แบบกําหนดเอง |
| รายสัปดาห์ | ThisWeek สัปดาห์ที่แล้ว LastFourWeeks เดือนนี้ เดือนที่แล้ว ปีนี้ ปีที่แล้ว ช่วงวันที่แบบกําหนดเอง |
| รายปี | ปีนี้ ปีที่แล้ว ช่วงวันที่แบบกําหนดเอง |
การแสดงประทับเป็นศูนย์
ข้อมูลรายงานสามารถรวมแถวที่มีการแสดงผลเป็นศูนย์หากการแสดงผลเกิดขึ้นก่อนระยะเวลาที่ขอ จากนั้นการดําเนินการที่ตามมา เช่น คลิก การแปลง หรือการติดต่อทางโทรศัพท์เกิดขึ้นระหว่างระยะเวลาที่ร้องขอ ในทํานองเดียวกัน แม้ภายในระยะเวลาที่ร้องขอ หากคุณดาวน์โหลดรายงานประสิทธิภาพรายวันเมื่อสัปดาห์ที่แล้ว ก็เป็นไปได้ว่าการแสดงผลทั้งหมดเกิดขึ้นในวันอาทิตย์ จากนั้นการคลิกหรือประสิทธิภาพอื่นๆ เกิดขึ้น เช่น วันจันทร์หรือวันอังคาร ข้อมูลรายงานสําหรับวันจันทร์หรือวันอังคารอาจมีการคลิกโดยไม่มีการแสดงผล คุณสามารถใช้บริการกลุ่มหรือบริการการจัดการแคมเปญเพื่อรับเอนทิตีทั้งหมดในบัญชีของคุณ โดยไม่คํานึงว่าเอนทิตีเหล่านั้นมีข้อมูลประสิทธิภาพที่เกี่ยวข้องหรือไม่
โซนเวลาในการรายงาน
ข้อมูลรายงานที่ดาวน์โหลดจะสัมพันธ์กับเวลา UTC เสมอ ตัวอย่างเช่น รายงานรายชั่วโมงอาจระบุการคลิก 5 ครั้งในชั่วโมงที่ 7 ในกรณีดังกล่าว การคลิก 5 ครั้งเกิดขึ้นระหว่าง 07:00 และ 08:00 UTC
องค์ประกอบการร้องขอ ReportTimeZone จะระบุโซนเวลาที่ใช้ในการสร้างวันที่ของวันนี้ เมื่อคุณส่งคําขอรายงาน วันที่ของวันนี้อาจแตกต่างกันไปทั่วโลกโดยขึ้นอยู่กับโซนเวลา ระยะเวลารายงานที่คุณเลือก เช่น 'เมื่อวานนี้' จะสัมพันธ์กับวันที่ของวันนี้ ถ้าคุณไม่เลือกโซนเวลา บริการการรายงานจะใช้ PacificTimeUSCanadaTijuana ตามค่าเริ่มต้น ตัวอย่างเช่น รายงานที่ร้องขอโดยไม่มีโซนเวลาที่ระบุเวลา 2 AM EasternTimeUSCanada ในวันที่ 2/2/2020 สําหรับ 'เมื่อวานนี้' จะถูกตีความเป็นคําขอสําหรับ 31/1/2020 รายงานที่ร้องขอในเวลาเดียวกันสําหรับ 'เมื่อวานนี้' ที่มีโซนเวลาตั้งเป็น EasternTimeUSCanada จะถูกตีความเป็นคําขอสําหรับวันที่ 2/1/2020
องค์ประกอบการร้องขอ ReturnOnlyCompleteData จะระบุว่าบริการต้องตรวจสอบให้แน่ใจว่าข้อมูลทั้งหมดได้รับการประมวลผลและพร้อมใช้งานหรือไม่ ถ้าถูกตั้งค่าเป็น true และถ้าระบบยังไม่เสร็จสิ้นการประมวลผลข้อมูลทั้งหมดตามการรวม ขอบเขต และเวลาที่ร้องขอ บริการจะส่งกลับรหัสข้อผิดพลาด NoCompleteDataAvaliable (2004) มิฉะนั้นตามค่าเริ่มต้นคําขอจะประสบความสําเร็จ จะไม่มีการบ่งชี้ว่าข้อมูลสมบูรณ์หรือไม่ และรายงานจะมีเฉพาะข้อมูลที่ระบบประมวลผลเสร็จแล้วในขณะที่มีการร้องขอ ในขณะที่วันนี้ยังดําเนินการ คุณสามารถรับข้อมูลล่าสุดได้โดยไม่ต้องร้องขอข้อมูลที่สมบูรณ์ จากนั้นหลังจากหนังสือปิดสําหรับวันนี้คุณอาจต้องการตั้งค่าสถานะนี้เป็นจริงและมองย้อนกลับไปที่ 'เมื่อวาน' ตอนนี้และรับข้อมูลรายงานขั้นสุดท้าย
หมายเหตุ
หากคุณขอรายงานสําหรับแคมเปญที่มีโซนเวลาที่แตกต่างกัน ข้อมูลจะถือว่าเสร็จสมบูรณ์หลังจากวันสิ้นสุดและประมวลผลข้อมูลการคลิกในโซนเวลาแคมเปญทั้งหมดแล้วเท่านั้น ตัวอย่างเช่น สมมติว่าคุณร้องขอรายงานที่มีแคมเปญ A (ซึ่งระบุโซนเวลา PST) และแคมเปญ B (ซึ่งระบุโซนเวลา EST) ข้อมูลยังไม่สมบูรณ์จนกว่าข้อมูลการคลิกทั้งหมดสําหรับแคมเปญ A จะได้รับการประมวลผลสําหรับช่วงเวลาที่ระบุ
เมื่อผู้ใช้คลิกโฆษณา ระบบอาจใช้เวลาถึงสองชั่วโมงในการประมวลผลการคลิก (3 ชั่วโมงสําหรับการแปลง) และเพื่อให้พร้อมใช้งานสําหรับการรายงาน โดยทั่วไปข้อมูลจะถือว่าสมบูรณ์ โดยหนังสือจะปิดหลัง 3 ชั่วโมง ในบางกรณียกเว้นเนื่องจากการรับส่งข้อมูลที่ไม่ถูกต้อง อาจมีการปรับเปลี่ยนที่ไม่คาดคิดซึ่งอาจใช้เวลาหนึ่งสัปดาห์หรือมากกว่าในการแก้ไข ตัวอย่างเช่น หากคําร้องเรียนของผู้ลงโฆษณาระบุกิจกรรมการคลิกที่ไม่ถูกต้องที่หลุดรอดจากระบบการกรองอัตโนมัติ ทีมคุณภาพการรับส่งข้อมูลและการสนับสนุนจะประมวลผลเครดิตไปยังบัญชีของผู้ลงโฆษณา และจะร่วมมือกับทีมภายในเพื่อตรวจสอบว่าพวกเขาสามารถอัปเดตระบบอัตโนมัติเพื่อปรับปรุงการตรวจสอบในอนาคตหรือไม่ สําหรับข้อมูลเพิ่มเติม โปรดดู ศูนย์คุณภาพการรับส่งข้อมูล
ตัวชี้วัดที่ได้รับการรับรองจาก MRC
เมตริกการคลิกโฆษณาในผลการค้นหาได้รับการรับรองโดย Media Rating Council (MRC) การรับรองนี้ไม่สามารถนําไปใช้กับเมตริกอื่นๆ ดู คําอธิบายของวิธีการวัดคลิก สําหรับข้อมูลเพิ่มเติม
ดูเพิ่มเติม
แอตทริบิวต์รายงานและสถิติประสิทธิภาพการทํางาน
ชนิดรายงาน
ร้องขอและดาวน์โหลดรายงาน
ที่อยู่บริการเว็บ Bing Ads API