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

หากต้องการประกาศอย่างเป็นทางการเกี่ยวกับ API ของ Google Analytics โปรดติดตาม กลุ่มการแจ้งเตือนเกี่ยวกับ API ของ Google Analytics

2024-10-20 เพิ่มประเภทตัวกรองมิติข้อมูล EmptyFilter

การใช้ตัวกรองมิติข้อมูล EmptyFilter คุณจะสร้างเงื่อนไขการกรองเพื่อ เปรียบเทียบกับค่าว่างได้

15-10-2024 เพิ่มฟีเจอร์ระดับการสุ่มตัวอย่างลงในเมธอด reportTasks

การใช้ฟิลด์ samplingLevel ของเมธอด properties.runReportTask จะช่วยให้คุณควบคุมระดับการสุ่มตัวอย่างของรายงานได้

ฟีเจอร์นี้ช่วยให้พร็อพเพอร์ตี้ Google Analytics 360 เข้าถึงขีดจํากัดการเก็บตัวอย่างที่สูงขึ้นได้ถึง 1,000 ล้านเหตุการณ์ นอกจากนี้ ยังตั้งค่าขีดจํากัดการสุ่มตัวอย่างเป็น UNSAMPLED สําหรับผลลัพธ์แบบไม่สุ่มตัวอย่างที่มีจํานวนเหตุการณ์มากได้ด้วย

2024-09-18 เพิ่มฟีเจอร์สแนปชอตโควต้าพร็อพเพอร์ตี้

เมื่อใช้เมธอด properties.getPropertyQuotasSnapshot คุณจะดูสแนปชอตปัจจุบันของโควต้าพร็อพเพอร์ตี้ทั้งหมด ที่จัดระเบียบตามหมวดหมู่โควต้าสำหรับพร็อพเพอร์ตี้ที่ระบุได้

28-06-2024 เพิ่มโควต้า "ข้อผิดพลาดของไคลเอ็นต์ต่อโปรเจ็กต์ต่อพร็อพเพอร์ตี้"

ตอนนี้เราจำกัดข้อผิดพลาดของเซิร์ฟเวอร์ API ไว้ที่ 10,000 รายการต่อโปรเจ็กต์ ต่อพร็อพเพอร์ตี้ ภายในช่วงเวลา 15 นาที ซึ่งรวมถึงคำขอทั้งหมดที่ส่งผลให้เกิดการตอบกลับที่มีรหัสอื่นที่ไม่ใช่ 500 หรือ 200 ตัวอย่างข้อผิดพลาดที่อยู่ภายใต้โควต้านี้ ได้แก่ การใช้ชุดค่าผสมของมิติข้อมูลและเมตริกที่ไม่เข้ากัน ข้อผิดพลาดในการตรวจสอบสิทธิ์ทั้งหมด

หากเกินขีดจำกัดนี้ ระบบจะบล็อกการเรียก API เพิ่มเติมไปยังพร็อพเพอร์ตี้นั้นชั่วคราวสำหรับโปรเจ็กต์ Google Cloud ที่เชื่อมโยงจนกว่าช่วงเวลา 15 นาทีจะสิ้นสุดลง

2024-05-14 เพิ่มฟีเจอร์การเปรียบเทียบ

การใช้การเปรียบเทียบช่วยให้คุณประเมินข้อมูลชุดย่อยไปพร้อมกันได้

เราได้อัปเดตวิธีการรายงานหลักของ Data API v1beta เพื่อรองรับฟิลด์ comparisons ซึ่งเมื่อรวมไว้แล้ว จะระบุการกำหนดค่าของการเปรียบเทียบที่ขอ

ในคำขอ คุณสามารถระบุการเปรียบเทียบพื้นฐานได้โดยระบุdimensionFilter นิพจน์พร้อมคำขอ หรือใช้การเปรียบเทียบที่บันทึกไว้โดยระบุชื่อทรัพยากรของการเปรียบเทียบในฟิลด์ comparison

เราได้อัปเดตเมธอด getMetadata เพื่อ แสดงรายการการเปรียบเทียบที่บันทึกไว้ทั้งหมดซึ่งพร้อมใช้งานสำหรับพร็อพเพอร์ตี้ภายใต้ช่องการตอบกลับ comparisons

เมื่อระบุการเปรียบเทียบอย่างน้อย 1 รายการในคำขอ การตอบกลับจะมีคอลัมน์ comparison ที่ระบุการเปรียบเทียบแต่ละรายการ

ปัจจุบันคุณสร้างการเปรียบเทียบที่บันทึกไว้ได้โดยใช้ UI ของ Google Analytics เท่านั้น

2024-05-08 เพิ่มงานรายงาน ซึ่งเป็นฟีเจอร์การรายงานแบบไม่พร้อมกันลงใน 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ฟิลด์ที่ซ้ำได้มีรายการที่มีชื่อ Conversion API ที่เลิกใช้งานแล้ว

2024-03-25 เพิ่ม Channel Group หลัก แหล่งที่มาของการเข้าชมที่กําหนดเอง และมิติข้อมูลเฉพาะการผสานรวม

กลุ่มแชแนลหลัก แหล่งที่มาของการเข้าชมที่กําหนดเอง และมิติข้อมูลเฉพาะการผสานรวม CM360, DV360, SA360 ที่เพิ่มลงในสคีมา Data API

มิติข้อมูลกลุ่มเป้าหมาย:

  • audienceId รหัสกลุ่มเป้าหมาย ตัวระบุที่เป็นตัวเลขของกลุ่มเป้าหมาย

