คู่มือนักพัฒนาซอฟต์แวร์การนำเข้าข้อมูล

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