Google Analytics Management API ช่วยให้เข้าถึงฟีเจอร์การนำเข้าข้อมูลของ Google Analytics แบบเป็นโปรแกรมได้
เกริ่นนำ
Management API ช่วยให้คุณอัปโหลด แสดงรายการ ลบ และรับไฟล์ที่อัปโหลดรวมถึงแสดงรายการชุดข้อมูล หากต้องการดูภาพรวมระดับสูงของประโยชน์ของฟีเจอร์การนำเข้าข้อมูล โปรดดูบทความเกี่ยวกับการนำเข้าข้อมูลในศูนย์ช่วยเหลือ
ทรัพยากร 2 รายการใน Management API ที่เปิดใช้การนำเข้าข้อมูล ได้แก่
- ทรัพยากรแหล่งข้อมูลที่กำหนดเองซึ่งเรียกว่าชุดข้อมูลในอินเทอร์เฟซเว็บ ซึ่งทำหน้าที่เป็นคอนเทนเนอร์สำหรับไฟล์ที่อัปโหลด การรวบรวมแหล่งข้อมูลที่กำหนดเองจะแสดงชุดข้อมูลทั้งหมดที่เชื่อมโยงกับพร็อพเพอร์ตี้ Google Analytics
- ทรัพยากร อัปโหลด ซึ่งแสดงไฟล์ที่อัปโหลด ชุดของทรัพยากรการอัปโหลดจะแสดงไฟล์ทั้งหมดที่คุณได้อัปโหลดไปยังชุดข้อมูล
กรณีการใช้งาน
ฟีเจอร์การนำเข้าข้อมูลมีหมวดหมู่ระดับบนสุด 3 หมวดหมู่ ซึ่งแต่ละหมวดหมู่มีกรณีการใช้งานของตัวเอง โดยมีองค์กรดังนี้
การนำเข้าข้อมูล Hit
ข้อมูลการคืนเงิน
ธุรกรรมอีคอมเมิร์ซที่มีการคืนเงินเต็มจำนวนหรือบางส่วนสามารถอัปโหลดไปยัง Google Analytics ได้ วิธีนี้จะช่วยให้คุณปรับเทียบข้อมูลในรายงานอีคอมเมิร์ซของ Google Analytics กับการคืนเงินที่ได้รับการประมวลผลโดยอัตโนมัติได้ง่ายขึ้น
ดูวิธีนําเข้าข้อมูลการคืนเงินไปยัง Google Analytics ได้ที่ตัวอย่างการนําเข้าข้อมูลการคืนเงิน
การนำเข้าข้อมูลที่ขยาย
ข้อมูลผู้ใช้
คุณสามารถอัปโหลดข้อมูลผู้ใช้ที่ใช้ระบุตัวบุคคลไม่ได้จากเครื่องมือ CRM ภายนอก และสร้างกลุ่มเป้าหมายรีมาร์เก็ตติ้งของ Google Ads สำหรับกลุ่มผู้ใช้ที่มีคุณค่ามากที่สุดได้
ดูวิธีนำเข้าข้อมูลผู้ใช้ไปยัง Google Analytics เพื่อสร้างกลุ่มเป้าหมายรีมาร์เก็ตติ้งของ Google Ads ได้ที่
ข้อมูลแคมเปญ
คุณสามารถนำเข้าข้อมูลแคมเปญไปยัง Google Analytics เพื่อปรับแต่งการวิเคราะห์ประสิทธิภาพแคมเปญสำหรับธุรกิจของคุณ
หากต้องการเรียนรู้วิธีนำเข้าข้อมูลแคมเปญไปยัง Google Analytics โปรดดูการนำเข้าข้อมูลแคมเปญโดยใช้ Management API
ข้อมูลทางภูมิศาสตร์
คุณสามารถนำเข้าการแมปรหัสทางภูมิศาสตร์ไปยังภูมิภาคต่างๆ โดยอนุญาตให้แสดงรายงานข้อมูล Google Analytics ตามภูมิภาคที่กำหนดเองได้ ตัวอย่างเช่น ในสหรัฐอเมริกา คุณอาจดำเนินงานโดยกลุ่มรัฐทางตะวันออก กลาง และตะวันตก ในยุโรป คุณอาจดำเนินการในกลุ่มประเทศเหนือ กลาง และใต้ เมื่อนำเข้าข้อมูล คุณสามารถใช้คีย์ ga:regionId
, ga:cityId
, ga:countryIsoCode
หรือ ga:subContinentCode
เป็นคีย์ได้ รหัสเมืองและรหัสประเทศสามารถดูได้ในตารางการกำหนดเป้าหมายตามภูมิศาสตร์ ดูรหัสประเทศ ISO และรหัสอนุทวีปได้ในตาราง ISO-3166-1 alpha-2 และ UN M.49 ตามลำดับ
สำหรับข้อมูลเพิ่มเติมเกี่ยวกับการนำเข้าข้อมูลทางภูมิศาสตร์ โปรดดูตัวอย่างการนำเข้าข้อมูลทางภูมิศาสตร์
ข้อมูลเนื้อหา
คุณสามารถอัปโหลดข้อมูลเมตาที่เกี่ยวข้องกับเนื้อหา เช่น ผู้แต่งและเรื่อง เพื่อใช้ประโยชน์จาก Google Analytics ในการวิเคราะห์บทความที่เผยแพร่ในเว็บไซต์ในเชิงลึก
ดูวิธีนำเข้าข้อมูลเนื้อหาไปยัง Google Analytics ได้ที่ตัวอย่างการนำเข้าข้อมูลเนื้อหา
ข้อมูลผลิตภัณฑ์
การนำเข้าข้อมูลผลิตภัณฑ์ไปยัง Google Analytics ช่วยลดความซับซ้อนและลดจำนวนข้อมูลอีคอมเมิร์ซที่ต้องส่งไปกับ Hit เช่น จำนวนการดูหน้าเว็บและเหตุการณ์ คุณสามารถรวมรหัสผลิตภัณฑ์หรือ SKU เดียวเข้ากับข้อมูลผลิตภัณฑ์ที่นำเข้าเพื่อป้อนข้อมูลมิติข้อมูลและเมตริกผลิตภัณฑ์ในรายงาน
ดูวิธีนําเข้าข้อมูลผลิตภัณฑ์ไปยัง Google Analytics ได้ที่การนําเข้าข้อมูลผลิตภัณฑ์โดยใช้ Management API
การนำเข้าข้อมูลสรุป
ข้อมูลค่าใช้จ่าย
คุณสามารถอัปโหลดข้อมูลค่าใช้จ่ายสำหรับแคมเปญที่ไม่ใช่ของ Google ที่เสียค่าใช้จ่ายและใช้ประโยชน์จากแพลตฟอร์ม Google Analytics ในการวิเคราะห์ ROI และเปรียบเทียบประสิทธิภาพของแคมเปญสำหรับการโฆษณาออนไลน์และการลงทุนทางการตลาดทั้งหมด
ดูวิธีนําเข้าข้อมูลค่าใช้จ่ายไปยัง Google Analytics ได้ที่การนําเข้าข้อมูลค่าใช้จ่ายโดยใช้ Management API
แนวคิด
สถานะการประมวลผล
หลังจากที่คุณอัปโหลดไฟล์ สถานะของการอัปโหลดจะเป็น PENDING
จนกว่าจะมีการตรวจสอบและประมวลผลการอัปโหลด หากการประมวลผลสำเร็จ สถานะจะเปลี่ยนเป็น COMPLETED
หากเกิดข้อผิดพลาดระหว่างการประมวลผลและอัปโหลดไม่สำเร็จ สถานะของการอัปโหลดจะเป็น FAILED
รายการข้อผิดพลาดจะปรากฏขึ้นเพื่อช่วยคุณระบุปัญหาเกี่ยวกับไฟล์ ต่อไปนี้คือตัวอย่างการตอบกลับสำหรับการอัปโหลดที่ไม่ผ่านการตรวจสอบ
{
id: "YU4DersR_ORzyzXC_AoWw",
kind: "analytics#upload",
accountId: "12345",
customDataSourceId: "poaU7EPcR4WGU-dkNghYKQ",
status: "FAILED",
errors:
[
"Invalid cell data 12.99 at row 1 column 6. expected data type LONG.",
"Invalid cell data 12.99 at row 2 column 6. expected data type LONG.",
"Invalid cell data 23.81 at row 3 column 6. expected data type LONG.",
"Invalid cell data 199.99 at row 4 column 6. expected data type LONG."
]
}
การรวมข้อมูลค่าใช้จ่ายเทียบกับการเขียนทับ
เมื่อสร้างแหล่งข้อมูลที่กำหนดเอง / ชุดข้อมูลสำหรับข้อมูลค่าใช้จ่าย คุณจะมีตัวเลือกในการระบุวิธีจัดการกรณีที่ไฟล์ที่อัปโหลดมีแถวข้อมูลที่มีคีย์ (เช่น วันที่ แหล่งที่มา สื่อ) ที่ตรงกับแถวที่มีอยู่ ตัวเลือกมีดังนี้
- summation (ค่าเริ่มต้น) - ระบบจะเพิ่มข้อมูลใหม่ไปยังข้อมูลที่ตรงกันก่อนหน้านี้ และเมตริกจะถูกรวมเข้าด้วยกัน
- เขียนทับ - ข้อมูลใหม่จะเขียนทับข้อมูลที่ตรงกันก่อนหน้านี้
หากต้องการดูว่าตั้งค่าประเภทให้กับชุดข้อมูลประเภทใด ให้ใช้เมธอดรายการแหล่งข้อมูลที่กำหนดเองเพื่อตรวจสอบว่าพร็อพเพอร์ตี้ importBehavior
ได้รับการตั้งค่าเป็น OVERWRITE
หรือ SUMMATION
ผลรวมระดับแถวของข้อมูลค่าใช้จ่ายเทียบกับการเขียนทับ
นอกจากนี้ คุณยังมีตัวเลือกในการลบล้างลักษณะการทำงานของชุดข้อมูลสำหรับแต่ละไฟล์ที่คุณอัปโหลดด้วยการรวมคอลัมน์ ga:importBehavior
ในส่วนหัว สำหรับแถวต่อแถว คุณจะตั้งค่าของ ga:importBehavior
เป็น SUMMATION
หรือ OVERWRITE
ได้
ตัวอย่างเช่น ไฟล์ต่อไปนี้จะเขียนทับข้อมูลค่าใช้จ่ายก่อนหน้านี้สำหรับ Facebook/cpc และ Yahoo/cpc แต่จะเพิ่มแถวของ Bing/cpc ลงในข้อมูลค่าใช้จ่ายที่มีอยู่สำหรับวันที่นั้นๆ และชุดค่าผสมแหล่งที่มา/สื่อ
ga:date,ga:source, ga:medium,ga:adCost,ga:importBehavior
20140604,facebook,cpc,12.23,OVERWRITE
20140604,bing,cpc,3.23,SUMMATION
20140604,yahoo,cpc,11.23,OVERWRITE
รูปแบบและข้อจำกัด
เพื่อให้สามารถอัปโหลดข้อมูลไปยัง Google Analytics ข้อมูลนั้นต้องอยู่ในไฟล์ CSV ที่จัดรูปแบบอย่างถูกต้อง ส่วนนี้จะอธิบายข้อจำกัดที่ต้องทำตามก่อนที่จะได้รับการพิจารณาว่าใช้ได้กับการอัปโหลดไปยังการนำเข้าข้อมูลทุกประเภท
หากข้อจำกัดข้อใดข้อหนึ่งด้านล่างเป็นการละเมิดหรือหากมีข้อผิดพลาดในการแยกวิเคราะห์ คำขออัปโหลดจะล้มเหลวโดยมีข้อความแสดงข้อผิดพลาด API จะรายงานข้อผิดพลาดสูงสุด 10 รายการในการตอบกลับ 1 ครั้งเพื่อช่วยผู้ใช้ลดจำนวนการอัปโหลดที่ไม่ถูกต้อง
ข้อจำกัดไฟล์
- การเข้ารหัส: UTF-8
- ขีดจำกัดขนาดไฟล์: 1 GB
ข้อจำกัดของส่วนหัว
- แถวแรกถือเป็นส่วนหัวของคอลัมน์และต้องระบุ โดยจะต้องกำหนดมิติข้อมูลและเมตริกที่คอลัมน์นั้นๆ จะมีอยู่
ข้อจำกัดแถว
- มีการจำกัดแถวไว้ที่ 1 MB
การจัดรูปแบบเซลล์
- เซลล์มีความยาวได้สูงสุด 2,048 อักขระ
- ช่องว่างขึ้นต้นและต่อท้ายของเซลล์จะถูกตัดออก
- หากต้องการระบุคอมมาภายในเซลล์ ค่าของเซลล์ควรอยู่ในเครื่องหมายคำพูดคู่ เช่น
source1,"medium,ether",group1,100
- ค่าของเซลล์ที่ 2 คือปานกลาง อีเทอร์ - หากต้องการระบุเครื่องหมายคำพูดคู่ภายในเซลล์ นอกเหนือจากเครื่องหมายคำพูดเริ่มต้นและสิ้นสุด ให้ใช้เครื่องหมายคำพูดคู่เป็นเครื่องหมายคำพูดคู่อีกรายการหนึ่ง เช่น
source1,"medium""ether",group1,100
- ค่าของเซลล์ที่ 2 คือmedium"ether