มิติข้อมูล Channel Group หลัก:

  • firstUserPrimaryChannelGroup Channel Group หลักของผู้ใช้ครั้งแรก

  • primaryChannelGroup Channel Group หลัก

  • sessionPrimaryChannelGroup Channel Group หลักของเซสชัน

มิติข้อมูลแหล่งที่มาของการเข้าชมที่กำหนดเอง:

  • 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):

  • 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 สื่อ CM360

  • cm360PlacementCostStructure โครงสร้างต้นทุนตำแหน่งโฆษณา CM360

  • cm360PlacementId รหัสตำแหน่งโฆษณา CM360

  • cm360PlacementName ชื่อตำแหน่งโฆษณา CM360

  • cm360RenderingId รหัสการแสดงผล CM360

  • cm360SiteId รหัสเว็บไซต์ CM360

  • cm360SiteName ชื่อเว็บไซต์ CM360

  • cm360Source แหล่งที่มา CM360

  • cm360SourceMedium แหล่งที่มา / สื่อ CM360

  • firstUserCm360AccountId รหัสบัญชี CM360 ของผู้ใช้ครั้งแรก

  • firstUserCm360AccountName ชื่อบัญชี CM360 ของผู้ใช้ครั้งแรก

  • firstUserCm360AdvertiserId รหัสผู้ลงโฆษณา CM360 ของผู้ใช้ครั้งแรก

  • firstUserCm360AdvertiserName ชื่อผู้ลงโฆษณา CM360 ของผู้ใช้ครั้งแรก

  • firstUserCm360CampaignId รหัสแคมเปญ CM360 ของผู้ใช้ครั้งแรก

  • firstUserCm360CampaignName ชื่อแคมเปญ CM360 ของผู้ใช้ครั้งแรก

  • firstUserCm360CreativeFormat รูปแบบครีเอทีฟโฆษณา CM360 ของผู้ใช้ครั้งแรก

  • firstUserCm360CreativeId รหัสครีเอทีฟโฆษณา CM360 ของผู้ใช้ครั้งแรก

  • firstUserCm360CreativeName ชื่อครีเอทีฟโฆษณา CM360 ของผู้ใช้ครั้งแรก

  • firstUserCm360CreativeType ประเภทครีเอทีฟโฆษณา CM360 ของผู้ใช้ครั้งแรก

  • firstUserCm360CreativeTypeId รหัสประเภทครีเอทีฟโฆษณา CM360 ของผู้ใช้ครั้งแรก

  • firstUserCm360CreativeVersion เวอร์ชันครีเอทีฟโฆษณา CM360 ของผู้ใช้ครั้งแรก

  • firstUserCm360Medium สื่อ CM360 ของผู้ใช้ครั้งแรก

  • firstUserCm360PlacementCostStructure โครงสร้างต้นทุนตำแหน่งโฆษณา CM360 ของผู้ใช้ครั้งแรก

  • firstUserCm360PlacementId รหัสตำแหน่งโฆษณา CM360 ของผู้ใช้ครั้งแรก

  • firstUserCm360PlacementName ชื่อตำแหน่งโฆษณา CM360 ของผู้ใช้ครั้งแรก

  • firstUserCm360RenderingId รหัสการแสดงผล CM360 ของผู้ใช้ครั้งแรก

  • firstUserCm360SiteId รหัสเว็บไซต์ CM360 ของผู้ใช้ครั้งแรก

  • firstUserCm360SiteName ชื่อเว็บไซต์ CM360 ของผู้ใช้ครั้งแรก

  • firstUserCm360Source แหล่งที่มา CM360 ของผู้ใช้ครั้งแรก

  • firstUserCm360SourceMedium แหล่งที่มา / สื่อ CM360 ของผู้ใช้ครั้งแรก

  • sessionCm360AccountId รหัสบัญชี CM360 ของเซสชัน

  • sessionCm360AccountName ชื่อบัญชี CM360 ของเซสชัน

  • sessionCm360AdvertiserId รหัสผู้ลงโฆษณาใน CM360 ของเซสชัน

  • sessionCm360AdvertiserName ชื่อผู้ลงโฆษณา CM360 ของเซสชัน

  • sessionCm360CampaignId รหัสแคมเปญ CM360 ของเซสชัน

  • sessionCm360CampaignName ชื่อแคมเปญ CM360 ของเซสชัน

  • sessionCm360CreativeFormat รูปแบบครีเอทีฟโฆษณา CM360 ของเซสชัน

  • sessionCm360CreativeId รหัสครีเอทีฟโฆษณา CM360 ของเซสชัน

  • sessionCm360CreativeName ชื่อครีเอทีฟโฆษณา CM360 ของเซสชัน

  • sessionCm360CreativeType ประเภทครีเอทีฟโฆษณา CM360 ของเซสชัน

  • sessionCm360CreativeTypeId รหัสประเภทครีเอทีฟโฆษณา CM360 ของเซสชัน

  • sessionCm360CreativeVersion เวอร์ชันครีเอทีฟโฆษณา CM360 ของเซสชัน

  • sessionCm360Medium สื่อ CM360 ของเซสชัน

  • sessionCm360PlacementCostStructure โครงสร้างต้นทุนตำแหน่งโฆษณา CM360 ของเซสชัน

  • sessionCm360PlacementId รหัสตำแหน่งโฆษณา CM360 ของเซสชัน

  • sessionCm360PlacementName ชื่อตำแหน่งโฆษณา CM360 ของเซสชัน

  • sessionCm360RenderingId รหัสการแสดงผล CM360 ของเซสชัน

  • sessionCm360SiteId รหัสเว็บไซต์ CM360 ของเซสชัน

  • sessionCm360SiteName ชื่อเว็บไซต์ CM360 ของเซสชัน

  • sessionCm360Source แหล่งที่มา CM360 ของเซสชัน

  • sessionCm360SourceMedium แหล่งที่มา / สื่อ CM360 ของเซสชัน

