วัตถุข้อมูล GeographicPerformanceReportRequest - การรายงาน

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

คุณสามารถร้องขอการแสดงผล การคลิก การใช้จ่าย และค่าใช้จ่ายเฉลี่ยต่อหนึ่งคลิกสําหรับแต่ละกลุ่มโฆษณา ซึ่งจัดระเบียบเป็นคอลัมน์ที่แสดงตําแหน่งที่ใช้แสดงโฆษณา

เมื่อต้องการร้องขอรายงานชนิดนี้ ให้ส่งวัตถุนี้ไปยังการดําเนินการ SubmitGenerateReport

หมายเหตุ

จะไม่มีการส่งกลับข้อมูลแคมเปญสูงสุดของประสิทธิภาพการทํางานถ้าคอลัมน์ AdGroupName, AdGroupId, AdGroupStatus, AdId, AdStatus ถูกเลือก และไม่ได้เลือกคอลัมน์ AssetGroupId, AssetGroupName, AssetGroupStatus, CampaignType

ถ้ามีการเลือกคอลัมน์ AssetGroupId, AssetGroupName, AssetGroupStatus, CampaignType จากนั้นคอลัมน์ AdGroupName, AdGroupId, AdGroupStatus, AdId, AdStatus สามารถเป็น Null สําหรับข้อมูลแคมเปญสูงสุดของประสิทธิภาพการทํางานได้

ไวยากรณ์

<xs:complexType name="GeographicPerformanceReportRequest" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:ReportRequest">
      <xs:sequence>
        <xs:element name="Aggregation" type="tns:ReportAggregation" />
        <xs:element name="Columns" nillable="true" type="tns:ArrayOfGeographicPerformanceReportColumn" />
        <xs:element minOccurs="0" name="Filter" nillable="true" type="tns:GeographicPerformanceReportFilter" />
        <xs:element name="Scope" nillable="true" type="tns:AccountThroughAdGroupReportScope" />
        <xs:element name="Time" nillable="true" type="tns:ReportTime" />
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

องค์ ประกอบ

วัตถุ GeographicPerformanceReportRequest มีองค์ประกอบต่อไปนี้: การรวมคอลัมน์ตัวกรองขอบเขตเวลา

องค์ ประกอบ	คำอธิบาย	ชนิดข้อมูล
การรวม	ชนิดของการรวมที่จะใช้เพื่อรวมข้อมูลรายงาน ตัวอย่างเช่น คุณสามารถรวมข้อมูลรายงานตามวันหรือสัปดาห์ หรือร้องขอรายงานสรุปได้ การรวมเริ่มต้นคือ สรุป สิ่งสําคัญคือถ้าคุณไม่รวม TimePeriod ในรายการของ คอลัมน์ การรวมที่คุณเลือกจะถูกละเว้นและจะใช้การรวมข้อมูลสรุปโดยไม่คํานึงถึง	ReportAggregation
คอลัมน์	รายการของแอตทริบิวต์และสถิติประสิทธิภาพที่จะรวมไว้ในรายงาน รายงานจะรวมคอลัมน์ตามลําดับที่คุณระบุ	อาร์เรย์ GeographicPerformanceReportColumn
ตัว กรอง	ข้อมูลตัวกรองเพื่อใช้ในการกรองข้อมูลรายงาน	GeographicPerformanceReportFilter
ขอบ เขต	ขอบเขตเอนทิตีของรายงาน ใช้องค์ประกอบนี้เพื่อจํากัดข้อมูลรายงานไปยังบัญชี กลุ่มโฆษณา หรือแคมเปญที่เฉพาะเจาะจง	AccountThroughAdGroupReportScope
เวลา	รอบระยะเวลาที่จะใช้สําหรับรายงาน คุณสามารถระบุช่วงวันที่แบบกําหนดเอง หรือเลือกช่วงวันที่ที่กําหนดไว้ล่วงหน้า ตัวอย่างเช่น Today หรือ ThisWeek สําหรับรายการของรอบระยะเวลาที่คุณสามารถระบุสําหรับการรวมแต่ละชนิด ให้ดู การรวมและเวลา คุณสามารถตั้งค่าโซนเวลาภายในออบเจ็กต์ ReportTime ซึ่งช่วยให้คุณกําหนดขอบเขตข้อมูลสําหรับช่วงเวลาที่ร้องขอได้อย่างแม่นยํา ถ้าคุณไม่ได้เลือกโซนเวลา บริการการรายงานจะใช้ PacificTimeUSCanadaTijuana ตามค่าเริ่มต้น	ReportTime

วัตถุ GeographicPerformanceReportRequest มีการสืบทอดองค์ประกอบ

องค์ประกอบที่สืบทอดมา

องค์ประกอบที่สืบทอดมาจาก ReportRequest

วัตถุ GeographicPerformanceReportRequest มาจากวัตถุ ReportRequest และสืบทอดองค์ประกอบต่อไปนี้: ExcludeColumnHeaders, ExcludeReportFooter, ExcludeReportHeader, Format, FormatVersion, ReportName, ReturnOnlyCompleteData คําอธิบายด้านล่างเป็นคําอธิบายเฉพาะสําหรับ GeographicPerformanceReportRequest และอาจไม่นําไปใช้กับวัตถุอื่น ๆ ที่สืบทอดองค์ประกอบเดียวกันจากวัตถุ ReportRequest

