แบบจําลองบริการการรายงาน

บริการการรายงานประกอบด้วยการดําเนินการที่คุณใช้เพื่อส่งคําขอรายงานและแบบสํารวจสําหรับสถานะของพวกเขา รายงานแสดงสถิติโดยละเอียดเกี่ยวกับบัญชีการโฆษณาของ Microsoft แคมเปญ และกลุ่มโฆษณา ข้อมูลสามารถช่วยให้คุณติดตามการเงิน วัดประสิทธิภาพโฆษณา และปรับการตั้งค่าเพื่อปรับงบประมาณหรือแคมเปญของคุณให้เหมาะสม ตัวอย่างเช่น คุณสามารถใช้รายงานประสิทธิภาพของคําหลักเพื่อดูว่าคําหลักใดทํางานได้ดีและคําหลักที่ไม่ได้ทํางานได้ดี

ภาพรวมของบริการการรายงาน

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

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

สําหรับรายการของรายงานที่คุณสามารถร้องขอได้ ดูชนิดรายงาน สําหรับรายการทั้งหมดของพารามิเตอร์รายงานที่คุณสามารถตั้งค่าดูแต่ละวัตถุคําขอรายงานและวัตถุฐาน ReportRequest

สําหรับข้อมูลเกี่ยวกับวิธีการร้องขอและดาวน์โหลดรายงาน ดู ร้องขอและดาวน์โหลดรายงานเมื่อรายงานเสร็จสมบูรณ์ คุณสามารถดาวน์โหลดรายงานจาก URL ที่บริการส่งกลับ ไฟล์รายงานถูกบีบอัด ดังนั้นคุณต้องคลายการบีบอัดไฟล์เพื่ออ่านรายงาน ไม่มีขีดจํากัดสําหรับจํานวนรายงานที่ระบบสามารถจัดเก็บได้ อย่างไรก็ตาม ไม่ได้กําหนดระยะเวลาที่จัดเก็บรายงาน บริการไม่ได้ตรวจสอบคําขอรายงานที่ซ้ํากัน

สําหรับข้อมูลเกี่ยวกับวิธีที่โซนเวลามีผลต่อความพร้อมใช้งานของรายงาน ดู โซนเวลาในการรายงาน ด้านล่าง

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. "

เมตาดาต้าส่วนหัวของรายงานต่อไปนี้จะรวมอยู่ตามค่าเริ่มต้น หากคุณไม่ต้องการให้เมตาดาต้าส่วนหัวตั้งค่า ExcludeReportHeaderเป็นจริง

เมตาดาต้าของส่วนหัว	คำอธิบาย
ชื่อรายงาน	ReportName ที่คุณเลือกเมื่อมีการส่งรายงาน
เวลารายงาน	เวลารายงานที่คุณเลือกเมื่อมีการส่งรายงาน ถ้ามีการร้องขอหลายวัน วันที่เริ่มต้นและสิ้นสุดจะถูกคั่นด้วยเครื่องหมายจุลภาค เช่น "เวลารายงาน: 2/1/2020, 2/7/2020"
โซนเวลา	ระบุโซนเวลาที่ใช้ในการกําหนดจุดสิ้นสุดของวันสุดท้ายของเวลารายงานที่ร้องขอ สําหรับข้อมูลเกี่ยวกับวิธีที่โซนเวลามีผลต่อความพร้อมใช้งานของรายงาน ดู โซนเวลาในการรายงาน ด้านล่าง
วันที่พร้อมใช้งานที่เสร็จสมบูรณ์ล่าสุด	วันที่และเวลาล่าสุดเมื่อ Microsoft Advertising ประมวลผลข้อมูลสําหรับรายงานประเภทนี้เสร็จสิ้น เวลาจะถูกรายงานเทียบกับ UTC เสมอ ดังนั้นโปรดละเว้นคําต่อท้าย (GMT) ที่เขียนในรายงาน
ชั่วโมงที่พร้อมใช้งานที่เสร็จสมบูรณ์ล่าสุด	วันที่และเวลาล่าสุดเมื่อ Microsoft Advertising ประมวลผลข้อมูลสําหรับรายงานประเภทนี้เสร็จสิ้น เวลาจะถูกรายงานเทียบกับ UTC เสมอ ดังนั้นโปรดละเว้นคําต่อท้าย (GMT) ที่เขียนในรายงาน
การรวมรายงาน	แสดงชนิดการรวมที่ถูกตั้งค่าในคําขอรายงาน สําหรับข้อมูล ดู การรวมและเวลา ด้านล่าง
ตัวกรองรายงาน	สงวนไว้สําหรับใช้ในอนาคต
ข้อมูลที่ไม่สมบูรณ์ที่อาจเกิดขึ้น	ถ้าตั้งค่าเป็น จริง ข้อมูลรายงานอาจไม่ได้รับการประมวลผลอย่างสมบูรณ์ในวันสุดท้ายของเวลารายงานที่ร้องขอ องค์ประกอบคําขอ ReturnOnlyCompleteData จะกําหนดว่าบริการต้องตรวจสอบให้แน่ใจว่าข้อมูลทั้งหมดได้รับการประมวลผลและพร้อมใช้งานหรือไม่ สําหรับข้อมูลเกี่ยวกับวิธีที่โซนเวลามีผลต่อความพร้อมใช้งานของรายงาน ดู โซนเวลาในการรายงาน ด้านล่าง
แถว	จํานวนข้อมูลเรกคอร์ดรายงานซึ่งไม่รวมส่วนหัวของบรรทัดที่ว่างเปล่า ชื่อคอลัมน์ และเมตาดาต้าส่วนท้าย Metadata นี้ไม่พร้อมใช้งานในรายงาน Xml

