curl --request POST \
--url 'https://api.scanova.io/lead/analytics/?type=entries_count,leads_conversion,source&from=2026-08-01&to=2026-08-31' \
--header 'Authorization: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{ "q": ["L9c2f4a1e"], "filter_by": "lead_id" }'
{
"entries_count": {
"total": 14,
"elevation": { "percent": 12, "previous": 12, "type": "+", "period": { "start": "2026-07-01", "end": "2026-08-01" } }
},
"leads_conversion": {
"all": [["2026-08-01", 3], ["2026-08-02", 1]],
"leads": [["2026-08-01", 2], ["2026-08-02", 1]],
"skip": [["2026-08-01", 1], ["2026-08-02", 0]]
},
"source": [["Booth QR", 9.0], ["Flyer QR", 5.0]]
}
العملاء المحتملون والنماذج
الحصول على تحليلات العملاء المحتملين
POST /lead/analytics/
POST
/
lead
/
analytics
/
curl --request POST \
--url 'https://api.scanova.io/lead/analytics/?type=entries_count,leads_conversion,source&from=2026-08-01&to=2026-08-31' \
--header 'Authorization: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{ "q": ["L9c2f4a1e"], "filter_by": "lead_id" }'
{
"entries_count": {
"total": 14,
"elevation": { "percent": 12, "previous": 12, "type": "+", "period": { "start": "2026-07-01", "end": "2026-08-01" } }
},
"leads_conversion": {
"all": [["2026-08-01", 3], ["2026-08-02", 1]],
"leads": [["2026-08-01", 2], ["2026-08-02", 1]],
"skip": [["2026-08-01", 1], ["2026-08-02", 0]]
},
"source": [["Booth QR", 9.0], ["Flyer QR", 5.0]]
}
يعيد تحليلات مجمَّعة (أعداد الإدخالات وتفصيل التحويل ومصدر الزيارات) لقائمة أو أكثر من قوائم العملاء المحتملين.
تكون
يتطلب مفتاح واجهة برمجة تطبيقات إدارة بحصة
MANAGEMENT_API (أو MANAGEMENT_API_SANDBOX) وصلاحية LEAD_GENERATION_ANALYTICS_CAN_VIEW، يُرسَل كقيمة خام لترويسة Authorization — راجع نظرة عامة على واجهة برمجة التطبيقات للإدارة.array
مطلوب
مصفوفة من السلاسل تحدد قوائم العملاء المحتملين المراد تحليلها — إما
lead_ids أو url_hashes لرموز QR، حسب filter_by.string
افتراضي:"lead_id"
lead_id (الافتراضي) أو qr_hash.string
افتراضي:"entries_count"
مجموعة فرعية مفصولة بفواصل من
entries_count وleads_conversion وsource المراد حسابها.string
تاريخ البدء (
YYYY-MM-DD). القيمة الافتراضية هي 7 أيام قبل to.string
تاريخ الانتهاء (
YYYY-MM-DD). القيمة الافتراضية هي اليوم.curl --request POST \
--url 'https://api.scanova.io/lead/analytics/?type=entries_count,leads_conversion,source&from=2026-08-01&to=2026-08-31' \
--header 'Authorization: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{ "q": ["L9c2f4a1e"], "filter_by": "lead_id" }'
{
"entries_count": {
"total": 14,
"elevation": { "percent": 12, "previous": 12, "type": "+", "period": { "start": "2026-07-01", "end": "2026-08-01" } }
},
"leads_conversion": {
"all": [["2026-08-01", 3], ["2026-08-02", 1]],
"leads": [["2026-08-01", 2], ["2026-08-02", 1]],
"skip": [["2026-08-01", 1], ["2026-08-02", 0]]
},
"source": [["Booth QR", 9.0], ["Flyer QR", 5.0]]
}
elevation بقيمة null عندما يكون لكل من الفترة المطلوبة وفترة المقارنة السابقة صفر إدخالات، لتجنّب نسبة مئوية مضلِّلة. يُعاد 400 تحت q إذا كانت مفقودة أو فارغة — عقد هذا الطرف هو {"q": [...], "filter_by": "..."}، وليس {"lead_list": [...], "date_from": "...", "date_to": "..."} من شكل أقدم غير متوافق.
ذو صلة
- تصدير تحليلات العملاء المحتملين — تنزيل هذه التفصيلات نفسها كملف.
- سرد قوائم العملاء المحتملين — إيجاد قيم
lead_idالمراد تحليلها. - نظرة عامة على واجهة برمجة التطبيقات للإدارة — مخطط المصادقة وبنية الحصص التي ينتمي إليها هذا الطرف.
التفويضات
Send your Management API key as the raw value of the Authorization header — no "Bearer " or "Token " prefix, and no other characters. Example: Authorization: 401f7ac837da42b97f613d789819ff93537bee6a. A header containing more than one space-separated part is rejected outright. Requests also require the request's Host header to be the management API host (e.g. api.scanova.io) — the same key sent to the regular API host will not authenticate.
الاستجابة
200
Aggregated analytics for the requested lead lists.
هل كانت هذه الصفحة مفيدة؟