องค์ ประกอบ	คำอธิบาย	ชนิดข้อมูล
ExcludeColumnHeaders	กําหนดว่ารายงานที่ดาวน์โหลดควรประกอบด้วยคําอธิบายส่วนหัวสําหรับแต่ละคอลัมน์หรือไม่ ส่วนหัวของคอลัมน์รายงานตรงกับชื่อคอลัมน์ที่ร้องขอ เช่น การแสดงผลและการคลิก ตั้งค่าคุณสมบัตินี้ เป็นจริง ถ้าคุณต้องการให้ส่วนหัวของคอลัมน์รายงานไม่รวมอยู่ในรายงานที่ดาวน์โหลด ค่าเริ่มต้นคือ เท็จ	บูลีน
ExcludeReportFooter	กําหนดว่ารายงานที่ดาวน์โหลดควรประกอบด้วยเมตาดาต้าท้ายกระดาษ เช่น ลิขสิทธิ์ของ Microsoft (@2020 Microsoft Corporation หรือไม่ All rights reserved.) ตั้งค่าคุณสมบัตินี้ เป็นจริง ถ้าคุณต้องการให้เมตาดาต้าส่วนท้ายของรายงานถูกแยกออกจากรายงานที่ดาวน์โหลด ค่าเริ่มต้นคือ เท็จ	บูลีน
ExcludeReportHeader	กําหนดว่ารายงานที่ดาวน์โหลดควรประกอบด้วยเมตาดาต้าส่วนหัว เช่น ชื่อรายงาน ช่วงวันที่ และการรวมหรือไม่ ตั้งค่าคุณสมบัตินี้ เป็นจริง ถ้าคุณต้องการให้เมตาดาต้าส่วนหัวของรายงานถูกแยกออกจากรายงานที่ดาวน์โหลด ค่าเริ่มต้นคือ เท็จ	บูลีน
รูป แบบ	รูปแบบของข้อมูลรายงาน ตัวอย่างเช่น คุณสามารถร้องขอข้อมูลในรูปแบบค่าที่คั่นด้วยเครื่องหมายจุลภาค (Csv) หรือรูปแบบค่าที่คั่นด้วยแท็บ (Tsv) ค่าเริ่มต้นคือ Csv ไฟล์ที่ดาวน์โหลดทั้งหมดจะถูกบีบอัด ZIP	ReportFormat
FormatVersion	กําหนดรูปแบบสําหรับเขตข้อมูลบางอย่างในไฟล์รายงานที่ดาวน์โหลด รูปแบบข้อมูลสําหรับเขตข้อมูลบางอย่างสามารถอัปเดตได้ภายในเวอร์ชัน API ปัจจุบันโดยไม่ทําให้แอปพลิเคชันไคลเอ็นต์ที่มีอยู่เสียหาย คุณสามารถรับรูปแบบข้อมูลล่าสุดได้โดยการตั้งค่าเขตข้อมูลคําขอทางเลือกนี้เป็น 2.0 ถ้าคุณไม่ได้ตั้งค่าฟิลด์นี้ บริการจะใช้ค่าเริ่มต้นเป็นเวอร์ชัน 1.0 สําหรับรายละเอียดเกี่ยวกับการเปลี่ยนแปลงระหว่างเวอร์ชันรูปแบบ ดูเวอร์ชันของรูปแบบรายงาน	สาย อักขระ
ReportName	ชื่อของรายงาน ชื่อจะรวมอยู่ในส่วนหัวของรายงาน ถ้าคุณไม่ได้ระบุชื่อรายงาน ระบบจะสร้างชื่อในแบบฟอร์ม ReportType-ReportDateTime ความยาวสูงสุดของชื่อรายงานคือ 200	สาย อักขระ
ReturnOnlyCompleteData	กําหนดว่าบริการต้องตรวจสอบให้แน่ใจว่าข้อมูลทั้งหมดได้รับการประมวลผลแล้วและพร้อมใช้งานหรือไม่ ถ้าตั้งค่าเป็น true และถ้าระบบยังประมวลผลข้อมูลทั้งหมดไม่เสร็จตามการรวมขอบเขตและเวลาที่ร้องขอ บริการจะส่งกลับรหัสข้อผิดพลาด NoCompleteDataAvaliable (2004) มิฉะนั้นตามค่าเริ่มต้นคําขอสามารถประสบความสําเร็จไม่มีข้อบ่งชี้ว่าข้อมูลเสร็จสมบูรณ์หรือไม่และรายงานจะมีเฉพาะข้อมูลที่ระบบประมวลผลเสร็จสิ้นในเวลาที่คําขอ โปรดทราบว่าเนื่องจากวันนี้ยังอยู่ระหว่างดําเนินการและข้อมูลไม่สมบูรณ์ คุณไม่สามารถตั้งค่าองค์ประกอบนี้เป็นจริงถ้าช่วงเวลา (ไม่ว่าจะเป็นวันที่แบบกําหนดเองหรือกําหนดไว้ล่วงหน้า) รวมวันที่ของวันนี้ สําหรับข้อมูลเพิ่มเติม ดูโซนเวลาในการรายงาน	บูลีน

ข้อกําหนด

บริการ: ReportingService.svc v13
Namespace: https://bingads.microsoft.com/Reporting/v13