دليل أحداث التطبيق (Events) والمحددات (Parameters) لربط Adjust مع المنصات الإعلانية

لا توجد مقالات في هذا القسم

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

إكمال الطلب

Type	Description	Parameter
string (hashed)	الجنس بعد التشفير	hashed_gender
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	قائمة المنتجات داخل الطلب	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

📚 مصادر مهمة

Self-attributing network setup – Adjust Help Center

مركز المساعدة

دليل أحداث التطبيق (Events) والمحددات (Parameters) لربط Adjust مع المنصات الإعلانية