Linkly's Analytics API

ส่งออกข้อมูลการคลิกและรายงานการรับส่งข้อมูลจาก Linkly โดยใช้โปรแกรมผ่าน Analytics API ของเรา

ที่เกี่ยวข้อง: Link Shortening API | Webhooks

ก่อนที่คุณจะเริ่มต้น

Linkly สร้างคำขอ API ในอินเทอร์เฟซเพื่อให้คุณคัดลอกและวางในแอปพลิเคชันของคุณ

ประหยัดเวลาและปล่อยให้เราทำงานหนัก API ของเราสามารถบริโภคได้ทั้งหมด

การอนุญาต

คุณจะต้องมี API Key และ Workspace ID คุณสามารถรับรายละเอียดเหล่านี้จากภายใน Linkly

Traffic reports API

Linkly สร้างคำขอ API สำหรับคุณโดยอัตโนมัติภายในรายงานการรับส่งข้อมูลของคุณ

รายงานการรับส่งข้อมูลของ Linkly สร้างคำขอ API สำหรับคุณโดยอัตโนมัติ ตามข้อมูลที่แสดงบนหน้าจอ

ลิงค์เหล่านี้รวม API key ของคุณ และปรับแต่งและใช้งานได้อย่างง่ายดายในแอปพลิเคชันของคุณเอง

รูปแบบผลลัพธ์

Analytics API รองรับรูปแบบผลลัพธ์สามรูปแบบ:

โหมด Pivot (รูปแบบเมทริกซ์)

โดยค่าเริ่มต้น API จะส่งคืนข้อมูลอนุกรมเวลาด้วยหนึ่งแถวต่อวันที่ ด้วย โหมด pivot คุณสามารถรับการรับส่งข้อมูลของลิงค์ทั้งหมดในคำขอเดียวเป็นเมทริกซ์

ใช้ดรอปดาวน์ Export Data ในรายงานการรับส่งข้อมูลใด ๆ เพื่อส่งออกข้อมูลด้วยลิงค์อย่างรวดเร็ว หรือเพิ่ม pivot=link_id ในคำขอ API ของคุณ

เพิ่ม pivot=link_id ในคำขอของคุณเพื่อรับข้อมูลด้วย:

• วันที่เป็นแถว (หนึ่งแถวต่อวัน)
• ลิงค์เป็นคอลัมน์ (หนึ่งคอลัมน์ต่อลิงค์)

ตัวอย่างผลลัพธ์ CSV/TSV pivot

ตัวอย่างผลลัพธ์ JSON pivot

{
  "links": [
    {"id": 123, "name": "My Link", "full_url": "https://linkly.link/abc"},
    {"id": 456, "name": "Other Link", "full_url": "https://linkly.link/xyz"}
  ],
  "data": [
    {"date": "2025-12-30", "clicks": {"123": 45, "456": 12}},
    {"date": "2025-12-31", "clicks": {"123": 52, "456": 8}}
  ]
}

โหมด Pivot มีประโยชน์สำหรับ:

• การเปรียบเทียบการรับส่งข้อมูลในหลายลิงค์
• การนำเข้าลงในสเปรดชีตเพื่อวิเคราะห์
• การสร้างแdashboard ด้วยข้อมูลลิงค์ทั้งหมดในการเรียกเดียว

ข้อมูลการคลิกดิบ

ข้อมูลการคลิกดิบที่เราบันทึก รวมถึงพารามิเตอร์เต็ม แสตมป์เวลา และข้อมูลจำหน่าย ใช้ได้

เพื่อเข้าถึงข้อมูลนี้ คลิก Export จากแท็บที่ด้านล่างและเลือกรูปแบบของคุณ เหล่านี้เป็นคำขอ API ที่เต็มไปด้วยที่คุณสามารถใช้ได้โดยตรงในแอปพลิเคชันของคุณ

หมายเหตุเกี่ยวกับการส่งออกข้อมูล

• พิจารณาการกรองข้อมูลในมุมมองก่อนเพื่อลดจำนวนข้อมูลที่ส่งออก ฟังก์ชันนี้ส่งออกข้อมูลพื้นฐานที่ใช้สร้างรายงานที่อยู่บนหน้าจออยู่ในขณะนี้
• ข้อมูลนี้ถูกแคช นานถึง 3 ชั่วโมง คำขอซ้ำไปยังจุดสิ้นสุดนี้จะไม่สร้างข้อมูลแบบเรียลไทม์

การนับแบบจัดกลุ่ม

จุดสิ้นสุด /counters/{dimension} ส่งคืนเมื่อคลิก รวมตัวเลขตามมิติเดียว เช่น country, platform, destination, referer, isp หรือ link_id ผลลัพธ์จะกลับมาเรียงตามจำนวนคลิก สูงสุดก่อน

ส่งคืนค่าสูงสุด 10,000 ค่า มิติที่มีคาร์ดินาลิตีสูง — destination, referer, remote_ip และ isp — สามารถมีค่าที่แตกต่างกันมากกว่าจำนวนนั้นในพื้นที่ทำงานที่ยุ่ง เมื่อพวกเขาทำ คุณจะได้รับ 10,000 อันดับแรกจากจำนวนคลิกและส่วนที่เหลือจะไม่ส่งคืน

