هذا المرجع مخصص للمطورين والمسوقين التقنيين الذين يعملون على ربط تطبيق المتجر مع المنصات الإعلانية من خلال Adjust.
يحتوي هذا الدليل على:
قائمة الأحداث المرسلة من التطبيق (App Events)
قائمة الباراميترات لكل حدث
وصف كل باراميتر ونوعه
استخدامات كل حدث
الأسماء الداعمة في المنصات الإعلانية (Meta وغيرها)
يساعدك هذا المرجع على إعداد Event Mapping و Parameter Mapping داخل Adjust بشكل صحيح لرفع جودة البيانات وتحسين أداء الحملات الإعلانية.
🔧 أولاً: ربط البراميترز Parameter Mapping
إذا كان التطبيق يرسل باراميترات بأسماء تختلف عن الأسماء التي تستخدمها المنصة الإعلانية، يجب ربطها (Parameter Mapping) لضمان أن المنصة تقوم بقراءة البيانات بالشكل الصحيح.
مثال بسيط:
التطبيق يرسل: Price ، ولكن فيسبوك يستخدم:fb_price
لذلك يجب ربطهما في Adjust.
📌 الأحداث الأساسية (Events) والباراميترات الخاصة بكل حدث
1. Event: Product Added to Wishlist
اضافة المنتج لقائمة المفضلة:
Parameter | Description | Type |
|---|---|---|
| wishlist_name | اسم قائمة المفضلة | string |
| product_id | رمز المنتج | string |
| wishlist_id | رقم قائمة المفضلة | string |
| id | رمز المستخدم داخل المتجر | string |
| position | ترتيب العنصر داخل قائمة المفضلة | number |
| gender | جنس المستخدم male,female | string |
| phone | رقم جوال المستخدم | string |
| language | لغة التطبيق عند حدوث الحدث | string |
| hashed_gender_short | الجنس المختصر بعد التشفير | string (hashed) |
| content_ids | قائمة معرفات المنتجات المرتبطة بالحدث | array of strings |
| category | فئة/قسم المنتج | string |
| sku | رقم SKU الخاص بالمنتج | string |
| url | رابط صفحة المنتج | string |
| quantity | الكمية | number |
| name | اسم المنتج | string |
| birthday | تاريخ الميلاد (yyyy-mm-dd) | string |
| hashed_phone_number | رقم الجوال بعد التشفير | string (hashed) |
| item_id | رمز المنتج | string |
| hashed_gender | الجنس بعد التشفير | string (hashed) |
| البريد الإلكتروني | string | |
| content_type | نوع المحتوى (مثال: product,product_group) | string |
| user_id | رمز المستخدم | string |
| gender_short | الجنس المختصر (مثال: m, f) | string |
| hashed_dob | تاريخ الميلاد بعد التشفير | string (hashed) |
| hashed_last_name | الاسم الاخير بعد التشفير | string (hashed) |
| currency | العملة المستخدمة | string |
| first_name | الاسم الاول | string |
| price | سعر المنتج | number |
| last_name | الاسم الاخير | string |
| hashed_email_address | البريد الإلكتروني بعد التشفير | string (hashed) |
| image_url | رابط صورة المنتج | string |
| hashed_first_name | الاسم الأول بعد التشفير | string (hashed) |
2. Event: Product Added (Add to Cart)
إضافة المنتج للسلة
Parameter | Description | Type |
|---|---|---|
| content_type | نوع المحتوى (مثال: product,product_group) | string |
| first_name | الاسم الاول | string |
| birthday | تاريخ الميلاد (yyyy-mm-dd) | string |
| quantity | الكميه | number |
| hashed_gender_short | الجنس المختصر بعد التشفير | string (hashed) |
| البريد الإلكتروني | string | |
| id | رمز المستخدم | string |
| user_id | رمز المستخدم | string |
| item_id | رمز المنتج | string |
| product_id | رمز المنتج | string |
| hashed_last_name | الإسم الأخير بعد التشفير | string (hashed) |
| hashed_email_address | البريد الإلكتروني بعد التشفير | string (hashed) |
| hashed_first_name | الاسم الأول بعد التشفير | string (hashed) |
| position | ترتيب المنتج في القائمة أو النتائج | number |
| image_url | رابط صورة المنتج | string |
| price | سعر المنتج | number |
| language | لغة التطبيق | string |
| hashed_dob | تاريخ الميلاد بعد التشفير | string (hashed) |
| phone | رقم جوال المستخدم | string |
| hashed_gender | الجنس بعد التشفير | string (hashed) |
| url | رابط صفحة المنتج | string |
| last_name | الإسم الأخير | string |
| content_ids | قائمة معرفات المنتجات المرتبطة | array of strings |
| gender | جنس المستخدم | string |
| sku | رقم SKU للمنتج | string |
| gender_short | الجنس المختصر (m/f) | string |
| cart_id | رمز السلة | string |
| hashed_phone_number | رقم الجوال بعد التشفير | string (hashed) |
| category | فئة/قسم المنتج | string |
| name | اسم المنتج | string |
| currency | العملة المستخدمة | string |
3. Event: Promotion Clicked
الضغط على إعلان داخل التطبيق
Parameter | Description | Type |
|---|---|---|
| hashed_gender | الجنس بعد التشفير | string (hashed) |
| last_name | الإسم الأخير | string |
| name | اسم البانر أو الترويج (مثال: brand banner) | string |
| hashed_email_address | البريد الإلكتروني بعد التشفير | string (hashed) |
| language | لغة التطبيق | string |
| id | رمز المستخدم | string |
| hashed_gender_short | الجنس المختصر بعد التشفير | string (hashed) |
| hashed_last_name | الإسم الأخير بعد التشفير | string (hashed) |
| gender_short | الجنس المختصر (m/f) | string |
| promotion_id | رمز الإعلان | string |
| first_name | الاسم الأول للمستخدم | string |
| position | مكان ظهور الإعلان داخل التطبيق (مثال: الرئيسية) | string |
| hashed_first_name | الاسم الأول بعد التشفير | string (hashed) |
| birthday | تاريخ الميلاد (yyyy-mm-dd) | string |
| phone | رقم الجوال | string |
| البريد الإلكتروني | string | |
| hashed_dob | تاريخ الميلاد بعد التشفير | string (hashed) |
| gender | جنس المستخدم | string |
| currency | العملة | string |
| user_id | رمز المستخدم | string |
| hashed_phone_number | رقم الجوال بعد التشفير | string (hashed) |
4. Event: Products Searched
البحث داخل التطبيق
Parameter | Description | Type |
|---|---|---|
| user_id | رمز المستخدم | string |
| results_count | عدد النتائج التي ظهرت للمستخدم | number |
| gender_short | الجنس المختصر (m/f) | string |
| hashed_email_address | البريد الإلكتروني بعد التشفير | string (hashed) |
| results | عدد النتائج التي ظهرت للمستخدم | number |
| hashed_gender_short | الجنس المختصر بعد التشفير | string (hashed) |
| last_name | الإسم الأخير | string |
| البريد الإلكتروني | string | |
| hashed_phone_number | رقم الجوال بعد التشفير | string (hashed) |
| gender | جنس المستخدم | string |
| id | رمز المستخدم | string |
| language | لغة التطبيق | string |
| phone | رقم الجوال | string |
| hashed_gender | الجنس بعد التشفير | string (hashed) |
| first_name | الاسم الأول للمستخدم | string |
| search_string | نص البحث الذي أدخله المستخدم | string |
| query | نص البحث الذي أدخله المستخدم | string |
| birthday | تاريخ الميلاد (yyyy-mm-dd) | string |
| currency | العملة | string |
| hashed_dob | تاريخ الميلاد بعد التشفير | string (hashed) |
| hashed_first_name | الاسم الأول بعد التشفير | string (hashed) |
| hashed_last_name | الاسم الأخير بعد التشفير | string (hashed) |
5. Event: Order Completed
إكمال الطلب
number | تكلفة الشحن | shipping |
string (hashed) | الجنس المختصر بعد التشفير | hashed_gender_short |
string | معرف العملية/الترانزكشن | transaction_id |
number | قيمه الطلب بدون ضريبه | revenue |
number | قيمه الطلب مع الضريبه | value |
string | جنس المستخدم | gender |
string (hashed) | الاسم الأول بعد التشفير | hashed_first_name |
number | عدد المنتجات | num_items |
string (hashed) | البريد الإلكتروني بعد التشفير | hashed_email_address |
string | الإسم الأخير | last_name |
string | العملة الخاصة بالطلب | currency |
number | قيمة الضريبة | tax |
string (hashed) | رقم الجوال بعد التشفير | hashed_phone_number |
number | الخصم | discount |
string | الاسم الأول للمستخدم | first_name |
string | تاريخ الميلاد (yyyy-mm-dd) | birthday |
string | رمز المستخدم | user_id |
string | الجنس المختصر (m/f) | gender_short |
array of strings | قائمة معرفات المنتجات في الطلب | content_ids |
string | رقم الجوال | phone |
string | رمز المستخدم | id |
string (hashed) | تاريخ الميلاد بعد التشفير | hashed_dob |
string | رقم الطلب | order_id |
string (hashed) | الإسم الأخير بعد التشفير | hashed_last_name |
string | لغة التطبيق | language |
string | نوع المحتوى (مثال: product_group) | content_type |
string | البريد الإلكتروني | email list |
array of products | قائمة المنتجات داخل الطلب |
6. المنتجات داخل الطلب (Products Array)
لكل منتج في الطلب، قد تكون البراميترز التالية:
Parameter | Description | Type |
|---|---|---|
| sku | رقم SKU الخاص بالمنتج | string |
| price | سعر المنتج | number |
| quantity | كمية هذا المنتج في الطلب | number |
| variant | نوع/خيار المنتج (مثل اللون أو المقاس) | string |
| brand | العلامة التجارية | string |
| category | فئة المنتج | string |
| position | ترتيب المنتج في القائمة | number |
| image_url | رابط صورة | string |
| currency | العملة | string |
| product_id | رمز المنتج | string |
| name | اسم المنتج | string |
| url | رابط صفحة المنتج | string |