มิติข้อมูลการผสานรวม Google Display & Video 360 (DV360):

  • dv360AdvertiserId รหัสผู้ลงโฆษณา DV360

  • dv360AdvertiserName ชื่อผู้ลงโฆษณา DV360

  • dv360CampaignId รหัสแคมเปญ DV360

  • dv360CampaignName ชื่อแคมเปญ DV360

  • dv360CreativeFormat รูปแบบครีเอทีฟโฆษณา DV360

  • dv360CreativeId รหัสครีเอทีฟโฆษณา DV360

  • dv360CreativeName ชื่อครีเอทีฟโฆษณา DV360

  • dv360ExchangeId รหัสการแลกเปลี่ยน DV360

  • dv360ExchangeName ชื่อการแลกเปลี่ยน DV360

  • dv360InsertionOrderId รหัสใบสั่งซื้อการใส่โฆษณา DV360

  • dv360InsertionOrderName ชื่อใบสั่งซื้อการใส่โฆษณา DV360

  • dv360LineItemId รหัสรายการโฆษณา DV360

  • dv360LineItemName ชื่อรายการโฆษณา DV360

  • dv360Medium สื่อ DV360

  • dv360PartnerId รหัสพาร์ทเนอร์ DV360

  • dv360PartnerName ชื่อพาร์ทเนอร์ DV360

  • dv360Source แหล่งที่มาของ DV360

  • dv360SourceMedium แหล่งที่มา / สื่อ DV360

  • firstUserDv360AdvertiserId รหัสผู้ลงโฆษณา DV360 ของผู้ใช้ครั้งแรก

  • firstUserDv360AdvertiserName ชื่อผู้ลงโฆษณา DV360 ของผู้ใช้ครั้งแรก

  • firstUserDv360CampaignId รหัสแคมเปญ DV360 ของผู้ใช้ครั้งแรก

  • 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 ของผู้ใช้ครั้งแรก

  • 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 แหล่งที่มา / สื่อ DV360 ของเซสชัน

มิติข้อมูลการผสานรวม Google Search Ads 360 (SA360):

  • firstUserSa360AdGroupId รหัสกลุ่มโฆษณา SA360 ของผู้ใช้ครั้งแรก

  • firstUserSa360AdGroupName ชื่อกลุ่มโฆษณา SA360 ของผู้ใช้ครั้งแรก

  • firstUserSa360CampaignId รหัสแคมเปญ SA360 ของผู้ใช้ครั้งแรก

  • firstUserSa360CampaignName แคมเปญ SA360 ของผู้ใช้ครั้งแรก

  • firstUserSa360CreativeFormat รูปแบบครีเอทีฟโฆษณา SA360 ของผู้ใช้ครั้งแรก

  • firstUserSa360EngineAccountId รหัสบัญชีเครื่องมือค้นหา SA360 ของผู้ใช้ครั้งแรก

  • firstUserSa360EngineAccountName ชื่อบัญชีเครื่องมือค้นหา SA360 ของผู้ใช้ครั้งแรก

  • firstUserSa360EngineAccountType ประเภทบัญชีเครื่องมือค้นหา SA360 ของผู้ใช้ครั้งแรก

  • firstUserSa360KeywordText ข้อความคีย์เวิร์ด SA360 ของผู้ใช้ครั้งแรก

  • firstUserSa360ManagerAccountId รหัสบัญชีดูแลจัดการ SA360 ของผู้ใช้ครั้งแรก

  • firstUserSa360ManagerAccountName ชื่อบัญชีดูแลจัดการ SA360 ของผู้ใช้ครั้งแรก

  • firstUserSa360Medium สื่อ SA360 ของผู้ใช้ครั้งแรก

  • firstUserSa360Query คำค้นหา SA360 ของผู้ใช้ครั้งแรก

  • firstUserSa360Source แหล่งที่มา SA360 ของผู้ใช้ครั้งแรก

  • firstUserSa360SourceMedium แหล่งที่มา / สื่อ SA360 ของผู้ใช้ครั้งแรก

  • sa360AdGroupId รหัสกลุ่มโฆษณา SA360

  • sa360CampaignId รหัสแคมเปญ SA360

  • sa360AdGroupName ชื่อกลุ่มโฆษณา SA360

  • sa360CampaignName แคมเปญ SA360

  • sa360CreativeFormat รูปแบบครีเอทีฟโฆษณา SA360

  • sa360EngineAccountId รหัสบัญชีเครื่องมือค้นหา SA360

  • sa360EngineAccountName ชื่อบัญชีเครื่องมือค้นหา SA360

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

  • sa360KeywordText ข้อความคีย์เวิร์ด SA360

  • sa360ManagerAccountId รหัสบัญชีดูแลจัดการ SA360

  • sa360ManagerAccountName ชื่อบัญชีดูแลจัดการ SA360

  • sa360Medium สื่อ SA360

  • sa360Query คำค้นหา SA360

  • sa360Source แหล่งที่มาของ SA360

  • sa360SourceMedium แหล่งที่มา / สื่อ SA360

  • sessionSa360AdGroupId รหัสกลุ่มโฆษณาใน SA360 ของเซสชัน

  • sessionSa360CampaignId รหัสแคมเปญ SA360 ของเซสชัน

  • sessionSa360ManagerAccountId รหัสบัญชีดูแลจัดการ SA360 ของเซสชัน

  • sessionSa360ManagerAccountName ชื่อบัญชีดูแลจัดการ SA360 ของเซสชัน

  • sessionSa360SourceMedium แหล่งที่มา / สื่อใน SA360 ของเซสชัน

