ประเภทรายงาน: Conversion

ข้อมูลเหตุการณ์ดิบเกี่ยวกับ Conversion

รายงานนี้สามารถส่งคืนได้โดยคำขอแบบอะซิงโครนัสเท่านั้น (นั่นคือผ่านทาง Reports.request())

เนื่องจากกิจกรรมเกิดขึ้นในวันที่ระบุ คำขอสำหรับรายงานนี้ต้องระบุ timeRange คุณสามารถระบุรายการใดรายการหนึ่งต่อไปนี้

ขอข้อความที่ตัดตอนมา

ส่ง Reports.request() เนื้อหาของคำขอ แต่ระบุ "reportType": "conversion"

{
...
  "reportType": "conversion",
  "columns": [
    {
      "columnName": string,
      "headerText": string,
      "startDate": string,
      "endDate": string
    }
  ],
  "filters": [
    {
      "column": {
        "columnName": string,
      },
      ...
    },
    ...
  ],
...
}

สำหรับแต่ละคอลัมน์ที่คุณต้องการให้ส่งคืนหรือกรองในรายงาน ให้ระบุ columnName ที่แสดงในตารางด้านล่าง นอกจากนี้คุณยังสามารถเลือกระบุ headerText startDate, และ endDate โปรดทราบว่าบางคอลัมน์ไม่สามารถกรองได้ ดูที่ "กรองได้" ในตารางด้านล่าง

