ข้อมูลดิบของเหตุการณ์เกี่ยวกับการเข้าชม การเข้าชมจะเกิดขึ้นทุกครั้งที่ผู้บริโภคคลิกโฆษณาและเปลี่ยนเส้นทางไปยังหน้า Landing Page
รายงานนี้สามารถแสดงผ่านคําขอแบบไม่พร้อมกันเท่านั้น (กล่าวคือ ผ่านเมธอด Reports.request())
เนื่องจากเหตุการณ์เกิดขึ้นในวันที่ที่ระบุ คําขอสําหรับรายงานนี้จึงต้องระบุ timeRange คุณสามารถระบุอย่างใดอย่างหนึ่งต่อไปนี้
- startDate และ endDate
- changedMetricsSinceTimestamp (changedAttributesSinceTimestamp ใช้ไม่ได้กับเหตุการณ์)
ข้อความที่ตัดตอนมา
ส่งเนื้อหาคําขอ Reports.request() ปกติ แต่ระบุ "reportType": "visit"
{ ... "reportType": "visit", "columns": [ { "columnName": string, "headerText": string, "startDate": string, "endDate": string } ], "filters": [ { "column": { "columnName": string, }, ... }, ... ], ... }
สําหรับแต่ละคอลัมน์ที่คุณต้องการส่งคืนหรือกรองในรายงาน ให้ระบุ columnName
ที่แสดงในตารางด้านล่าง
นอกจากนี้ คุณยังระบุ headerText, startDate และ endDate ได้ด้วย
โปรดทราบว่าตัวกรองบางคอลัมน์ไม่ได้ โปรดดู "กรองได้" ในตารางด้านล่าง
columnName | คำอธิบาย | ลักษณะการทำงาน | ประเภท | กรองได้ |
---|---|---|---|---|
status |
สถานะของการเข้าชม การเข้าชมจะเปลี่ยนแปลงไม่ได้ จึงถือว่าเป็น Active เสมอ |
แอตทริบิวต์ | Status |
ได้ |
deviceSegment |
กลุ่มอุปกรณ์ที่การเข้าชมนั้นมีที่มาจาก Desktop , Mobile , Tablet หรือ Other |
แอตทริบิวต์ | Device segment |
ได้ |
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 |
รหัสกลุ่มผลิตภัณฑ์ที่เชื่อมโยงกับการเข้าชมนี้ เฉพาะการเข้าชมจากแคมเปญ Shopping เท่านั้นที่มีรหัสกลุ่มผลิตภัณฑ์ ไม่ควรใช้รหัสกลุ่มผลิตภัณฑ์เพื่อเข้าร่วม | แอตทริบิวต์ | ID |
ได้ |
ad |
ชื่อโฆษณา | แอตทริบิวต์ | String |
ได้ |
adId |
รหัสโฆษณา DS ค่า 0 หมายความว่าโฆษณาไม่ได้รับการระบุแหล่งที่มา | แอตทริบิวต์ | ID |
ได้ |
isUnattributedAd |
ระบุว่าเมตริกในแถวนี้ไม่สามารถระบุที่มาโฆษณารายการใดรายการหนึ่งได้หรือไม่ ตัวอย่างเช่น โฆษณาที่มีรูปแบบที่ไม่รองรับหรือ URL ของเซิร์ฟเวอร์ที่ผิดพลาดอาจทําให้ DS ไม่สามารถระบุแหล่งที่มาของเมตริกไปยังโฆษณาได้ | แอตทริบิวต์ | Boolean |
ได้ |
inventoryAccountId |
รหัสบัญชีพื้นที่โฆษณา DS ที่มีผลิตภัณฑ์ที่คลิก DS สร้างรหัสนี้เมื่อคุณลิงก์บัญชีพื้นที่โฆษณาใน DS | แอตทริบิวต์ | ID |
ได้ |
productId |
รหัสของผลิตภัณฑ์ที่คลิก | แอตทริบิวต์ | String |
ได้ |
productCountry |
ประเทศ (รูปแบบ ISO 3166) ที่ลงทะเบียนสําหรับฟีดสินค้าคงคลังซึ่งมีผลิตภัณฑ์ที่คลิก | แอตทริบิวต์ | String |
ได้ |
productLanguage |
ภาษา (ISO 639-1) ที่ตั้งค่าสําหรับฟีด Merchant Center ที่มีข้อมูลเกี่ยวกับผลิตภัณฑ์ | แอตทริบิวต์ | String |
ได้ |
productStoreId |
ร้านค้าในโฆษณาสินค้าคงคลังในร้านที่ผู้ใช้คลิก ข้อมูลนี้ควรตรงกับรหัสร้านค้าที่ใช้ในฟีดผลิตภัณฑ์ในร้าน | แอตทริบิวต์ | String |
ได้ |
productChannel |
ช่องทางการขายของผลิตภัณฑ์ที่มีการคลิก: Online หรือ Local |
แอตทริบิวต์ | Product channel |
ได้ |
visitId |
รหัสการเข้าชม DS | แอตทริบิวต์ | ID |
ได้ |
visitSearchQuery |
คําค้นหาที่สร้างการเข้าชมนี้ | แอตทริบิวต์ | String |
ได้ |
visitDate |
วันที่ในเขตเวลาของบัญชีเครื่องมือค้นหาเมื่อเกิดการเข้าชม วันที่นี้ใช้สําหรับรวมการเข้าชม เช่น เมื่อ DS รวมการเข้าชมสําหรับวันที่ 1 พฤษภาคม ระบบจะนับการเข้าชมทั้งหมดที่ visitDate เป็น 1 พฤษภาคม |
แอตทริบิวต์ | Date |
ได้ |
visitTimestamp |
การประทับเวลา UTC เมื่อเกิดการเข้าชม | แอตทริบิวต์ | Timestamp |
ได้ |
visitNetworkType |
เครือข่ายโฆษณาที่ทําให้เกิดการเข้าชมนี้: Content , Search หรือ Other |
แอตทริบิวต์ | Network type |
ได้ |
visitReferrer |
URL ที่มาของการเข้าชม | แอตทริบิวต์ | String |
ได้ |
visitExternalClickId |
สตริงที่ไม่ซ้ํากันสําหรับการเข้าชมแต่ละรายการที่ส่งไปยังหน้า Landing Page เป็นพารามิเตอร์ของ URL gclid เปิดใช้สําหรับผู้ลงโฆษณาที่มีการผสานรวม API ของ Conversion หรือการผสานรวม Google Analytics เท่านั้น | แอตทริบิวต์ | String |
ได้ |
feedItemId |
รหัสของแถวรายการฟีดที่เชื่อมโยงกับการเข้าชมนี้ | แอตทริบิวต์ | ID |
ได้ |
feedId |
รหัสของตารางฟีดที่เชื่อมโยงกับการเข้าชมนี้ | แอตทริบิวต์ | ID |
ได้ |
feedType |
ประเภทของฟีดที่เชื่อมโยงกับการเข้าชมนี้ | แอตทริบิวต์ | Feed type |
ได้ |