ข้อมูลเหตุการณ์ดิบเกี่ยวกับ 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 เปิดใช้สําหรับผู้ลงโฆษณาที่มีการผสานรวม API ของ Conversion หรือการผสานรวม Google Analytics เท่านั้น | แอตทริบิวต์ | String |
ได้ |
conversionSearchTerm |
ข้อความค้นหาที่ทําให้เกิด Conversion | แอตทริบิวต์ | String |
ได้ |
floodlightOriginalRevenue |
รายได้เดิมที่ไม่ได้เปลี่ยนแปลงซึ่งเกี่ยวข้องกับเหตุการณ์ Floodlight (ในสกุลเงินของรายงานปัจจุบัน) ก่อนการแก้ไขคําสั่งสกุลเงิน Floodlight | แอตทริบิวต์ | Money |
ได้ |
floodlightEventRequestString |
สตริงคําขอ Floodlight ของ Conversion | แอตทริบิวต์ | String |
ได้ |
floodlightReferrer |
เว็บไซต์ URL ที่มา Floodlight ของ Conversion | แอตทริบิวต์ | String |
ได้ |
floodlightOrderId |
รหัสคําสั่งซื้อ Floodlight ที่มาจากผู้ลงโฆษณาสําหรับ Conversion | แอตทริบิวต์ | String |
ได้ |
feedItemId |
รหัสแถวรายการฟีดที่เชื่อมโยงกับ Conversion นี้ | แอตทริบิวต์ | ID |
ได้ |
feedId |
รหัสของตารางฟีดที่เชื่อมโยงกับ Conversion นี้ | แอตทริบิวต์ | ID |
ได้ |
feedType |
ประเภทของฟีดที่เชื่อมโยงกับ Conversion นี้ | แอตทริบิวต์ | Feed type |
ได้ |