หากต้องการประกาศอย่างเป็นทางการเกี่ยวกับ Google Analytics API โปรดสมัครรับข้อมูลจาก Google Analytics API Notify Group
28-06-2024 เพิ่มโควต้า "ข้อผิดพลาดของไคลเอ็นต์ต่อโปรเจ็กต์ต่อพร็อพเพอร์ตี้"
ในตอนนี้ เราอนุญาตให้มีข้อผิดพลาดเกี่ยวกับเซิร์ฟเวอร์ API ได้ไม่เกิน 10,000 รายการต่อโปรเจ็กต์ต่อพร็อพเพอร์ตี้ ภายในกรอบเวลา 15 นาที ซึ่งรวมถึงคำขอทั้งหมดที่ทำให้เกิดการตอบกลับด้วยรหัสอื่นๆ ที่ไม่ใช่ 500
หรือ 200
ตัวอย่างข้อผิดพลาดที่อยู่ภายใต้โควต้านี้ ได้แก่ การใช้ชุดค่าผสมของมิติข้อมูลและเมตริกที่ทำงานร่วมกันไม่ได้ ข้อผิดพลาดในการตรวจสอบสิทธิ์ทั้งหมด
หากเกินขีดจำกัดนี้ การเรียก API เพิ่มเติมไปยังพร็อพเพอร์ตี้ดังกล่าวจะถูกบล็อกชั่วคราวสำหรับโปรเจ็กต์ Google Cloud ที่เกี่ยวข้องจนกว่ากรอบเวลา 15 นาทีจะสิ้นสุดลง
14-05-2024 เพิ่มฟีเจอร์การเปรียบเทียบ
การใช้การเปรียบเทียบจะช่วยให้คุณประเมินข้อมูลชุดย่อยไปพร้อมกันได้
วิธีการรายงานหลักของ Data API v1beta ได้รับการอัปเดตเพื่อรองรับช่อง comparisons
ซึ่งเมื่อใส่แล้วจะระบุการกำหนดค่าการเปรียบเทียบที่ขอ
ในคำขอ คุณสามารถระบุการเปรียบเทียบพื้นฐาน โดยระบุนิพจน์ dimensionFilter
พร้อมกับคำขอ หรือใช้การเปรียบเทียบที่บันทึกไว้โดยระบุชื่อทรัพยากรของการเปรียบเทียบในช่อง comparison
ระบบจะอัปเดตเมธอด getMetadata เพื่อแสดงรายการการเปรียบเทียบที่บันทึกไว้ทั้งหมดที่พร้อมใช้งานสำหรับพร็อพเพอร์ตี้ในช่องการตอบกลับ comparisons
เมื่อระบุการเปรียบเทียบอย่างน้อย 1 รายการในคำขอ การตอบกลับจะมีคอลัมน์ comparison
ที่ระบุการเปรียบเทียบแต่ละรายการ
ปัจจุบันการเปรียบเทียบที่บันทึกไว้สามารถสร้างได้โดยใช้ UI ของ Google Analytics เท่านั้น
08-05-2024 เพิ่มงานรายงาน ซึ่งเป็นฟีเจอร์การรายงานแบบไม่พร้อมกันลงใน Data API v1alpha
เมื่อใช้งานรายงาน คุณจะสามารถเริ่มคําขอแบบไม่พร้อมกันที่ทำงานเป็นเวลานานเพื่อสร้างรายงานที่กําหนดเองของข้อมูลเหตุการณ์ Google Analytics ได้
มีการเพิ่มวิธีการจัดการงานของรายงานต่อไปนี้ใน Data API v1alpha
- properties.reportTasks.create
- properties.reportTasks.get
- properties.reportTasks.list
- properties.reportTasks.query
06-05-2024 มิติข้อมูลใหม่สำหรับเหตุการณ์สำคัญ
มิติข้อมูลและเมตริกสำหรับเหตุการณ์สําคัญพร้อมใช้งานแล้ว
แก้ไขคำขอรายงานที่ใช้มิติข้อมูล isConversionEvent
ให้ใช้มิติข้อมูล isKeyEvent
แทน
แก้ไขคำขอรายงานที่ใช้เมตริกที่เลิกใช้งานแล้วในตารางต่อไปนี้ให้ใช้เมตริกเหตุการณ์สําคัญแทน
เมตริกที่เลิกใช้งานแล้ว | เมตริกเหตุการณ์สําคัญ |
---|---|
advertiserAdCostPerConversion |
advertiserAdCostPerKeyEvent |
conversions |
keyEvents |
firstTimePurchaserConversionRate |
firstTimePurchaserRate |
purchaserConversionRate |
purchaserRate |
sessionConversionRate |
sessionKeyEventRate |
userConversionRate |
userKeyEventRate |
ทำการแก้ไขที่คล้ายกันกับการใช้เมตริกเหตุการณ์สำคัญของ 1 เหตุการณ์สำคัญในคำขอรายงาน
คำตอบสำหรับเมธอด properties/getMetadata
จะแสดงการแนะนำมิติข้อมูลและเมตริกเหตุการณ์สําคัญในออบเจ็กต์ DimensionMetadata
และ MetricMetadata
ดังนี้
apiName
,uiName
และdescription
มีชื่อ API ของเหตุการณ์สําคัญ, ชื่อ UI และคำอธิบาย- ช่องที่ซ้ำ
deprecatedApiNames
มีรายการที่มีชื่อ API สำหรับ Conversion ที่เลิกใช้งานแล้ว
25-03-2024 เพิ่ม Channel Group หลัก แหล่งที่มาของการเข้าชมด้วยตนเอง และมิติข้อมูลเฉพาะการผสานรวม
Channel Group หลัก, แหล่งที่มาของการเข้าชมด้วยตนเอง และมิติข้อมูลเฉพาะสำหรับการผสานรวม CM360, DV360, SA360 ที่เพิ่มลงในสคีมาของ Data API
มิติข้อมูลกลุ่มเป้าหมาย
audienceId
รหัสกลุ่มเป้าหมาย ตัวระบุที่เป็นตัวเลขของกลุ่มเป้าหมาย
มิติข้อมูล Channel Group หลัก:
firstUserPrimaryChannelGroup
Channel Group หลักของผู้ใช้ครั้งแรกChannel Group หลัก
primaryChannelGroup
Channel Group หลักของเซสชัน
sessionPrimaryChannelGroup
รายการ
มิติข้อมูลแหล่งที่มาของการเข้าชมด้วยตนเอง:
รหัสแคมเปญที่กำหนดเอง
manualCampaignId
รายการmanualCampaignName
ชื่อแคมเปญที่กำหนดเองmanualCreativeFormat
รูปแบบครีเอทีฟโฆษณาที่กำหนดเองmanualMarketingTactic
กลยุทธ์ทางการตลาดแบบดำเนินการด้วยตนเองmanualMedium
สื่อที่กำหนดเองmanualSource
แหล่งที่มาที่กำหนดเองmanualSourceMedium
แหล่งที่มา / สื่อที่กำหนดเองmanualSourcePlatform
แพลตฟอร์มแหล่งที่มาที่กำหนดเองfirstUserManualCampaignId
รหัสแคมเปญที่กำหนดเองของผู้ใช้ครั้งแรกfirstUserManualCampaignName
ชื่อแคมเปญที่กำหนดเองของผู้ใช้ครั้งแรกfirstUserManualCreativeFormat
รูปแบบครีเอทีฟโฆษณาที่กำหนดเองของผู้ใช้ครั้งแรกfirstUserManualMarketingTactic
กลยุทธ์การตลาดแบบดำเนินการด้วยตนเองของผู้ใช้ครั้งแรกfirstUserManualMedium
สื่อที่กำหนดเองของผู้ใช้ครั้งแรกfirstUserManualSource
แหล่งที่มาที่กำหนดเองของผู้ใช้ครั้งแรกfirstUserManualSourceMedium
แหล่งที่มา / สื่อที่กำหนดเองของผู้ใช้ครั้งแรกfirstUserManualSourcePlatform
แพลตฟอร์มแหล่งที่มาที่กำหนดเองของผู้ใช้ครั้งแรกรหัสแคมเปญที่กำหนดเองของเซสชัน
sessionManualCampaignId
ชื่อแคมเปญที่กำหนดเองของเซสชัน
sessionManualCampaignName
รายการรูปแบบครีเอทีฟโฆษณาที่กำหนดเองของเซสชัน
sessionManualCreativeFormat
sessionManualMarketingTactic
กลยุทธ์การตลาดแบบดำเนินการด้วยตนเองของเซสชันสื่อที่กำหนดเองของเซสชัน
sessionManualMedium
รายการแหล่งที่มาที่กำหนดเองของเซสชัน
sessionManualSource
สื่อ / แหล่งที่มาที่กำหนดเองของเซสชัน
sessionManualSourceMedium
รายการแพลตฟอร์มแหล่งที่มาที่กำหนดเองของเซสชัน
sessionManualSourcePlatform
มิติข้อมูลการผสานรวม Campaign Manager 360 (CM360):
รหัสบัญชี CM360
cm360AccountId
รายการชื่อบัญชี CM360
cm360AccountName
รายการรหัสผู้ลงโฆษณา CM360
cm360AdvertiserId
รายการชื่อผู้ลงโฆษณา CM360
cm360AdvertiserName
รายการรหัสแคมเปญ CM360
cm360CampaignId
รายการชื่อแคมเปญ CM360
cm360CampaignName
รายการรูปแบบครีเอทีฟโฆษณา CM360
cm360CreativeFormat
รายการรหัสครีเอทีฟโฆษณา CM360
cm360CreativeId
รายการชื่อครีเอทีฟโฆษณา CM360
cm360CreativeName
รายการประเภทครีเอทีฟโฆษณา CM360
cm360CreativeType
รายการรหัสประเภทครีเอทีฟโฆษณา CM360
cm360CreativeTypeId
รายการเวอร์ชันครีเอทีฟโฆษณา CM360
cm360CreativeVersion
รายการสื่อ CM360
cm360Medium
รายการcm360PlacementCostStructure
โครงสร้างต้นทุนตำแหน่งโฆษณา CM360รหัสตำแหน่งโฆษณา CM360
cm360PlacementId
รายการชื่อตำแหน่งโฆษณา CM360
cm360PlacementName
รายการรหัสการแสดงผล CM360
cm360RenderingId
รายการรหัสเว็บไซต์ CM360
cm360SiteId
รายการชื่อเว็บไซต์
cm360SiteName
CM360แหล่งที่มาของ CM360
cm360Source
รายการแหล่งที่มา / สื่อ CM360
cm360SourceMedium
รายการfirstUserCm360AccountId
รหัสบัญชี CM360 ของผู้ใช้ครั้งแรกfirstUserCm360AccountName
ชื่อบัญชี CM360 ของผู้ใช้ครั้งแรกfirstUserCm360AdvertiserId
รหัสผู้ลงโฆษณา CM360 ของผู้ใช้ครั้งแรกfirstUserCm360AdvertiserName
ชื่อผู้ลงโฆษณา CM360 ของผู้ใช้ครั้งแรกรหัสแคมเปญ CM360 ของผู้ใช้ครั้งแรก
firstUserCm360CampaignId
firstUserCm360CampaignName
ชื่อแคมเปญ CM360 ของผู้ใช้ครั้งแรกfirstUserCm360CreativeFormat
รูปแบบครีเอทีฟโฆษณา CM360 ของผู้ใช้ครั้งแรกfirstUserCm360CreativeId
รหัสครีเอทีฟโฆษณา CM360 ของผู้ใช้ครั้งแรกfirstUserCm360CreativeName
ชื่อครีเอทีฟโฆษณา CM360 ของผู้ใช้ครั้งแรกfirstUserCm360CreativeType
ประเภทครีเอทีฟโฆษณา CM360 ของผู้ใช้ครั้งแรกfirstUserCm360CreativeTypeId
รหัสประเภทครีเอทีฟโฆษณา CM360 ของผู้ใช้ครั้งแรกfirstUserCm360CreativeVersion
เวอร์ชันครีเอทีฟโฆษณา CM360 ของผู้ใช้ครั้งแรกfirstUserCm360Medium
สื่อ CM360 ของผู้ใช้ครั้งแรกfirstUserCm360PlacementCostStructure
โครงสร้างต้นทุนตำแหน่งโฆษณา CM360 ของผู้ใช้ครั้งแรกรหัสตำแหน่งโฆษณา CM360 ของผู้ใช้ครั้งแรก
firstUserCm360PlacementId
firstUserCm360PlacementName
ชื่อตำแหน่งโฆษณา CM360 ของผู้ใช้ครั้งแรกรหัสการแสดงผล CM360 ของผู้ใช้ครั้งแรก
firstUserCm360RenderingId
รายการfirstUserCm360SiteId
รหัสเว็บไซต์ CM360 ของผู้ใช้ครั้งแรกfirstUserCm360SiteName
ชื่อเว็บไซต์ CM360 ของผู้ใช้ครั้งแรกfirstUserCm360Source
แหล่งที่มาของ CM360 ของผู้ใช้ครั้งแรกfirstUserCm360SourceMedium
แหล่งที่มา / สื่อ CM360 ของผู้ใช้ครั้งแรกรหัสบัญชีของเซสชัน CM360
sessionCm360AccountId
รายการชื่อบัญชีของเซสชัน CM360 ของ
sessionCm360AccountName
รหัสผู้ลงโฆษณาใน CM360 ของเซสชัน
sessionCm360AdvertiserId
ชื่อผู้ลงโฆษณาใน CM360 ของเซสชัน
sessionCm360AdvertiserName
รหัสแคมเปญใน CM360 ของเซสชัน
sessionCm360CampaignId
รายการชื่อแคมเปญใน CM360 ของเซสชัน
sessionCm360CampaignName
รายการsessionCm360CreativeFormat
รูปแบบครีเอทีฟโฆษณาใน CM360 ของเซสชันรหัสครีเอทีฟโฆษณาใน CM360 ของเซสชัน
sessionCm360CreativeId
รายการชื่อครีเอทีฟโฆษณาใน CM360 ของเซสชัน
sessionCm360CreativeName
รายการsessionCm360CreativeType
ประเภทครีเอทีฟโฆษณาใน CM360 ของเซสชันรหัสประเภทครีเอทีฟโฆษณาใน CM360 ของเซสชัน
sessionCm360CreativeTypeId
รายการเวอร์ชันครีเอทีฟโฆษณาใน CM360 ของเซสชัน
sessionCm360CreativeVersion
สื่อใน CM360 ของเซสชัน
sessionCm360Medium
รายการsessionCm360PlacementCostStructure
โครงสร้างต้นทุนตำแหน่งโฆษณาใน CM360 ของเซสชันรหัสตำแหน่งโฆษณาใน CM360 ของเซสชัน
sessionCm360PlacementId
รายการชื่อตำแหน่งโฆษณาใน CM360 ของเซสชัน
sessionCm360PlacementName
รายการรหัสการแสดงผลใน CM360 ของเซสชัน
sessionCm360RenderingId
รายการรหัสเว็บไซต์ใน CM360 ของเซสชัน
sessionCm360SiteId
ชื่อเว็บไซต์ใน CM360 ของเซสชัน
sessionCm360SiteName
รายการแหล่งที่มาใน CM360 ของเซสชัน
sessionCm360Source
รายการแหล่งที่มา / สื่อของเซสชัน CM360
sessionCm360SourceMedium
มิติข้อมูลการผสานรวม Display & Video 360 (DV360) ของ Google:
รหัสผู้ลงโฆษณา DV360
dv360AdvertiserId
รายการชื่อผู้ลงโฆษณา DV360
dv360AdvertiserName
รายการรหัสแคมเปญ DV360
dv360CampaignId
รายการชื่อแคมเปญ DV360
dv360CampaignName
รายการรูปแบบครีเอทีฟโฆษณา DV360
dv360CreativeFormat
รายการรหัสครีเอทีฟโฆษณา DV360
dv360CreativeId
รายการชื่อครีเอทีฟโฆษณา DV360
dv360CreativeName
รายการรหัสการแลกเปลี่ยน DV360
dv360ExchangeId
รายการชื่อการแลกเปลี่ยน DV360
dv360ExchangeName
รายการรหัสใบสั่งซื้อการใส่โฆษณา DV360
dv360InsertionOrderId
รายการdv360InsertionOrderName
ชื่อใบสั่งซื้อการใส่โฆษณา DV360รหัสรายการโฆษณา DV360
dv360LineItemId
รายการชื่อรายการโฆษณา DV360
dv360LineItemName
รายการสื่อ DV360
dv360Medium
รายการรหัสพาร์ทเนอร์ DV360
dv360PartnerId
รายการชื่อพาร์ทเนอร์ DV360
dv360PartnerName
รายการแหล่งที่มาของ DV360
dv360Source
รายการdv360SourceMedium
แหล่งที่มา / สื่อ DV360firstUserDv360AdvertiserId
รหัสผู้ลงโฆษณา DV360 ของผู้ใช้ครั้งแรกfirstUserDv360AdvertiserName
ชื่อผู้ลงโฆษณา DV360 ของผู้ใช้ครั้งแรกรหัสแคมเปญ DV360 ของผู้ใช้ครั้งแรก
firstUserDv360CampaignId
firstUserDv360CampaignName
ชื่อแคมเปญ DV360 ของผู้ใช้ครั้งแรกfirstUserDv360CreativeFormat
รูปแบบครีเอทีฟโฆษณา DV360 ของผู้ใช้ครั้งแรกfirstUserDv360CreativeId
รหัสครีเอทีฟโฆษณา DV360 ของผู้ใช้ครั้งแรกfirstUserDv360CreativeName
ชื่อครีเอทีฟโฆษณา DV360 ของผู้ใช้ครั้งแรกfirstUserDv360ExchangeId
รหัสการแลกเปลี่ยน DV360 ของผู้ใช้ครั้งแรกfirstUserDv360ExchangeName
ชื่อการแลกเปลี่ยน DV360 ของผู้ใช้ครั้งแรกfirstUserDv360InsertionOrderId
รหัสใบสั่งซื้อการใส่โฆษณา DV360 ของผู้ใช้ครั้งแรกfirstUserDv360InsertionOrderName
ชื่อใบสั่งซื้อการใส่โฆษณา DV360 ของผู้ใช้ครั้งแรกfirstUserDv360LineItemId
รหัสรายการโฆษณา DV360 ของผู้ใช้ครั้งแรกfirstUserDv360LinteItemName
ชื่อรายการโฆษณา DV360 ของผู้ใช้ครั้งแรกfirstUserDv360Medium
สื่อ DV360 ของผู้ใช้ครั้งแรกfirstUserDv360PartnerId
รหัสพาร์ทเนอร์ DV360 ของผู้ใช้ครั้งแรกfirstUserDv360PartnerName
ชื่อพาร์ทเนอร์ DV360 ของผู้ใช้ครั้งแรกfirstUserDv360Source
แหล่งที่มา DV360 ของผู้ใช้ครั้งแรกfirstUserDv360SourceMedium
แหล่งที่มา / สื่อ DV360 ของผู้ใช้ครั้งแรกรหัสผู้ลงโฆษณา DV360 ของเซสชัน
sessionDv360AdvertiserId
รายการชื่อผู้ลงโฆษณา DV360 ของเซสชัน
sessionDv360AdvertiserName
รหัสแคมเปญ DV360 ของเซสชัน
sessionDv360CampaignId
รายการชื่อแคมเปญ DV360 ของเซสชัน
sessionDv360CampaignName
รายการรูปแบบครีเอทีฟโฆษณา DV360 ของเซสชัน
sessionDv360CreativeFormat
รหัสครีเอทีฟโฆษณา DV360 ของเซสชัน
sessionDv360CreativeId
รายการชื่อครีเอทีฟโฆษณา DV360 ของเซสชัน
sessionDv360CreativeName
รายการรหัสการแลกเปลี่ยน DV360 ของเซสชัน
sessionDv360ExchangeId
ชื่อการแลกเปลี่ยน DV360 ของเซสชัน
sessionDv360ExchangeName
รหัสใบสั่งซื้อการใส่โฆษณา DV360 ของเซสชัน
sessionDv360InsertionOrderId
รายการชื่อใบสั่งซื้อการใส่โฆษณา DV360 ของเซสชัน
sessionDv360InsertionOrderName
รายการรหัสรายการโฆษณา DV360 ของเซสชัน
sessionDv360LineItemId
รายการชื่อรายการโฆษณา DV360 ของเซสชัน
sessionDv360LineItemName
รายการสื่อ DV360 ของเซสชัน
sessionDv360Medium
รายการรหัสพาร์ทเนอร์ DV360 ของเซสชัน
sessionDv360PartnerId
รายการชื่อพาร์ทเนอร์ DV360 ของเซสชัน
sessionDv360PartnerName
แหล่งที่มา DV360 ของเซสชัน
sessionDv360Source
รายการแหล่งที่มา / สื่อ DV360 ของเซสชัน
sessionDv360SourceMedium
มิติข้อมูลการผสานรวม Google Search Ads 360 (SA360)
firstUserSa360AdGroupId
รหัสกลุ่มโฆษณา SA360 ของผู้ใช้ครั้งแรกfirstUserSa360AdGroupName
ชื่อกลุ่มโฆษณา SA360 ของผู้ใช้ครั้งแรกรหัสแคมเปญ SA360 ของผู้ใช้ครั้งแรก
firstUserSa360CampaignId
firstUserSa360CampaignName
แคมเปญ SA360 ของผู้ใช้ครั้งแรกfirstUserSa360CreativeFormat
รูปแบบครีเอทีฟโฆษณา SA360 ของผู้ใช้ครั้งแรกfirstUserSa360EngineAccountId
รหัสบัญชีเครื่องมือค้นหา SA360 ของผู้ใช้ครั้งแรกfirstUserSa360EngineAccountName
ชื่อบัญชีเครื่องมือค้นหา SA360 ของผู้ใช้ครั้งแรกfirstUserSa360EngineAccountType
ประเภทบัญชีเครื่องมือค้นหา SA360 ของผู้ใช้ครั้งแรกfirstUserSa360KeywordText
ข้อความคีย์เวิร์ด SA360 ของผู้ใช้ครั้งแรกfirstUserSa360ManagerAccountId
รหัสบัญชีดูแลจัดการ SA360 ของผู้ใช้ครั้งแรกfirstUserSa360ManagerAccountName
ชื่อบัญชีดูแลจัดการ SA360 ของผู้ใช้ครั้งแรกfirstUserSa360Medium
สื่อ SA360 ของผู้ใช้ครั้งแรกfirstUserSa360Query
คำค้นหา SA360 ของผู้ใช้ครั้งแรกfirstUserSa360Source
แหล่งที่มาของ SA360 ของผู้ใช้ครั้งแรกfirstUserSa360SourceMedium
แหล่งที่มา / สื่อ SA360 ของผู้ใช้ครั้งแรกรหัสกลุ่มโฆษณา SA360
sa360AdGroupId
รายการรหัสแคมเปญ SA360
sa360CampaignId
รายการชื่อกลุ่มโฆษณา SA360
sa360AdGroupName
ชื่อแคมเปญ SA360
sa360CampaignName
รายการsa360CreativeFormat
รูปแบบครีเอทีฟโฆษณา SA360รหัสบัญชีเครื่องมือค้นหา SA360
sa360EngineAccountId
รายการsa360EngineAccountName
ชื่อบัญชีเครื่องมือค้นหา SA360sa360EngineAccountType
ประเภทบัญชีเครื่องมือค้นหา SA360sa360KeywordText
ข้อความคีย์เวิร์ด SA360รหัสบัญชีดูแลจัดการ SA360
sa360ManagerAccountId
รายการsa360ManagerAccountName
ชื่อบัญชีดูแลจัดการ SA360สื่อ SA360
sa360Medium
รายการคำค้นหา SA360
sa360Query
รายการแหล่งที่มา SA360
sa360Source
รายการsa360SourceMedium
แหล่งที่มา / สื่อ SA360รหัสกลุ่มโฆษณา SA360 ของเซสชัน
sessionSa360AdGroupId
รายการรหัสแคมเปญใน SA360 ของเซสชัน
sessionSa360CampaignId
รายการรหัสบัญชีดูแลจัดการ SA360 ของเซสชัน
sessionSa360ManagerAccountId
รายการชื่อบัญชีดูแลจัดการ SA360 ของเซสชัน
sessionSa360ManagerAccountName
sessionSa360SourceMedium
แหล่งที่มา / สื่อ SA360 ของเซสชัน
06-03-2024 การรองรับกลุ่มเป้าหมายของผู้ใช้ที่ไม่ได้ใช้งานในการส่งออกกลุ่มเป้าหมาย
ฟีเจอร์การส่งออกกลุ่มเป้าหมายรองรับการส่งออกกลุ่มเป้าหมายของผู้ใช้ที่ไม่ได้ใช้งานได้ดีขึ้น ผู้ใช้ป้อนกลุ่มเป้าหมายเหล่านี้โดยไม่มีเหตุการณ์ตามเกณฑ์ เช่น ผู้ใช้สามารถป้อนกลุ่มเป้าหมายได้โดยไม่ต้องเข้าชมเว็บไซต์เป็นเวลา 7 วัน ตัวอย่างของกลุ่มเป้าหมายที่เป็นผู้ใช้ที่ไม่ได้ใช้งาน ได้แก่ "ผู้ซื้อที่ไม่ได้ใช้งานเป็นเวลา 7 วัน" "ผู้ใช้ที่ไม่ได้ใช้งานเป็นเวลา 7 วัน" และ "ผู้ใช้ที่ไม่ได้รับการแจ้งเตือนในช่วง 7 วัน" ดูข้อมูลเพิ่มเติมเกี่ยวกับกลุ่มเป้าหมายที่แนะนําได้ที่กลุ่มเป้าหมายที่แนะนํา
2024-02-28 การส่งออกกลุ่มเป้าหมายจะแสดงรหัสผู้ใช้ที่ระบุในการติดแท็ก
ตอนนี้การส่งออกกลุ่มเป้าหมายจะแสดงรหัสผู้ใช้ที่ระบุในการติดแท็ก แม้ว่าจะเปิดใช้ข้อมูลที่ได้จากผู้ใช้สําหรับพร็อพเพอร์ตี้ก็ตาม หากเปิดการเก็บรวบรวมข้อมูลที่ได้จากผู้ใช้ ระบบจะส่งข้อมูลที่ได้จากผู้ใช้พร้อมกับ User-ID ไปยัง Google Analytics ในการติดแท็กเพื่อปรับปรุงการวัดผล ดูข้อมูลเพิ่มเติมได้ที่การเก็บรวบรวมข้อมูลที่ได้จากผู้ใช้
30-01-2024 รองรับการแจ้งเตือนเว็บฮุคสําหรับรายการกลุ่มเป้าหมาย รายการกลุ่มเป้าหมายที่เกิดซ้ำใน Data API เวอร์ชันอัลฟ่า 1
คุณระบุช่อง AudienceList.webhookNotification
และ RecurringAudienceList.webhookNotification
ได้เมื่อสร้างรายการกลุ่มเป้าหมาย (โดยใช้ properties.audienceLists.create) หรือรายการกลุ่มเป้าหมายที่เกิดซ้ำ (โดยใช้ properties.recurringAudienceLists.create)
ฟังก์ชันนี้ช่วยให้คุณได้รับการแจ้งเตือนเว็บฮุคแบบไม่พร้อมกันเมื่อรายการกลุ่มเป้าหมายพร้อมใช้งาน
2024-01-18 ปรับปรุงความเข้ากันได้สำหรับมิติข้อมูลที่มีคอมโพเนนต์สตริงหรือสตริงการค้นหาหรือนาที
มิติข้อมูลที่มีสตริงการค้นหาใช้ได้กับช่องส่วนใหญ่แล้ว
มิติข้อมูลอย่าง pagePathPlusQueryString
, unifiedPageScreen
, pageLocation
และ fullPageUrl
ใช้ได้กับช่องเพิ่มเติมมากมาย ได้แก่ sessionSource
, browser
, city
และ landingPage
ตอนนี้มิติข้อมูลที่มีคอมโพเนนต์นาทีใช้ได้กับช่องส่วนใหญ่แล้ว มิติข้อมูลอย่าง minute
, nthMinute
และ dateHourMinute
ใช้ร่วมกับชุดช่องเพิ่มเติมที่คล้ายกันได้แล้ว
ดูข้อมูลความเข้ากันได้ที่ครอบคลุมได้จากมิติข้อมูลและเครื่องมือสำรวจเมตริกของ GA4
2023-12-13 พารามิเตอร์ระดับสินค้าที่กำหนดเอง
ตอนนี้คุณสามารถรวมมิติข้อมูลที่กําหนดเองระดับสินค้าไว้ในการค้นหา API ข้อมูลของ Analytics โดยใช้ไวยากรณ์ต่อไปนี้ได้แล้ว
ชื่อ API ทั่วไป | คำอธิบาย |
---|---|
สินค้าที่กำหนดเอง:ชื่อพารามิเตอร์_ชื่อ | มิติข้อมูลที่กำหนดเองระดับสินค้าสำหรับ parameter_name |
ดูข้อมูลเพิ่มเติมที่มิติข้อมูลและเมตริกของ API
05-12-2023 มีให้บริการใน Data API v1 รุ่นเบต้าเป็นการส่งออกกลุ่มเป้าหมาย
ฟีเจอร์รายการกลุ่มเป้าหมายได้เปลี่ยนชื่อเป็น การส่งออกกลุ่มเป้าหมายและเพิ่มลงใน Data API เวอร์ชัน 1 เบต้าแล้ว
เพิ่มเมธอดต่อไปนี้ใน Data API v1 เบต้า
28-11-2023 เพิ่ม samplingMetadatas
ในคำตอบของรายงานแล้ว
เพิ่ม samplingMetadatas
ลงใน ResponseMetaData
แล้ว คอลเล็กชันนี้จะมี SampleMetadata
สำหรับช่วงวันที่แต่ละช่วงในคำขอที่มีการสุ่มตัวอย่างผลลัพธ์ Google Analytics จะใช้การสุ่มตัวอย่างเฉพาะในกรณีที่คาดว่าขีดจำกัดของ Cardinality จะลดคุณภาพของข้อมูลเท่านั้น
28-11-2023 เพิ่มฟังก์ชันการส่งออกรายการกลุ่มเป้าหมายที่เกิดซ้ำใน Data API เวอร์ชัน 1 อัลฟ่า
เพิ่มเมธอด properties.recurringAudienceLists.create
,
properties.recurringAudienceLists.create
,
properties.recurringAudienceLists.list
ใน Data API v1 alpha
ฟังก์ชันการทำงานนี้ช่วยให้คุณสร้างรายการกลุ่มเป้าหมายได้ทุกวันเมื่อการเป็นสมาชิกกลุ่มเป้าหมายเปลี่ยนแปลง รายการกลุ่มเป้าหมายที่เกิดซ้ำช่วยเพิ่มประสิทธิภาพ กับผลลัพธ์จากการเป็นสมาชิกกลุ่มเป้าหมายล่าสุด
08-11-2023 เพิ่มการส่งออกรายการกลุ่มเป้าหมายไปยังฟังก์ชันของชีตไปยัง Data API เวอร์ชัน 1 อัลฟ่า
เพิ่มเมธอด properties.audienceLists.exportSheet
ลงใน Data API v1 เวอร์ชันอัลฟ่าแล้ว ซึ่งจะช่วยให้คุณส่งออกรายการกลุ่มเป้าหมายไปยัง Google ชีตได้
13-10-2023 เพิ่มการรองรับกลุ่มเป้าหมายที่มีระยะเวลาการเป็นสมาชิก 1 วัน
ฟังก์ชันการส่งออกรายการกลุ่มเป้าหมายรองรับกลุ่มเป้าหมายที่มีระยะเวลาการเป็นสมาชิก 1 วันแล้ว
12-09-2023 กฎการจัดลำดับเริ่มต้นของรายการกลุ่มเป้าหมาย
โดยค่าเริ่มต้น รายงานที่สร้างขึ้นโดยใช้ฟังก์ชันการส่งออกรายการกลุ่มเป้าหมายจะมีลำดับตามกฎการจัดลำดับเดียวกับวิธีการรายงานอื่นๆ ของ Data API ซึ่งได้แก่ การจัดเรียงจะเรียงจากมากไปน้อยตามคอลัมน์แรก แล้วเรียงจากมากไปน้อยตามคอลัมน์ที่ 2 ฯลฯ
ก่อนการเปลี่ยนแปลงนี้ คุณอาจได้รับรายงานต่อไปนี้
deviceId | isAdsPersonalizationAllowed |
---|---|
ABC | จริง |
DAC | false |
ABC | false |
AAA | จริง |
หลังจากการเปลี่ยนแปลงนี้ คุณจะได้รับรายงานต่อไปนี้
deviceId | isAdsPersonalizationAllowed |
---|---|
AAA | จริง |
ABC | false |
ABC | จริง |
DAC | false |
15-08-2023 เพิ่มมิติข้อมูล isLimitedAdTracking
รายการในสคีมาการส่งออกรายการกลุ่มเป้าหมาย
isLimitedAdTracking
การตั้งค่า "จำกัดการติดตามโฆษณา" ของอุปกรณ์ ค่าที่เป็นไปได้ ได้แก่true
,false
และ(not set)
ดูข้อมูลเพิ่มเติมได้ที่มิติข้อมูลรายการกลุ่มเป้าหมาย
2023-08-15 เพิ่มมิติข้อมูล currencyCode
รายการ เมตริก itemDiscountAmount
รายการแล้ว
currencyCode
รหัสสกุลเงินท้องถิ่น (ตามมาตรฐาน ISO 4217) ของเหตุการณ์อีคอมเมิร์ซ เช่น "USD" หรือ "GBP"itemDiscountAmount
มูลค่าทางการเงินของส่วนลดสินค้าในกิจกรรมอีคอมเมิร์ซ เมตริกนี้สร้างขึ้นในการติดแท็กโดยพารามิเตอร์สินค้า "discount"
ดูข้อมูลเพิ่มเติมได้ในสคีมาการรายงาน Data API
10-08-2023 เพิ่มมิติข้อมูล isAdsPersonalizationAllowed
รายการในสคีมาการส่งออกรายการกลุ่มเป้าหมาย
isAdsPersonalizationAllowed
อนุญาตการปรับโฆษณาตามโปรไฟล์ของผู้ใช้หรือไม่ หากผู้ใช้มีสิทธิ์ใช้การปรับโฆษณาตามโปรไฟล์ของผู้ใช้isAdsPersonalizationAllowed
จะแสดงผลtrue
หากผู้ใช้ไม่มีสิทธิ์ใช้การปรับโฆษณาตามโปรไฟล์ของผู้ใช้isAdsPersonalizationAllowed
จะแสดงผลfalse
ดูข้อมูลเพิ่มเติมได้ที่มิติข้อมูลรายการกลุ่มเป้าหมาย
รายการกลุ่มเป้าหมาย 2023-07-2023
เพิ่มการรองรับรายการกลุ่มเป้าหมายใน Data API เวอร์ชัน 1 อัลฟ่าแล้ว รายการกลุ่มเป้าหมายประกอบด้วยภาพรวมของผู้ใช้ในกลุ่มเป้าหมายในขณะที่สร้างรายการกลุ่มเป้าหมาย
เมธอดต่อไปนี้ที่เพิ่มลงใน Data API v1 alpha
Channel Group ที่กําหนดเอง 2023-05-2023
เพิ่มการรองรับ Channel Group ที่กําหนดเองใน Data API
การเปลี่ยนแปลงโควต้าโทเค็น 2023-05-2023
ระบบโควต้าของ Data API ได้รับการอัปเดตเพื่อให้สามารถเรียกเก็บเงินได้อย่างแม่นยำยิ่งขึ้น
จำนวนโทเค็นที่เรียกเก็บสำหรับแต่ละคำขอได้รับการอัปเดตให้สอดคล้องกับการเปลี่ยนแปลงโควต้าและปรับสมดุลใหม่เพื่อให้คำค้นหาการรายงานง่ายๆ มีจำนวนมากขึ้น พร้อมทั้งเรียกเก็บเงินโทเค็นโควต้ามากขึ้นอย่างมากสำหรับรายงานวันที่ขนาดใหญ่
หลังจากการเปลี่ยนแปลงนี้ แม้การเรียกเก็บเงินสำหรับคำขอบางรายการจะยังคงเหมือนเดิม แต่การเรียกเก็บเงินสำหรับคำค้นหาที่ซับซ้อนขึ้นจะเพิ่มสูงขึ้นอย่างเห็นได้ชัด เช่น คำขอข้อมูลที่มีอายุเกิน 6 เดือนอาจเรียกเก็บเงินโทเค็นโควต้าตั้งแต่ 1,000 โทเค็นขึ้นไป
พร็อพเพอร์ตี้มาตรฐาน
ชื่อโควต้า | ขีดจำกัดเดิม | ขีดจำกัดใหม่ |
---|---|---|
โทเค็นหลักต่อพร็อพเพอร์ตี้ต่อวัน | 25,000 | 200,000 คน |
โทเค็นหลักต่อพร็อพเพอร์ตี้ต่อชั่วโมง | 5,000 | 40,000 คน |
โทเค็นหลักต่อโปรเจ็กต์ต่อพร็อพเพอร์ตี้ต่อชั่วโมง | 1,750 ตัว | 14,000 คน |
โทเค็นแบบเรียลไทม์ต่อพร็อพเพอร์ตี้ต่อวัน | 25,000 | 200,000 คน |
โทเค็นแบบเรียลไทม์ต่อพร็อพเพอร์ตี้ต่อชั่วโมง | 5,000 | 40,000 คน |
โทเค็นแบบเรียลไทม์ต่อโปรเจ็กต์ต่อพร็อพเพอร์ตี้ต่อชั่วโมง | 1,750 ตัว | 14,000 คน |
โทเค็นช่องทางต่อพร็อพเพอร์ตี้ต่อวัน | 25,000 | 200,000 คน |
โทเค็นช่องทางต่อพร็อพเพอร์ตี้ต่อชั่วโมง | 5,000 | 40,000 คน |
โทเค็น Funnel ต่อโปรเจ็กต์ต่อพร็อพเพอร์ตี้ต่อชั่วโมง | 1,750 ตัว | 14,000 คน |
พร็อพเพอร์ตี้ Analytics 360
ชื่อโควต้า | ขีดจำกัดเดิม | ขีดจำกัดใหม่ |
---|---|---|
โทเค็นหลักต่อพร็อพเพอร์ตี้ต่อวัน | 250,000 | 2,000,000 คน |
โทเค็นหลักต่อพร็อพเพอร์ตี้ต่อชั่วโมง | 50,000 | 400,000 คน |
โทเค็นหลักต่อโปรเจ็กต์ต่อพร็อพเพอร์ตี้ต่อชั่วโมง | 17,500 คน | 140,000 คน |
โทเค็นแบบเรียลไทม์ต่อพร็อพเพอร์ตี้ต่อวัน | 250,000 | 2,000,000 คน |
โทเค็นแบบเรียลไทม์ต่อพร็อพเพอร์ตี้ต่อชั่วโมง | 50,000 | 400,000 คน |
โทเค็นแบบเรียลไทม์ต่อโปรเจ็กต์ต่อพร็อพเพอร์ตี้ต่อชั่วโมง | 17,500 คน | 140,000 คน |
โทเค็นช่องทางต่อพร็อพเพอร์ตี้ต่อวัน | 250,000 | 2,000,000 คน |
โทเค็นช่องทางต่อพร็อพเพอร์ตี้ต่อชั่วโมง | 50,000 | 400,000 คน |
โทเค็น Funnel ต่อโปรเจ็กต์ต่อพร็อพเพอร์ตี้ต่อชั่วโมง | 17,500 คน | 140,000 คน |
2023-03-02 เพิ่มมิติข้อมูลวันที่แล้ว
ชื่อวันของสัปดาห์
dayOfWeekName
วันของสัปดาห์เป็นภาษาอังกฤษ มิติข้อมูลนี้มีค่าเป็นSunday
,Monday
ฯลฯisoWeek
สัปดาห์ ISO ของปี หมายเลขสัปดาห์ ISO ซึ่งแต่ละสัปดาห์จะเริ่มต้นในวันจันทร์ ดูรายละเอียดได้ที่ https://en.wikipedia.org/wiki/ISO_week_date ค่าตัวอย่าง ได้แก่01
,02
และ53
isoYear
ปี ISO ปี ISO ของกิจกรรม ดูรายละเอียดได้ที่ https://en.wikipedia.org/wiki/ISO_week_date ค่าตัวอย่าง ได้แก่2022
&2023
isoYearIsoWeek
สัปดาห์ ISO ของปี ISO ค่ารวมของisoWeek
และisoYear
ค่าตัวอย่าง ได้แก่201652
&201701
yearMonth
ปี ค่ารวมของyear
และmonth
ค่าตัวอย่าง ได้แก่202212
หรือ202301
yearWeek
ปี ค่ารวมของyear
และweek
ค่าตัวอย่าง ได้แก่202253
หรือ202301
27-02-2023 เพิ่มมิติข้อมูลอีคอมเมิร์ซแล้ว
itemListPosition
ตำแหน่งรายการสินค้า ตําแหน่งของสินค้า (เช่น ผลิตภัณฑ์ที่ขาย) ในรายการ มิติข้อมูลนี้สร้างขึ้นในการติดแท็กตามพารามิเตอร์ "index" ในอาร์เรย์ itemsitemLocationID
รหัสสถานที่ตั้งสินค้า สถานที่ตั้งจริงที่เชื่อมโยงกับสินค้า (เช่น สถานที่ตั้งกิจการที่มีหน้าร้านจริง) เราขอแนะนำให้ใช้รหัส Google Place ที่ตรงกับรายการที่เกี่ยวข้อง นอกจากนี้ยังใช้รหัสสถานที่ตั้งที่กำหนดเองได้อีกด้วย ช่องนี้จะป้อนข้อมูลในการติดแท็กโดยพารามิเตอร์ "location_id" ในอาร์เรย์ itemsitemPromotionCreativeSlot
ช่องครีเอทีฟโฆษณาโปรโมชันสินค้า ชื่อของสล็อตครีเอทีฟโฆษณาโปรโมชันที่เชื่อมโยงกับสินค้า มิติข้อมูลนี้ระบุในการติดแท็กได้โดยใช้พารามิเตอร์creative_slot
ที่ระดับเหตุการณ์หรือระดับสินค้า หากระบุพารามิเตอร์ทั้งในระดับเหตุการณ์และระดับสินค้า ระบบจะใช้พารามิเตอร์ระดับสินค้า
2023-02-21 เพิ่มมิติข้อมูล "หน้า Landing Page + สตริงการค้นหา"
landingPagePlusQueryString
หน้า Landing Page + สตริงการค้นหา เส้นทางหน้าเว็บ + สตริงการค้นหาที่เชื่อมโยงกับการดูหน้าเว็บครั้งแรกในเซสชัน
ช่องนี้แทนที่มิติข้อมูล landingPage
ที่เลิกใช้งานแล้ว และจะได้รับการอัปเดตไม่ให้แสดงสตริงการค้นหาในวันที่ 14 พฤษภาคม 2023
28-01-2023 เพิ่มเมตริก "การดูต่อผู้ใช้", "ผู้ใช้ที่เลื่อน"
การดู
screenPageViewsPerUser
ครั้งต่อผู้ใช้ จํานวนหน้าจอแอปหรือหน้าเว็บที่ผู้ใช้ดูต่อผู้ใช้ที่ใช้งานอยู่ นับการดูหน้าเว็บหรือหน้าจอเดียวซ้ำหลายครั้งด้วย(screen_view + page_view events) / active users
.ผู้ใช้ที่เลื่อนหน้าจอ
scrolledUsers
คน จํานวนผู้ใช้ที่ไม่ซ้ำที่เลื่อนหน้าเว็บลงอย่างน้อย 90%
2023-01-23 เพิ่มมิติข้อมูล "ทวีป" "รหัสทวีป"
continent
ทวีป ทวีปที่เกิดกิจกรรมของผู้ใช้ เช่นAmericas
หรือAsia
รหัสทวีป
continentId
รหัสทางภูมิศาสตร์ของทวีปที่เกิดกิจกรรมของผู้ใช้ ซึ่งดูจากที่อยู่ IP ของผู้ใช้
2023-01-23 เพิ่มมิติข้อมูล "รหัสตัวกรองข้อมูลทดสอบ"
testDataFilterId
รหัสตัวกรองข้อมูลทดสอบ ตัวระบุที่เป็นตัวเลขของตัวกรองข้อมูลในสถานะทดสอบ คุณใช้ตัวกรองข้อมูลเพื่อรวมหรือยกเว้นข้อมูลเหตุการณ์จากรายงานตามค่าพารามิเตอร์เหตุการณ์ ดูข้อมูลเพิ่มเติมได้ที่ https://support.google.com/analytics/answer/10108813
18-10-2022 เพิ่มเมตริก Google Ads
- การคลิกโฆษณา
advertiserAdClicks
ครั้ง จํานวนครั้งที่ผู้ใช้คลิกที่โฆษณาเพื่อเข้าถึงพร็อพเพอร์ตี้ - ค่าโฆษณา
advertiserAdCost
จำนวนเงินทั้งหมดที่คุณจ่ายสำหรับโฆษณา - ต้นทุนต่อคลิกของโฆษณา
advertiserAdCostPerClick
ต้นทุนต่อคลิกของโฆษณาคือค่าใช้จ่ายโฆษณาหารด้วยจำนวนการคลิกโฆษณา และมักจะเป็นค่า CPC แบบย่อ advertiserAdCostPerConversion
ต้นทุนต่อ Conversion ต้นทุนต่อ Conversion คือค่าใช้จ่ายโฆษณาหารด้วย Conversion- การแสดงโฆษณา
advertiserAdImpressions
ครั้ง จำนวนการแสดงผลทั้งหมด returnOnAdSpend
ผลตอบแทนจากค่าโฆษณา ผลตอบแทนจากค่าโฆษณา (ROAS) คือรายได้ทั้งหมดหารด้วยค่าใช้จ่ายโฆษณาของผู้ลงโฆษณา
17-10-2022 เพิ่มเมตริกที่กำหนดขอบเขตระดับสินค้า
- เพิ่มสินค้า
itemsAddedToCart
รายการลงในรถเข็นแล้ว จํานวนหน่วยที่เพิ่มลงในรถเข็นสำหรับสินค้า 1 รายการ - ชำระเงินแล้ว
itemsCheckedOut
รายการ จำนวนหน่วยที่ชำระเงินสำหรับสินค้า 1 รายการ itemsClickedInList
คลิกในรายการ จำนวนหน่วยที่คลิกในรายการสำหรับรายการเดียวitemsClickedInPromotion
สินค้าที่คลิกในโปรโมชัน จํานวนหน่วยที่คลิกในโปรโมชันสำหรับสินค้ารายการเดียว- ดูแล้ว
itemsViewed
รายการ จํานวนหน่วยที่ดูสำหรับสินค้ารายการเดียว - สินค้าที่ดู
itemsViewedInList
รายการ จํานวนหน่วยที่ดูในรายการสําหรับสินค้ารายการเดียว - สินค้าที่ดูในโปรโมชัน
itemsViewedInPromotion
รายการ จํานวนหน่วยที่ดูในโปรโมชันสําหรับสินค้ารายการเดียว
13-09-2022 ประกาศการเปลี่ยนแปลงความเข้ากันได้ของสคีมา
ในวันที่ 1 ธันวาคม 2022 การเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบต่อไปนี้จะเกิดขึ้น
มิติข้อมูลที่กําหนดขอบเขตระดับสินค้า เช่น
itemName
จะใช้กับเมตริกที่กําหนดขอบเขตระดับเหตุการณ์ เช่นeventCount
ไม่ได้ มิติข้อมูลระดับสินค้าจะยังคงใช้ร่วมกับเมตริกที่กําหนดขอบเขตระดับสินค้า เช่นitemRevenue
, เมตริกที่อิงตามผู้ใช้ เช่นactiveUsers
และเมตริกตามเซสชัน เช่นsessions
ได้มิติข้อมูลการระบุแหล่งที่มา เช่น
source
ใช้ไม่ได้กับเมตริกที่กำหนดขอบเขตระดับเหตุการณ์บางรายการ เช่นeventCount
มิติข้อมูลการระบุแหล่งที่มาจะยังคงใช้ร่วมกับเมตริกที่ระบุแหล่งที่มาได้ เช่นconversions
เมตริกตามผู้ใช้ เช่นactiveUsers
และเมตริกตามเซสชัน เช่นsessions
มิติข้อมูลที่มีสตริงการค้นหา เช่น
pagePathPlusQueryString
จะใช้ได้เฉพาะกับชุดมิติข้อมูลและเมตริกบางชุดเท่านั้น
โปรดดูคำอธิบายโดยละเอียดเกี่ยวกับการเปลี่ยนแปลงความเข้ากันได้เพื่อดูข้อมูลเพิ่มเติม
01-09-2022 การเปลี่ยนแปลงโควต้า
ระบบจะนำโควต้า
Requests per day
,Requests Per Minute
,Requests Per Minute Per User
ออกจาก Data APIเพิ่มโควต้า
Tokens Per Project Per Property Per Hour
รายการไปยัง API แล้วคำขอแต่ละรายการจะใช้โควต้าสำหรับทั้ง
Tokens Per Property Per Hour
และTokens Per Project Per Property Per Hour
ดูข้อมูลโดยละเอียดเกี่ยวกับโควต้าใหม่ได้ในเอกสารประกอบเกี่ยวกับโควต้า
2022-08-03 เพิ่มมิติข้อมูล SA360 ที่กำหนดขอบเขตระดับเซสชัน
sessionSa360AdGroupName
ชื่อกลุ่มโฆษณาของเซสชัน SA360 ชื่อกลุ่มโฆษณาจาก Search Ads 360 ที่นํามายังเซสชันนี้sessionSa360CampaignName
แคมเปญของเซสชัน SA360 ชื่อแคมเปญจาก Search Ads 360 ที่นํามายังเซสชันนี้sessionSa360CreativeFormat
รูปแบบครีเอทีฟโฆษณาใน SA360 ของเซสชัน ประเภทครีเอทีฟโฆษณาใน Search Ads 360 ที่นํามายังเซสชันนี้ เช่น "โฆษณา Search ที่ปรับเปลี่ยนตามบริบท" หรือ "โฆษณาแบบข้อความที่ขยายออก"sessionSa360EngineAccountId
รหัสบัญชีเครื่องมือค้นหาของเซสชัน SA360 รหัสบัญชีเครื่องมือค้นหาใน SA360 ที่นําไปยังเซสชันนี้sessionSa360EngineAccountName
ชื่อบัญชีเครื่องมือค้นหาของเซสชัน SA360 ชื่อบัญชีเครื่องมือค้นหาใน SA360 ที่นําไปยังเซสชันนี้sessionSa360EngineAccountType
ประเภทบัญชีเครื่องมือค้นหาของเซสชัน SA360 ประเภทบัญชีเครื่องมือค้นหาใน Search Ads 360 ที่นํามายังเซสชันนี้ ตัวอย่างเช่น "Google Ads" "bing" หรือ "Baidu"sessionSa360Keyword
ข้อความคีย์เวิร์ดของเซสชัน SA360 คีย์เวิร์ดในเครื่องมือค้นหาจาก Search Ads 360 ที่นํามายังเซสชันนี้sessionSa360Medium
สื่อของเซสชัน SA360 คีย์เวิร์ดในเครื่องมือค้นหาจาก Search Ads 360 ที่นํามายังเซสชันนี้ เช่น "cpc"sessionSa360Query
การค้นหาใน SA360 ของเซสชัน คําค้นหาจาก Search Ads 360 ที่นํามาใช้เซสชันนี้sessionSa360Source
แหล่งที่มาของเซสชัน SA360 แหล่งที่มาของการเข้าชมจาก Search Ads 360 ที่นํามายังเซสชันนี้ ตัวอย่างเช่น "example.com" หรือ "google"sessionCampaignId
มิติข้อมูลsessionCampaignName
รองรับแคมเปญ Search Ads 360 แล้ว
11-07-2022 เพิ่มเมตริกอัตรา Conversion
อัตรา Conversion
sessionConversionRate
เปอร์เซ็นต์ของเซสชันที่เรียกให้แสดงเหตุการณ์ ConversionuserConversionRate
เปอร์เซ็นต์ของผู้ใช้ที่เรียกให้แสดงเหตุการณ์ Conversion
เมตริกอัตรา Conversion สำหรับ 1 Conversion
sessionConversionRate:event_name
เปอร์เซ็นต์ของเซสชันที่เรียกให้แสดงเหตุการณ์ Conversion หนึ่งๆuserConversionRate:event_name
เปอร์เซ็นต์ของผู้ใช้ที่เรียกให้แสดงเหตุการณ์ Conversion หนึ่งๆ
2022-05-05 เพิ่มฟังก์ชันการรายงาน Funnel ในแชแนลอัลฟ่า
เมธอด
runFunnelReport
ที่เพิ่มลงใน API เวอร์ชัน v1alpha ซึ่งแสดงผลรายงานช่องทางที่กำหนดเองของข้อมูลเหตุการณ์ Google Analyticsวิธีการนี้จะเปิดตัวเมื่อมีความเสถียรในเวอร์ชันอัลฟ่า โดยมีจุดประสงค์เพื่อรวบรวมความคิดเห็นเกี่ยวกับไวยากรณ์และความสามารถต่างๆ ก่อนเข้าสู่เวอร์ชันเบต้า โปรดกรอกความคิดเห็นในการรายงาน Funnel ของ Google Analytics Data API เพื่อแสดงความคิดเห็นเกี่ยวกับ API นี้
2022-02-16 เพิ่มมิติข้อมูลใหม่
คำและเนื้อหาที่กำหนดเอง
firstUserManualAdContent
เนื้อหาโฆษณาที่กำหนดเองของผู้ใช้ครั้งแรก เนื้อหาโฆษณา ที่ได้ผู้ใช้ก่อน ป้อนข้อมูลโดยพารามิเตอร์utm_content
firstUserManualTerm
คำที่กำหนดเองของผู้ใช้ครั้งแรก คำที่ได้ผู้ใช้ก่อน ป้อนข้อมูลโดยพารามิเตอร์utm_term
manualAdContent
เนื้อหาโฆษณาที่กำหนดเอง เนื้อหาโฆษณาที่มาจาก เหตุการณ์ Conversion ป้อนข้อมูลโดยพารามิเตอร์utm_content
manualTerm
คำที่กำหนดเอง คําที่มีแหล่งที่มาจากเหตุการณ์ Conversion ป้อนข้อมูลโดยพารามิเตอร์utm_term
เนื้อหาโฆษณาที่กำหนดเองในเซสชัน
sessionManualAdContent
เนื้อหาโฆษณาที่ทำให้เกิด เซสชัน ป้อนข้อมูลโดยพารามิเตอร์utm_content
sessionManualTerm
คำที่กำหนดเองในเซสชัน คําที่ทําให้เกิดเซสชัน ป้อนข้อมูลโดยพารามิเตอร์utm_term
การวิเคราะห์ข้อขัดข้อง
crashAffectedUsers
ผู้ใช้ที่ได้รับผลกระทบจากข้อขัดข้อง จำนวนผู้ใช้ที่บันทึกข้อขัดข้องในแถวนี้ของรายงานcrashFreeUsersRate
อัตราผู้ใช้ที่ไม่พบข้อขัดข้อง
แอป/เว็บ
averageSessionDuration
ระยะเวลาเฉลี่ย (เป็นวินาที) ของเซสชันของผู้ใช้ผู้ใช้ใหม่ / ผู้ใช้ที่กลับมา
newVsReturning
รายscreenPageViewsPerSession
การดูต่อเซสชันlandingPage
หน้า Landing Page เส้นทางหน้าเว็บ + สตริงการค้นหาที่เชื่อมโยงกับ การดูหน้าเว็บครั้งแรกในเซสชันplatformDeviceCategory
แพลตฟอร์มและประเภทของอุปกรณ์ที่เว็บไซต์หรือแอปบนอุปกรณ์เคลื่อนที่ทำงาน
แอปบนอุปกรณ์เคลื่อนที่
averagePurchaseRevenuePerUser
รายได้จากการซื้อโดยเฉลี่ยต่อผู้ใช้firstTimePurchaserConversionRate
เปอร์เซ็นต์ของผู้ใช้ที่ใช้งานอยู่ซึ่งทำการซื้อครั้งแรกfirstTimePurchasersPerNewUser
จำนวนผู้ซื้อครั้งแรกโดยเฉลี่ย ต่อผู้ใช้ใหม่dauPerMau
DAU / MAU เปอร์เซ็นต์ต่อเนื่องของผู้ใช้ที่ใช้งานอยู่ในช่วง 30 วัน ซึ่งเป็นผู้ใช้ที่ใช้งานใน 1 วันด้วยDAU / WAU
dauPerWau
รายการ เปอร์เซ็นต์ต่อเนื่องของผู้ใช้ที่ใช้งานอยู่ในช่วง 7 วัน และยังเป็นผู้ใช้ที่ใช้งานอยู่ใน 1 วันด้วยWAU / MAU
wauPerMau
เปอร์เซ็นต์ต่อเนื่องของผู้ใช้ที่ใช้งานอยู่ในช่วง 30 วัน ซึ่งเป็นผู้ใช้ที่ใช้งานในช่วง 7 วันด้วยpurchaserConversionRate
เปอร์เซ็นต์ของผู้ใช้ที่ใช้งานอยู่ซึ่งทำธุรกรรมการซื้ออย่างน้อย 1 รายการtransactionsPerPurchaser
ธุรกรรมต่อผู้ซื้อ
แคมเปญ Google Ads
firstUserGoogleAdsCampaignType
ประเภทแคมเปญ Google Ads ที่ได้ผู้ใช้ก่อนgoogleAdsCampaignType
ประเภทแคมเปญสำหรับแคมเปญ Google Ads ที่มีแหล่งที่มาจากเหตุการณ์ ConversionsessionGoogleAdsCampaignType
ประเภทแคมเปญของแคมเปญ Google Ads ที่นำมาสู่เซสชันนี้
2021-09-07 เพิ่มมิติข้อมูลวันที่/เวลาใหม่
dateHourMinute
ค่ารวมของวันที่ ชั่วโมง และนาที โดยอยู่ในรูปแบบ YYYYMMDDHHMMminute
นาทีแบบ 2 หลักของชั่วโมงที่บันทึกเหตุการณ์nthMinute
จำนวนนาทีนับตั้งแต่ที่เริ่มต้นช่วงวันที่
2021-09-07 เพิ่มมิติข้อมูลใหม่ที่สร้างโดยพารามิเตอร์เหตุการณ์
achievementId
รหัสรางวัลพิเศษในเกมสำหรับกิจกรรมcharacter
ตัวละครของผู้เล่นในเกมสําหรับเหตุการณ์fileExtension
ส่วนขยายของไฟล์ที่ดาวน์โหลดfileName
เส้นทางหน้าเว็บของไฟล์ที่ดาวน์โหลดgroupId
รหัสกลุ่มผู้เล่นในเกมสําหรับเหตุการณ์linkClasses
แอตทริบิวต์คลาส HTML สำหรับลิงก์ขาออกlinkDomain
โดเมนปลายทางของลิงก์ขาออกlinkId
แอตทริบิวต์รหัส HTML สำหรับลิงก์ขาออกหรือไฟล์ดาวน์โหลดlinkText
ข้อความลิงก์ของไฟล์ดาวน์โหลดlinkUrl
URL แบบเต็มของลิงก์ขาออกหรือไฟล์ดาวน์โหลดmethod
วิธีการเรียกเหตุการณ์ให้แสดงoutbound
แสดงผล "จริง" หากลิงก์นำไปยังเว็บไซต์ไม่ได้เป็นส่วนหนึ่งของโดเมนของพร็อพเพอร์ตี้pageLocation
โปรโตคอล ชื่อโฮสต์ เส้นทางหน้าเว็บ และสตริงการค้นหาสำหรับหน้าเว็บที่เข้าชมpageReferrer
URL อ้างอิงแบบเต็มที่มีชื่อโฮสต์และเส้นทางpercentScrolled
เปอร์เซ็นต์ที่ผู้ใช้เลื่อนจากด้านล่างของหน้าเว็บ (เช่น "90")searchTerm
คำที่ผู้ใช้ค้นหาvideoProvider
แหล่งที่มาของวิดีโอ (เช่น "youtube")videoTitle
ชื่อของวิดีโอvideoUrl
URL ของวิดีโอvisible
แสดงผล "true" หากเนื้อหามองเห็นได้unifiedPagePathScreen
เส้นทางหน้าเว็บ (เว็บ) หรือคลาสหน้าจอ (แอป) ที่มีการบันทึกเหตุการณ์
07-09-2021 การเปลี่ยนแปลงสคีมา API
การเปลี่ยนแปลงมิติข้อมูลที่มีอยู่
unifiedPageScreen
สำหรับเหตุการณ์ที่เว็บสร้างขึ้น มิติข้อมูลนี้จะแสดงเส้นทางหน้าเว็บและสตริงการค้นหาที่เหตุการณ์บันทึกไว้
ประกาศเกี่ยวกับการเปลี่ยนแปลงที่กำลังจะเกิดขึ้น:
firstUserTrafficOrigin
ต้นทางการเข้าชมที่ได้ผู้ใช้ก่อน โปรดอย่าอาศัยช่องนี้ที่แสดง "ด้วยตนเอง" สำหรับการเข้าชมที่ใช้ UTM ช่องนี้จะอัปเดตจากการแสดงผล "ด้วยตนเอง" เป็น "(not set)" สำหรับการเปิดตัวฟีเจอร์ที่กำลังจะเกิดขึ้นsessionTrafficOrigin
ต้นทางการเข้าชมของแคมเปญของเซสชัน โปรดอย่าอาศัยช่องนี้ที่แสดง "ด้วยตนเอง" สำหรับการเข้าชมที่ใช้ UTM ช่องนี้จะอัปเดตจากการแสดงผล "ด้วยตนเอง" เป็น "(not set)" สำหรับการเปิดตัวฟีเจอร์ที่กำลังจะเกิดขึ้นtrafficOrigin
ต้นทางการเข้าชมของแคมเปญของเหตุการณ์ Conversion โปรดอย่าอาศัยช่องนี้ที่แสดง "ด้วยตนเอง" สำหรับการเข้าชมที่ใช้ UTM ช่องนี้จะอัปเดตจากการแสดงผล "ด้วยตนเอง" เป็น "(not set)" สำหรับการเปิดตัวฟีเจอร์ที่กำลังจะเกิดขึ้น
เพิ่มเมธอด checkCompatibility
2021-09-07 ลงใน API แล้ว
checkCompatibility
จะแสดงมิติข้อมูลและเมตริกที่สามารถเพิ่มลงในคำขอรายงานและรักษาความเข้ากันได้
21-07-2021 การเปลี่ยนแปลงในการรายงานแบบเรียลไทม์
ตอนนี้คุณสามารถระบุช่วงนาทีของข้อมูลเหตุการณ์ที่อ่านได้โดยใช้พารามิเตอร์ minuteRanges
ของเมธอด runRealtimeReport
2021-07-21 มิติข้อมูลการจัด Channel Group ใหม่
มิติข้อมูลการจัด Channel Group ใหม่ที่เพิ่มลงในสคีมาการรายงาน API ข้อมูล ได้แก่
firstUserDefaultChannelGrouping
การจัด Channel Group เริ่มต้นของผู้ใช้ครั้งแรกdefaultChannelGrouping
การจัด Channel Group เริ่มต้น
สคีมา API 2021-06-2021
เพิ่มมิติข้อมูล
minutesAgo
ลงในสคีมาแบบเรียลไทม์ของ Data API แล้ว และจะใช้ในการค้นหาไปยังเมธอดrunRealtimeReport
ได้ มิติข้อมูลนี้แสดงจำนวนนาทีที่ผ่านมาที่มีการรวบรวมเหตุการณ์ 00 หมายถึงนาทีปัจจุบัน และ 01 หมายถึงนาทีก่อนหน้าเพิ่มมิติข้อมูล
googleAdsCreativeId
รายการลงในสคีมา Data API แล้ว มิติข้อมูลนี้มีรหัสของครีเอทีฟโฆษณา Google Ads ที่มาจากเหตุการณ์ Conversionเพิ่มมิติข้อมูล
sessionGoogleAdsCreativeId
รายการลงในสคีมา Data API แล้ว มิติข้อมูลนี้ประกอบด้วยรหัสของครีเอทีฟโฆษณา Google Ads ที่ทําให้เกิดเซสชันในเว็บไซต์หรือแอปเปลี่ยนชื่อมิติข้อมูล
firstUserCreativeId
เป็นfirstUserGoogleAdsCreativeId
ในสคีมา Data API มิติข้อมูลนี้มีรหัสของครีเอทีฟโฆษณา Google Ads ที่ได้ผู้ใช้ก่อน
09-04-2021 เปิดตัว Google Analytics Data API เวอร์ชัน 1 รุ่นเบต้า
อัปเดตปลายทาง API เป็น
https://analyticsdata.googleapis.com/v1beta
แล้วตอนนี้เมธอด
runReport
,runPivotReport
,batchRunReports
,batchRunPivotReports
จะยอมรับรหัสของพร็อพเพอร์ตี้ Google Analytics 4 ในพารามิเตอร์property
ของเส้นทาง URL แทนช่องentity
ของเนื้อหาคำขอ ดังนี้POST https://analyticsdata.googleapis.com/v1beta/GA4_PROPERTY_ID:batchRunReports
อัปเดตไลบรารีของไคลเอ็นต์ API ให้ใช้ปลายทาง API ใหม่แล้ว
2021-02-19 มีการเปลี่ยนแปลงการใส่เลขหน้า
ขนาดการตอบกลับรายงานเริ่มต้นเพิ่มขึ้นจาก 10 เป็น 10,000 แถว
ค่า
"limit" : -1
ที่ใช้เพื่อระบุว่าพยายามเรียกข้อมูลแถวทั้งหมดจะไม่ได้รับการรองรับใน RunReportRequest อีกต่อไปค่าสูงสุดของช่อง
limit
ตั้งค่าไว้เป็น100000
ใช้การใส่เลขหน้าเพื่อเรียกดูรายงานที่มีแถวมากกว่า 100,000 แถว
08-02-2021 มิติข้อมูลและเมตริกอีคอมเมิร์ซใหม่
มีการเพิ่มมิติข้อมูลและเมตริกอีคอมเมิร์ซใหม่ในสคีมา API ดังนี้
มิติข้อมูล: adFormat
, adSourceName
, adUnitName
, itemBrand
,
itemCategory
, itemCategory2
, itemCategory3
, itemCategory4
,
itemCategory5
itemId
, itemListId
, itemListName
, itemName
,
itemPromotionCreativeName
, itemPromotionId
, itemPromotionName
,
orderCoupon
, transactionId
เมตริก: adUnitExposure
, addToCarts
, cartToViewRate
, checkouts
,
ecommercePurchases
, firstTimePurchasers
, itemListClickThroughRate
,
itemListClicks
, itemListViews
, itemPromotionClickThroughRate
,
itemPromotionClicks
, itemPromotionViews
, itemPurchaseQuantity
,
itemRevenue
, itemViews
, publisherAdClicks
,
publisherAdImpressions
, totalPurchasers
2021-02-08 เพิ่มมิติข้อมูลแคมเปญใหม่แล้ว
มีการเพิ่มมิติข้อมูลแคมเปญแบบใหม่ในสคีมา API ได้แก่
campaignId
, campaignName
, googleAdsAccountName
,
googleAdsAdGroupId
, googleAdsAdGroupName
, googleAdsAdNetworkType
,
source
, trafficOrigin
08-02-2021 dayOfWeek
, มิติข้อมูล week
รายการมีการเปลี่ยนแปลง
ตอนนี้ค่าของมิติข้อมูล
dayOfWeek
จะเริ่มต้นด้วย 0 แทนที่จะเป็น 1ตอนนี้ค่าของมิติข้อมูล
week
จะขึ้นต้นด้วย 01 และแสดงผลตัวเลข 2 หลักตั้งแต่ 01 ถึง 53 แต่ละสัปดาห์เริ่มต้นที่วันอาทิตย์ วันที่ 1 มกราคมเป็นสัปดาห์ 01 เสมอ
28-01-2021 เพิ่มตัวแปรการรวมสำหรับเมตริกที่กำหนดเอง
เมตริกที่กําหนดเองแต่ละรายการที่พร็อพเพอร์ตี้ลงทะเบียนจะสร้างรูปแบบเมตริก API 3 รายการ ได้แก่ ผลรวม ค่าเฉลี่ย และจำนวน
2021-01-28 เพิ่มมิติข้อมูลวันที่/เวลาใหม่
มีการเพิ่มมิติข้อมูลใหม่ต่อไปนี้ในสคีมา API:
hour
, nthHour
, nthYear
, dateHour
28-01-2021 Data API ลดโทเค็นโควต้าที่เรียกเก็บต่อการค้นหา
Data API ลดโทเค็นโควต้าที่เรียกเก็บเงินต่อการค้นหา ขีดจำกัดโควต้าสำหรับโทเค็นโควต้าพร็อพเพอร์ตี้ต่อชั่วโมงและต่อวันไม่มีการเปลี่ยนแปลง
2020-11-09 ลบเมธอด getUniversalMetadata
แล้ว
ลบเมธอด getUniversalMetadata
แล้ว โปรดใช้ getMetadata ระบบนำช่วงวันที่สูงสุด 1 ปีต่อคำขอ API ออกแล้ว
02-11-2020 เพิ่มวิธีการรายงานแบบเรียลไทม์
โปรดดูการสร้างรายงานแบบเรียลไทม์เพื่อดูตัวอย่าง และ runRealtimeReport สำหรับเอกสารอ้างอิงของ REST
19-10-2020 อัปเดตอาร์ติแฟกต์ไลบรารีของไคลเอ็นต์แล้ว
อาร์ติแฟกต์ไลบรารีของไคลเอ็นต์ได้รับการอัปเดตพร้อมกับคำแนะนำการใช้งานและตัวอย่างโค้ด
13-10-2020 พร็อพเพอร์ตี้แอป + เว็บได้เปลี่ยนชื่อเป็น Google Analytics 4 (GA4)
เพิ่มเมธอด getMetadata
2020-10-08 ลงใน API แล้ว
เมธอด getMetadata จะแสดงมิติข้อมูลและเมตริกที่กําหนดเองซึ่งใช้ได้กับรหัสพร็อพเพอร์ตี้ GA4 ที่ระบุ และข้อมูลเมตาสากล
08-10-2020 มิติข้อมูลและเมตริกที่กำหนดเองพร้อมใช้งานแล้วในรายงาน
ดูเอกสารประกอบสคีมา API เพื่อดูเอกสารเกี่ยวกับมิติข้อมูลและเมตริกที่กำหนดเอง การอัปเดตนี้ประกอบด้วยมิติข้อมูลและเมตริกที่กำหนดเองที่กำหนดขอบเขตระดับเหตุการณ์ รวมถึงมิติข้อมูลที่กำหนดเองที่กำหนดขอบเขตระดับผู้ใช้