Google Analytics Management API ช่วยให้เข้าถึงฟีเจอร์การนำเข้าข้อมูลของ Google Analytics แบบเป็นโปรแกรมได้
เกริ่นนำ
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 โปรดดูการนำเข้าข้อมูลค่าใช้จ่ายโดยใช้ 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