ชื่อคอลัมน์รายงาน เช่น "AccountId","CampaignId","Keyword","KeywordId","DeviceType","Clicks" จะรวมอยู่ตามค่าเริ่มต้น หากคุณไม่ต้องการให้คอลัมน์รายงานตั้งค่า ExcludeColumnHeaders เป็น true

เมตาดาต้าส่วนท้ายของรายงาน เช่น @2020 Microsoft Corporation สงวน จะรวมอยู่ตามค่าเริ่มต้น หากคุณไม่ต้องการให้เมตาดาต้าส่วนท้ายตั้งค่า ExcludeReportFooterเป็นจริง

เวอร์ชันของรูปแบบรายงาน

รูปแบบข้อมูลสําหรับเขตข้อมูลบางอย่างสามารถอัปเดตได้ภายในเวอร์ชัน API ปัจจุบันโดยไม่ทําให้แอปพลิเคชันไคลเอ็นต์ที่มีอยู่เสียหาย คุณสามารถรับรูปแบบข้อมูลล่าสุดได้โดยการตั้งค่าเขตข้อมูลคําขอ FormatVersion ที่เลือกได้ ตารางด้านล่างสรุปความแตกต่างระหว่างรูปแบบเวอร์ชัน 1.0 และ 2.0

คำอธิบาย	คอลัมน์รายงาน	ตัวอย่าง FormatVersion 1.0	ตัวอย่าง FormatVersion 2.0
ตัวคั่นกลุ่มหลักพัน (เครื่องหมายจุลภาค) ถูกลบออก	AllRevenue ช่วย ExtendedCost รายได้	1,000.00	1000.00
ความแม่นยําถูกอัปเดตจากตัวเลข 4 หลักเป็น 2 หลัก	LowQualityClicksPercent LowQualityImpressionsPercent Ptr	12.3400	12.34
ความแม่นยําได้รับการอัปเดตจากตัวเลข 0 หลักเป็น 2 หลัก	AbsoluteTopImpressionShareLostToBudgetPercent AbsoluteTopImpressionShareLostToRankPercent ExactMatchImpressionSharePercent ImpressionLostToBudgetPercent ImpressionLostToRankAggPercent ImpressionSharePercent TopImpressionShareLostToBudgetPercent TopImpressionShareLostToRankPercent	12	12.34
รูปแบบรายงานรายชั่วโมงได้รับการอัปเดตจาก "mm/dd/yyyy 12:00:00 AM|hour" เป็น "yyyy-mm-dd|hour" รูปแบบนี้ใช้ได้กับคอลัมน์ TimePeriod เท่านั้นถ้าการรวมรายงานถูกตั้งค่าเป็น รายชั่วโมง	TimePeriod	"3/15/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 TopVsOther

