إحصاءات رمز QR عبر API: اجلب أعداد المسح إلى تقاريرك

ما الذي يُحتسب

يحسب Same-QR لكل رمز QR ديناميكي كم مرة مُسح. ولا يتكوّن بذلك ملف تعريفي عن الماسحين. تصبح الأعداد ذات دلالة بالتقسيم الجيد: رمز QR لكل مكان أو مادة إعلانية أو فرع. تتضمن إحصاءات رمز QR إجمالي المسحات وتاريخ الإنشاء وعدد مرات تغيير الوجهة وهل رمز QR غير نشط، مثلًا لأن الحساب تجاوز حد باقته.

الخطوة 1: إنشاء مفتاح قراءة

للتقارير لا تحتاج أبدًا إلى صلاحيات الكتابة. أنشئ في لوحة التحكم تحت الحساب، «الوصول لـ CLI والسكربتات والوكلاء»، مفتاحًا بصلاحية «قراءة فقط» وسمّه باسم غرضه، مثل «التقرير الشهري». يستطيع الاستعلام عن الأرقام، لكنه لا يغيّر شيئًا ولا يحذف. وهذا مهم خصوصًا للمهام التي تعمل دون إشراف.

الخطوة 2: جلب الأرقام

عبر واجهة REST API تعيد قائمة جميع رموز QR عدد المسحات لكل رمز QR أصلًا، وإحصاءات رمز QR واحد تجلبها بطلب مخصص:

curl -H "Authorization: Bearer $SAMEQR_API_KEY" https://sameqr.com/api/v1/qr
curl -H "Authorization: Bearer $SAMEQR_API_KEY" https://sameqr.com/api/v1/qr/<id>/stats

أما مع سطر الأوامر فالأمر أقصر:

sameqr qr list --json > scans-$(date +%Y-%m).json
sameqr qr stats <id>

الخطوة 3: بناء التقرير

بما أن أعداد المسح مجاميع، فاحفظ كل شهر لقطة وقارنها بالشهر السابق. الفرق هو عدد المسحات في الشهر. من التقارير النموذجية:

• تقرير شهري لعميل وكالة يشمل كل رموز QR في مشروع عميله.
• مقارنة عدة فروع، عندما يكون لكل فرع رموز QR خاصة به وتسمية خاصة به.
• تحليل حملة لوحات إعلانية حسب المواقع.

ويمكن دون برنامج خاص أيضًا: مساعد مثل ChatGPT أو Claude مع Same-QR كموصّل يجيب عن «ما أكثر خمسة رموز QR مسحًا؟» مباشرة في المحادثة.

حدود الأرقام

• المسح لا يعني أن أحدًا قرأ الصفحة.
• قلة المسحات قد تعود إلى المكان، مثل إضاءة سيئة أو رمز QR صغير جدًا.
• لسلوك الزوار على الموقع تحتاج إلى تحليلات الويب. والحملات بمعاملات utm تربط بين الاثنين.

الخلاصة: لماذا Same-QR

يحسب Same-QR بدقة وبأقل قدر من البيانات، وتصل إلى الأرقام كما يناسبك: في لوحة التحكم أو عبر API أو عبر CLI أو في محادثة مع مساعد. يكفي مفتاح قراءة، وواجهة API متاحة في كل باقة.

ابدأ الآن: سجّل مجانًا على sameqr.com، فـ 20 رمز QR ديناميكيًا مجانية بشكل دائم. واجهة API وCLI وخادم MCP متاحة في كل باقة، والتوثيق على sameqr.com/entwickler.

الأسئلة الشائعة