ฟิลด์ total นั้นเสมอจำนวนคลิกทั้งหมดในทุกกลุ่ม รวมถึงกลุ่มที่ไม่ส่งคืน ดังนั้นในผลลัพธ์ที่ถูกตัดทอน ค่า count จะบวกกันให้น้อยกว่า total — ซึ่งหมายความว่าเปอร์เซ็นต์ที่คำนวณเป็น count / total ยังคงถูกต้อง

หากคุณต้องการชุดค่าที่สมบูรณ์แทนที่ 10,000 อันดับแรก ส่งออกข้อมูลการคลิกดิบและรวมตัวเลขด้วยตัวเอง หรือใช้ BigQuery integration

การแจ้งเตือนการคลิกแบบเรียลไทม์

สำหรับการแจ้งเตือนการคลิกแบบเรียลไทม์ โปรดดู Webhooks Webhooks ส่งคำขอ POST ไปยัง URL ที่ระบุของคุณทันทีเมื่อการคลิกเกิดขึ้น พร้อมข้อมูลโดยละเอียดเกี่ยวกับการคลิก

คุณสามารถจัดการ webhooks ผ่าน API ได้เช่นกัน - ดู OpenAPI spec สำหรับรายละเอียด

นโยบายการใช้อย่างยุติธรรม

ขีดจำกัดอัตรา

Analytics API มีขีดจำกัดอัตรา 50 คำขอต่อชั่วโมง ต่อพื้นที่ทำงาน

ขีดจำกัดการใช้งาน

นอกจากขีดจำกัดอัตรา Analytics API มีขีดจำกัดการใช้งานที่รีเซ็ตในแต่ละช่วงการเรียกเก็บเงิน:

สิ่งที่นับเป็นการใช้งาน

• API Requests: การเรียกแต่ละครั้งไปยังจุดสิ้นสุด Analytics API (/clicks, /counters, /export) นับเป็นหนึ่งคำขอ
• Data Scanned: ปริมาณข้อมูลที่ประมวลผลโดยฐานข้อมูลการวิเคราะห์ของเราเพื่อทำให้คำขอของคุณเสร็จสมบูรณ์ ช่วงวันที่ที่ใหญ่กว่าและการค้นหาที่ซับซ้อนมากขึ้นจะสแกนข้อมูลมากขึ้น

สิ่งที่เกิดขึ้นเมื่อคุณเกินขีดจำกัด

หากคุณเกินขีดจำกัดการใช้งาน:

1. 1
   คำขอ API จะส่งคืนข้อผิดพลาด 429 Too Many Requests
2. 2
   ขีดจำกัดของคุณจะรีเซ็ตโดยอัตโนมัติในตอนเริ่มต้นของช่วงการเรียกเก็บเงินถัดไป
3. 3
   ลิงค์ของคุณจะทำงานต่อและติดตามการคลิกตามปกติ

เคล็ดลับในการลดการใช้งาน

ผู้ใช้ส่วนใหญ่สามารถรับข้อมูลทั้งหมดในคำขอ API เดียว โดยใช้โหมด pivot (pivot=link_id) ซึ่งส่งคืนการรับส่งข้อมูลของลิงค์ทั้งหมดเป็นเมทริกซ์ในการเรียกเดียว

• ใช้โหมด pivot: เพิ่ม pivot=link_id เพื่อรับการรับส่งข้อมูลสำหรับลิงค์ทั้งหมดในคำขอเดียวแทนการค้นหาแต่ละลิงค์แยกกัน
• แคชตอบสนอง: เก็บตอบสนองของ API ในเครื่องแทนการดึงข้อมูลเดียวกันซ้ำแล้วซ้ำเล่า
• ใช้ช่วงวันที่เล็กกว่า: สอบถามเฉพาะวันที่ที่คุณต้องการ
• คำขอแบตช์: รวมการค้นหาลิงค์หลายรายการเป็นคำขอเดียวโดยใช้พารามิเตอร์ link_ids

ต้องการมากขึ้นหรือไม่?

หากคุณต้องการขีดจำกัดที่สูงขึ้น โปรดพูดคุยกับเราโดยใช้วิดเจ็ตการสนับสนุน

BigQuery integration

สำหรับความต้องการการวิเคราะห์ปริมาณสูง Linkly มี BigQuery integration ที่ให้การเข้าถึง SQL โดยตรงกับข้อมูลการคลิกของคุณ

• การเข้าถึงข้อมูลแบบเรียลไทม์ - สอบถามข้อมูลการคลิกของคุณโดยตรงใน BigQuery พร้อมการอัปเดตแบบเรียลไทม์
• การค้นหาไม่จำกัด - ไม่มีขีดจำกัดอัตรา API; คุณจ่ายเฉพาะสำหรับการคำนวณ BigQuery
• รายงานแบบกำหนดเอง - สร้างแดชบอร์ดด้วย Looker, Data Studio หรือ Tableau
• การรวมข้อมูล - เข้าร่วมข้อมูลการคลิกกับเมตริกทางธุรกิจอื่น ๆ

BigQuery integration รวมอยู่ในแผน Enterprise ติดต่อเรา สำหรับรายละเอียด

เรียนรู้เพิ่มเติมเกี่ยวกับ BigQuery Integration →

ที่เกี่ยวข้อง

• Link Shortening API - สร้างและอัปเดตลิงค์โดยใช้โปรแกรม
• Webhooks - การแจ้งเตือนการคลิกแบบเรียลไทม์
• BigQuery Integration - การเข้าถึง SQL โดยตรงกับข้อมูลการคลิก
• Zapier Integration - การรวมแบบไม่มีโค้ด