محمود عبدالنبي
التقارير والتحليلات · أداة سطر أوامر · 2

دليل المستودع: أداة مطابقة تحويلات Meta CAPI غير المتصلة

صفحة تعريفية مستقلة بمستودع أداة مطابقة تحويلات Meta CAPI غير المتصلة. توضّح ما الذي يحاول حله، ولمن يناسب، وما الملفات التي ستجدها قبل الانتقال إلى المصدر.

المشكلة التي يعالجها

يوضح التوثيق الأصلي نطاق المشكلة بهذا الوصف:

Develop a pure Python CLI utility (capi_reconciler.py) for formatting Meta CAPI offline events: 1) Normalizes Egyptian (+20) and GCC (+966, +971, +965, etc.) phone numbers to strict E.164 standards, handling missing leading zeroes, 2) Performs lowercase SHA256 hashing on emails, names, and phone numbers, 3) Formats Unix timestamps, 4) Generates a pre-flight validation report showing estimated Event Match Quality.

لمن صُمم؟

الجمهور المحدد في README: PRO operating in high-growth e-commerce, digital publishing, and direct-response marketing across Saudi Arabia, UAE, and Egypt.

محتويات المستودع

الملفات الأساسية التي يسردها قسم بنية المستودع في README:

  • data/mena_phone_rules.json
  • examples/hashed_meta_ready.csv
  • examples/raw_crm_sample.csv
  • examples/unmatched_crm_leads.csv
  • LICENSE
  • README.md
  • reports/reconciliation_summary.json
  • src/capi_reconciler.py
  • templates/offline_event_payload.json
  • tests/test_reconciler.py

طريقة مراجعته واستخدامه

  1. ابدأ بقراءة README وتأكد أن المشكلة المذكورة تطابق احتياجك الفعلي.
  2. افحص الملفات المذكورة أعلاه؛ أسماء الملفات توضح مكان البيانات والأدوات والقوالب والاختبارات.
  3. اتبع Quick Start الموجود في README، وتحقق من المتطلبات قبل تشغيل أي أمر.
  4. قارن المخرجات بعينة موثقة، وراجع القيود قبل استخدامها في قرار أو عمل عميل.

أمثلة أوامر البدء من README: python -m unittest discover -s tests · python src/capi_reconciler.py --help

النطاق والقيود

  • Event Deduplication (event_id): Requires identical event_id and event_name on both browser pixel and server CAPI payloads within 48-hour deduplication window.
  • Customer Information Parameters: Hashes PII (email, phone, first/last name) with SHA-256 before transmission to maximize Event Quality Match score.
  • Timezone Normalization: Offline CRM delivery events must be converted to UTC Unix timestamps to match Meta ad auction attribution windows.

هذه الصفحة تلخص التوثيق المتاح ولا تثبت أداءً أو نتيجة تجارية. تحقق من صلاحية البيانات والمتطلبات قبل الاستخدام.

مستودعات مرتبطة