AbsoluteTopImpressionRatePercent AbsoluteTopImpressionShareLostToBudgetPercent AbsoluteTopImpressionShareLostToRankPercent AbsoluteTopImpressionSharePercent AudienceImpressionLostToBudgetPercent AudienceImpressionLostToRankPercent AudienceImpressionSharePercent ClickSharePercent ExactMatchImpressionSharePercent ImpressionLostToBudgetPercent ImpressionLostToRankAggPercent ImpressionSharePercent RelativeCtr

แอตทริบิวต์และการแสดงผลคอลัมน์สถิติประสิทธิภาพการแชร์ต่อไปนี้จะไม่เกิดร่วมกันเมื่อส่ง CampaignPerformanceReportRequest

หมายเหตุ

นอกจากนี้ ถ้าคุณรวมคอลัมน์ AudienceImpressionLostToBudgetPercent, AudienceImpressionLostToRankPercent, AudienceImpressionSharePercent หรือ RelativeCtr จากนั้นคุณต้องแยกคอลัมน์แอตทริบิวต์ CustomerId, CustomerName และ DeliveredMatchType ออก และในทางกลับกันด้วย

แอ ตทริ บิวต์

สถิติประสิทธิภาพการแชร์การแสดงผล

BidMatchType BudgetAssociationStatus BudgetName BudgetStatus DeviceOS เป้าหมาย GoalType TopVsOther

AbsoluteTopImpressionRatePercent AbsoluteTopImpressionShareLostToBudgetPercent AbsoluteTopImpressionShareLostToRankPercent AbsoluteTopImpressionSharePercent AudienceImpressionLostToBudgetPercent AudienceImpressionLostToRankPercent AudienceImpressionSharePercent ClickSharePercent ExactMatchImpressionSharePercent ImpressionLostToBudgetPercent ImpressionLostToRankAggPercent ImpressionSharePercent RelativeCtr TopImpressionRatePercent TopImpressionShareLostToBudgetPercent TopImpressionShareLostToRankPercent TopImpressionSharePercent

แอตทริบิวต์ต่อไปนี้จะถูกจํากัดเมื่อส่ง HotelDimensionPerformanceReportRequest

แอ ตทริ บิวต์
AdId

แอตทริบิวต์ต่อไปนี้จะถูกจํากัดเมื่อส่ง HotelGroupPerformanceReportRequest

แอ ตทริ บิวต์
AdId

แอตทริบิวต์ต่อไปนี้และการแสดงผลแชร์คอลัมน์สถิติประสิทธิภาพการทํางานจะไม่เกี่ยวข้องกันเมื่อส่ง ProductDimensionPerformanceReportRequest

แอ ตทริ บิวต์	สถิติประสิทธิภาพการแชร์การแสดงผล
การกระจาย AdDistribution AdId AdStatus คลิกชนิด ClickTypeId เป้าหมาย GoalType ภาษา LocalStoreCode เครือ ข่าย TopVsOther	AbsoluteTopImpressionShareLostToBudgetPercent AbsoluteTopImpressionShareLostToRankPercent AbsoluteTopImpressionSharePercent BenchmarkBid BenchmarkCtr ClickSharePercent ImpressionLostToBudgetPercent ImpressionLostToRankPercent ImpressionSharePercent TopImpressionShareLostToBudgetPercent TopImpressionShareLostToRankPercent TopImpressionSharePercent

แอตทริบิวต์ต่อไปนี้และการแสดงผลแชร์คอลัมน์สถิติประสิทธิภาพการทํางานจะไม่ซ้ํากันเมื่อส่ง ProductPartitionPerformanceReportRequest

แอ ตทริ บิวต์	สถิติประสิทธิภาพการแชร์การแสดงผล
การกระจาย AdDistribution AdId AdStatus BidMatchType คลิกชนิด ClickTypeId DeliveredMatchType เป้าหมาย GoalType ภาษา LocalStoreCode เครือ ข่าย TopVsOther	AbsoluteTopImpressionSharePercent BenchmarkBid BenchmarkCtr ClickSharePercent ImpressionLostToBudgetPercent ImpressionLostToRankPercent ImpressionSharePercent

คอลัมน์ช่วงเวลา

