บันทึกการเปลี่ยนแปลง

หากต้องการประกาศอย่างเป็นทางการเกี่ยวกับ 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

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 แหล่งที่มา / สื่อ DV360

  • firstUserDv360AdvertiserId รหัสผู้ลงโฆษณา 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 ชื่อบัญชีเครื่องมือค้นหา SA360

  • sa360EngineAccountType ประเภทบัญชีเครื่องมือค้นหา SA360

  • sa360KeywordText ข้อความคีย์เวิร์ด 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 รายการในสคีมาการส่งออกรายการกลุ่มเป้าหมาย

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" ในอาร์เรย์ items

  • itemLocationID รหัสสถานที่ตั้งสินค้า สถานที่ตั้งจริงที่เชื่อมโยงกับสินค้า (เช่น สถานที่ตั้งกิจการที่มีหน้าร้านจริง) เราขอแนะนำให้ใช้รหัส Google Place ที่ตรงกับรายการที่เกี่ยวข้อง นอกจากนี้ยังใช้รหัสสถานที่ตั้งที่กำหนดเองได้อีกด้วย ช่องนี้จะป้อนข้อมูลในการติดแท็กโดยพารามิเตอร์ "location_id" ในอาร์เรย์ items

  • itemPromotionCreativeSlot ช่องครีเอทีฟโฆษณาโปรโมชันสินค้า ชื่อของสล็อตครีเอทีฟโฆษณาโปรโมชันที่เชื่อมโยงกับสินค้า มิติข้อมูลนี้ระบุในการติดแท็กได้โดยใช้พารามิเตอร์ 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 การเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบต่อไปนี้จะเกิดขึ้น

  1. มิติข้อมูลที่กําหนดขอบเขตระดับสินค้า เช่น itemName จะใช้กับเมตริกที่กําหนดขอบเขตระดับเหตุการณ์ เช่น eventCount ไม่ได้ มิติข้อมูลระดับสินค้าจะยังคงใช้ร่วมกับเมตริกที่กําหนดขอบเขตระดับสินค้า เช่น itemRevenue, เมตริกที่อิงตามผู้ใช้ เช่น activeUsers และเมตริกตามเซสชัน เช่น sessions ได้

  2. มิติข้อมูลการระบุแหล่งที่มา เช่น source ใช้ไม่ได้กับเมตริกที่กำหนดขอบเขตระดับเหตุการณ์บางรายการ เช่น eventCount มิติข้อมูลการระบุแหล่งที่มาจะยังคงใช้ร่วมกับเมตริกที่ระบุแหล่งที่มาได้ เช่น conversions เมตริกตามผู้ใช้ เช่น activeUsers และเมตริกตามเซสชัน เช่น sessions

  3. มิติข้อมูลที่มีสตริงการค้นหา เช่น 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 เปอร์เซ็นต์ของเซสชันที่เรียกให้แสดงเหตุการณ์ Conversion

  • userConversionRate เปอร์เซ็นต์ของผู้ใช้ที่เรียกให้แสดงเหตุการณ์ 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 ที่มีแหล่งที่มาจากเหตุการณ์ Conversion

  • sessionGoogleAdsCampaignType ประเภทแคมเปญของแคมเปญ Google Ads ที่นำมาสู่เซสชันนี้

2021-09-07 เพิ่มมิติข้อมูลวันที่/เวลาใหม่

  • dateHourMinute ค่ารวมของวันที่ ชั่วโมง และนาที โดยอยู่ในรูปแบบ YYYYMMDDHHMM

  • minute นาทีแบบ 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 เพื่อดูเอกสารเกี่ยวกับมิติข้อมูลและเมตริกที่กำหนดเอง การอัปเดตนี้ประกอบด้วยมิติข้อมูลและเมตริกที่กำหนดเองที่กำหนดขอบเขตระดับเหตุการณ์ รวมถึงมิติข้อมูลที่กำหนดเองที่กำหนดขอบเขตระดับผู้ใช้