هذا المرجع مخصص للمطورين والمسوقين التقنيين الذين يعملون على ربط تطبيق المتجر مع المنصات الإعلانية من خلال 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 |