معرفات API الرئيسية

يسرد هذا المنشور المعرفات الأساسية المستخدمة في طلبات Pushwoosh API. هذه المعرفات مطلوبة للمصادقة، وإنشاء الرسائل، والاستهداف، والتقسيم، والتتبع، وإدارة المستخدمين عبر تطبيقاتك.

معرف فريد يتم تعيينه لكل تطبيق في حساب Pushwoosh الخاص بك. وهو مطلوب في معظم استدعاءات API لتحديد التطبيق المستهدف.

أين تجده

لوحة تحكم Pushwoosh ← أسفل اسم التطبيق.

رمز فريد يتم تعيينه لحساب Pushwoosh، ويستخدم لمصادقة طلبات API. يتيح الوصول لإدارة المشاريع، وإرسال الرسائل، وتعديل الإعدادات، واسترداد البيانات. يحتوي كل حساب على رمز واحد على الأقل تم إنشاؤه افتراضيًا. اعرف المزيد

أين تجده

لوحة تحكم Pushwoosh ← الوصول إلى API.

معرف فريد يتم تعيينه للجهاز بواسطة Pushwoosh SDK. يتم تعيينه تلقائيًا بواسطة SDK أو يتم تمريره أثناء تسجيل الجهاز. اعرف المزيد

أين تجده

• في سجلات الجهاز. اعرف المزيد

• في مستكشف المستخدم (User Explorer) عند البحث بواسطة معرف المستخدم (User ID)

• في ملف CSV الذي تم تنزيله من قائمة الشرائح (Segments list)

رمز صادر عن مزودي المنصات يحدد زوجًا من التطبيق والجهاز لتوصيل إشعارات الدفع. يتم جمعه تلقائيًا بواسطة SDK عند منح أذونات الدفع. اعرف المزيد

أين تجده

• في سجلات الجهاز. اعرف المزيد

• في مستكشف المستخدم (User Explorer)، أدخل HWID في حقل البحث للعثور على الجهاز المرتبط، ثم افتح تفاصيل الجهاز لعرض رمز الدفع.

يشير إلى منصة الجهاز المستهدف باستخدام رمز رقمي. يتم تعيينه تلقائيًا بواسطة SDK.

القيم المدعومة:

1 – iOS
3 – Android
7 – macOS
8 – Windows
9 – Amazon
10 – Safari
11 – Chrome
12 – Firefox
13 – Internet Explorer
14 – Email
16 – Baidu Android
17 – Huawei
18 – SMS
20 – Web
21 – WhatsApp
22 – Line
23 – Kakao Talk
24 – Telegram
25 – Apple Wallet
26 – Google Wallet
27 – Viber

معرف مخصص يتم تعيينه للمستخدم، مما يتيح الاستهداف عبر الأجهزة والاستهداف المخصص. اعرف المزيد

أين تجده

لوحة تحكم Pushwoosh ← الجمهور ← مستكشف المستخدم (User Explorer)

معرف فريد يتم تعيينه لكل رسالة عند إنشائها. يتبع تنسيقًا محددًا: XXXX-XXXXXXXX-XXXXXXXX.

هذا الرمز ضروري لـ:

• تتبع حالة وتسليم رسالة معينة
• إلغاء (أو حذف) رسالة تم إرسالها مسبقًا
• الحصول على إحصائيات الرسالة

أين تجده

• لوحة تحكم Pushwoosh: انتقل إلى الحملات ← الرسائل لمرة واحدة، ثم افتح خصائص الرسالة المطلوبة. سيتم عرض رمز الرسالة هناك.
• استجابة واجهة برمجة التطبيقات /createMessage: عند إنشاء رسالة جديدة عبر واجهة برمجة التطبيقات، يتم تضمين رمز الرسالة في الاستجابة.

يربط رسالة بطلب HTTP الذي أنشأها، مما يتيح لك تتبع إرسال واحد من البداية إلى النهاية — من استدعاء HTTP عبر طبقة توجيه Pushwoosh إلى الرسالة الناتجة.

موجود في أي رسالة تم إنشاؤها بواسطة استدعاء HTTP إلى /createMessage أو Messaging API v2، بما في ذلك الرسائل المرسلة من لوحة التحكم. الرسائل التي تم إنشاؤها بواسطة Journeys أو إرسالات cron أو مشغلات داخلية أخرى غير HTTP ليس لها معرف طلب.

تعيين قيمتك الخاصة

مرر ترويسة X-Request-ID مع الطلب. إذا كانت القيمة بطول 8-128 حرفًا وتحتوي فقط على أحرف لاتينية وأرقام ونقاط وشرطات سفلية وواصلات، فإن Pushwoosh يعيد استخدامها؛ وإلا — أو إذا تم حذف الترويسة — فإن Pushwoosh ينشئ واحدة لك. يتم استبدال القيمة غير الصالحة بصمت، لذلك لا يفشل الطلب أبدًا بسببها. لا يتم فرض التفرد، لذا استخدم قيمة فريدة بالفعل لكل طلب إذا كنت تعتمد عليها للتتبع.

أين تجده