2024-03-06 รองรับกลุ่มเป้าหมายผู้ใช้ที่ไม่ได้ใช้งานในการส่งออกกลุ่มเป้าหมาย

ฟีเจอร์การส่งออกกลุ่มเป้าหมายรองรับการส่งออกกลุ่มเป้าหมายของผู้ใช้ที่ไม่ได้ใช้งานได้ดียิ่งขึ้น ผู้ใช้จะเข้าสู่กลุ่มเป้าหมายเหล่านี้โดยไม่มีเหตุการณ์ที่มีสิทธิ์ เช่น ผู้ใช้ สามารถเข้าสู่กลุ่มเป้าหมายได้โดยไม่เข้าชมเว็บไซต์เป็นเวลา 7 วัน ตัวอย่างกลุ่มเป้าหมายผู้ใช้ที่ไม่ได้ใช้งาน ได้แก่ "ผู้ซื้อที่ไม่ได้ใช้งานในช่วง 7 วัน" "ผู้ใช้ที่ไม่ได้ใช้งานในช่วง 7 วัน" และ "ผู้ใช้ที่ไม่ได้รับการแจ้งเตือนในช่วง 7 วัน" ดูข้อมูลเพิ่มเติมเกี่ยวกับกลุ่มเป้าหมายที่แนะนําเหล่านั้นได้ที่ กลุ่มเป้าหมายที่แนะนํา

2024-02-28 การส่งออกกลุ่มเป้าหมายจะแสดงรหัสผู้ใช้ที่ระบุในการติดแท็ก

ตอนนี้การส่งออกกลุ่มเป้าหมายจะแสดงรหัสผู้ใช้ที่ระบุในการติดแท็ก แม้ว่าจะมีการเปิดใช้ข้อมูลที่ได้จากผู้ใช้สําหรับพร็อพเพอร์ตี้ก็ตาม หากเปิดการเก็บรวบรวมข้อมูลที่ได้จากผู้ใช้ คุณจะส่งข้อมูลที่ได้จากผู้ใช้พร้อมกับ User-ID ไปยัง Google Analytics ในการติดแท็กเพื่อปรับปรุงการวัดได้ ดูข้อมูลเพิ่มเติมได้ที่การเก็บรวบรวมข้อมูลที่ได้จากผู้ใช้

30-01-2024 การรองรับการแจ้งเตือน Webhook สำหรับรายการกลุ่มเป้าหมายและรายการกลุ่มเป้าหมายที่เกิดซ้ำใน Data API v1 อัลฟ่า

ระบุฟิลด์ AudienceList.webhookNotification และ RecurringAudienceList.webhookNotification ได้เมื่อสร้างรายการกลุ่มเป้าหมาย (ใช้ properties.audienceLists.create) หรือรายการกลุ่มเป้าหมายที่เกิดซ้ำ (ใช้ properties.recurringAudienceLists.create)

ฟังก์ชันนี้ช่วยให้คุณได้รับการแจ้งเตือน Webhook แบบไม่พร้อมกัน เมื่อรายการกลุ่มเป้าหมายพร้อมใช้งาน

2024-01-18 ปรับปรุงความเข้ากันได้สำหรับมิติข้อมูลที่มีสตริงการค้นหาหรือคอมโพเนนต์นาที

ตอนนี้มิติข้อมูลที่มีสตริงการค้นหาใช้ได้กับฟิลด์ส่วนใหญ่แล้ว ตอนนี้มิติข้อมูล เช่น pagePathPlusQueryString, unifiedPageScreen, pageLocation และ fullPageUrl ใช้ร่วมกับฟิลด์อื่นๆ ได้อีกมากมาย ซึ่งรวมถึง sessionSource, browser, city และ landingPage

ตอนนี้มิติข้อมูลที่มีองค์ประกอบนาทีใช้ได้กับฟิลด์ส่วนใหญ่แล้ว ตอนนี้มิติข้อมูล เช่น minute nthMinute และ dateHourMinute ใช้ได้กับชุดฟิลด์เพิ่มเติมที่คล้ายกันแล้ว

ดูข้อมูลความเข้ากันได้อย่างละเอียดได้ที่เครื่องมือสำรวจมิติข้อมูลและเมตริกของ GA4

13-12-2023 พารามิเตอร์ระดับสินค้าที่กำหนดเอง

ตอนนี้คุณรวมมิติข้อมูลที่กําหนดเองระดับสินค้าไว้ในคําค้นหา Analytics Data API ได้แล้ว โดยใช้ไวยากรณ์ต่อไปนี้

ชื่อ API ทั่วไป คำอธิบาย
customItem:parameter_name มิติข้อมูลที่กำหนดเองระดับสินค้าสำหรับ parameter_name

ดูข้อมูลเพิ่มเติมได้ที่มิติข้อมูลและเมตริกของ API

05-12-2023 รายชื่อกลุ่มเป้าหมายพร้อมใช้งานใน Data API v1 เบต้าเป็นการส่งออกกลุ่มเป้าหมาย

เราได้เปลี่ยนชื่อฟีเจอร์รายการกลุ่มเป้าหมายเป็นการส่งออกกลุ่มเป้าหมาย และเพิ่มลงใน Data API v1 เบต้า

เพิ่มเมธอดต่อไปนี้ลงใน Data API v1 เบต้า

