ข้อมูลเหตุการณ์ดิบเกี่ยวกับ Conversion
รายงานนี้สามารถส่งคืนได้โดยคำขอแบบอะซิงโครนัสเท่านั้น (นั่นคือผ่านทาง Reports.request())
เนื่องจากกิจกรรมเกิดขึ้นในวันที่ระบุ คำขอสำหรับรายงานนี้ต้องระบุ timeRange คุณสามารถระบุรายการใดรายการหนึ่งต่อไปนี้
- startDate และ endDate
- changedMetricsSinceTimestamp (changedAttributesSinceTimestamp ไม่ถูกต้องสำหรับเหตุการณ์)
ขอข้อความที่ตัดตอนมา
ส่ง
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 |
ใช่ |