หากคุณรวมคอลัมน์ TimePeriod แล้วรูปแบบของค่าในรายงานที่ดาวน์โหลดจะแตกต่างกันไปขึ้นอยู่กับระดับ การรวมรายงาน ที่คุณระบุในคําขอรายงาน ตัวอย่างเช่น ถ้าระดับการรวมคือ รายวัน แต่ละเขตข้อมูลในคอลัมน์ TimePeriod จะมีวันที่จัดรูปแบบเป็น yyyy-mm-dd

หมายเหตุ

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

การรวม	คำอธิบาย
ประจำ วัน	แต่ละแถวของรายงานจะระบุเดือน วัน และปีที่มีธุรกรรมเกิดขึ้น ข้อมูลรายงานจะถูกรวมโดยแต่ละวัน ช่วงเวลาจะถูกจัดรูปแบบเป็น yyyy-mm-dd
DayOfWeek	แต่ละแถวของรายงานจะระบุวันในสัปดาห์เมื่อมีธุรกรรมเกิดขึ้น ข้อมูลรายงานจะถูกรวมโดยแต่ละเจ็ดวันในหนึ่งสัปดาห์ ค่าข้อมูลที่เป็นไปได้คือ 1 - 7 โดยที่ 1 แสดงถึงวันอาทิตย์ และ 7 แสดงถึงวันเสาร์ หากเวลาของรายงานครอบคลุมหลายสัปดาห์ ข้อมูลประสิทธิภาพการทํางานตลอดทั้งสัปดาห์สําหรับวันในสัปดาห์ที่กําหนดจะถูกรวมเป็นหนึ่งแถว ตัวอย่างเช่น หาก แคมเปญ A มีการแสดง 5 ครั้งทุกวันจันทร์ (วันที่ 2) ตลอดทั้ง 3 สัปดาห์ที่รวมอยู่ในช่วงเวลารายงาน รายงานจะมีแถวหนึ่งแถวที่มี 2 ในคอลัมน์ TimePeriod และการแสดงผลในแถวนั้นมีผลรวม 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|hour" ตัวอย่างเช่น ถ้าการคลิกเกิดขึ้นเมื่อวันที่ 15 มีนาคม 2020 ระหว่าง 07:00 ถึง 08:00 ดังนั้นเขตข้อมูลในรายงานที่ดาวน์โหลดมาจะเป็น "2020-03-15|7" ค่าที่เป็นไปได้สําหรับคอมโพเนนต์ชั่วโมงคือ 0 - 23 หากเวลาของรายงานครอบคลุมหลายวัน ข้อมูลประสิทธิภาพสําหรับชั่วโมงที่ระบุจะได้รับแยกจากกันในหลายแถว เช่น รายงานจะมีหนึ่งแถวสําหรับแต่ละวันและชั่วโมงที่ไม่ซ้ํากัน ตัวอย่างเช่น หาก แคมเปญ A มีการแสดง 5 ครั้งในช่วง ชั่วโมง 7 ในแต่ละ 3 วันซึ่งรวมอยู่ในช่วงเวลารายงาน รายงานจะมีสามแถวแต่ละรายการที่มีการแสดงผล 5 ครั้งสําหรับ ชั่วโมง 7
HourOfDay	แต่ละแถวของรายงานจะระบุชั่วโมงของวันเมื่อธุรกรรมเกิดขึ้น ข้อมูลรายงานจะถูกรวมโดยแต่ละ 24 ชั่วโมงตลอดทั้งวัน ค่าที่เป็นไปได้คือ 0 - 23 ถ้าเวลาของรายงานครอบคลุมหลายวัน ข้อมูลประสิทธิภาพการทํางานในทุกวันสําหรับชั่วโมงที่ระบุจะถูกรวมเป็นหนึ่งแถว ตัวอย่างเช่น หาก แคมเปญ A มีการแสดง 5 ครั้งระหว่างชั่วโมง 7 ในแต่ละ 3 วันซึ่งรวมอยู่ในช่วงเวลารายงาน รายงานจะมีแถวหนึ่งแถวที่มีการแสดงผลสําหรับ HourOfDay รวมเป็น 15
ประจำ เดือน	แต่ละแถวของรายงานจะระบุเดือนที่มีธุรกรรมเกิดขึ้น ข้อมูลรายงานจะถูกรวมในแต่ละเดือน ช่วงเวลาที่มีวันแรกของเดือนจะถูกจัดรูปแบบเป็น ป-ดด-วว.
ประจำ สัปดาห์	แต่ละแถวของรายงานจะระบุสัปดาห์เมื่อมีธุรกรรมเกิดขึ้น ข้อมูลรายงานจะถูกรวมโดยแต่ละสัปดาห์ ช่วงเวลาที่มีวันที่ของวันอาทิตย์สําหรับแต่ละสัปดาห์จะถูกจัดรูปแบบเป็น yyyy-mm-dd
ประจำ ปี	แต่ละแถวของรายงานจะระบุปีที่มีธุรกรรมเกิดขึ้น ข้อมูลรายงานจะถูกรวมโดยแต่ละปี ช่วงเวลาที่มีปีจะถูกจัดรูปแบบเป็น ปปปป