28-11-2023 เพิ่ม samplingMetadatas ในการตอบกลับรายงาน

เพิ่ม samplingMetadatas ไปยัง ResponseMetaData แล้ว คอลเล็กชันนี้จะมี SampleMetadata สำหรับแต่ละช่วงวันที่ในคำขอที่มีผลลัพธ์ตัวอย่าง Google Analytics จะใช้การสุ่มตัวอย่างเฉพาะเมื่อคาดการณ์ว่าขีดจำกัดของ Cardinality จะ ลดคุณภาพของข้อมูล

2023-11-28 เพิ่มฟังก์ชันการส่งออกกลุ่มเป้าหมายที่เกิดซ้ำไปยัง Data API v1 เวอร์ชันอัลฟ่า

เพิ่มเมธอด properties.recurringAudienceLists.create, properties.recurringAudienceLists.create, properties.recurringAudienceLists.list ลงใน Data API v1 อัลฟ่า

ฟังก์ชันนี้ช่วยให้คุณสร้างรายการกลุ่มเป้าหมายได้ทุกวันเมื่อมีการเปลี่ยนแปลงการเป็นสมาชิกของกลุ่มเป้าหมาย รายการกลุ่มเป้าหมายที่เกิดซ้ำช่วยให้คุณทำงาน โดยใช้ผลลัพธ์การเป็นสมาชิกของกลุ่มเป้าหมายล่าสุด

2023-10-13 เพิ่มการรองรับกลุ่มเป้าหมายที่มีระยะเวลาการเป็นสมาชิก 1 วัน

ตอนนี้ฟังก์ชันการส่งออกรายการกลุ่มเป้าหมายรองรับกลุ่มเป้าหมายที่มีระยะเวลาการเป็นสมาชิก 1 วันแล้ว

12-09-2023 กฎการจัดเรียงเริ่มต้นของ AudienceList

โดยค่าเริ่มต้น รายงานที่สร้างขึ้นโดยใช้ฟังก์ชันการส่งออกกลุ่มเป้าหมาย จะใช้กฎการจัดเรียงเดียวกันกับวิธีการรายงานอื่นๆ ของ Data API ดังนี้ การจัดเรียงจะเป็นแบบจากมากไปน้อยตามคอลัมน์แรก จากนั้นจะเป็นแบบจากมากไปน้อยตามคอลัมน์ที่ 2 เป็นต้น

ก่อนการเปลี่ยนแปลงนี้ คุณอาจได้รับรายงานต่อไปนี้

deviceId isAdsPersonalizationAllowed
ABC จริง
DAC เท็จ
ABC เท็จ
AAA จริง

หลังจากทำการเปลี่ยนแปลงนี้แล้ว คุณจะได้รับรายงานต่อไปนี้

deviceId isAdsPersonalizationAllowed
AAA จริง
ABC เท็จ
ABC จริง
DAC เท็จ

2023-08-15 เพิ่มมิติข้อมูล isLimitedAdTracking ลงในสคีมาการส่งออกรายการกลุ่มเป้าหมาย

15-08-2023 เพิ่มมิติข้อมูล currencyCode เมตริก itemDiscountAmount

  • currencyCode รหัสสกุลเงินท้องถิ่น (ตามมาตรฐาน ISO 4217) ของ เหตุการณ์อีคอมเมิร์ซ เช่น "USD" หรือ "GBP"

  • itemDiscountAmount มูลค่าเป็นตัวเงินของส่วนลดสินค้าในเหตุการณ์อีคอมเมิร์ซ เมตริกนี้สร้างขึ้นในการติดแท็กโดยพารามิเตอร์สินค้า "discount"

ดูข้อมูลเพิ่มเติมได้ที่สคีมารายงาน Data API

2023-08-10 เพิ่มมิติข้อมูล isAdsPersonalizationAllowed ลงในสคีมาการส่งออกรายการกลุ่มเป้าหมาย

  • isAdsPersonalizationAllowed อนุญาตให้ใช้การปรับโฆษณาตามโปรไฟล์ของผู้ใช้หรือไม่ หากผู้ใช้มีสิทธิ์ใช้การปรับโฆษณาตามโปรไฟล์ของผู้ใช้ isAdsPersonalizationAllowed จะแสดงผลเป็น true หากผู้ใช้ไม่มีสิทธิ์ใช้การปรับโฆษณาตามโปรไฟล์ของผู้ใช้ isAdsPersonalizationAllowed จะแสดงผลเป็น false

    ดูข้อมูลเพิ่มเติมได้ที่มิติข้อมูลรายการกลุ่มเป้าหมาย

2023-07-10 รายการกลุ่มเป้าหมาย

เพิ่มการรองรับกลุ่มเป้าหมายใน Data API v1 อัลฟ่า รายการกลุ่มเป้าหมายประกอบด้วยสแนปชอตของผู้ใช้ในกลุ่มเป้าหมาย ณ เวลาที่สร้างรายการกลุ่มเป้าหมาย

เราได้เพิ่มเมธอดต่อไปนี้ลงใน Data API v1 อัลฟ่า

2023-05-19 กลุ่มแชแนลที่กำหนดเอง

กลุ่มแชแนลที่กำหนดเอง เพิ่มการรองรับลงใน Data API

2023-05-11 การเปลี่ยนแปลงโควต้าโทเค็น

