إحصائيات الرسائل داخل التطبيق

تعرض طريقتان إحصائيات لـ حملات الرسائل الفورية داخل التطبيق. استخدم inapps:totals للحصول على إجماليات الفترة لحملة واحدة أو أكثر، و inapps:timeline للحصول على سلسلة زمنية لحملة واحدة. تتطابق القيم مع شاشة إحصائيات الرسائل داخل التطبيق في لوحة التحكم (Control Panel).

الرسائل داخل التطبيق المرسلة من Journey

تغطي هذه الطرق حملات الرسائل الفورية داخل التطبيق فقط. يتم الإبلاغ عن الرسائل داخل التطبيق التي يتم تسليمها بواسطة عنصر رحلة العميل (Customer Journey) لكل نقطة في الرحلة بواسطة Get Journey stats.

المقاييس

الحقل	النوع	الوصف
impressions	number	عدد مرات عرض الرسالة داخل التطبيق. تسمى Impressions في لوحة التحكم.
unique_impressions	number	عدد الأجهزة الفريدة التي عُرضت عليها الرسالة داخل التطبيق.
interactions	number	التفاعلات مع محتوى الرسالة داخل التطبيق: نقرات الأزرار، نقرات الروابط، وتقديم النماذج.
unique_interactions	number	عدد الأجهزة الفريدة التي تفاعلت مع الرسالة داخل التطبيق.
skips	number	عدد المرات التي أغلق فيها المستخدمون الرسالة داخل التطبيق دون تفاعل.
audience	number	عدد الأجهزة الفريدة التي أنتجت أي حدث للرسالة داخل التطبيق في الفترة المحددة.

ملاحظة

المقاييس الفريدة و audience هي قيم تقريبية لأنها تستخدم العد المميز الاحتمالي. أرقام المنصات لا تُجمع إلى إجمالي الحملة: الجهاز الذي يظهر على منصتين يتم عده مرة واحدة في تفصيل كل منصة ومرة واحدة في إجمالي الحملة.

inapps:totals

يعرض الإجماليات للفترة. مرر inapp_codes للإبلاغ عن حملات محددة، أو احذفه لتصفح كل رسالة داخل التطبيق للتطبيق صفحة بصفحة. هذه هي الطريقة التي يجب استخدامها للتصدير المجدول.

POST https://api.pushwoosh.com/api/v2/statistics/inapps:totals

الترويسات

الاسم	مطلوب	الوصف
Authorization	نعم	رمز Server API بالتنسيق Authorization: Api <Server Key>.

معلمات نص الطلب

الاسم	مطلوب	النوع	الوصف
application	نعم	String	رمز التطبيق.
date_range	نعم	Object	فترة التقرير. date_from و date_to تستخدمان تنسيق YYYY-MM-DD وهما شاملتان. يتم حساب الفترة بالتوقيت العالمي المنسق (UTC) ويجب ألا تتجاوز 366 يومًا.
inapp_codes	لا	Array	رموز الرسائل داخل التطبيق، حتى 100 لكل طلب. احذفه للإبلاغ عن جميع الرسائل داخل التطبيق للتطبيق. إذا كان أي رمز في القائمة لا ينتمي إلى التطبيق، يفشل الطلب بأكمله مع 404.
platforms	لا	Array	حصر المقاييس على هذه المنصات. القيم الممكنة: "IOS", "ANDROID", "HUAWEI_ANDROID", "AMAZON", "OSX", "WINDOWS", "SAFARI", "CHROME", "FIREFOX", "WEB".
with_platforms	لا	Boolean	أضف تفصيلاً لكل منصة إلى كل عنصر.
page	لا	Integer	رقم الصفحة، يبدأ من 0. ينطبق عند حذف inapp_codes.
per_page	لا	Integer	عدد العناصر في كل صفحة، 20 افتراضيًا، 100 كحد أقصى.

مثال على الطلب

curl -X POST https://api.pushwoosh.com/api/v2/statistics/inapps:totals \
  -H "Authorization: Api YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "application": "XXXXX-XXXXX",
    "date_range": {
      "date_from": "2026-07-01",
      "date_to": "2026-07-31"
    },
    "inapp_codes": ["AAAAA-BBBBB"],
    "with_platforms": true
  }'

حقول الاستجابة

total هو عدد الرسائل داخل التطبيق التي يطابقها الطلب. عند حذف inapp_codes، يكون هذا هو كل الرسائل داخل التطبيق للتطبيق، لذا يمكن لترقيم الصفحات تصفحها. items يحتوي على الصفحة الحالية. page يبدأ العد من 0.

مثال على الاستجابة