columnNameคำอธิบายลักษณะการทำงานประเภทกรองได้
status สถานะของ Conversion: Active หรือ Removed แอตทริบิวต์ Status ใช่
deviceSegment กลุ่มอุปกรณ์ที่มีแหล่งที่มาของ Conversion: Desktop, Mobile, Tablet หรือ Other แอตทริบิวต์ Device segment ใช่
floodlightGroup ชื่อกลุ่ม Floodlight แอตทริบิวต์ String ใช่
floodlightGroupConversionType ประเภท Conversion ที่สร้างโดยกิจกรรม Floodlight ในกลุ่มนี้: Action หรือ Transaction แอตทริบิวต์ Conversion type ใช่
floodlightGroupId รหัสกลุ่ม DS Floodlight แอตทริบิวต์ ID ใช่
floodlightGroupTag แท็กกลุ่ม Floodlight แอตทริบิวต์ String ใช่
floodlightActivity ชื่อกิจกรรม Floodlight แอตทริบิวต์ String ใช่
floodlightActivityId รหัสกิจกรรม DS Floodlight แอตทริบิวต์ ID ใช่
floodlightActivityTag แท็กกิจกรรม Floodlight แอตทริบิวต์ String ใช่
agency ชื่อเอเจนซี แอตทริบิวต์ String ใช่
agencyId รหัสเอเจนซี DS แอตทริบิวต์ ID ใช่
advertiser ชื่อผู้ลงโฆษณา แอตทริบิวต์ String ใช่
advertiserId รหัสผู้ลงโฆษณา DS แอตทริบิวต์ ID ใช่
account ชื่อบัญชีเครื่องมือค้นหา แอตทริบิวต์ String ใช่
accountId รหัสบัญชีเครื่องมือค้นหา DS แอตทริบิวต์ ID ใช่
accountEngineId รหัสบัญชีในบัญชีเครื่องมือค้นหาภายนอก แอตทริบิวต์ String ใช่
accountType ประเภทบัญชีเครื่องมือค้นหา: Google AdWords, Bing Ads, Yahoo Japan Listing Ads, Yahoo Search Marketing, Yahoo Gemini, Baidu หรือ Comparison Shopping แอตทริบิวต์ Engine type ใช่
campaign ชื่อแคมเปญ แอตทริบิวต์ String ใช่
campaignId รหัสแคมเปญ DS แอตทริบิวต์ ID ใช่
campaignStatus สถานะของแคมเปญที่มีรายการนี้ แอตทริบิวต์ Status ใช่
adGroup ชื่อกลุ่มโฆษณา แอตทริบิวต์ String ใช่
adGroupId รหัสกลุ่มโฆษณา DS แอตทริบิวต์ ID ใช่
adGroupStatus สถานะของกลุ่มโฆษณาที่มีรายการนี้ แอตทริบิวต์ Status ใช่
keywordId รหัสคีย์เวิร์ด DS ค่า 0 หมายความว่าคีย์เวิร์ดไม่มีการระบุแหล่งที่มา แอตทริบิวต์ ID ใช่
keywordMatchType ประเภทการทำงานของคีย์เวิร์ด: Broad, Exact, Phrase หรือ Content แอตทริบิวต์ Match type ใช่
keywordText ข้อความคีย์เวิร์ด แอตทริบิวต์ String ใช่
productTargetId รหัสเป้าหมายผลิตภัณฑ์ DS แอตทริบิวต์ ID ใช่
productGroupId รหัสกลุ่มผลิตภัณฑ์ที่เชื่อมโยงกับ Conversion นี้ เฉพาะ Conversion จากแคมเปญ Shopping เท่านั้นที่มีรหัสกลุ่มผลิตภัณฑ์ ไม่ควรใช้รหัสกลุ่มผลิตภัณฑ์สำหรับการเข้าร่วม แอตทริบิวต์ ID ใช่
ad ชื่อโฆษณา แอตทริบิวต์ String ใช่
adId รหัสโฆษณา DS ค่า 0 หมายความว่าโฆษณาไม่มีการระบุแหล่งที่มา แอตทริบิวต์ ID ใช่
isUnattributedAd ระบุว่าเมตริกในแถวนี้ระบุแหล่งที่มาไปยังโฆษณารายการใดรายการหนึ่งได้หรือไม่ ตัวอย่างเช่น โฆษณาที่มีรูปแบบที่ไม่รองรับหรือ URL ของเซิร์ฟเวอร์คลิกที่ไม่ถูกต้องอาจทำให้ DS ระบุแหล่งที่มาของเมตริกเป็นโฆษณาไม่ได้ แอตทริบิวต์ Boolean ใช่
inventoryAccountId รหัสบัญชีพื้นที่โฆษณา DS ที่มีผลิตภัณฑ์ที่เชื่อมโยงกับ Conversion DS จะสร้างรหัสนี้เมื่อคุณลิงก์บัญชีพื้นที่โฆษณาใน DS แอตทริบิวต์ ID ใช่
productId รหัสของผลิตภัณฑ์ที่เชื่อมโยงกับ Conversion นี้ แอตทริบิวต์ String ใช่
productCountry ประเทศ (รูปแบบ ISO 3166) ที่ลงทะเบียนสำหรับฟีดสินค้าคงคลังที่มีผลิตภัณฑ์ที่เชื่อมโยงกับ Conversion นี้ แอตทริบิวต์ String ใช่
productLanguage ภาษา (ISO 639-1) ของผลิตภัณฑ์ที่เชื่อมโยงกับ Conversion นี้ แอตทริบิวต์ String ใช่
productStoreId ร้านค้าในโฆษณาสินค้าคงคลังในร้านที่เชื่อมโยงกับ Conversion ซึ่งควรตรงกับรหัสร้านค้าที่ใช้ในฟีดผลิตภัณฑ์ในร้าน แอตทริบิวต์ String ใช่
productChannel ช่องทางการขายของผลิตภัณฑ์ที่เชื่อมโยงกับ Conversion: Online หรือ Local แอตทริบิวต์ Product channel ใช่
conversionId รหัสที่ Search Ads 360 สร้างขึ้นสำหรับ Conversion แต่ละรายการ แอตทริบิวต์ ID ใช่
advertiserConversionId สำหรับ Conversion ออฟไลน์ นี่คือรหัสที่ผู้ลงโฆษณาให้ไว้ หากผู้ลงโฆษณาไม่ได้ระบุรหัสดังกล่าว Search Ads 360 จะสร้างรหัสดังกล่าว สำหรับ Conversion ออนไลน์ ค่านี้จะเท่ากับคอลัมน์ conversionId หรือคอลัมน์ FloodlightOrderId โดยขึ้นอยู่กับคำสั่ง Floodlight ของผู้ลงโฆษณา แอตทริบิวต์ String ใช่
conversionType ประเภทของ Conversion: Action หรือ Transaction แอตทริบิวต์ Conversion type ใช่
conversionRevenue จํานวนเงินดอลลาร์ทั้งหมดจาก Conversion แอตทริบิวต์ Money ใช่
conversionQuantity จำนวนรายการที่ Conversion บันทึกไว้ตามที่กำหนดโดยพารามิเตอร์ qty ผู้ลงโฆษณาเป็นผู้รับผิดชอบในการใส่พารามิเตอร์แบบไดนามิก (เช่น จำนวนสินค้าที่ขายใน Conversion) มิเช่นนั้น จะมีค่าเริ่มต้นเป็น 1 แอตทริบิวต์ Number ใช่
conversionDate วันที่ในเขตเวลาของเครือข่าย Campaign Manager เมื่อเกิด Conversion วันที่นี้ใช้สำหรับการรวมเมตริก Conversion ตัวอย่างเช่น เมื่อ DS รวบรวมการกระทำสำหรับวันที่ 1 พฤษภาคม ระบบจะนับ Conversion การดำเนินการทั้งหมดที่ conversionDate เป็นวันที่ 1 พฤษภาคม แอตทริบิวต์ Date ใช่
conversionTimestamp การประทับเวลา UTC เมื่อเกิด Conversion แอตทริบิวต์ Timestamp ใช่
conversionLastModifiedTimestamp การประทับเวลา UTC ของการแก้ไขล่าสุดของ Conversion แอตทริบิวต์ Timestamp ใช่
conversionAttributionType Conversion มีที่มาจาก Visit หรือ Keyword+Ad แอตทริบิวต์ Conversion attribution type ใช่
conversionVisitId รหัสการเข้าชม DS ที่เป็นแหล่งที่มาของ Conversion แอตทริบิวต์ ID ใช่
conversionVisitTimestamp การประทับเวลา UTC ของการเข้าชมซึ่งเป็นแหล่งที่มาของ Conversion แอตทริบิวต์ Timestamp ใช่
conversionVisitExternalClickId สตริงที่ไม่ซ้ำกันสำหรับการเข้าชมซึ่งมีที่มาจาก Conversion ซึ่งส่งไปยังหน้า Landing Page เป็นพารามิเตอร์ของ URL gclid ใช้ได้กับผู้ลงโฆษณาที่ผสานรวมกับ Conversion API หรือการผสานรวม Google Analytics เท่านั้น แอตทริบิวต์ String ใช่
conversionSearchTerm ข้อความค้นหาที่ทำให้เกิด Conversion แอตทริบิวต์ String ใช่
floodlightOriginalRevenue รายได้เดิมที่ไม่มีการเปลี่ยนแปลงซึ่งเชื่อมโยงกับเหตุการณ์ Floodlight (ในสกุลเงินของรายงานปัจจุบัน) ก่อนการแก้ไขคำสั่งสกุลเงินของ Floodlight แอตทริบิวต์ Money ใช่
floodlightEventRequestString สตริงคำขอ Floodlight ของ Conversion แอตทริบิวต์ String ใช่
floodlightReferrer เว็บไซต์ผู้อ้างอิง Floodlight ของ Conversion แอตทริบิวต์ String ใช่
floodlightOrderId รหัสคำสั่งซื้อของ Floodlight ที่ผู้ลงโฆษณาระบุสำหรับ Conversion แอตทริบิวต์ String ใช่
feedItemId รหัสของแถวรายการฟีดที่เชื่อมโยงกับ Conversion นี้ แอตทริบิวต์ ID ใช่
feedId รหัสของตารางฟีดที่เชื่อมโยงกับ Conversion นี้ แอตทริบิวต์ ID ใช่
feedType ประเภทของฟีดที่เชื่อมโยงกับ Conversion นี้ แอตทริบิวต์ Feed type ใช่