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

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

## المعرفات العامة

### رمز التطبيق

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

**أين تجده**

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

### رمز الوصول إلى API

رمز فريد يتم تعيينه لحساب Pushwoosh، ويستخدم لمصادقة طلبات API. يتيح الوصول لإدارة المشاريع، وإرسال الرسائل، وتعديل الإعدادات، واسترداد البيانات. يحتوي كل حساب على رمز واحد على الأقل تم إنشاؤه افتراضيًا. [اعرف المزيد](/ar/developer/api-reference/api-access-token/)

**أين تجده**

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

## معرفات الجهاز

### معرف الجهاز (Hardware ID)

معرف فريد يتم تعيينه للجهاز بواسطة Pushwoosh SDK. يتم تعيينه تلقائيًا بواسطة SDK أو يتم تمريره أثناء تسجيل الجهاز. [اعرف المزيد](/ar/developer/pushwoosh-knowledge-hub/device-identifiers/#hwid)

**أين تجده**

*   في سجلات الجهاز. [اعرف المزيد](/ar/developer/pushwoosh-knowledge-hub/device-identifiers/#how-to-obtain-hwid-and-push-token)

*   في [مستكشف المستخدم (User Explorer)](/ar/product/audience-data-and-segmentation/user-explorer/) عند البحث بواسطة **User ID**
*   في ملف CSV الذي تم تنزيله من [قائمة الشرائح (Segments)](/ar/product/audience-data-and-segmentation/segmentation/segments/)

### رمز الدفع (Push token)

رمز صادر عن مزودي المنصات يحدد زوج التطبيق-الجهاز لتوصيل إشعارات الدفع. يتم جمعه تلقائيًا بواسطة SDK عند منح أذونات الدفع. [اعرف المزيد](/ar/developer/pushwoosh-knowledge-hub/device-identifiers/#push-token)

**أين تجده**

*   في سجلات الجهاز. [اعرف المزيد](/ar/developer/pushwoosh-knowledge-hub/device-identifiers/#how-to-obtain-hwid-and-push-token)

*   في [مستكشف المستخدم (User Explorer)](/ar/product/audience-data-and-segmentation/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
```

## معرفات المستخدم

### معرف المستخدم (User ID)

معرف مخصص يتم تعيينه للمستخدم، مما يتيح الاستهداف عبر الأجهزة والاستهداف المخصص. [اعرف المزيد](/ar/developer/pushwoosh-knowledge-hub/users-userids/users-userids/)

**أين تجده**

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

## معرفات الرسائل

### رمز الرسالة

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

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

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

**أين تجده**

*   **لوحة تحكم Pushwoosh:** انتقل إلى **الحملات ← رسائل لمرة واحدة**، ثم افتح **خصائص** الرسالة المطلوبة. سيتم عرض رمز الرسالة هناك.
*   **استجابة واجهة برمجة التطبيقات [`/createMessage`](/ar/developer/api-reference/messages-api/#createmessage):** عند إنشاء رسالة جديدة عبر واجهة برمجة التطبيقات، يتم تضمين رمز الرسالة في الاستجابة.

## معرفات المحتوى

### رمز الإعداد المسبق (Preset code)

معرف لإعداد مسبق محفوظ للرسائل (على سبيل المثال، إشعار دفع أو رسالة نصية قصيرة). [اعرف المزيد](/ar/product/content/)

**أين تجده**

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

يمكنك العثور على رمز الإعداد المسبق في مكانين:
- في عرض القائمة، معروض أسفل اسم الإعداد المسبق.

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

**مثال**:

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

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

### رمز الوسائط الغنية

معرف لقالب رسالة داخل التطبيق. [اعرف المزيد](/ar/product/content/in-apps/)

**أين تجده**

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

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

### رمز محتوى البريد الإلكتروني

رمز محتوى البريد الإلكتروني هو معرف فريد لمحتوى البريد الإلكتروني المحفوظ. [اعرف المزيد](/ar/product/content/email-content/)

**أين تجده**

لوحة تحكم 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`

### معرف الرحلة (Journey ID)

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

**أين تجده**

يظهر معرف الرحلة في عنوان URL الخاص بلوحة الحملة في لوحة تحكم Pushwoosh.

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

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



## معرفات التقسيم والاستهداف

### اسم الشريحة / الفلتر

اسم شريحة مستخدم محددة مسبقًا تم إنشاؤها في Pushwoosh لاستهداف الجمهور. [اعرف المزيد](/ar/product/audience-data-and-segmentation/segmentation/segments/)

**أين تجده**

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

### رمز الشريحة / الفلتر

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

**أين تجده**

- عبر طريقة API [`/listFilters`](/ar/developer/api-reference/segmentation-filters-api/#listfilters).

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

**مثال:**

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




### العلامة (Tag)

سمة مخصصة يتم تعيينها للمستخدمين أو الأجهزة. تستخدم للتقسيم الديناميكي والتخصيص. [اعرف المزيد](/ar/developer/guides/audience-and-segmentation/tags/)

**أين تجده**

لوحة تحكم Pushwoosh ← العلامات أو عبر واجهة برمجة التطبيقات [`/getTags`](/ar/developer/api-reference/device-api/#gettags).

## معرفات الأحداث

### اسم الحدث

اسم حدث يتم تتبعه (على سبيل المثال، `purchase`، `login`، `subscription`). يستخدم لتشغيل تدفقات العمل الآلية أو للتحليلات. [اعرف المزيد](/ar/developer/guides/audience-and-segmentation/events/)

**أين تجده**

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

## معرفات الموقع الجغرافي

### معرف المنطقة الجغرافية (Geozone ID)

يحدد منطقة جغرافية مسيجة تستخدم لتشغيل الإشعارات المستندة إلى الموقع. [اعرف المزيد](/ar/product/messaging-channels/push-notifications/geo-based-push/)

**أين تجده**

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