สถาปัตยกรรมทางกายภาพ
CitrusAd Reporting API ช่วยให้เข้าถึงคลังข้อมูล CitrusAd ได้อย่างปลอดภัย คลังข้อมูลนั้นมีข้อมูลและข้อมูลเชิงลึกที่มาจากแพลตฟอร์ม CitrusAd
คลังข้อมูล CitrusAd เป็นรูปแบบแบบกระจาย ข้อมูลบางส่วนจะถูกเก็บไว้ภายในอินสแตนซ์แพลตฟอร์ม CitrusAd ข้อมูลอื่นๆ ในคลังข้อมูลส่วนกลางแบบรวมศูนย์กลาง
แผนภาพต่อไปนี้แสดงโครงสร้างของแบบจำลองข้อมูล
| เลเยอร์ | คำอธิบาย |
|---|---|
| ข้อมูลแพลตฟอร์ม | แหล่งข้อมูลจากแพลตฟอร์ม CitrusAd แพลตฟอร์มดังกล่าวมีการกระจายไปยังอินสแตนซ์ทางกายภาพหลายรายการ อินสแตนซ์มีอยู่ต่อผู้ค้าปลีกรายใหญ่ หรือในบางกรณี จะแบ่งปันอย่างปลอดภัยระหว่างร้านค้าปลีกขนาดเล็กหลายราย ไม่อนุญาตให้การเชื่อมต่อภายนอกเข้าถึงข้อมูลแพลตฟอร์มโดยตรง |
| ข้อมูลตามขั้นตอน | ข้อมูลแพลตฟอร์มที่เกี่ยวข้องจะถูกจัดเรียงในคลังข้อมูลในเวลาใกล้เคียงเรียลไทม์ ข้อมูลตามขั้นตอนได้รับการดูแลตามอินสแตนซ์แพลตฟอร์มในตำแหน่งทางกายภาพเดียวกันกับข้อมูลแพลตฟอร์ม โดยทั่วไป ไม่อนุญาตให้การเชื่อมต่อภายนอกเข้าถึงข้อมูลตามขั้นตอน |
| ชุดข้อมูลหลัก | ในแต่ละวัน กระบวนการแบบแบตช์จะใช้ข้อมูลตามขั้นตอนและสร้างโมเดลให้เป็นสคีมาเกล็ดหิมะที่ใช้งานง่าย ซึ่งเรียกว่าชุดข้อมูลหลัก ชุดข้อมูลหลักยังได้รับการดูแลต่ออินสแตนซ์ของแพลตฟอร์มในตําแหน่งทางกายภาพเดียวกันกับข้อมูลแบบกําหนดขั้นตอนและข้อมูลแพลตฟอร์ม ข้อเท็จจริงของชุดข้อมูลหลักแต่ละชุดสามารถดูได้ทั้งในระดับธุรกรรมแต่ละรายการและระดับรายละเอียดรวม การติดตามการเปลี่ยนแปลงยังปรากฏอยู่ในหลายมิติด้วย อนุญาตให้ลูกค้าบางรายเข้าถึงชุดข้อมูลหลักได้โดยตรง (เมื่อมีการร้องขอ) โดยเฉพาะอย่างยิ่งในระดับผู้ค้าปลีก (ขึ้นอยู่กับการอนุมัติ) |
| ชุดข้อมูลหลักแบบรวม | หลังจากอัปเดตชุดข้อมูลหลักแล้ว กระบวนการแบบแบตช์จะนำชุดข้อมูลหลักแต่ละชุดและถ่ายโอนไปยังตำแหน่งรวมศูนย์ (คลังข้อมูลส่วนกลาง) จากนั้นชุดข้อมูลหลักแต่ละชุดจะถูกรวมเข้าเป็นชุดข้อมูลหลักรวมแบบรวมชุดเดียว โปรดทราบว่าเฉพาะข้อมูลข้อเท็จจริงที่รวบรวมไว้ (ไม่ใช่ข้อมูลธุรกรรม) เท่านั้นที่ถูกจัดเก็บไว้ในคลังข้อมูลส่วนกลาง โดยทั่วไป ไม่อนุญาตให้การเชื่อมต่อภายนอกเข้าถึงชุดข้อมูลหลักแบบรวมโดยตรง |
| Reporting Datamart | หลังจากอัปเดตชุดข้อมูลหลักแบบรวมแล้ว กระบวนการแบบแบตช์รายวันจะคำนวณ Reporting Datamart แบบเรียบง่ายและแบบรวมเพิ่มเติม เช่นเดียวกับชุดข้อมูลหลัก Reporting Datamart ก็เป็นสคีมาเกล็ดหิมะเช่นกัน มีการเสนอเฉพาะมิติเวอร์ชันปัจจุบันเท่านั้น ลูกค้าจะต้องรักษาประวัติการเปลี่ยนแปลงภายในคลังข้อมูลของตนเองตามความจำเป็นโดยอิงตามสแนปช็อตรายวัน Reporting Datamart ยังมีมุมมองที่ตกแต่งข้อเท็จจริงบางอย่างและทำให้การสืบค้นสำหรับลูกค้าง่ายขึ้นอีกด้วย อนุญาตให้ลูกค้าที่หลากหลาย ทั้งผู้ค้าปลีกและซัพพลายเออร์ เข้าถึง Reporting Datamart ได้โดยตรง (ตามคำขอ) (ขึ้นอยู่กับการอนุมัติ) |
| Insights [เร็ว ๆ นี้] | ชุดมุมมองที่สร้างขึ้นบน Reporting Datamart ที่ให้ Insights ที่สร้างไว้ล่วงหน้าที่ลูกค้ามักร้องขอ เช่น: ประสิทธิภาพของแคมเปญ (สถิติโฆษณาที่รับรู้ เช่น CTR/ROAS) อัตราการเติมสินค้าคงคลัง (% คําขอที่ตอบสนองด้วยการโฆษณาแบบชําระเงิน) การแสดงความคิดเห็น (ส่วนแบ่งของซัพพลายเออร์ ofimpressions ตามหมวดหมู่/คําค้นหา ฯลฯ) การเรียกเก็บเงิน (การใช้จ่ายผ่านกระเป๋าเงินต่อแคมเปญต่อช่วงเวลา) อนุญาตให้เข้าถึงเลเยอร์ Insights (ตามคําขอ) แก่ลูกค้าที่หลากหลาย ทั้งผู้ค้าปลีกและซัพพลายเออร์ (ขึ้นอยู่กับการอนุมัติ) เอกสารนี้ยังแบ่งปันรหัส SQL ที่ใช้ในการสร้างเลเยอร์ Insights เพื่อให้ลูกค้าที่คัดลอก Reporting Datamart ไปยังคลังข้อมูลของพวกเขาสามารถเข้าใจวิธีการจำลองตรรกะได้อย่างง่ายดาย |
| การแสดงภาพ [รุ่นจํากัด] | ชุดมุมมองที่สร้างขึ้นบนเลเยอร์ Reporting Datamart และ Insights ที่ให้ข้อมูลที่เทียบเท่ากับที่เห็นในแพลตฟอร์ม BI เดิม ปัจจุบันการเข้าถึงเลเยอร์การแสดงภาพได้รับอนุญาต (ตามคําขอ) ให้กับลูกค้า ทั้งผู้ค้าปลีกและซัพพลายเออร์ที่ต้องการเข้าถึงข้อมูลตรงตามที่แสดงในแพลตฟอร์ม BI เดิมของเรา (ขึ้นอยู่กับการอนุมัติ) หมายเหตุ: เว้นแต่จะมีความจำเป็นต้องปรับให้เข้ากับแพลตฟอร์ม BI รุ่นเก่าอย่างแน่นอน ขอแนะนำให้ใช้เลเยอร์ Reporting Datamart หรือ Insights ที่เทียบเท่า นอกจากนี้ยังมีข้อมูลที่ละเอียดมากขึ้นในกรอบเวลาที่ยาวขึ้น |
ต้นแบบข้อมูลเชิงตรรกะ
ข้อมูลที่มีอยู่จะรวมถึงหัวข้อแพลตฟอร์ม CitrusAd ที่มีการร้องขอทั่วไปจำนวนมาก ทั้งนี้ขึ้นอยู่กับประเภทการเข้าถึงของคุณ เช่น:
(โปรดดูอภิธานศัพท์สำหรับคำจำกัดความเพิ่มเติม)
- ข้อมูลมิติ
- แคมเปญ
- แค็ตตาล็อกสินค้า
- ผลิตภัณฑ์
- ทีม
- ผู้ค้าปลีก
- ซัพพลายเออร์
- กระเป๋าเงิน
- คําค้นหา
- หมวดหมู่
- ตำแหน่ง
- ข้อมูลข้อเท็จจริง
- สถิติคำขอโฆษณา (จำนวนคำขอตามเงื่อนไขการค้นหาหรือหมวดหมู่ ฯลฯ)
- สถิติโฆษณาที่รับรู้ (การแสดงผล/คลิก/การใช้จ่ายโฆษณาตามคำค้นหาหรือหมวดหมู่ ฯลฯ)
- สถิติการระบุแหล่งที่มาที่ได้รับการปรับปรุง (เมื่อกำหนดค่าไว้เท่านั้น - การดูการแสดงผลผ่าน การระบุแหล่งที่มาของการคลิกแบบรัศมี ฯลฯ)
- สถิติการใช้จ่ายแคมเปญ FTA
- สรุปธุรกรรมบัญชีแยกประเภท (ข้อมูลการเรียกเก็บเงิน การเติมเงินกระเป๋าเงิน ฯลฯ)
- สถิติการสั่งซื้อ
โดยทั่วไป Reporting API มักใช้เพื่อแชร์สคีมาภายในชุดข้อมูลหลักและ/หรือ Reporting Datamart ทั้งสองรูปแบบนี้ครอบคลุมหัวข้อดังกล่าวข้างต้นเพียงในระดับที่แตกต่างกันของการรวบรวม (ชุดข้อมูลหลักนำเสนอรายละเอียดระดับการทำธุรกรรมสำหรับข้อเท็จจริงและรวม)
ประเภทผู้ใช้
สาขาวิชาที่คุณสามารถดูได้จะถูกจำกัดตามสิ่งที่องค์กรของคุณมีสิทธิ์ดู การเข้าถึงขององค์กรมี 4 ประเภท:
- ระดับเนมสเปซ: ไคลเอนต์ที่ควบคุมเครือข่ายทั้งหมดของทีม (ทั้งทีมซัพพลายเออร์และผู้ค้าปลีก) การเข้าถึงระดับเนมสเปซทำให้มองเห็นข้อมูลทั้งหมดสำหรับการใช้งาน CitrusAd ที่กำหนด
- ระดับผู้ค้าปลีก : ลูกค้าที่เป็นทีมผู้ค้าปลีกเฉพาะ (หรือกลุ่มทีมผู้ค้าปลีก) เท่านั้น
- ระดับซัพพลายเออร์: ลูกค้าที่เป็นทีมซัพพลายเออร์เฉพาะ (หรือกลุ่มทีมซัพพลายเออร์) เท่านั้น
- ระดับผู้รวมระบบ: การขยายระดับซัพพลายเออร์ ยกเว้นที่พวกเขาสามารถเข้าถึงวัตถุระดับผู้ค้าปลีกบางอย่างเต็มรูปแบบ (ตามดุลยพินิจของผู้ค้าปลีกเท่านั้น)
หัวข้อเหล่านี้คือหัวข้อหลักที่ครอบคลุมและวิธีนำไปใช้กับการเข้าถึงทั้ง 3 ประเภท
| พื้นที่เรื่อง | เนมสเปซ | ผู้ค้าปลีก | ซัพพลายเออร์ | ผู้รวมระบบ |
|---|---|---|---|---|
| แคมเปญ | ข้อมูลทั้งหมด | เกี่ยวข้องกับทีมผู้ค้าปลีก | เกี่ยวข้องกับทีมซัพพลายเออร์ | เกี่ยวข้องกับทีมซัพพลายเออร์ |
| แค็ตตาล็อกสินค้า | ข้อมูลทั้งหมด | เกี่ยวข้องกับทีมผู้ค้าปลีก | ไม่มีข้อมูล | เกี่ยวข้องกับทีมผู้ค้าปลีกที่ได้รับอนุมัติเป็นผู้รวมระบบ |
| ผลิตภัณฑ์ | ข้อมูลทั้งหมด | เกี่ยวข้องกับทีมผู้ค้าปลีก | เฉพาะผลิตภัณฑ์ที่ปรากฏในตารางสถิติโฆษณาที่รับรู้จาก supplier_product เท่านั้น | เกี่ยวข้องกับทีมผู้ค้าปลีกที่ได้รับอนุมัติเป็นผู้รวมระบบ |
| ทีม | ข้อมูลทั้งหมด | เกี่ยวข้องกับทีมผู้ค้าปลีก | เกี่ยวข้องกับทีมซัพพลายเออร์ | เกี่ยวข้องกับทีมซัพพลายเออร์ |
| ผู้ค้าปลีก | ข้อมูลทั้งหมด | เกี่ยวข้องกับทีมผู้ค้าปลีก | เฉพาะผู้ค้าปลีกที่ปรากฏในตารางสถิติโฆษณาที่รับรู้ supplier_retailer เท่านั้น | สำหรับผู้ค้าปลีกที่ปรากฏในสถิติโฆษณาที่รับรู้เท่านั้น |
| ซัพพลายเออร์ | ข้อมูลทั้งหมด | เฉพาะสำหรับซัพพลายเออร์ที่ปรากฏในตารางสถิติโฆษณาที่รับรู้ retailer_supplier เท่านั้น | เกี่ยวข้องกับทีมซัพพลายเออร์ | เกี่ยวข้องกับทีมซัพพลายเออร์ |
| กระเป๋าเงิน | ข้อมูลทั้งหมด | กระเป๋าเงินทีมผู้ค้าปลีกเท่านั้น | กระเป๋าเงินทีมซัพพลายเออร์เท่านั้น | กระเป๋าเงินทีมซัพพลายเออร์เท่านั้น |
| คําค้นหา | ข้อมูลทั้งหมด | เกี่ยวข้องกับทีมผู้ค้าปลีก | เฉพาะคำค้นหาที่ปรากฏในสถิติโฆษณาที่รับรู้ (เฉพาะตามที่เป็นในตารางข้อเท็จจริง) | เฉพาะคำค้นหาที่ปรากฏในสถิติโฆษณาที่รับรู้ (เฉพาะตามที่เป็นในตารางข้อเท็จจริง) |
| หมวดหมู่ | ข้อมูลทั้งหมด | เกี่ยวข้องกับทีมผู้ค้าปลีก | สำหรับหมวดหมู่ที่ปรากฏในสถิติโฆษณาที่สร้างเท่านั้น (ปรากฏตามที่อยู่ในตารางข้อเท็จจริงเท่านั้น) | สำหรับหมวดหมู่ที่ปรากฏในสถิติโฆษณาที่สร้างเท่านั้น (ปรากฏตามที่อยู่ในตารางข้อเท็จจริงเท่านั้น) |
| สถิติคำขอโฆษณา | ข้อมูลทั้งหมด | เกี่ยวข้องกับทีมผู้ค้าปลีก | ไม่มีข้อมูล | ไม่มีข้อมูล |
| สถิติการระบุแหล่งที่มาที่ได้รับการปรับปรุง | ข้อมูลทั้งหมด | เกี่ยวข้องกับทีมผู้ค้าปลีก | เกี่ยวข้องกับทีมซัพพลายเออร์ | เกี่ยวข้องกับทีมซัพพลายเออร์ |
| สถิติการใช้จ่ายแคมเปญ FTA | ข้อมูลทั้งหมด | เกี่ยวข้องกับทีมผู้ค้าปลีก | เกี่ยวข้องกับทีมซัพพลายเออร์ | เกี่ยวข้องกับทีมซัพพลายเออร์ |
| สรุปธุรกรรมบัญชีแยกประเภท | ข้อมูลทั้งหมด | กระเป๋าเงินทีมผู้ค้าปลีกเท่านั้น | กระเป๋าเงินทีมซัพพลายเออร์เท่านั้น | กระเป๋าเงินทีมซัพพลายเออร์เท่านั้น |
| สถิติการสั่งซื้อ | ข้อมูลทั้งหมด | เกี่ยวข้องกับทีมผู้ค้าปลีก | ไม่มีข้อมูล | ไม่มีข้อมูล |
| สถิติโฆษณาที่รับรู้ (การแสดงผล/การคลิก AdSpend ฯลฯ) | ข้อมูลทั้งหมด | เกี่ยวข้องกับทีมผู้ค้าปลีก | เกี่ยวข้องกับทีมซัพพลายเออร์ | เกี่ยวข้องกับทีมซัพพลายเออร์ |
| ตำแหน่ง | ข้อมูลทั้งหมด | เกี่ยวข้องกับทีมผู้ค้าปลีก | สำหรับตำแหน่งที่ปรากฏในคำขอโฆษณาและสถิติโฆษณาที่รับรู้เท่านั้น | เกี่ยวข้องกับทีมผู้ค้าปลีกที่ได้รับอนุมัติเป็นผู้รวมระบบ |
วิธีการเข้าถึงของผู้ใช้
มีวิธีการเข้าถึงสองประเภท ขึ้นอยู่กับแพลตฟอร์มคลาวด์ที่คุณใช้
| ประเภทผู้ใช้ | วิธีการเข้าถึง |
|---|---|
| ผู้ใช้ Google Cloud Platform (GCP) ดั้งเดิม | การเข้าถึงโดยตรง เนื่องจากคลังข้อมูลของเราถูกปรับใช้ใน BigQuery (บริการคลังข้อมูลของ GCP) ลูกค้าที่อยู่ใน GCP เองจะสามารถเข้าถึงชุดข้อมูลได้โดยตรง ซึ่งจะช่วยให้คุณเห็นออบเจ็กต์และค้นหาผ่าน BigQuery UI ในโปรเจ็กต์ GCP ของคุณเอง คุณเพียงแค่ต้องให้ที่อยู่อีเมลจากโครงการ GCP ของคุณแก่เรา แล้วเราจะให้สิทธิ์ตามนั้น (รอการอนุมัติ) โปรดทราบว่าผู้ใช้ที่เข้าถึงโดยตรงยังสามารถเรียก BigQuery API ผ่านสคริปต์ ฯลฯ ได้ (นอกเหนือจากการใช้ BigQuery API) |
| ผู้ใช้อื่น ๆ (ที่ไม่ใช่ GCP) | API หากคุณไม่ได้อยู่ใน GCP (เช่น Azure หรือ AWS) CitrusAD จะสร้างบัญชีสำหรับคุณ (บัญชีบริการ) และให้ข้อมูลประจำตัว (รอดำเนินการอนุมัติ) บัญชีนี้จะให้สิทธิ์การเข้าถึงระดับ BigQuery API แก่คุณเท่านั้น (คุณจะไม่สามารถเข้าถึงคอนโซลระบบคลาวด์ได้) |
เวอร์ชัน: f34ea10