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

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

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

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

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

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

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

2024-09-18 เพิ่มฟีเจอร์ภาพรวมโควต้าพร็อพเพอร์ตี้

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

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

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

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

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

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

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

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

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

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

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

08-05-2024 เพิ่มงานรายงาน ซึ่งเป็นฟีเจอร์การรายงานแบบไม่พร้อมกันลงใน Data API v1alpha

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

เราได้เพิ่มวิธีการจัดการงานรายงานต่อไปนี้ลงใน Data API v1alpha

2024-05-06 มิติข้อมูลใหม่สําหรับเหตุการณ์สําคัญ

มิติข้อมูลและเมตริกสําหรับเหตุการณ์สําคัญพร้อมใช้งานแล้ว

แก้ไขคําขอรายงานที่ใช้มิติข้อมูล 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 หลัก แหล่งที่มาของการเข้าชมที่กําหนดเอง และมิติข้อมูลเฉพาะของการผสานรวม

กลุ่มแชแนลหลัก แหล่งที่มาของการเข้าชมที่กําหนดเอง และมิติข้อมูลเฉพาะการผสานรวม 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

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

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

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

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

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

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

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

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

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

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

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

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

2023-11-08 เพิ่มฟังก์ชันการส่งออกรายการกลุ่มเป้าหมายไปยังชีตใน Data API v1 เวอร์ชันอัลฟ่า

เพิ่มเมธอด properties.audienceLists.exportSheet ลงใน Data API v1 เวอร์ชันอัลฟ่า ซึ่งช่วยให้คุณส่งออกรายการกลุ่มเป้าหมายไปยัง Google ชีตได้

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

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

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

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

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

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

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

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

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

2023-08-15 เพิ่มมิติข้อมูล 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 alpha รายการกลุ่มเป้าหมายประกอบด้วยภาพรวมของผู้ใช้ในกลุ่มเป้าหมาย ณ เวลาที่สร้างรายการกลุ่มเป้าหมาย

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

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

เพิ่มการรองรับChannel Group ที่กําหนดเองลงใน 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

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

2023-02-27 เพิ่มมิติข้อมูลอีคอมเมิร์ซ

  • itemListPosition ตำแหน่งรายการสินค้า ตําแหน่งของสินค้า (เช่น ผลิตภัณฑ์ที่ขาย) ในรายการ มิติข้อมูลนี้สร้างขึ้นในการติดแท็กโดยพารามิเตอร์ "index" ในอาร์เรย์ items

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

  • itemPromotionCreativeSlot ช่องครีเอทีฟโฆษณาโปรโมชันสินค้า ชื่อของสล็อตครีเอทีฟโฆษณาโปรโมชันที่เชื่อมโยงกับสินค้า คุณระบุมิติข้อมูลนี้ในการติดแท็กได้โดยใช้พารามิเตอร์ creative_slot ที่ระดับเหตุการณ์หรือระดับสินค้า หากระบุพารามิเตอร์ทั้งในระดับเหตุการณ์และระดับสินค้า ระบบจะใช้พารามิเตอร์ระดับสินค้า

2023-02-21 เพิ่มมิติข้อมูล "หน้า Landing Page + สตริงการค้นหา"

  • landingPagePlusQueryString หน้า Landing Page + สตริงการค้นหา เส้นทางหน้าเว็บ + สตริงการค้นหาที่เชื่อมโยงกับการดูหน้าเว็บครั้งแรกในเซสชัน

ช่องนี้จะแทนที่มิติข้อมูล landingPage ซึ่งเลิกใช้งานแล้วและจะอัปเดตให้ไม่แสดงสตริงการค้นหาในวันที่ 14 พฤษภาคม 2023

2023-01-28 เพิ่มเมตริก "ยอดดูต่อผู้ใช้" "ผู้ใช้ที่เลื่อนดู"

  • 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

2022-10-18 เพิ่มเมตริก Google Ads

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

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

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

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

ในวันที่ 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

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

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 แล้ว

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 วันซึ่งเข้ามาใช้งานทุกวัน

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

  • transactionsPerPurchaser จํานวนธุรกรรมต่อผู้ซื้อ

แคมเปญ Google Ads

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

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

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

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

  • 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 เส้นทางหน้าเว็บ (เว็บ) หรือคลาสหน้าจอ (แอป) ที่บันทึกเหตุการณ์

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

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

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

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

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

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

  • trafficOrigin ต้นทางการเข้าชมของแคมเปญของเหตุการณ์ Conversion โปรดอย่าคาดหวังว่าฟิลด์นี้จะแสดงผลเป็น "กําหนดเอง" สําหรับการเข้าชมที่ใช้ UTM เนื่องจากฟิลด์นี้จะอัปเดตจากการแสดงผลเป็น "กําหนดเอง" เป็น "(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 เริ่มต้น

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

  • มิติข้อมูล minutesAgo ที่เพิ่มลงในสคีมาแบบเรียลไทม์ของ Data API และสามารถใช้ในการค้นหาเมธอด runRealtimeReport มิติข้อมูลนี้มีจํานวนนาทีที่ผ่านมาที่รวบรวมเหตุการณ์ 00 คือนาทีปัจจุบัน และ 01 หมายถึงนาทีก่อนหน้า

  • มีการเพิ่มมิติข้อมูล googleAdsCreativeId ลงในสคีมา Data API มิติข้อมูลนี้มีรหัสของครีเอทีฟโฆษณา Google Ads ที่ระบุว่ามาจากเหตุการณ์ Conversion

  • มีการเพิ่มมิติข้อมูล sessionGoogleAdsCreativeId ลงในสคีมา Data API มิติข้อมูลนี้มีรหัสของครีเอทีฟโฆษณา Google Ads ที่ทําให้เกิดเซสชันในเว็บไซต์หรือแอป

  • เปลี่ยนชื่อมิติข้อมูล firstUserCreativeId เป็น firstUserGoogleAdsCreativeId ในสคีมา Data API มิติข้อมูลนี้มีรหัสของครีเอทีฟโฆษณา Google Ads ที่ได้ผู้ใช้ครั้งแรก

2021-04-09 เปิดตัว 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 แถว

2021-02-08 มิติข้อมูลและเมตริกอีคอมเมิร์ซใหม่

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

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

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

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

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

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

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

เราได้เพิ่มมิติข้อมูลใหม่ต่อไปนี้ลงในสคีมา API hour, nthHour, nthYear, dateHour

2021-01-28 Data API ลดจำนวนโทเค็นโควต้าที่เรียกเก็บต่อคำค้นหา

Data API ลดจำนวนโทเค็นโควต้าที่เรียกเก็บต่อคำค้นหา ขีดจํากัดโควต้าสําหรับโทเค็นโควต้าพร็อพเพอร์ตี้ต่อชั่วโมงและต่อวันจะไม่มีการเปลี่ยนแปลง

2020-11-09 ลบเมธอด getUniversalMetadata แล้ว

ลบเมธอด getUniversalMetadata แล้ว โปรดใช้ getMetadata ระบบได้นำช่วงวันที่สูงสุด 1 ปีต่อคำขอ API ออกแล้ว

2020-11-02 เพิ่มวิธีการรายงานแบบเรียลไทม์

ดูตัวอย่างในการสร้างรายงานแบบเรียลไทม์ และดูเอกสารอ้างอิง REST ของ runRealtimeReport

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

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

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

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

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

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

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