การรวมและเวลา

สําหรับคําขอรายงานส่วนใหญ่ คุณต้องตั้งค่าองค์ประกอบการรวมและเวลา ต่อไปนี้คือช่วงเวลาที่คุณสามารถระบุสําหรับค่าการรวมแต่ละค่าได้

ค่าการรวม	ช่วงเวลา
ประจำ วัน	วันนี้ เมื่อวานนี้ LastSevenDays เดือนนี้ LastMonth ช่วงวันที่แบบกําหนดเอง
DayOfWeek	วันนี้ เมื่อวานนี้ LastSevenDays เดือนนี้ LastMonth LastThreeMonths LastSixMonths
รายชั่วโมง	วันนี้ เมื่อวานนี้ ช่วงวันที่แบบกําหนดเอง
HourOfDay	วันนี้ เมื่อวานนี้ LastSevenDays เดือนนี้ LastMonth LastThreeMonths LastSixMonths
ประจำ เดือน	เดือนนี้ LastMonth LastThreeMonths LastSixMonths ThisYear LastYear ช่วงวันที่แบบกําหนดเอง
สรุป	วันนี้ เมื่อวานนี้ LastSevenDays เดือนนี้ LastMonth ช่วงวันที่แบบกําหนดเอง
ประจำ สัปดาห์	ThisWeek LastWeek LastFourWeeks เดือนนี้ LastMonth ThisYear LastYear ช่วงวันที่แบบกําหนดเอง
ประจำ ปี	ThisYear LastYear ช่วงวันที่แบบกําหนดเอง

การแสดงผลเป็นศูนย์

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

โซนเวลาในการรายงาน

ข้อมูลรายงานที่ดาวน์โหลดจะสัมพันธ์กับเวลา UTC เสมอ ตัวอย่างเช่น รายงานรายชั่วโมงอาจมีแอตทริบิวต์ 5 การคลิกถึงชั่วโมง 7 ในกรณีดังกล่าว มีการคลิก 5 ครั้งระหว่างเวลา 07:00 ถึง 08:00 UTC

องค์ประกอบคําขอ ReportTimeZone จะกําหนดโซนเวลาที่ใช้ในการสร้างวันที่ของวันนี้ เมื่อคุณส่งคําขอรายงานของวันนี้อาจแตกต่างกันไปทั่วโลกโดยขึ้นอยู่กับโซนเวลา ช่วงเวลาของรายงานที่คุณเลือก เช่น 'เมื่อวานนี้' สัมพันธ์กับวันที่ปัจจุบัน ถ้าคุณไม่ได้เลือกโซนเวลา บริการการรายงานจะใช้ PacificTimeUSCanadaTijuana ตามค่าเริ่มต้น ตัวอย่างเช่น รายงานที่ร้องขอโดยไม่มีโซนเวลาที่ระบุที่ 2 AM EasternTimeUSCanada ในวันที่ 2/2/2020 สําหรับ 'เมื่อวานนี้' จะถูกตีความว่าเป็นคําขอสําหรับวันที่ 1/31/2020 รายงานที่ร้องขอในเวลาเดียวกันสําหรับ 'เมื่อวานนี้' ที่มีโซนเวลาที่ตั้งค่าเป็น EasternTimeUSCanada จะถูกตีความว่าเป็นคําขอสําหรับวันที่ 2/1/2020