{
  "total": 1,
  "page": 0,
  "per_page": 20,
  "items": [{
    "inapp": {
      "code": "AAAAA-BBBBB",
      "name": "Summer sale",
      "status": "active",
      "rich_media_code": "CCCCC-DDDDD"
    },
    "metrics": {
      "impressions": 15230,
      "unique_impressions": 9120,
      "interactions": 2311,
      "unique_interactions": 1980,
      "skips": 640,
      "audience": 9120
    },
    "platforms": [{
      "platform": "IOS",
      "metrics": {
        "impressions": 8100,
        "unique_impressions": 4900,
        "interactions": 1300,
        "unique_interactions": 1120,
        "skips": 310,
        "audience": 4900
      }
    }],
    "frequency_capping": {
      "suppressions": 45,
      "affected_users": 30,
      "data_available_from": "2026-07-17"
    }
  }]
}

inapps:timeline

يعرض إجماليات الفترة وسلسلة زمنية لحملة رسائل داخل التطبيق واحدة.

POST https://api.pushwoosh.com/api/v2/statistics/inapps:timeline

معلمات نص الطلب

الاسم	مطلوب	النوع	الوصف
application	نعم	String	رمز التطبيق.
inapp_code	نعم	String	رمز الرسالة داخل التطبيق.
date_range	نعم	Object	فترة التقرير. date_from و date_to تستخدمان تنسيق YYYY-MM-DD وهما شاملتان. يتم حساب الفترة بالتوقيت العالمي المنسق (UTC) ويجب ألا تتجاوز 366 يومًا. interval اختياري: "HOUR", "DAY" (افتراضي), "WEEK" أو "MONTH". "HOUR" متاح للفترات التي تصل إلى 31 يومًا.
platforms	لا	Array	حصر المقاييس على هذه المنصات.
with_platforms	لا	Boolean	أضف تفصيلاً لكل منصة إلى الإجماليات وإلى كل صف.

مثال على الطلب

curl -X POST https://api.pushwoosh.com/api/v2/statistics/inapps:timeline \
  -H "Authorization: Api YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "application": "XXXXX-XXXXX",
    "inapp_code": "AAAAA-BBBBB",
    "date_range": {
      "date_from": "2026-07-01",
      "date_to": "2026-07-07",
      "interval": "DAY"
    }
  }'

مثال على الاستجابة

{
  "inapp": {
    "code": "AAAAA-BBBBB",
    "name": "Summer sale",
    "status": "active",
    "rich_media_code": "CCCCC-DDDDD"
  },
  "totals": {
    "impressions": 15230,
    "unique_impressions": 9120,
    "interactions": 2311,
    "unique_interactions": 1980,
    "skips": 640,
    "audience": 9120
  },
  "frequency_capping": {
    "suppressions": 45,
    "affected_users": 30,
    "data_available_from": "2026-07-17"
  },
  "rows": [{
    "timestamp": "2026-07-01T00:00:00Z",
    "metrics": {
      "impressions": 2140,
      "unique_impressions": 1700,
      "interactions": 320,
      "unique_interactions": 290,
      "skips": 95,
      "audience": 1700
    }
  }],
  "impression_duration": [
    { "from_seconds": 0, "to_seconds": 5, "count": 3200 },
    { "from_seconds": 5, "to_seconds": 15, "count": 5400 },
    { "from_seconds": 15, "to_seconds": 30, "count": 4100 },
    { "from_seconds": 30, "to_seconds": 0, "count": 2530 }
  ]
}

impression_duration يصنف مدة بقاء الرسالة داخل التطبيق على الشاشة. في التصنيف الأخير، to_seconds هو 0، مما يعني “30 ثانية وأطول”.

تحديد سقف التكرار (Frequency capping)

يُبلغ قسم frequency_capping عن عروض الرسائل داخل التطبيق التي منعها تحديد سقف التكرار، وعدد المستخدمين الفريدين المتأثرين. لا يتم احتساب عمليات المنع في impressions.

بيانات المنع تبدأ في 17 يوليو 2026

لم يتم تسجيل عمليات المنع قبل هذا التاريخ. بالنسبة لفترة تنتهي قبل ذلك، يعود قسم frequency_capping كـ null بدلاً من الأصفار، حتى لا يتم الخلط بين نقص البيانات وتحديد السقف الذي لم يمنع شيئًا. data_available_from في الاستجابة يحدد أول يوم مغطى. لا يوجد تفصيل لكل منصة لتحديد سقف التكرار.

الاحتفاظ بالبيانات

يتم الاحتفاظ بالإحصائيات لمدة 365 يومًا، لذا فإن الفترة التي تبدأ قبل ذلك لا تُرجع أي بيانات للأيام غير المغطاة.

رموز الاستجابة

الرمز	المعنى
200	نجاح.
400	طلب غير صالح: date_range مفقود أو غير صحيح، فترة أطول من 366 يومًا، فاصل زمني بالساعة على مدى أكثر من 31 يومًا، أو أكثر من 100 inapp_codes.
401	رمز API مفقود أو غير صالح.
404	لم يتم العثور على رمز رسالة داخل التطبيق في هذا التطبيق.