ระบบโควต้าของ 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
โทเค็น Funnel ต่อพร็อพเพอร์ตี้ต่อวัน 25,000 200,000
โทเค็น Funnel ต่อพร็อพเพอร์ตี้ต่อชั่วโมง 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
โทเค็น Funnel ต่อพร็อพเพอร์ตี้ต่อวัน 250,000 2,000,000
โทเค็น Funnel ต่อพร็อพเพอร์ตี้ต่อชั่วโมง 50,000 400,000
โทเค็น Funnel ต่อโปรเจ็กต์ ต่อพร็อพเพอร์ตี้ ต่อชั่วโมง 17,500 140,000

02-03-2023 เพิ่มมิติข้อมูลวันที่

  • 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" ในอาร์เรย์สินค้า

  • itemLocationID รหัสสถานที่ตั้งของสินค้า สถานที่ตั้งจริงที่เชื่อมโยงกับสินค้า (เช่น สถานที่ตั้งกิจการที่มีหน้าร้านจริง) ขอแนะนำให้ใช้รหัสสถานที่ของ Google ที่สอดคล้องกับรายการที่เกี่ยวข้อง นอกจากนี้ยังใช้รหัสสถานที่ที่กำหนดเองได้ด้วย ระบบจะกรอกข้อมูลในช่องนี้ในการติดแท็กโดยใช้พารามิเตอร์ "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% ของหน้าเว็บ

23-01-2023 เพิ่มมิติข้อมูล "ทวีป" และ "รหัสทวีป"

  • continent ทวีป ทวีปที่เกิดกิจกรรมของผู้ใช้ เช่น Americas หรือ Asia

  • continentId รหัสทวีป รหัสทางภูมิศาสตร์ของทวีปที่เกิดกิจกรรมของผู้ใช้ ซึ่งได้มาจากที่อยู่ IP

23-01-2023 เพิ่มมิติข้อมูล "รหัสตัวกรองข้อมูลทดสอบ"

  • testDataFilterId รหัสตัวกรองข้อมูลทดสอบ ตัวระบุตัวเลขของตัวกรองข้อมูลในสถานะทดสอบ คุณใช้ตัวกรองข้อมูลเพื่อรวมหรือยกเว้นข้อมูลเหตุการณ์จากรายงานตามค่าพารามิเตอร์เหตุการณ์ ดูข้อมูลเพิ่มเติมได้ที่ https://support.google.com/analytics/answer/10108813

18-10-2022 เพิ่มเมตริกโฆษณา

  • advertiserAdClicks การคลิกโฆษณา จํานวนครั้งที่ผู้ใช้คลิกที่โฆษณาเพื่อเข้าถึงพร็อพเพอร์ตี้
  • advertiserAdCost ค่าโฆษณา จำนวนเงินทั้งหมดที่คุณจ่ายสำหรับโฆษณา
  • advertiserAdCostPerClick ต้นทุนต่อคลิกของโฆษณา ต้นทุนต่อคลิกของโฆษณาคือต้นทุนโฆษณาหารด้วยการคลิกโฆษณา และมักย่อว่า CPC
  • advertiserAdCostPerConversion ต้นทุนต่อ Conversion ต้นทุนต่อ Conversion คือต้นทุนโฆษณาหารด้วย Conversion
  • advertiserAdImpressions การแสดงโฆษณา จำนวนการแสดงผลทั้งหมด
  • returnOnAdSpend ผลตอบแทนจากค่าโฆษณา ผลตอบแทนจากค่าโฆษณา (ROAS) คือรายได้ทั้งหมดหารด้วยต้นทุนโฆษณาของผู้ลงโฆษณา

17-10-2022 เพิ่มเมตริกระดับสินค้า

  • itemsAddedToCart เพิ่มสินค้าลงในรถเข็นแล้ว จํานวนหน่วยที่เพิ่มลงในรถเข็นสําหรับสินค้าชิ้นเดียว
  • itemsCheckedOut รายการที่ชำระเงินแล้ว จํานวนหน่วยที่ชําระเงินแล้วสําหรับสินค้าชิ้นเดียว
  • itemsClickedInList สินค้าที่คลิกในรายการ จํานวนหน่วยที่คลิกในรายการสําหรับสินค้าชิ้นเดียว
  • itemsClickedInPromotion สินค้าที่คลิกในโปรโมชัน จํานวนหน่วยที่คลิกในโปรโมชันสําหรับสินค้าชิ้นเดียว
  • itemsViewed ดูรายการ จํานวนหน่วยที่ดูสําหรับสินค้าชิ้นเดียว
  • itemsViewedInList สินค้าที่ดูในรายการ จํานวนหน่วยที่ดูในรายการสําหรับสินค้าชิ้นเดียว
  • itemsViewedInPromotion สินค้าที่ดูในโปรโมชัน จํานวนหน่วยที่ดูในโปรโมชันสําหรับสินค้าชิ้นเดียว

2022-09-13 ประกาศการเปลี่ยนแปลงความเข้ากันได้ของสคีมา

ในวันที่ 1 ธันวาคม 2022 จะมีการเปลี่ยนแปลงที่ทำให้เกิดข้อขัดข้องต่อไปนี้

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

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

  3. มิติข้อมูลที่มีสตริงคำค้นหา เช่น pagePathPlusQueryString จะใช้ได้กับชุดมิติข้อมูลและเมตริกที่จำกัดเท่านั้น

ดูข้อมูลเพิ่มเติมได้ที่คำอธิบายโดยละเอียดเกี่ยวกับการเปลี่ยนแปลงความเข้ากันได้

2022-09-01 การเปลี่ยนแปลงโควต้า

  • 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

    ดูข้อมูลโดยละเอียดเกี่ยวกับโควต้าใหม่ได้ที่เอกสารประกอบเกี่ยวกับโควต้า

