คู่มือนักพัฒนาในการนำเข้าข้อมูล

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