لوحة تحكم Pushwoosh ← افتح رسالة ← تفاصيل الرسالة ← إظهار جميع الخصائص ← إعدادات الرسالة ← معرف الطلب (Request ID) (مع زر نسخ).

مثال: a1b2c3d4e5f64a7b8c9d0e1f2a3b4c5d

رمز فريد يحدد حملة in-app فورية. أين تجده

لوحة تحكم Pushwoosh ← الحملات ← Instant in-apps. في القائمة، يتم عرض الرمز أسفل اسم الحملة.

مثال: AAAAA-BBBBB

معرف لإعداد مسبق لرسالة محفوظة (على سبيل المثال، push أو SMS). اعرف المزيد

أين تجده

لوحة تحكم Pushwoosh ← المحتوى ← الإعدادات المسبقة.

يمكنك العثور على رمز الإعداد المسبق في مكانين:

• في عرض القائمة، يتم عرضه أسفل اسم الإعداد المسبق.

• في عنوان URL عند تحرير أو إنشاء إعداد مسبق (إنه الجزء الأخير من عنوان URL).

مثال:

URL: https://app.pushwoosh.com/applications/XXXXX-XXXXX/sms-presets/edit/AAAAA-BBBBB

رمز الإعداد المسبق: AAAAA-BBBBB

معرف لقالب رسالة in-app. اعرف المزيد

أين تجده

لوحة تحكم Pushwoosh ← المحتوى ← الوسائط الغنية.

مثال: URL: https://app.pushwoosh.com/applications/XXXXX-XXXXX/rich-media/AAAAA-BBBBB/statistics رمز الوسائط الغنية: AAAAA-BBBBB

رمز محتوى البريد الإلكتروني هو معرف فريد لمحتوى البريد الإلكتروني المحفوظ. اعرف المزيد

أين تجده

لوحة تحكم Pushwoosh ← المحتوى ← محتوى البريد الإلكتروني.

الرمز هو الجزء الأخير من عنوان URL.

مثال:

URL: https://app.pushwoosh.com/applications/XXXXX-XXXXX/email-content/edit/AAAAA-BBBBB رمز محتوى البريد الإلكتروني: AAAAA-BBBBB

معرف فريد يستخدم للإشارة إلى حملة معينة للتتبع والتحليل.

أين تجده

يظهر رمز الحملة في عنوان URL عند عرض الإحصائيات المتعلقة بالحملة في لوحة تحكم Pushwoosh. لتحديد موقعه، انتقل إلى الإحصائيات ← الإحصائيات المجمعة، انقر فوق الحملة المطلوبة، وانسخ الرمز الموجود في نهاية عنوان URL.

مثال:

URL: https://app.pushwoosh.com/applications/XXXXX-XXXXX/statistics/aggregated-message?campaignCode=YYYYY-YYYYY

رمز الحملة: YYYYY-YYYYY

معرف فريد يستخدم لربط الرسائل بحملات تسويقية محددة لتتبع وتحليل الأداء.

أين تجده

• في عنوان URL الخاص بلوحة الحملة في لوحة تحكم Pushwoosh.
• حدد نقطة على اللوحة واضغط على Ctrl+I (Cmd+I) — ينسخ <journey UUID>/<point UUID> إلى الحافظة؛ معرف الرحلة هو الجزء قبل الشرطة المائلة.

مثال: URL: https://app.pushwoosh.com/journeys/XXXXX-XXXXX/1/aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee

معرف الرحلة: aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee

اسم شريحة مستخدم محددة مسبقًا تم إنشاؤها في Pushwoosh لاستهداف الجمهور. اعرف المزيد

أين تجده

لوحة تحكم Pushwoosh ← الشرائح.

رمز فريد بالتنسيق XXXXX-XXXXX يحدد شريحة (تسمى أيضًا فلتر) في Pushwoosh. يستخدم هذا الرمز في استدعاءات API، ومنطق الأتمتة، وقواعد التقسيم الديناميكي.

أين تجده

• عبر طريقة API /listFilters.

• في شريط العنوان عند عرض شريحة في لوحة تحكم Pushwoosh:

مثال:

URL: https://app.pushwoosh.com/applications/XXXXX-XXXXX/segments/XXXE9-XXX49/detail رمز الشريحة: XXXE9-XXX49

سمة مخصصة يتم تعيينها للمستخدمين أو الأجهزة. تستخدم للتقسيم الديناميكي والتخصيص. اعرف المزيد

أين تجده

لوحة تحكم Pushwoosh ← العلامات أو عبر واجهة برمجة التطبيقات /getTags.

اسم حدث يتم تتبعه (على سبيل المثال، purchase، login، subscription). يستخدم لتشغيل تدفقات عمل آلية أو للتحليلات. اعرف المزيد

أين تجده

لوحة تحكم Pushwoosh ← الجمهور ← الأحداث.

يحدد منطقة مسيجة جغرافيًا تستخدم لتشغيل الإشعارات المستندة إلى الموقع. اعرف المزيد

أين تجده

لوحة تحكم Pushwoosh ← المناطق الجغرافية.