03-08-2022 เพิ่มมิติข้อมูล 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"

  • sessionCampaignIdsessionCampaignName ตอนนี้มิติข้อมูลรองรับแคมเปญ Search Ads 360 แล้ว

2022-07-11 เพิ่มเมตริกอัตรา Conversion

อัตรา Conversion

  • sessionConversionRate เปอร์เซ็นต์ของเซสชันที่เรียกให้แสดงเหตุการณ์ Conversion

  • userConversionRate เปอร์เซ็นต์ของผู้ใช้ที่เรียกให้แสดงเหตุการณ์ Conversion

เมตริกอัตรา Conversion สำหรับ Conversion รายการเดียว

  • sessionConversionRate:event_name เปอร์เซ็นต์ของเซสชันที่เรียกให้แสดงเหตุการณ์ Conversion เฉพาะ

  • userConversionRate:event_name เปอร์เซ็นต์ของผู้ใช้ที่เรียกให้แสดงเหตุการณ์ Conversion เฉพาะ

2022-05-05 เพิ่มฟังก์ชันการรายงาน Funnel ลงในช่องอัลฟ่า

  • runFunnelReport เพิ่มลงใน API เวอร์ชัน v1alpha ซึ่ง จะแสดงรายงาน Funnel ที่กําหนดเอง ของข้อมูลเหตุการณ์ 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 วันอีกด้วย

  • dauPerWau DAU / WAU เปอร์เซ็นต์ของผู้ใช้ที่ใช้งานรายวันต่อเนื่องในช่วง 7 วัน และยังเป็นผู้ใช้ที่ใช้งานอยู่ใน 1 วันอีกด้วย

  • wauPerMau WAU / MAU เปอร์เซ็นต์ของผู้ใช้ที่ใช้งานในช่วง 30 วัน และยังเป็นผู้ใช้ที่ใช้งานในช่วง 7 วันอีกด้วย

  • purchaserConversionRate เปอร์เซ็นต์ของผู้ใช้ที่ใช้งานอยู่ซึ่งทำธุรกรรมการซื้ออย่างน้อย 1 รายการ

  • transactionsPerPurchaser ธุรกรรมต่อผู้ซื้อ

แคมเปญ Google Ads

  • firstUserGoogleAdsCampaignType ประเภทแคมเปญของแคมเปญ Google Ads ที่ได้ผู้ใช้ก่อน

  • googleAdsCampaignType ประเภทแคมเปญสําหรับแคมเปญ Google Ads ที่ระบุแหล่งที่มาของเหตุการณ์ Conversion

  • sessionGoogleAdsCampaignType ประเภทแคมเปญสําหรับแคมเปญ Google Ads ที่ทําให้เกิดเซสชันนี้

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

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

  • minute นาที 2 หลักของชั่วโมงที่บันทึกเหตุการณ์

  • nthMinute จำนวนนาทีนับตั้งแต่ที่เริ่มต้นช่วงวันที่

2021-09-07 เพิ่มมิติข้อมูลใหม่ที่สร้างขึ้นโดยพารามิเตอร์เหตุการณ์

  • achievementId รหัสรางวัลพิเศษในเกมสําหรับเหตุการณ์

  • character ตัวละครของผู้เล่นในเกมสําหรับเหตุการณ์

  • fileExtension นามสกุลของไฟล์ที่ดาวน์โหลด

  • fileName เส้นทางหน้าเว็บของไฟล์ที่ดาวน์โหลด

  • groupId รหัสกลุ่มผู้เล่นในเกมสําหรับเหตุการณ์

  • linkClasses แอตทริบิวต์ class ของ HTML สําหรับลิงก์ขาออก

  • linkDomain โดเมนปลายทางของลิงก์ขาออก

  • linkId แอตทริบิวต์ id ของ HTML สําหรับลิงก์ขาออกหรือไฟล์ดาวน์โหลด

  • linkText ข้อความลิงก์ของไฟล์ดาวน์โหลด

  • linkUrl URL แบบเต็มของลิงก์ขาออกหรือไฟล์ดาวน์โหลด

  • method วิธีการเรียกเหตุการณ์ให้แสดง

  • outbound แสดงผล "จริง" หากลิงก์นําไปยังเว็บไซต์ที่ไม่ได้เป็นส่วนหนึ่งของโดเมนของพร็อพเพอร์ตี้

  • pageLocation โปรโตคอล ชื่อโฮสต์ เส้นทางหน้าเว็บ และสตริงการค้นหาสำหรับหน้าเว็บ ที่เข้าชม

  • pageReferrer URL อ้างอิงแบบเต็ม รวมถึงชื่อโฮสต์และเส้นทาง

  • percentScrolled เปอร์เซ็นต์ที่ผู้ใช้เลื่อนจากด้านล่างของหน้าเว็บ (เช่น "90")

  • searchTerm คำที่ผู้ใช้ค้นหา

  • videoProvider แหล่งที่มาของวิดีโอ (เช่น "youtube")

  • videoTitle ชื่อวิดีโอ

  • videoUrl URL ของวิดีโอ

  • visible แสดงผลเป็น "จริง" หากเนื้อหาแสดง

  • unifiedPagePathScreen เส้นทางหน้าเว็บ (เว็บ) หรือคลาสหน้าจอ (แอป) ที่มีการบันทึกเหตุการณ์

07-09-2021 การเปลี่ยนแปลงสคีมา API

การเปลี่ยนแปลงในมิติข้อมูลที่มีอยู่

  • unifiedPageScreen สําหรับเหตุการณ์ที่สร้างขึ้นบนเว็บ ตอนนี้มิติข้อมูลนี้จะแสดงเส้นทางหน้าเว็บและสตริงการค้นหาที่บันทึกเหตุการณ์

