ข้อมูลเหตุการณ์ดิบเกี่ยวกับ 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 |
ระบุว่าเมตริกในแถวนี้ไม่สามารถระบุแหล่งที่มาเป็นโฆษณาที่เฉพาะเจาะจงได้หรือไม่ เช่น โฆษณาที่มีรูปแบบที่ไม่รองรับหรือ Clickserver 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 |
วันที่เกิด Conversion ตามเขตเวลาของเครือข่าย Campaign Manager วันที่นี้ใช้สําหรับการรวมเมตริก 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 เป็นพารามิเตอร์ gclid URL เปิดใช้สําหรับผู้ลงโฆษณาที่มีการผสานรวม 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 |
ใช่ |