องค์ประกอบคําขอ ReturnOnlyCompleteData จะกําหนดว่าบริการต้องตรวจสอบให้แน่ใจว่าข้อมูลทั้งหมดได้รับการประมวลผลและพร้อมใช้งานหรือไม่ ถ้าตั้งค่าเป็น true และถ้าระบบยังไม่เสร็จสิ้นการประมวลผลข้อมูลทั้งหมดตามการรวม ขอบเขต และเวลาที่ร้องขอ บริการจะส่งกลับรหัสข้อผิดพลาด NoCompleteDataAvaliable (2004) มิฉะนั้นตามค่าเริ่มต้นคําขอสามารถประสบความสําเร็จไม่มีข้อบ่งชี้ว่าข้อมูลเสร็จสมบูรณ์หรือไม่และรายงานจะมีเฉพาะข้อมูลที่ระบบประมวลผลเสร็จสิ้นในเวลาที่คําขอ ในขณะที่วันนี้ยังอยู่ระหว่างดําเนินการ คุณจะได้รับข้อมูลล่าสุดโดยไม่ได้ร้องขอข้อมูลที่เสร็จสมบูรณ์ หลังจากหนังสือปิดวันคุณอาจต้องการตั้งค่าสถานะนี้ว่าเป็นจริงและมองกลับไปที่สิ่งที่ตอนนี้เป็น 'เมื่อวานนี้' และรับข้อมูลรายงานขั้นสุดท้าย

หมายเหตุ

ถ้าคุณร้องขอรายงานสําหรับการส่งเสริมการขายที่มีโซนเวลาอื่น ข้อมูลจะถือว่าเสร็จสมบูรณ์เฉพาะหลังจากวันสิ้นสุดและข้อมูลการคลิกได้รับการประมวลผลในโซนเวลาการส่งเสริมการขายทั้งหมดแล้ว ตัวอย่างเช่น สมมติว่าคุณร้องขอรายงานที่มีแคมเปญ A (ซึ่งระบุโซนเวลา PST) และแคมเปญ B (ซึ่งระบุโซนเวลา EST) ข้อมูลจะไม่เสร็จสมบูรณ์จนกว่าข้อมูลการคลิกทั้งหมดสําหรับแคมเปญ A ได้รับการประมวลผลสําหรับช่วงเวลาที่ระบุ

เมื่อผู้ใช้คลิกโฆษณา ระบบอาจใช้เวลาสูงสุดสองชั่วโมงในการดําเนินการคลิก (3 ชั่วโมงสําหรับ Conversion) และทําให้พร้อมใช้งานสําหรับการรายงาน โดยทั่วไปข้อมูลจะถือว่าเสร็จสมบูรณ์โดยมีหนังสือที่ปิดหลังจาก 3 ชั่วโมง ในบางกรณีข้อยกเว้นเนื่องจากปริมาณการใช้งานไม่ถูกต้อง อาจมีการปรับที่ไม่คาดคิดซึ่งอาจใช้เวลาหนึ่งสัปดาห์หรือมากกว่าในการแก้ไข ตัวอย่างเช่น หากการร้องเรียนของผู้โฆษณาระบุกิจกรรมการคลิกที่ไม่ถูกต้องซึ่งหลบหนีจากระบบการกรองอัตโนมัติทีมคุณภาพการจราจรและทีมสนับสนุนจะประมวลผลเครดิตไปยังบัญชีของผู้โฆษณาและจะเป็นพันธมิตรกับทีมภายในเพื่อพิจารณาว่าพวกเขาสามารถอัปเดตระบบอัตโนมัติเพื่อปรับปรุงการตรวจจับในอนาคตได้หรือไม่ สําหรับข้อมูลเพิ่มเติม โปรดดูศูนย์คุณภาพการจราจร

เมตริกที่ได้รับการรับรอง MRC

เมตริกการคลิกโฆษณาในการค้นหาได้รับการรับรองโดยสภาการจัดอันดับสื่อ (MRC) การรับรองนี้ใช้ไม่ได้กับเมตริกอื่น ๆ ดู คําอธิบายการวัดคลิกของวิธีการ สําหรับข้อมูลเพิ่มเติม

ดูเพิ่มเติม

แอตทริบิวต์ของรายงานและสถิติประสิทธิภาพการทํางาน
ชนิดรายงาน
ร้องขอและดาวน์โหลดรายงาน
ที่อยู่ของบริการเว็บ API ของ Bing Ads