ประกาศการเปลี่ยนแปลงที่กำลังจะมีขึ้น:

  • firstUserTrafficOrigin ต้นทางการเข้าชมที่ได้ผู้ใช้ก่อน โปรดอย่าใช้ฟิลด์นี้เพื่อแสดงผล "Manual" สำหรับการเข้าชมที่ใช้ UTM ฟิลด์นี้จะอัปเดตจากการแสดงผล "Manual" เป็นการแสดงผล "(not set)" สำหรับการเปิดตัวฟีเจอร์ที่กำลังจะมาถึง

  • sessionTrafficOrigin ต้นทางการเข้าชมของแคมเปญของเซสชัน โปรดอย่าใช้ฟิลด์นี้เพื่อแสดงผล "Manual" สำหรับการเข้าชมที่ใช้ UTM ฟิลด์นี้จะอัปเดตจากการแสดงผล "Manual" เป็นการแสดงผล "(not set)" สำหรับการเปิดตัวฟีเจอร์ที่กำลังจะมาถึง

  • trafficOrigin ต้นทางการเข้าชมของแคมเปญของเหตุการณ์ Conversion โปรดอย่าใช้ฟิลด์นี้เพื่อแสดงผล "Manual" สำหรับการเข้าชมที่ใช้ UTM ฟิลด์นี้จะอัปเดตจากการแสดงผล "Manual" เป็นการแสดงผล "(not set)" สำหรับการเปิดตัวฟีเจอร์ที่กำลังจะมาถึง

2021-09-07 เพิ่มเมธอด checkCompatibility ลงใน API

checkCompatibility เมธอดจะแสดงมิติข้อมูลและเมตริกที่เพิ่มลงในคำขอรายงานได้และ ยังคงความเข้ากันได้

2021-07-21 การเปลี่ยนแปลงการรายงานแบบเรียลไทม์

ตอนนี้คุณสามารถระบุช่วงนาทีของข้อมูลเหตุการณ์ที่จะอ่านได้โดยใช้พารามิเตอร์ minuteRanges ของเมธอด runRealtimeReport

2021-07-21 มิติข้อมูลการจัด Channel Group ใหม่

มิติข้อมูลการจัด Channel Group ใหม่ที่เพิ่มลงในสคีมาการรายงาน Data API มีดังนี้

  • firstUserDefaultChannelGrouping การจัด Channel Group เริ่มต้นของผู้ใช้ครั้งแรก

  • defaultChannelGrouping การจัด Channel Group เริ่มต้น

10-06-2021 การเปลี่ยนแปลงสคีมา API

  • 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 v1 เวอร์ชันเบต้าแล้ว

  • อัปเดตปลายทาง 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

08-02-2021 เพิ่มมิติข้อมูลแคมเปญใหม่

เราได้เพิ่มมิติข้อมูลแคมเปญใหม่ลงในสคีมา API ดังนี้ campaignId, campaignName, googleAdsAccountName googleAdsAdGroupId, googleAdsAdGroupName, googleAdsAdNetworkType source, trafficOrigin

2021-02-08 dayOfWeek, week การเปลี่ยนแปลงมิติข้อมูล

  • ค่าของมิติข้อมูล dayOfWeek จะขึ้นต้นด้วย 0 แทน 1

  • ค่าของweekมิติข้อมูลจะเริ่มต้นด้วย 01 และแสดงผลตัวเลข 2 หลักตั้งแต่ 01 ถึง 53 แต่ละสัปดาห์จะเริ่มต้นในวันอาทิตย์ วันที่ 1 มกราคมเป็นสัปดาห์ที่ 01 เสมอ

2021-01-28 เพิ่มตัวแปรการรวบรวมสำหรับเมตริกที่กำหนดเอง

เมตริกที่กําหนดเองแต่ละรายการที่พร็อพเพอร์ตี้ลงทะเบียนจะสร้างตัวแปรเมตริก API 3 รายการ ได้แก่ ผลรวม ค่าเฉลี่ย และจํานวน

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

เราได้เพิ่มมิติข้อมูลใหม่ต่อไปนี้ลงในสคีมา 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

2020-10-19 อัปเดตอาร์ติแฟกต์ของไลบรารีไคลเอ็นต์

อาร์ติแฟกต์ของไลบรารีของไคลเอ็นต์ได้รับการอัปเดตพร้อมกับวิธีการใช้งาน และตัวอย่างโค้ด

2020-10-13 เราได้เปลี่ยนชื่อพร็อพเพอร์ตี้แอป + เว็บเป็น Google Analytics 4 (GA4)

2020-10-08 เพิ่มเมธอด getMetadata ลงใน API

เมธอด getMetadata จะแสดงมิติข้อมูลและเมตริกที่กําหนดเองซึ่งใช้ได้กับรหัสพร็อพเพอร์ตี้ GA4 ที่ระบุ รวมถึงข้อมูลเมตาของ Universal

08-10-2020 มิติข้อมูลและเมตริกที่กำหนดเองพร้อมใช้งานในรายงานแล้ว

ดูเอกสารประกอบเกี่ยวกับมิติข้อมูลและเมตริกที่กำหนดเองได้ในเอกสารประกอบเกี่ยวกับสคีมา API การอัปเดตนี้รวมถึงมิติข้อมูลและเมตริกที่กำหนดเองระดับเหตุการณ์ รวมถึงมิติข้อมูลที่กำหนดเองระดับผู้ใช้