يعرض هذا المرجع الأحداث المقترَحة المتوافقة مع علامات Google.
add_payment_info
يشير هذا الحدث إلى أنّ المستخدم قد أرسل معلومات الدفع الخاصة به في عملية دفع في التجارة الإلكترونية.
المَعلمات
الاسم | Type | عنصر مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
currency |
string |
نعم* | USD |
تمثّل هذه السمة عملة العناصر المرتبطة بالفعالية بتنسيق ISO 4217 المكوّن من 3 أحرف. * في حال ضبط السياسة value ، يجب احتساب currency
لكي يتم احتساب مقاييس الأرباح بدقة.
|
value |
number |
نعم* | 7.77 | القيمة المالية للحدث. * يكون value مطلوبًا عادةً لإعداد تقارير مفيدة.
إذا ضَعت علامة
على الحدث باعتباره إحالة ناجحة، ننصحك بإعداد
value .
* currency مطلوب في حال ضبط value .
|
coupon |
string |
لا | الدالة SUMMER_FUN | اسم/رمز القسيمة المرتبط بالحدث. إنّ مَعلمتَي coupon على مستوى الحدث ومستوى السلعة
مستقلتان.
|
payment_type |
string |
لا | بطاقة الائتمان | طريقة الدفع التي تم اختيارها |
items |
Array<Item> |
نعم | عناصر الحدث. |
معلّمات العناصر
الاسم | Type | عنصر مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
item_id |
string |
نعم* | SKU_12345 |
معرّف العنصر.
*يجب استخدام سمة واحدة من |
item_name |
string |
نعم* | قميص مُزيَّن بشخصيات كتاب Stan and Friends |
اسم السلعة.
*يجب استخدام سمة واحدة من |
affiliation |
string |
لا | Google Store |
ارتباط المنتج لتحديد الشركة التي تقدّمه أو الموقع الجغرافي للمتجر الذي يقدّمه ملاحظة: لا تتوفّر سمة "الارتباط" إلا على مستوى السلعة. |
coupon |
string |
لا | الدالة SUMMER_FUN | اسم/رمز القسيمة المرتبطة بالعنصر إنّ مَعلمتَي coupon على مستوى الحدث ومستوى السلعة
مستقلتان.
|
creative_name |
string |
لا | بانر_صيفي2 | اسم تصميم الإعلان الترويجي. في حال ضبطها، يتم تجاهل creative_name على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة creative_name على مستوى الحدث،
في حال توفّرها. |
creative_slot |
string |
لا | المميزة_1_ | اسم خانة تصميم الإعلان الترويجي المرتبط
بالعنصر. في حال ضبطها، يتم تجاهل creative_slot على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة creative_slot على مستوى الحدث،
في حال توفّرها. |
discount |
number |
لا | 2.22 | قيمة الخصم النقدي المرتبطة بالسلعة. |
index |
number |
لا | 5 | تمثّل هذه السمة فهرس/موضع العنصر في القائمة. |
item_brand |
string |
لا | العلامة التجارية للسلعة. | |
item_category |
string |
لا | ملابس | فئة السلعة وإذا تم استخدامها كجزء من التدرج الهرمي أو التصنيف، ستكون هذه هي الفئة الأولى. |
item_category2 |
string |
لا | للبالغين | التدرج الهرمي للفئة الثانية أو التصنيف الإضافي للعنصر. |
item_category3 |
string |
لا | قمصان | التدرج الهرمي للفئة الثالثة أو التصنيف الإضافي للعنصر. |
item_category4 |
string |
لا | طاقم العمل | التدرج الهرمي للفئة الرابعة أو التصنيف الإضافي للعنصر. |
item_category5 |
string |
لا | كُم قصير | التدرج الهرمي للفئة الخامسة أو التصنيف الإضافي للعنصر. |
item_list_id |
string |
لا | ذو صلة_المنتجات | رقم تعريف القائمة التي تم فيها عرض السلعة للمستخدِم في حال ضبطها، يتم تجاهل item_list_id على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة item_list_id على مستوى الحدث،
في حال توفّرها.
|
item_list_name |
string |
لا | منتجات ذات صلة | اسم القائمة التي تم فيها عرض السلعة للمستخدِم في حال ضبطها، يتم تجاهل item_list_name على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة item_list_name على مستوى الحدث،
في حال توفّرها.
|
item_variant |
string |
لا | أخضر | صيغة العنصر أو رمز فريد أو وصف لمزيد من التفاصيل/خيارات العناصر. |
location_id |
string |
لا | ChIJIQBpAG2ahYAR_6128GcTUEo (رقم تعريف المكان في Google لسان فرانسيسكو) |
تمثّل هذه السمة الموقع الجغرافي المرتبط بالعنصر (مثل الموقع الجغرافي للمتجر). ننصحك باستخدام
معرّف المكان من Google الذي يتوافق مع العنصر المرتبط. يمكن أيضًا استخدام معرّف الموقع المخصص. ملاحظة: لا يتوفّر "معرّف الموقع الجغرافي" إلا على مستوى العنصر. |
price |
number |
لا | يورو | السعر النقدي للسلعة، بوحدات معلمة العملة المحدّدة. |
promotion_id |
string |
لا | P_12345 |
معرّف العرض الترويجي المرتبط بالعنصر. في حال ضبطها، يتم تجاهل promotion_id على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة promotion_id على مستوى الحدث،
في حال توفّرها.
|
promotion_name |
string |
لا | تخفيضات موسم الصيف |
اسم العرض الترويجي المرتبط بالسلعة. في حال ضبطها، يتم تجاهل promotion_name على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة promotion_name على مستوى الحدث،
في حال توفّرها.
|
quantity |
number |
لا | 1 |
كمية السلعة |
add_shipping_info
يشير هذا الحدث إلى أنّ المستخدم قد أرسل معلومات الشحن الخاصة به في عملية دفع في التجارة الإلكترونية.
المَعلمات
الاسم | Type | عنصر مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
currency |
string |
نعم* | USD |
تمثّل هذه السمة عملة العناصر المرتبطة بالفعالية بتنسيق ISO 4217 المكوّن من 3 أحرف. * في حال ضبط السياسة value ، يجب احتساب currency
لكي يتم احتساب مقاييس الأرباح بدقة.
|
value |
number |
نعم* | 7.77 | القيمة المالية للحدث. * يكون value مطلوبًا عادةً لإعداد تقارير مفيدة.
إذا ضَعت علامة
على الحدث باعتباره إحالة ناجحة، ننصحك بإعداد
value .
* currency مطلوب في حال ضبط value .
|
coupon |
string |
لا | الدالة SUMMER_FUN | اسم/رمز القسيمة المرتبط بالحدث. إنّ مَعلمتَي coupon على مستوى الحدث ومستوى السلعة
مستقلتان.
|
shipping_tier |
string |
لا | شحن بري |
فئة الشحن (مثل Ground أو Air أو
Next-day ) التي تم اختيارها لتوصيل السلعة المشتراة.
|
items |
Array<Item> |
نعم | عناصر الحدث. |
معلّمات العناصر
الاسم | Type | عنصر مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
item_id |
string |
نعم* | SKU_12345 |
معرّف العنصر.
*يجب استخدام سمة واحدة من |
item_name |
string |
نعم* | قميص مُزيَّن بشخصيات كتاب Stan and Friends |
اسم السلعة.
*يجب استخدام سمة واحدة من |
affiliation |
string |
لا | Google Store |
ارتباط المنتج لتحديد الشركة التي تقدّمه أو الموقع الجغرافي للمتجر الذي يقدّمه ملاحظة: لا تتوفّر سمة "الارتباط" إلا على مستوى السلعة. |
coupon |
string |
لا | الدالة SUMMER_FUN | اسم/رمز القسيمة المرتبطة بالعنصر إنّ مَعلمتَي coupon على مستوى الحدث ومستوى السلعة
مستقلتان.
|
creative_name |
string |
لا | بانر_صيفي2 | اسم تصميم الإعلان الترويجي. في حال ضبطها، يتم تجاهل creative_name على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة creative_name على مستوى الحدث،
في حال توفّرها. |
creative_slot |
string |
لا | المميزة_1_ | اسم خانة تصميم الإعلان الترويجي المرتبط
بالعنصر. في حال ضبطها، يتم تجاهل creative_slot على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة creative_slot على مستوى الحدث،
في حال توفّرها. |
discount |
number |
لا | 2.22 | قيمة الخصم النقدي المرتبطة بالسلعة. |
index |
number |
لا | 5 | تمثّل هذه السمة فهرس/موضع العنصر في القائمة. |
item_brand |
string |
لا | العلامة التجارية للسلعة. | |
item_category |
string |
لا | ملابس | فئة السلعة وإذا تم استخدامها كجزء من التدرج الهرمي أو التصنيف، ستكون هذه هي الفئة الأولى. |
item_category2 |
string |
لا | للبالغين | التدرج الهرمي للفئة الثانية أو التصنيف الإضافي للعنصر. |
item_category3 |
string |
لا | قمصان | التدرج الهرمي للفئة الثالثة أو التصنيف الإضافي للعنصر. |
item_category4 |
string |
لا | طاقم العمل | التدرج الهرمي للفئة الرابعة أو التصنيف الإضافي للعنصر. |
item_category5 |
string |
لا | كُم قصير | التدرج الهرمي للفئة الخامسة أو التصنيف الإضافي للعنصر. |
item_list_id |
string |
لا | ذو صلة_المنتجات | رقم تعريف القائمة التي تم فيها عرض السلعة للمستخدِم في حال ضبطها، يتم تجاهل item_list_id على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة item_list_id على مستوى الحدث،
في حال توفّرها.
|
item_list_name |
string |
لا | منتجات ذات صلة | اسم القائمة التي تم فيها عرض السلعة للمستخدِم في حال ضبطها، يتم تجاهل item_list_name على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة item_list_name على مستوى الحدث،
في حال توفّرها.
|
item_variant |
string |
لا | أخضر | صيغة العنصر أو رمز فريد أو وصف لمزيد من التفاصيل/خيارات العناصر. |
location_id |
string |
لا | ChIJIQBpAG2ahYAR_6128GcTUEo (رقم تعريف المكان في Google لسان فرانسيسكو) |
تمثّل هذه السمة الموقع الجغرافي المرتبط بالعنصر (مثل الموقع الجغرافي للمتجر). ننصحك باستخدام
معرّف المكان من Google الذي يتوافق مع العنصر المرتبط. يمكن أيضًا استخدام معرّف الموقع المخصص. ملاحظة: لا يتوفّر "معرّف الموقع الجغرافي" إلا على مستوى العنصر. |
price |
number |
لا | يورو | السعر النقدي للسلعة، بوحدات معلمة العملة المحدّدة. |
promotion_id |
string |
لا | P_12345 |
معرّف العرض الترويجي المرتبط بالعنصر. في حال ضبطها، يتم تجاهل promotion_id على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة promotion_id على مستوى الحدث،
في حال توفّرها.
|
promotion_name |
string |
لا | تخفيضات موسم الصيف |
اسم العرض الترويجي المرتبط بالسلعة. في حال ضبطها، يتم تجاهل promotion_name على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة promotion_name على مستوى الحدث،
في حال توفّرها.
|
quantity |
number |
لا | 1 |
كمية السلعة |
add_to_cart
يشير هذا الحدث إلى أنه تمت إضافة سلعة إلى سلة التسوق لشرائها.
المَعلمات
الاسم | Type | عنصر مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
currency |
string |
نعم* | USD |
تمثّل هذه السمة عملة العناصر المرتبطة بالفعالية بتنسيق ISO 4217 المكوّن من 3 أحرف. * في حال ضبط السياسة value ، يجب احتساب currency
لكي يتم احتساب مقاييس الأرباح بدقة.
|
value |
number |
نعم* | 7.77 | القيمة المالية للحدث. * يكون value مطلوبًا عادةً لإعداد تقارير مفيدة.
إذا ضَعت علامة
على الحدث باعتباره إحالة ناجحة، ننصحك بإعداد
value .
* currency مطلوب في حال ضبط value .
|
items |
Array<Item> |
نعم | عناصر الحدث. |
معلّمات العناصر
الاسم | Type | عنصر مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
item_id |
string |
نعم* | SKU_12345 |
معرّف العنصر.
*يجب استخدام سمة واحدة من |
item_name |
string |
نعم* | قميص مُزيَّن بشخصيات كتاب Stan and Friends |
اسم السلعة.
*يجب استخدام سمة واحدة من |
affiliation |
string |
لا | Google Store |
ارتباط المنتج لتحديد الشركة التي تقدّمه أو الموقع الجغرافي للمتجر الذي يقدّمه ملاحظة: لا تتوفّر سمة "الارتباط" إلا على مستوى السلعة. |
coupon |
string |
لا | الدالة SUMMER_FUN | اسم/رمز القسيمة المرتبطة بالعنصر إنّ مَعلمتَي coupon على مستوى الحدث ومستوى السلعة
مستقلتان.
|
creative_name |
string |
لا | بانر_صيفي2 | اسم تصميم الإعلان الترويجي. في حال ضبطها، يتم تجاهل creative_name على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة creative_name على مستوى الحدث،
في حال توفّرها. |
creative_slot |
string |
لا | المميزة_1_ | اسم خانة تصميم الإعلان الترويجي المرتبط
بالعنصر. في حال ضبطها، يتم تجاهل creative_slot على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة creative_slot على مستوى الحدث،
في حال توفّرها. |
discount |
number |
لا | 2.22 | قيمة الخصم النقدي المرتبطة بالسلعة. |
index |
number |
لا | 5 | تمثّل هذه السمة فهرس/موضع العنصر في القائمة. |
item_brand |
string |
لا | العلامة التجارية للسلعة. | |
item_category |
string |
لا | ملابس | فئة السلعة وإذا تم استخدامها كجزء من التدرج الهرمي أو التصنيف، ستكون هذه هي الفئة الأولى. |
item_category2 |
string |
لا | للبالغين | التدرج الهرمي للفئة الثانية أو التصنيف الإضافي للعنصر. |
item_category3 |
string |
لا | قمصان | التدرج الهرمي للفئة الثالثة أو التصنيف الإضافي للعنصر. |
item_category4 |
string |
لا | طاقم العمل | التدرج الهرمي للفئة الرابعة أو التصنيف الإضافي للعنصر. |
item_category5 |
string |
لا | كُم قصير | التدرج الهرمي للفئة الخامسة أو التصنيف الإضافي للعنصر. |
item_list_id |
string |
لا | ذو صلة_المنتجات | رقم تعريف القائمة التي تم فيها عرض السلعة للمستخدِم في حال ضبطها، يتم تجاهل item_list_id على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة item_list_id على مستوى الحدث،
في حال توفّرها.
|
item_list_name |
string |
لا | منتجات ذات صلة | اسم القائمة التي تم فيها عرض السلعة للمستخدِم في حال ضبطها، يتم تجاهل item_list_name على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة item_list_name على مستوى الحدث،
في حال توفّرها.
|
item_variant |
string |
لا | أخضر | صيغة العنصر أو رمز فريد أو وصف لمزيد من التفاصيل/خيارات العناصر. |
location_id |
string |
لا | ChIJIQBpAG2ahYAR_6128GcTUEo (رقم تعريف المكان في Google لسان فرانسيسكو) |
تمثّل هذه السمة الموقع الجغرافي المرتبط بالعنصر (مثل الموقع الجغرافي للمتجر). ننصحك باستخدام
معرّف المكان من Google الذي يتوافق مع العنصر المرتبط. يمكن أيضًا استخدام معرّف الموقع المخصص. ملاحظة: لا يتوفّر "معرّف الموقع الجغرافي" إلا على مستوى العنصر. |
price |
number |
لا | يورو | السعر النقدي للسلعة، بوحدات معلمة العملة المحدّدة. |
promotion_id |
string |
لا | P_12345 |
معرّف العرض الترويجي المرتبط بالعنصر. في حال ضبطها، يتم تجاهل promotion_id على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة promotion_id على مستوى الحدث،
في حال توفّرها.
|
promotion_name |
string |
لا | تخفيضات موسم الصيف |
اسم العرض الترويجي المرتبط بالسلعة. في حال ضبطها، يتم تجاهل promotion_name على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة promotion_name على مستوى الحدث،
في حال توفّرها.
|
quantity |
number |
لا | 1 |
كمية السلعة |
add_to_wishlist
يشير الحدث إلى إضافة عنصر إلى قائمة المفضلات. يمكنك استخدام هذا الحدث لتحديد عناصر الهدايا الشائعة في تطبيقك.
المَعلمات
الاسم | Type | عنصر مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
currency |
string |
نعم* | USD |
تمثّل هذه السمة عملة العناصر المرتبطة بالفعالية بتنسيق ISO 4217 المكوّن من 3 أحرف. * في حال ضبط السياسة value ، يجب احتساب currency
لكي يتم احتساب مقاييس الأرباح بدقة.
|
value |
number |
نعم* | 7.77 | القيمة المالية للحدث. * يكون value مطلوبًا عادةً لإعداد تقارير مفيدة.
إذا ضَعت علامة
على الحدث باعتباره إحالة ناجحة، ننصحك بإعداد
value .
* currency مطلوب في حال ضبط value .
|
items |
Array<Item> |
نعم | عناصر الحدث. |
معلّمات العناصر
الاسم | Type | عنصر مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
item_id |
string |
نعم* | SKU_12345 |
معرّف العنصر.
*يجب استخدام سمة واحدة من |
item_name |
string |
نعم* | قميص مُزيَّن بشخصيات كتاب Stan and Friends |
اسم السلعة.
*يجب استخدام سمة واحدة من |
affiliation |
string |
لا | Google Store |
ارتباط المنتج لتحديد الشركة التي تقدّمه أو الموقع الجغرافي للمتجر الذي يقدّمه ملاحظة: لا تتوفّر سمة "الارتباط" إلا على مستوى السلعة. |
coupon |
string |
لا | الدالة SUMMER_FUN | اسم/رمز القسيمة المرتبطة بالعنصر إنّ مَعلمتَي coupon على مستوى الحدث ومستوى السلعة
مستقلتان.
|
creative_name |
string |
لا | بانر_صيفي2 | اسم تصميم الإعلان الترويجي. في حال ضبطها، يتم تجاهل creative_name على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة creative_name على مستوى الحدث،
في حال توفّرها. |
creative_slot |
string |
لا | المميزة_1_ | اسم خانة تصميم الإعلان الترويجي المرتبط
بالعنصر. في حال ضبطها، يتم تجاهل creative_slot على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة creative_slot على مستوى الحدث،
في حال توفّرها. |
discount |
number |
لا | 2.22 | قيمة الخصم النقدي المرتبطة بالسلعة. |
index |
number |
لا | 5 | تمثّل هذه السمة فهرس/موضع العنصر في القائمة. |
item_brand |
string |
لا | العلامة التجارية للسلعة. | |
item_category |
string |
لا | ملابس | فئة السلعة وإذا تم استخدامها كجزء من التدرج الهرمي أو التصنيف، ستكون هذه هي الفئة الأولى. |
item_category2 |
string |
لا | للبالغين | التدرج الهرمي للفئة الثانية أو التصنيف الإضافي للعنصر. |
item_category3 |
string |
لا | قمصان | التدرج الهرمي للفئة الثالثة أو التصنيف الإضافي للعنصر. |
item_category4 |
string |
لا | طاقم العمل | التدرج الهرمي للفئة الرابعة أو التصنيف الإضافي للعنصر. |
item_category5 |
string |
لا | كُم قصير | التدرج الهرمي للفئة الخامسة أو التصنيف الإضافي للعنصر. |
item_list_id |
string |
لا | ذو صلة_المنتجات | رقم تعريف القائمة التي تم فيها عرض السلعة للمستخدِم في حال ضبطها، يتم تجاهل item_list_id على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة item_list_id على مستوى الحدث،
في حال توفّرها.
|
item_list_name |
string |
لا | منتجات ذات صلة | اسم القائمة التي تم فيها عرض السلعة للمستخدِم في حال ضبطها، يتم تجاهل item_list_name على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة item_list_name على مستوى الحدث،
في حال توفّرها.
|
item_variant |
string |
لا | أخضر | صيغة العنصر أو رمز فريد أو وصف لمزيد من التفاصيل/خيارات العناصر. |
location_id |
string |
لا | ChIJIQBpAG2ahYAR_6128GcTUEo (رقم تعريف المكان في Google لسان فرانسيسكو) |
تمثّل هذه السمة الموقع الجغرافي المرتبط بالعنصر (مثل الموقع الجغرافي للمتجر). ننصحك باستخدام
معرّف المكان من Google الذي يتوافق مع العنصر المرتبط. يمكن أيضًا استخدام معرّف الموقع المخصص. ملاحظة: لا يتوفّر "معرّف الموقع الجغرافي" إلا على مستوى العنصر. |
price |
number |
لا | يورو | السعر النقدي للسلعة، بوحدات معلمة العملة المحدّدة. |
promotion_id |
string |
لا | P_12345 |
معرّف العرض الترويجي المرتبط بالعنصر. في حال ضبطها، يتم تجاهل promotion_id على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة promotion_id على مستوى الحدث،
في حال توفّرها.
|
promotion_name |
string |
لا | تخفيضات موسم الصيف |
اسم العرض الترويجي المرتبط بالسلعة. في حال ضبطها، يتم تجاهل promotion_name على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة promotion_name على مستوى الحدث،
في حال توفّرها.
|
quantity |
number |
لا | 1 |
كمية السلعة |
begin_checkout
يشير هذا الحدث إلى أن المستخدم بدأ عملية دفع.
المَعلمات
الاسم | Type | عنصر مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
currency |
string |
نعم* | USD |
تمثّل هذه السمة عملة العناصر المرتبطة بالفعالية بتنسيق ISO 4217 المكوّن من 3 أحرف. * في حال ضبط السياسة value ، يجب احتساب currency
لكي يتم احتساب مقاييس الأرباح بدقة.
|
value |
number |
نعم* | 7.77 | القيمة المالية للحدث. * يكون value مطلوبًا عادةً لإعداد تقارير مفيدة.
إذا ضَعت علامة
على الحدث باعتباره إحالة ناجحة، ننصحك بإعداد
value .
* currency مطلوب في حال ضبط value .
|
coupon |
string |
لا | الدالة SUMMER_FUN | اسم/رمز القسيمة المرتبط بالحدث. إنّ مَعلمتَي coupon على مستوى الحدث ومستوى السلعة
مستقلتان.
|
items |
Array<Item> |
نعم | عناصر الحدث. |
معلّمات العناصر
الاسم | Type | عنصر مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
item_id |
string |
نعم* | SKU_12345 |
معرّف العنصر.
*يجب استخدام سمة واحدة من |
item_name |
string |
نعم* | قميص مُزيَّن بشخصيات كتاب Stan and Friends |
اسم السلعة.
*يجب استخدام سمة واحدة من |
affiliation |
string |
لا | Google Store |
ارتباط المنتج لتحديد الشركة التي تقدّمه أو الموقع الجغرافي للمتجر الذي يقدّمه ملاحظة: لا تتوفّر سمة "الارتباط" إلا على مستوى السلعة. |
coupon |
string |
لا | الدالة SUMMER_FUN | اسم/رمز القسيمة المرتبطة بالعنصر إنّ مَعلمتَي coupon على مستوى الحدث ومستوى السلعة
مستقلتان.
|
creative_name |
string |
لا | بانر_صيفي2 | اسم تصميم الإعلان الترويجي. في حال ضبطها، يتم تجاهل creative_name على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة creative_name على مستوى الحدث،
في حال توفّرها. |
creative_slot |
string |
لا | المميزة_1_ | اسم خانة تصميم الإعلان الترويجي المرتبط
بالعنصر. في حال ضبطها، يتم تجاهل creative_slot على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة creative_slot على مستوى الحدث،
في حال توفّرها. |
discount |
number |
لا | 2.22 | قيمة الخصم النقدي المرتبطة بالسلعة. |
index |
number |
لا | 5 | تمثّل هذه السمة فهرس/موضع العنصر في القائمة. |
item_brand |
string |
لا | العلامة التجارية للسلعة. | |
item_category |
string |
لا | ملابس | فئة السلعة وإذا تم استخدامها كجزء من التدرج الهرمي أو التصنيف، ستكون هذه هي الفئة الأولى. |
item_category2 |
string |
لا | للبالغين | التدرج الهرمي للفئة الثانية أو التصنيف الإضافي للعنصر. |
item_category3 |
string |
لا | قمصان | التدرج الهرمي للفئة الثالثة أو التصنيف الإضافي للعنصر. |
item_category4 |
string |
لا | طاقم العمل | التدرج الهرمي للفئة الرابعة أو التصنيف الإضافي للعنصر. |
item_category5 |
string |
لا | كُم قصير | التدرج الهرمي للفئة الخامسة أو التصنيف الإضافي للعنصر. |
item_list_id |
string |
لا | ذو صلة_المنتجات | رقم تعريف القائمة التي تم فيها عرض السلعة للمستخدِم في حال ضبطها، يتم تجاهل item_list_id على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة item_list_id على مستوى الحدث،
في حال توفّرها.
|
item_list_name |
string |
لا | منتجات ذات صلة | اسم القائمة التي تم فيها عرض السلعة للمستخدِم في حال ضبطها، يتم تجاهل item_list_name على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة item_list_name على مستوى الحدث،
في حال توفّرها.
|
item_variant |
string |
لا | أخضر | صيغة العنصر أو رمز فريد أو وصف لمزيد من التفاصيل/خيارات العناصر. |
location_id |
string |
لا | ChIJIQBpAG2ahYAR_6128GcTUEo (رقم تعريف المكان في Google لسان فرانسيسكو) |
تمثّل هذه السمة الموقع الجغرافي المرتبط بالعنصر (مثل الموقع الجغرافي للمتجر). ننصحك باستخدام
معرّف المكان من Google الذي يتوافق مع العنصر المرتبط. يمكن أيضًا استخدام معرّف الموقع المخصص. ملاحظة: لا يتوفّر "معرّف الموقع الجغرافي" إلا على مستوى العنصر. |
price |
number |
لا | يورو | السعر النقدي للسلعة، بوحدات معلمة العملة المحدّدة. |
promotion_id |
string |
لا | P_12345 |
معرّف العرض الترويجي المرتبط بالعنصر. في حال ضبطها، يتم تجاهل promotion_id على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة promotion_id على مستوى الحدث،
في حال توفّرها.
|
promotion_name |
string |
لا | تخفيضات موسم الصيف |
اسم العرض الترويجي المرتبط بالسلعة. في حال ضبطها، يتم تجاهل promotion_name على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة promotion_name على مستوى الحدث،
في حال توفّرها.
|
quantity |
number |
لا | 1 |
كمية السلعة |
earn_virtual_currency
يقيس هذا الحدث عندما يتم منح المستخدم عملة افتراضية في لعبة. يمكنك تسجيل هذه العملية إلى جانب spend_virtual_currency لفهم اقتصادك الافتراضي بشكلٍ أفضل.
المَعلمات
الاسم | Type | عنصر مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
virtual_currency_name |
string |
لا | أحجار كريمة | اسم العملة الافتراضية. |
value |
number |
لا | 5 | قيمة العملة الافتراضية. |
الاستثناء
يتم تسجيل حدث استثناء في حال انقطاع العملية العادية لتنفيذ تطبيق.
المَعلمات
الاسم | Type | عنصر مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
description |
string |
لا | يجب إدخال الحقل المطلوب. | وصف الاستثناء الذي حدث. |
fatal |
boolean |
لا | true |
ما إذا كان الاستثناء خطيرًا أم لا. |
generate_lead
يقيس هذا الحدث وقت إنشاء نموذج العملاء المحتملين (على سبيل المثال، من خلال نموذج). يمكنك تسجيل ذلك لفهم مدى فعالية حملاتك التسويقية وعدد العملاء الذين يعيدون التفاعل مع نشاطك التجاري بعد تجديد النشاط التسويقي للعملاء.
المَعلمات
الاسم | Type | عنصر مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
currency |
string |
نعم* | USD |
تمثّل هذه السمة عملة العناصر المرتبطة بالفعالية بتنسيق ISO 4217 المكوّن من 3 أحرف. * في حال ضبط السياسة value ، يجب احتساب currency
لكي يتم احتساب مقاييس الأرباح بدقة.
|
value |
number |
نعم* | 7.77 | القيمة المالية للحدث. * يكون value مطلوبًا عادةً لإعداد تقارير مفيدة.
إذا ضَعت علامة
على الحدث باعتباره إحالة ناجحة، ننصحك بإعداد
value .
* currency مطلوب في حال ضبط value .
|
join_group
تسجيل هذا الحدث عندما ينضم مستخدم إلى مجموعة مثل رابطة أو فريق أو عائلة. يمكنك استخدام هذا الحدث لتحليل مدى رواج مجموعات أو ميزات اجتماعية معيّنة.
المَعلمات
الاسم | Type | عنصر مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
group_id |
string |
لا | G_12345 | رقم تعريف المجموعة. |
level_end
يشير هذا الحدث إلى وصول اللاعب إلى نهاية أحد المستويات في لعبة.
المَعلمات
الاسم | Type | عنصر مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
level_name |
string |
لا | تبدأ الرحلة... | اسم المستوى. |
success |
boolean |
لا | صحيح | اضبط القيمة على true إذا تم إكمال المستوى بنجاح. |
level_start
يشير هذا الحدث إلى أن اللاعب قد بدأ مستوى في لعبة.
المَعلمات
الاسم | Type | عنصر مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
level_name |
string |
لا | تبدأ الرحلة... | اسم المستوى. |
level_up
يشير هذا الحدث إلى انتقال اللاعب إلى مستوى أعلى في لعبة. استخدمه لقياس توزيع مستوى قاعدة المستخدمين وتحديد المستويات التي يصعب استكمالها.
المَعلمات
الاسم | Type | عنصر مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
level |
number |
لا | 5 | مستوى الحرف |
character |
string |
لا | لاعب رقم 1 | الشخصية التي انتقلت إلى مستوى أعلى. |
تسجيل دخول
يمكنك إرسال هذا الحدث للإشارة إلى أنّ أحد المستخدمين قد سجّل الدخول إلى موقعك الإلكتروني أو تطبيقك.
المَعلمات
الاسم | Type | عنصر مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
method |
string |
لا | الطريقة المستخدَمة لتسجيل الدخول. |
page_view
يشير هذا الحدث إلى أنّ المستخدم قد عرض صفحة معيّنة.
المَعلمات
الاسم | Type | عنصر مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
page_location |
string |
لا | https://example.com | عنوان URL للصفحة. |
client_id |
string |
لا | قناة ABC_123 | معرِّف العميل. |
language |
string |
لا | ar_sa | لغة العميل. راجِع علامات اللغة والرموز. |
page_encoding |
string |
لا | UTF-8 | ترميز الصفحة. |
page_title |
string |
لا | الصفحة الرئيسية | عنوان الصفحة. |
user_agent |
string |
لا | وكيل مستخدم العميل |
post_score
يمكنك إرسال هذا الحدث عندما ينشر المستخدم نتيجة. يمكنك استخدام هذا الحدث لفهم مستوى أداء المستخدمين في لعبتك وربطها بالنتائج العالية لدى الجماهير أو السلوكيات.
المَعلمات
الاسم | Type | عنصر مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
score |
number |
نعم | 10000 | التقييم المطلوب نشره |
level |
number |
لا | 5 | مستوى النتيجة. |
character |
string |
لا | لاعب رقم 1 | الشخصية التي حققت النتيجة. |
purchase
يشير هذا الحدث إلى شراء عنصر واحد أو أكثر من قِبل مستخدم.
المَعلمات
الاسم | Type | عنصر مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
currency |
string |
نعم* | USD |
تمثّل هذه السمة عملة العناصر المرتبطة بالفعالية بتنسيق ISO 4217 المكوّن من 3 أحرف. * في حال ضبط السياسة value ، يجب احتساب currency
لكي يتم احتساب مقاييس الأرباح بدقة.
|
transaction_id |
string |
نعم | T_12345 | المعرّف الفريد للمعاملة. تساعدك المَعلمة transaction_id في تجنُّب الحصول على أحداث مكرّرة لعملية الشراء. |
value |
number |
نعم* | 12.21 | القيمة المالية للحدث. * يجب استخدام value لإعداد تقارير مفيدة و
ملء الجمهور المتوقّع.
* currency مطلوب في حال ضبط value .
|
coupon |
string |
لا | الدالة SUMMER_FUN | اسم/رمز القسيمة المرتبط بالحدث. إنّ مَعلمتَي coupon على مستوى الحدث ومستوى السلعة
مستقلتان.
|
shipping |
number |
لا | 3.33 | تكلفة الشحن المرتبطة بمعاملة معيّنة. |
tax |
number |
لا | 11 | تكلفة الضريبة المرتبطة بمعاملة معيّنة. |
items |
Array<Item> |
نعم | عناصر الحدث. |
معلّمات العناصر
الاسم | Type | عنصر مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
item_id |
string |
نعم* | SKU_12345 |
معرّف العنصر.
*يجب استخدام سمة واحدة من |
item_name |
string |
نعم* | قميص مُزيَّن بشخصيات كتاب Stan and Friends |
اسم السلعة.
*يجب استخدام سمة واحدة من |
affiliation |
string |
لا | Google Store |
ارتباط المنتج لتحديد الشركة التي تقدّمه أو الموقع الجغرافي للمتجر الذي يقدّمه ملاحظة: لا تتوفّر سمة "الارتباط" إلا على مستوى السلعة. |
coupon |
string |
لا | الدالة SUMMER_FUN | اسم/رمز القسيمة المرتبطة بالعنصر إنّ مَعلمتَي coupon على مستوى الحدث ومستوى السلعة
مستقلتان.
|
creative_name |
string |
لا | بانر_صيفي2 | اسم تصميم الإعلان الترويجي. في حال ضبطها، يتم تجاهل creative_name على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة creative_name على مستوى الحدث،
في حال توفّرها. |
creative_slot |
string |
لا | المميزة_1_ | اسم خانة تصميم الإعلان الترويجي المرتبط
بالعنصر. في حال ضبطها، يتم تجاهل creative_slot على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة creative_slot على مستوى الحدث،
في حال توفّرها. |
discount |
number |
لا | 2.22 | قيمة الخصم النقدي المرتبطة بالسلعة. |
index |
number |
لا | 5 | تمثّل هذه السمة فهرس/موضع العنصر في القائمة. |
item_brand |
string |
لا | العلامة التجارية للسلعة. | |
item_category |
string |
لا | ملابس | فئة السلعة وإذا تم استخدامها كجزء من التدرج الهرمي أو التصنيف، ستكون هذه هي الفئة الأولى. |
item_category2 |
string |
لا | للبالغين | التدرج الهرمي للفئة الثانية أو التصنيف الإضافي للعنصر. |
item_category3 |
string |
لا | قمصان | التدرج الهرمي للفئة الثالثة أو التصنيف الإضافي للعنصر. |
item_category4 |
string |
لا | طاقم العمل | التدرج الهرمي للفئة الرابعة أو التصنيف الإضافي للعنصر. |
item_category5 |
string |
لا | كُم قصير | التدرج الهرمي للفئة الخامسة أو التصنيف الإضافي للعنصر. |
item_list_id |
string |
لا | ذو صلة_المنتجات | رقم تعريف القائمة التي تم فيها عرض السلعة للمستخدِم في حال ضبطها، يتم تجاهل item_list_id على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة item_list_id على مستوى الحدث،
في حال توفّرها.
|
item_list_name |
string |
لا | منتجات ذات صلة | اسم القائمة التي تم فيها عرض السلعة للمستخدِم في حال ضبطها، يتم تجاهل item_list_name على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة item_list_name على مستوى الحدث،
في حال توفّرها.
|
item_variant |
string |
لا | أخضر | صيغة العنصر أو رمز فريد أو وصف لمزيد من التفاصيل/خيارات العناصر. |
location_id |
string |
لا | ChIJIQBpAG2ahYAR_6128GcTUEo (رقم تعريف المكان في Google لسان فرانسيسكو) |
تمثّل هذه السمة الموقع الجغرافي المرتبط بالعنصر (مثل الموقع الجغرافي للمتجر). ننصحك باستخدام
معرّف المكان من Google الذي يتوافق مع العنصر المرتبط. يمكن أيضًا استخدام معرّف الموقع المخصص. ملاحظة: لا يتوفّر "معرّف الموقع الجغرافي" إلا على مستوى العنصر. |
price |
number |
لا | يورو | السعر النقدي للسلعة، بوحدات معلمة العملة المحدّدة. |
promotion_id |
string |
لا | P_12345 |
معرّف العرض الترويجي المرتبط بالعنصر. في حال ضبطها، يتم تجاهل promotion_id على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة promotion_id على مستوى الحدث،
في حال توفّرها.
|
promotion_name |
string |
لا | تخفيضات موسم الصيف |
اسم العرض الترويجي المرتبط بالسلعة. في حال ضبطها، يتم تجاهل promotion_name على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة promotion_name على مستوى الحدث،
في حال توفّرها.
|
quantity |
number |
لا | 1 |
كمية السلعة |
refund
يشير هذا الحدث إلى ردّ أموال عنصر واحد أو أكثر إلى مستخدم.
المَعلمات
الاسم | Type | عنصر مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
currency |
string |
نعم* | USD |
تمثّل هذه السمة عملة العناصر المرتبطة بالفعالية بتنسيق ISO 4217 المكوّن من 3 أحرف. * في حال ضبط السياسة value ، يجب احتساب currency
لكي يتم احتساب مقاييس الأرباح بدقة.
|
transaction_id |
string |
نعم | T_12345 | المعرّف الفريد للمعاملة. |
value |
number |
نعم* | 7.77 | القيمة المالية للحدث. * يكون value مطلوبًا عادةً لإعداد تقارير مفيدة.
إذا ضَعت علامة
على الحدث باعتباره إحالة ناجحة، ننصحك بإعداد
value .
* currency مطلوب في حال ضبط value .
|
coupon |
string |
لا | الدالة SUMMER_FUN | اسم/رمز القسيمة المرتبط بالحدث. إنّ مَعلمتَي coupon على مستوى الحدث ومستوى السلعة
مستقلتان.
|
shipping |
number |
لا | 3.33 | تكلفة الشحن المرتبطة بمعاملة معيّنة. |
tax |
number |
لا | 11 | تكلفة الضريبة المرتبطة بمعاملة معيّنة. |
items |
Array<Item>
|
لا* | عناصر الحدث. |
معلّمات العناصر
الاسم | Type | عنصر مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
item_id |
string |
نعم* | SKU_12345 |
معرّف العنصر.
*يجب استخدام سمة واحدة من |
item_name |
string |
نعم* | قميص مُزيَّن بشخصيات كتاب Stan and Friends |
اسم السلعة.
*يجب استخدام سمة واحدة من |
affiliation |
string |
لا | Google Store |
ارتباط المنتج لتحديد الشركة التي تقدّمه أو الموقع الجغرافي للمتجر الذي يقدّمه ملاحظة: لا تتوفّر سمة "الارتباط" إلا على مستوى السلعة. |
coupon |
string |
لا | الدالة SUMMER_FUN | اسم/رمز القسيمة المرتبطة بالعنصر إنّ مَعلمتَي coupon على مستوى الحدث ومستوى السلعة
مستقلتان.
|
creative_name |
string |
لا | بانر_صيفي2 | اسم تصميم الإعلان الترويجي. في حال ضبطها، يتم تجاهل creative_name على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة creative_name على مستوى الحدث،
في حال توفّرها. |
creative_slot |
string |
لا | المميزة_1_ | اسم خانة تصميم الإعلان الترويجي المرتبط
بالعنصر. في حال ضبطها، يتم تجاهل creative_slot على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة creative_slot على مستوى الحدث،
في حال توفّرها. |
discount |
number |
لا | 2.22 | قيمة الخصم النقدي المرتبطة بالسلعة. |
index |
number |
لا | 5 | تمثّل هذه السمة فهرس/موضع العنصر في القائمة. |
item_brand |
string |
لا | العلامة التجارية للسلعة. | |
item_category |
string |
لا | ملابس | فئة السلعة وإذا تم استخدامها كجزء من التدرج الهرمي أو التصنيف، ستكون هذه هي الفئة الأولى. |
item_category2 |
string |
لا | للبالغين | التدرج الهرمي للفئة الثانية أو التصنيف الإضافي للعنصر. |
item_category3 |
string |
لا | قمصان | التدرج الهرمي للفئة الثالثة أو التصنيف الإضافي للعنصر. |
item_category4 |
string |
لا | طاقم العمل | التدرج الهرمي للفئة الرابعة أو التصنيف الإضافي للعنصر. |
item_category5 |
string |
لا | كُم قصير | التدرج الهرمي للفئة الخامسة أو التصنيف الإضافي للعنصر. |
item_list_id |
string |
لا | ذو صلة_المنتجات | رقم تعريف القائمة التي تم فيها عرض السلعة للمستخدِم في حال ضبطها، يتم تجاهل item_list_id على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة item_list_id على مستوى الحدث،
في حال توفّرها.
|
item_list_name |
string |
لا | منتجات ذات صلة | اسم القائمة التي تم فيها عرض السلعة للمستخدِم في حال ضبطها، يتم تجاهل item_list_name على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة item_list_name على مستوى الحدث،
في حال توفّرها.
|
item_variant |
string |
لا | أخضر | صيغة العنصر أو رمز فريد أو وصف لمزيد من التفاصيل/خيارات العناصر. |
location_id |
string |
لا | ChIJIQBpAG2ahYAR_6128GcTUEo (رقم تعريف المكان في Google لسان فرانسيسكو) |
تمثّل هذه السمة الموقع الجغرافي المرتبط بالعنصر (مثل الموقع الجغرافي للمتجر). ننصحك باستخدام
معرّف المكان من Google الذي يتوافق مع العنصر المرتبط. يمكن أيضًا استخدام معرّف الموقع المخصص. ملاحظة: لا يتوفّر "معرّف الموقع الجغرافي" إلا على مستوى العنصر. |
price |
number |
لا | يورو | السعر النقدي للسلعة، بوحدات معلمة العملة المحدّدة. |
promotion_id |
string |
لا | P_12345 |
معرّف العرض الترويجي المرتبط بالعنصر. في حال ضبطها، يتم تجاهل promotion_id على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة promotion_id على مستوى الحدث،
في حال توفّرها.
|
promotion_name |
string |
لا | تخفيضات موسم الصيف |
اسم العرض الترويجي المرتبط بالسلعة. في حال ضبطها، يتم تجاهل promotion_name على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة promotion_name على مستوى الحدث،
في حال توفّرها.
|
quantity |
number |
لا | 1 |
كمية السلعة |
remove_from_cart
يشير هذا الحدث إلى إزالة سلعة من سلة التسوق.
المَعلمات
الاسم | Type | عنصر مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
currency |
string |
نعم* | USD |
تمثّل هذه السمة عملة العناصر المرتبطة بالفعالية بتنسيق ISO 4217 المكوّن من 3 أحرف. * في حال ضبط السياسة value ، يجب احتساب currency
لكي يتم احتساب مقاييس الأرباح بدقة.
|
value |
number |
نعم* | 7.77 | القيمة المالية للحدث. * يكون value مطلوبًا عادةً لإعداد تقارير مفيدة.
إذا ضَعت علامة
على الحدث باعتباره إحالة ناجحة، ننصحك بإعداد
value .
* currency مطلوب في حال ضبط value .
|
items |
Array<Item> |
نعم | عناصر الحدث. |
معلّمات العناصر
الاسم | Type | عنصر مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
item_id |
string |
نعم* | SKU_12345 |
معرّف العنصر.
*يجب استخدام سمة واحدة من |
item_name |
string |
نعم* | قميص مُزيَّن بشخصيات كتاب Stan and Friends |
اسم السلعة.
*يجب استخدام سمة واحدة من |
affiliation |
string |
لا | Google Store |
ارتباط المنتج لتحديد الشركة التي تقدّمه أو الموقع الجغرافي للمتجر الذي يقدّمه ملاحظة: لا تتوفّر سمة "الارتباط" إلا على مستوى السلعة. |
coupon |
string |
لا | الدالة SUMMER_FUN | اسم/رمز القسيمة المرتبطة بالعنصر إنّ مَعلمتَي coupon على مستوى الحدث ومستوى السلعة
مستقلتان.
|
creative_name |
string |
لا | بانر_صيفي2 | اسم تصميم الإعلان الترويجي. في حال ضبطها، يتم تجاهل creative_name على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة creative_name على مستوى الحدث،
في حال توفّرها. |
creative_slot |
string |
لا | المميزة_1_ | اسم خانة تصميم الإعلان الترويجي المرتبط
بالعنصر. في حال ضبطها، يتم تجاهل creative_slot على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة creative_slot على مستوى الحدث،
في حال توفّرها. |
discount |
number |
لا | 2.22 | قيمة الخصم النقدي المرتبطة بالسلعة. |
index |
number |
لا | 5 | تمثّل هذه السمة فهرس/موضع العنصر في القائمة. |
item_brand |
string |
لا | العلامة التجارية للسلعة. | |
item_category |
string |
لا | ملابس | فئة السلعة وإذا تم استخدامها كجزء من التدرج الهرمي أو التصنيف، ستكون هذه هي الفئة الأولى. |
item_category2 |
string |
لا | للبالغين | التدرج الهرمي للفئة الثانية أو التصنيف الإضافي للعنصر. |
item_category3 |
string |
لا | قمصان | التدرج الهرمي للفئة الثالثة أو التصنيف الإضافي للعنصر. |
item_category4 |
string |
لا | طاقم العمل | التدرج الهرمي للفئة الرابعة أو التصنيف الإضافي للعنصر. |
item_category5 |
string |
لا | كُم قصير | التدرج الهرمي للفئة الخامسة أو التصنيف الإضافي للعنصر. |
item_list_id |
string |
لا | ذو صلة_المنتجات | رقم تعريف القائمة التي تم فيها عرض السلعة للمستخدِم في حال ضبطها، يتم تجاهل item_list_id على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة item_list_id على مستوى الحدث،
في حال توفّرها.
|
item_list_name |
string |
لا | منتجات ذات صلة | اسم القائمة التي تم فيها عرض السلعة للمستخدِم في حال ضبطها، يتم تجاهل item_list_name على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة item_list_name على مستوى الحدث،
في حال توفّرها.
|
item_variant |
string |
لا | أخضر | صيغة العنصر أو رمز فريد أو وصف لمزيد من التفاصيل/خيارات العناصر. |
location_id |
string |
لا | ChIJIQBpAG2ahYAR_6128GcTUEo (رقم تعريف المكان في Google لسان فرانسيسكو) |
تمثّل هذه السمة الموقع الجغرافي المرتبط بالعنصر (مثل الموقع الجغرافي للمتجر). ننصحك باستخدام
معرّف المكان من Google الذي يتوافق مع العنصر المرتبط. يمكن أيضًا استخدام معرّف الموقع المخصص. ملاحظة: لا يتوفّر "معرّف الموقع الجغرافي" إلا على مستوى العنصر. |
price |
number |
لا | يورو | السعر النقدي للسلعة، بوحدات معلمة العملة المحدّدة. |
promotion_id |
string |
لا | P_12345 |
معرّف العرض الترويجي المرتبط بالعنصر. في حال ضبطها، يتم تجاهل promotion_id على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة promotion_id على مستوى الحدث،
في حال توفّرها.
|
promotion_name |
string |
لا | تخفيضات موسم الصيف |
اسم العرض الترويجي المرتبط بالسلعة. في حال ضبطها، يتم تجاهل promotion_name على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة promotion_name على مستوى الحدث،
في حال توفّرها.
|
quantity |
number |
لا | 1 |
كمية السلعة |
search
سجِّل هذا الحدث للإشارة إلى وقت إجراء المستخدم لعملية بحث. يمكنك استخدام هذا الحدث لتحديد ما يبحث عنه المستخدمون على موقعك الإلكتروني أو تطبيقك. على سبيل المثال، يمكنك إرسال هذا الحدث عندما يشاهد المستخدم صفحة نتائج البحث بعد إجراء عملية بحث.
المَعلمات
الاسم | Type | عنصر مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
search_term |
string |
نعم | القمصان | العبارة التي تم البحث عنها. |
select_content
يشير هذا الحدث إلى أن المستخدم قد اختار بعض المحتوى من نوع معيّن. يمكن أن يساعدك هذا الحدث في تحديد المحتوى وفئات المحتوى الرائج على موقعك الإلكتروني أو تطبيقك.
المَعلمات
الاسم | Type | عنصر مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
content_type |
string |
لا | product | نوع المحتوى المحدّد |
content_id |
string |
لا | C_12345 | معرِّف للمحتوى الذي تم اختياره. |
select_item
يشير هذا الحدث إلى أنه تم اختيار عنصر من القائمة.
المَعلمات
الاسم | Type | عنصر مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
item_list_id |
string |
لا | ذو صلة_المنتجات | رقم تعريف القائمة التي تم فيها عرض السلعة للمستخدِم يتم تجاهل هذه السمة في حال ضبطها على مستوى السلعة. |
item_list_name |
string |
لا | منتجات ذات صلة | اسم القائمة التي تم فيها عرض السلعة للمستخدِم يتم تجاهل هذه السمة في حال ضبطها على مستوى السلعة. |
items |
Array<Item> |
نعم* | عناصر الحدث. * من المتوقّع أن تحتوي الصفيف items على عنصر
واحد يمثّل العنصر المحدّد. وفي حال تقديم عناصر متعددة،
سيتم استخدام العنصر الأول فقط في السمة items .
|
معلّمات العناصر
الاسم | Type | عنصر مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
item_id |
string |
نعم* | SKU_12345 |
معرّف العنصر.
*يجب استخدام سمة واحدة من |
item_name |
string |
نعم* | قميص مُزيَّن بشخصيات كتاب Stan and Friends |
اسم السلعة.
*يجب استخدام سمة واحدة من |
affiliation |
string |
لا | Google Store |
ارتباط المنتج لتحديد الشركة التي تقدّمه أو الموقع الجغرافي للمتجر الذي يقدّمه ملاحظة: لا تتوفّر سمة "الارتباط" إلا على مستوى السلعة. |
coupon |
string |
لا | الدالة SUMMER_FUN | اسم/رمز القسيمة المرتبطة بالعنصر إنّ مَعلمتَي coupon على مستوى الحدث ومستوى السلعة
مستقلتان.
|
creative_name |
string |
لا | بانر_صيفي2 | اسم تصميم الإعلان الترويجي. في حال ضبطها، يتم تجاهل creative_name على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة creative_name على مستوى الحدث،
في حال توفّرها. |
creative_slot |
string |
لا | المميزة_1_ | اسم خانة تصميم الإعلان الترويجي المرتبط
بالعنصر. في حال ضبطها، يتم تجاهل creative_slot على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة creative_slot على مستوى الحدث،
في حال توفّرها. |
discount |
number |
لا | 2.22 | قيمة الخصم النقدي المرتبطة بالسلعة. |
index |
number |
لا | 5 | تمثّل هذه السمة فهرس/موضع العنصر في القائمة. |
item_brand |
string |
لا | العلامة التجارية للسلعة. | |
item_category |
string |
لا | ملابس | فئة السلعة وإذا تم استخدامها كجزء من التدرج الهرمي أو التصنيف، ستكون هذه هي الفئة الأولى. |
item_category2 |
string |
لا | للبالغين | التدرج الهرمي للفئة الثانية أو التصنيف الإضافي للعنصر. |
item_category3 |
string |
لا | قمصان | التدرج الهرمي للفئة الثالثة أو التصنيف الإضافي للعنصر. |
item_category4 |
string |
لا | طاقم العمل | التدرج الهرمي للفئة الرابعة أو التصنيف الإضافي للعنصر. |
item_category5 |
string |
لا | كُم قصير | التدرج الهرمي للفئة الخامسة أو التصنيف الإضافي للعنصر. |
item_list_id |
string |
لا | ذو صلة_المنتجات | رقم تعريف القائمة التي تم فيها عرض السلعة للمستخدِم في حال ضبطها، يتم تجاهل item_list_id على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة item_list_id على مستوى الحدث،
في حال توفّرها.
|
item_list_name |
string |
لا | منتجات ذات صلة | اسم القائمة التي تم فيها عرض السلعة للمستخدِم في حال ضبطها، يتم تجاهل item_list_name على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة item_list_name على مستوى الحدث،
في حال توفّرها.
|
item_variant |
string |
لا | أخضر | صيغة العنصر أو رمز فريد أو وصف لمزيد من التفاصيل/خيارات العناصر. |
location_id |
string |
لا | ChIJIQBpAG2ahYAR_6128GcTUEo (رقم تعريف المكان في Google لسان فرانسيسكو) |
تمثّل هذه السمة الموقع الجغرافي المرتبط بالعنصر (مثل الموقع الجغرافي للمتجر). ننصحك باستخدام
معرّف المكان من Google الذي يتوافق مع العنصر المرتبط. يمكن أيضًا استخدام معرّف الموقع المخصص. ملاحظة: لا يتوفّر "معرّف الموقع الجغرافي" إلا على مستوى العنصر. |
price |
number |
لا | يورو | السعر النقدي للسلعة، بوحدات معلمة العملة المحدّدة. |
promotion_id |
string |
لا | P_12345 |
معرّف العرض الترويجي المرتبط بالعنصر. في حال ضبطها، يتم تجاهل promotion_id على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة promotion_id على مستوى الحدث،
في حال توفّرها.
|
promotion_name |
string |
لا | تخفيضات موسم الصيف |
اسم العرض الترويجي المرتبط بالسلعة. في حال ضبطها، يتم تجاهل promotion_name على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة promotion_name على مستوى الحدث،
في حال توفّرها.
|
quantity |
number |
لا | 1 |
كمية السلعة |
select_promotion
يشير هذا الحدث إلى اختيار عرض ترويجي من القائمة.
المَعلمات
الاسم | Type | عنصر مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
creative_name |
string |
لا | بانر_صيفي2 | اسم تصميم الإعلان الترويجي. يتم تجاهل هذه السمة في حال ضبطها على مستوى السلعة. |
creative_slot |
string |
لا | المميزة_1_ | اسم خانة تصميم الإعلان الترويجي المرتبط بالفعالية. يتم تجاهل هذه السمة في حال ضبطها على مستوى السلعة. |
promotion_id |
string |
لا | P_12345 |
معرّف العرض الترويجي المرتبط بالحدث. يتم تجاهل هذه السمة في حال ضبطها على مستوى السلعة. |
promotion_name |
string |
لا | تخفيضات موسم الصيف |
اسم العرض الترويجي المرتبط بالحدث. يتم تجاهل هذه السمة في حال ضبطها على مستوى السلعة. |
items |
Array<Item>
|
لا | عناصر الحدث. |
معلّمات العناصر
الاسم | Type | عنصر مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
item_id |
string |
نعم* | SKU_12345 |
معرّف العنصر.
*يجب استخدام سمة واحدة من |
item_name |
string |
نعم* | قميص مُزيَّن بشخصيات كتاب Stan and Friends |
اسم السلعة.
*يجب استخدام سمة واحدة من |
affiliation |
string |
لا | Google Store |
ارتباط المنتج لتحديد الشركة التي تقدّمه أو الموقع الجغرافي للمتجر الذي يقدّمه ملاحظة: لا تتوفّر سمة "الارتباط" إلا على مستوى السلعة. |
coupon |
string |
لا | الدالة SUMMER_FUN | اسم/رمز القسيمة المرتبطة بالعنصر إنّ مَعلمتَي coupon على مستوى الحدث ومستوى السلعة
مستقلتان.
|
creative_name |
string |
لا | بانر_صيفي2 | اسم تصميم الإعلان الترويجي. في حال ضبطها، يتم تجاهل creative_name على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة creative_name على مستوى الحدث،
في حال توفّرها. |
creative_slot |
string |
لا | المميزة_1_ | اسم خانة تصميم الإعلان الترويجي المرتبط
بالعنصر. في حال ضبطها، يتم تجاهل creative_slot على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة creative_slot على مستوى الحدث،
في حال توفّرها. |
discount |
number |
لا | 2.22 | قيمة الخصم النقدي المرتبطة بالسلعة. |
index |
number |
لا | 5 | تمثّل هذه السمة فهرس/موضع العنصر في القائمة. |
item_brand |
string |
لا | العلامة التجارية للسلعة. | |
item_category |
string |
لا | ملابس | فئة السلعة وإذا تم استخدامها كجزء من التدرج الهرمي أو التصنيف، ستكون هذه هي الفئة الأولى. |
item_category2 |
string |
لا | للبالغين | التدرج الهرمي للفئة الثانية أو التصنيف الإضافي للعنصر. |
item_category3 |
string |
لا | قمصان | التدرج الهرمي للفئة الثالثة أو التصنيف الإضافي للعنصر. |
item_category4 |
string |
لا | طاقم العمل | التدرج الهرمي للفئة الرابعة أو التصنيف الإضافي للعنصر. |
item_category5 |
string |
لا | كُم قصير | التدرج الهرمي للفئة الخامسة أو التصنيف الإضافي للعنصر. |
item_list_id |
string |
لا | ذو صلة_المنتجات | رقم تعريف القائمة التي تم فيها عرض السلعة للمستخدِم في حال ضبطها، يتم تجاهل item_list_id على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة item_list_id على مستوى الحدث،
في حال توفّرها.
|
item_list_name |
string |
لا | منتجات ذات صلة | اسم القائمة التي تم فيها عرض السلعة للمستخدِم في حال ضبطها، يتم تجاهل item_list_name على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة item_list_name على مستوى الحدث،
في حال توفّرها.
|
item_variant |
string |
لا | أخضر | صيغة العنصر أو رمز فريد أو وصف لمزيد من التفاصيل/خيارات العناصر. |
location_id |
string |
لا | ChIJIQBpAG2ahYAR_6128GcTUEo (رقم تعريف المكان في Google لسان فرانسيسكو) |
تمثّل هذه السمة الموقع الجغرافي المرتبط بالعنصر (مثل الموقع الجغرافي للمتجر). ننصحك باستخدام
معرّف المكان من Google الذي يتوافق مع العنصر المرتبط. يمكن أيضًا استخدام معرّف الموقع المخصص. ملاحظة: لا يتوفّر "معرّف الموقع الجغرافي" إلا على مستوى العنصر. |
price |
number |
لا | يورو | السعر النقدي للسلعة، بوحدات معلمة العملة المحدّدة. |
promotion_id |
string |
لا | P_12345 |
معرّف العرض الترويجي المرتبط بالعنصر. في حال ضبطها، يتم تجاهل promotion_id على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة promotion_id على مستوى الحدث،
في حال توفّرها.
|
promotion_name |
string |
لا | تخفيضات موسم الصيف |
اسم العرض الترويجي المرتبط بالسلعة. في حال ضبطها، يتم تجاهل promotion_name على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة promotion_name على مستوى الحدث،
في حال توفّرها.
|
quantity |
number |
لا | 1 |
كمية السلعة |
مشاركة
يمكنك استخدام هذا الحدث عندما يشارك المستخدم محتوى.
المَعلمات
الاسم | Type | عنصر مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
method |
string |
لا | الطريقة التي تمت مشاركة المحتوى بها | |
content_type |
string |
لا | صورة | نوع المحتوى الذي تمت مشاركته. |
item_id |
string |
لا | C_12345 | رقم تعريف المحتوى المشترَك |
sign_up
يشير هذا الحدث إلى اشتراك مستخدم لحساب. يمكنك استخدام هذا الحدث لفهم السلوكيات المختلفة للمستخدمين الذين سجّلوا دخولهم وسجّلوا خروجهم.
المَعلمات
الاسم | Type | عنصر مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
method |
string |
لا | الطريقة المستخدَمة للاشتراك. |
spend_virtual_currency
يقيس هذا الحدث بيع السلع الافتراضية في تطبيقك ويساعدك في تحديد السلع الافتراضية الأكثر رواجًا.
المَعلمات
الاسم | Type | عنصر مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
value |
number |
نعم | 5 | قيمة العملة الافتراضية. |
virtual_currency_name |
string |
نعم | أحجار كريمة | اسم العملة الافتراضية. |
item_name |
string |
لا | تعزيز الصوت للمبتدئين | اسم العنصر الذي يتم استخدام العملة الافتراضية فيه. |
tutorial_begin
يشير هذا الحدث إلى بدء عملية الإعداد. استخدِم هذا المسار في مسار الإحالة الناجحة مع السمة tutorial_complete لمعرفة عدد المستخدمين الذين يُكملون البرنامج التعليمي.
المَعلمات
ما مِن معلّمات لهذا الحدث.
tutorial_complete
يشير هذا الحدث إلى إكمال المستخدم لعملية الإعداد. ويمكنك استخدام هذا المسار في مسار الإحالة الناجحة مع tutorial_begin لمعرفة عدد المستخدمين الذين يُكملون البرنامج التعليمي.
المَعلمات
لم يتم اقتراح أي معلَمات لهذا الحدث.
unlock_achievement
يمكنك تسجيل هذا الحدث عندما يفتح المستخدم إنجازًا. يمكن أن يساعدك هذا الحدث في فهم تجربة المستخدمين للعبتك.
المَعلمات
الاسم | Type | عنصر مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
achievement_id |
string |
نعم | A_12345 | رقم تعريف الإنجاز الذي تم فتحه. |
view_cart
يشير هذا الحدث إلى أن مستخدمًا شاهد سلة التسوق.
المَعلمات
الاسم | Type | عنصر مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
currency |
string |
نعم* | USD |
تمثّل هذه السمة عملة العناصر المرتبطة بالفعالية بتنسيق ISO 4217 المكوّن من 3 أحرف. * في حال ضبط السياسة value ، يجب احتساب currency
لكي يتم احتساب مقاييس الأرباح بدقة.
|
value |
number |
نعم* | 7.77 | القيمة المالية للحدث. * يكون value مطلوبًا عادةً لإعداد تقارير مفيدة.
إذا ضَعت علامة
على الحدث باعتباره إحالة ناجحة، ننصحك بإعداد
value .
* currency مطلوب في حال ضبط value .
|
items |
Array<Item> |
نعم | عناصر الحدث. |
معلّمات العناصر
الاسم | Type | عنصر مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
item_id |
string |
نعم* | SKU_12345 |
معرّف العنصر.
*يجب استخدام سمة واحدة من |
item_name |
string |
نعم* | قميص مُزيَّن بشخصيات كتاب Stan and Friends |
اسم السلعة.
*يجب استخدام سمة واحدة من |
affiliation |
string |
لا | Google Store |
ارتباط المنتج لتحديد الشركة التي تقدّمه أو الموقع الجغرافي للمتجر الذي يقدّمه ملاحظة: لا تتوفّر سمة "الارتباط" إلا على مستوى السلعة. |
coupon |
string |
لا | الدالة SUMMER_FUN | اسم/رمز القسيمة المرتبطة بالعنصر إنّ مَعلمتَي coupon على مستوى الحدث ومستوى السلعة
مستقلتان.
|
creative_name |
string |
لا | بانر_صيفي2 | اسم تصميم الإعلان الترويجي. في حال ضبطها، يتم تجاهل creative_name على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة creative_name على مستوى الحدث،
في حال توفّرها. |
creative_slot |
string |
لا | المميزة_1_ | اسم خانة تصميم الإعلان الترويجي المرتبط
بالعنصر. في حال ضبطها، يتم تجاهل creative_slot على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة creative_slot على مستوى الحدث،
في حال توفّرها. |
discount |
number |
لا | 2.22 | قيمة الخصم النقدي المرتبطة بالسلعة. |
index |
number |
لا | 5 | تمثّل هذه السمة فهرس/موضع العنصر في القائمة. |
item_brand |
string |
لا | العلامة التجارية للسلعة. | |
item_category |
string |
لا | ملابس | فئة السلعة وإذا تم استخدامها كجزء من التدرج الهرمي أو التصنيف، ستكون هذه هي الفئة الأولى. |
item_category2 |
string |
لا | للبالغين | التدرج الهرمي للفئة الثانية أو التصنيف الإضافي للعنصر. |
item_category3 |
string |
لا | قمصان | التدرج الهرمي للفئة الثالثة أو التصنيف الإضافي للعنصر. |
item_category4 |
string |
لا | طاقم العمل | التدرج الهرمي للفئة الرابعة أو التصنيف الإضافي للعنصر. |
item_category5 |
string |
لا | كُم قصير | التدرج الهرمي للفئة الخامسة أو التصنيف الإضافي للعنصر. |
item_list_id |
string |
لا | ذو صلة_المنتجات | رقم تعريف القائمة التي تم فيها عرض السلعة للمستخدِم في حال ضبطها، يتم تجاهل item_list_id على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة item_list_id على مستوى الحدث،
في حال توفّرها.
|
item_list_name |
string |
لا | منتجات ذات صلة | اسم القائمة التي تم فيها عرض السلعة للمستخدِم في حال ضبطها، يتم تجاهل item_list_name على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة item_list_name على مستوى الحدث،
في حال توفّرها.
|
item_variant |
string |
لا | أخضر | صيغة العنصر أو رمز فريد أو وصف لمزيد من التفاصيل/خيارات العناصر. |
location_id |
string |
لا | ChIJIQBpAG2ahYAR_6128GcTUEo (رقم تعريف المكان في Google لسان فرانسيسكو) |
تمثّل هذه السمة الموقع الجغرافي المرتبط بالعنصر (مثل الموقع الجغرافي للمتجر). ننصحك باستخدام
معرّف المكان من Google الذي يتوافق مع العنصر المرتبط. يمكن أيضًا استخدام معرّف الموقع المخصص. ملاحظة: لا يتوفّر "معرّف الموقع الجغرافي" إلا على مستوى العنصر. |
price |
number |
لا | يورو | السعر النقدي للسلعة، بوحدات معلمة العملة المحدّدة. |
promotion_id |
string |
لا | P_12345 |
معرّف العرض الترويجي المرتبط بالعنصر. في حال ضبطها، يتم تجاهل promotion_id على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة promotion_id على مستوى الحدث،
في حال توفّرها.
|
promotion_name |
string |
لا | تخفيضات موسم الصيف |
اسم العرض الترويجي المرتبط بالسلعة. في حال ضبطها، يتم تجاهل promotion_name على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة promotion_name على مستوى الحدث،
في حال توفّرها.
|
quantity |
number |
لا | 1 |
كمية السلعة |
view_item
يشير هذا الحدث إلى أنه تم عرض بعض المحتوى للمستخدم. يمكنك استخدام هذا الحدث لاكتشاف العناصر الأكثر رواجًا التي تمّت مشاهدتها.
المَعلمات
الاسم | Type | عنصر مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
currency |
string |
نعم* | USD |
تمثّل هذه السمة عملة العناصر المرتبطة بالفعالية بتنسيق ISO 4217 المكوّن من 3 أحرف. * في حال ضبط السياسة value ، يجب احتساب currency
لكي يتم احتساب مقاييس الأرباح بدقة.
|
value |
number |
نعم* | 7.77 | القيمة المالية للحدث. * يكون value مطلوبًا عادةً لإعداد تقارير مفيدة.
إذا ضَعت علامة
على الحدث باعتباره إحالة ناجحة، ننصحك بإعداد
value .
* currency مطلوب في حال ضبط value .
|
items |
Array<Item> |
نعم | عناصر الحدث. |
معلّمات العناصر
الاسم | Type | عنصر مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
item_id |
string |
نعم* | SKU_12345 |
معرّف العنصر.
*يجب استخدام سمة واحدة من |
item_name |
string |
نعم* | قميص مُزيَّن بشخصيات كتاب Stan and Friends |
اسم السلعة.
*يجب استخدام سمة واحدة من |
affiliation |
string |
لا | Google Store |
ارتباط المنتج لتحديد الشركة التي تقدّمه أو الموقع الجغرافي للمتجر الذي يقدّمه ملاحظة: لا تتوفّر سمة "الارتباط" إلا على مستوى السلعة. |
coupon |
string |
لا | الدالة SUMMER_FUN | اسم/رمز القسيمة المرتبطة بالعنصر إنّ مَعلمتَي coupon على مستوى الحدث ومستوى السلعة
مستقلتان.
|
creative_name |
string |
لا | بانر_صيفي2 | اسم تصميم الإعلان الترويجي. في حال ضبطها، يتم تجاهل creative_name على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة creative_name على مستوى الحدث،
في حال توفّرها. |
creative_slot |
string |
لا | المميزة_1_ | اسم خانة تصميم الإعلان الترويجي المرتبط
بالعنصر. في حال ضبطها، يتم تجاهل creative_slot على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة creative_slot على مستوى الحدث،
في حال توفّرها. |
discount |
number |
لا | 2.22 | قيمة الخصم النقدي المرتبطة بالسلعة. |
index |
number |
لا | 5 | تمثّل هذه السمة فهرس/موضع العنصر في القائمة. |
item_brand |
string |
لا | العلامة التجارية للسلعة. | |
item_category |
string |
لا | ملابس | فئة السلعة وإذا تم استخدامها كجزء من التدرج الهرمي أو التصنيف، ستكون هذه هي الفئة الأولى. |
item_category2 |
string |
لا | للبالغين | التدرج الهرمي للفئة الثانية أو التصنيف الإضافي للعنصر. |
item_category3 |
string |
لا | قمصان | التدرج الهرمي للفئة الثالثة أو التصنيف الإضافي للعنصر. |
item_category4 |
string |
لا | طاقم العمل | التدرج الهرمي للفئة الرابعة أو التصنيف الإضافي للعنصر. |
item_category5 |
string |
لا | كُم قصير | التدرج الهرمي للفئة الخامسة أو التصنيف الإضافي للعنصر. |
item_list_id |
string |
لا | ذو صلة_المنتجات | رقم تعريف القائمة التي تم فيها عرض السلعة للمستخدِم في حال ضبطها، يتم تجاهل item_list_id على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة item_list_id على مستوى الحدث،
في حال توفّرها.
|
item_list_name |
string |
لا | منتجات ذات صلة | اسم القائمة التي تم فيها عرض السلعة للمستخدِم في حال ضبطها، يتم تجاهل item_list_name على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة item_list_name على مستوى الحدث،
في حال توفّرها.
|
item_variant |
string |
لا | أخضر | صيغة العنصر أو رمز فريد أو وصف لمزيد من التفاصيل/خيارات العناصر. |
location_id |
string |
لا | ChIJIQBpAG2ahYAR_6128GcTUEo (رقم تعريف المكان في Google لسان فرانسيسكو) |
تمثّل هذه السمة الموقع الجغرافي المرتبط بالعنصر (مثل الموقع الجغرافي للمتجر). ننصحك باستخدام
معرّف المكان من Google الذي يتوافق مع العنصر المرتبط. يمكن أيضًا استخدام معرّف الموقع المخصص. ملاحظة: لا يتوفّر "معرّف الموقع الجغرافي" إلا على مستوى العنصر. |
price |
number |
لا | يورو | السعر النقدي للسلعة، بوحدات معلمة العملة المحدّدة. |
promotion_id |
string |
لا | P_12345 |
معرّف العرض الترويجي المرتبط بالعنصر. في حال ضبطها، يتم تجاهل promotion_id على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة promotion_id على مستوى الحدث،
في حال توفّرها.
|
promotion_name |
string |
لا | تخفيضات موسم الصيف |
اسم العرض الترويجي المرتبط بالسلعة. في حال ضبطها، يتم تجاهل promotion_name على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة promotion_name على مستوى الحدث،
في حال توفّرها.
|
quantity |
number |
لا | 1 |
كمية السلعة |
view_item_list
سجِّل هذا الحدث عندما يتم عرض المستخدم مع قائمة بالعناصر من فئة معيّنة.
المَعلمات
الاسم | Type | عنصر مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
item_list_id |
string |
لا | ذو صلة_المنتجات | رقم تعريف القائمة التي تم فيها عرض السلعة للمستخدِم يتم تجاهل هذه السمة في حال ضبطها على مستوى السلعة. |
item_list_name |
string |
لا | منتجات ذات صلة | اسم القائمة التي تم فيها عرض السلعة للمستخدِم يتم تجاهل هذه السمة في حال ضبطها على مستوى السلعة. |
items |
Array<Item> |
نعم | عناصر الحدث. |
معلّمات العناصر
الاسم | Type | عنصر مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
item_id |
string |
نعم* | SKU_12345 |
معرّف العنصر.
*يجب استخدام سمة واحدة من |
item_name |
string |
نعم* | قميص مُزيَّن بشخصيات كتاب Stan and Friends |
اسم السلعة.
*يجب استخدام سمة واحدة من |
affiliation |
string |
لا | Google Store |
ارتباط المنتج لتحديد الشركة التي تقدّمه أو الموقع الجغرافي للمتجر الذي يقدّمه ملاحظة: لا تتوفّر سمة "الارتباط" إلا على مستوى السلعة. |
coupon |
string |
لا | الدالة SUMMER_FUN | اسم/رمز القسيمة المرتبطة بالعنصر إنّ مَعلمتَي coupon على مستوى الحدث ومستوى السلعة
مستقلتان.
|
creative_name |
string |
لا | بانر_صيفي2 | اسم تصميم الإعلان الترويجي. في حال ضبطها، يتم تجاهل creative_name على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة creative_name على مستوى الحدث،
في حال توفّرها. |
creative_slot |
string |
لا | المميزة_1_ | اسم خانة تصميم الإعلان الترويجي المرتبط
بالعنصر. في حال ضبطها، يتم تجاهل creative_slot على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة creative_slot على مستوى الحدث،
في حال توفّرها. |
discount |
number |
لا | 2.22 | قيمة الخصم النقدي المرتبطة بالسلعة. |
index |
number |
لا | 5 | تمثّل هذه السمة فهرس/موضع العنصر في القائمة. |
item_brand |
string |
لا | العلامة التجارية للسلعة. | |
item_category |
string |
لا | ملابس | فئة السلعة وإذا تم استخدامها كجزء من التدرج الهرمي أو التصنيف، ستكون هذه هي الفئة الأولى. |
item_category2 |
string |
لا | للبالغين | التدرج الهرمي للفئة الثانية أو التصنيف الإضافي للعنصر. |
item_category3 |
string |
لا | قمصان | التدرج الهرمي للفئة الثالثة أو التصنيف الإضافي للعنصر. |
item_category4 |
string |
لا | طاقم العمل | التدرج الهرمي للفئة الرابعة أو التصنيف الإضافي للعنصر. |
item_category5 |
string |
لا | كُم قصير | التدرج الهرمي للفئة الخامسة أو التصنيف الإضافي للعنصر. |
item_list_id |
string |
لا | ذو صلة_المنتجات | رقم تعريف القائمة التي تم فيها عرض السلعة للمستخدِم في حال ضبطها، يتم تجاهل item_list_id على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة item_list_id على مستوى الحدث،
في حال توفّرها.
|
item_list_name |
string |
لا | منتجات ذات صلة | اسم القائمة التي تم فيها عرض السلعة للمستخدِم في حال ضبطها، يتم تجاهل item_list_name على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة item_list_name على مستوى الحدث،
في حال توفّرها.
|
item_variant |
string |
لا | أخضر | صيغة العنصر أو رمز فريد أو وصف لمزيد من التفاصيل/خيارات العناصر. |
location_id |
string |
لا | ChIJIQBpAG2ahYAR_6128GcTUEo (رقم تعريف المكان في Google لسان فرانسيسكو) |
تمثّل هذه السمة الموقع الجغرافي المرتبط بالعنصر (مثل الموقع الجغرافي للمتجر). ننصحك باستخدام
معرّف المكان من Google الذي يتوافق مع العنصر المرتبط. يمكن أيضًا استخدام معرّف الموقع المخصص. ملاحظة: لا يتوفّر "معرّف الموقع الجغرافي" إلا على مستوى العنصر. |
price |
number |
لا | يورو | السعر النقدي للسلعة، بوحدات معلمة العملة المحدّدة. |
promotion_id |
string |
لا | P_12345 |
معرّف العرض الترويجي المرتبط بالعنصر. في حال ضبطها، يتم تجاهل promotion_id على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة promotion_id على مستوى الحدث،
في حال توفّرها.
|
promotion_name |
string |
لا | تخفيضات موسم الصيف |
اسم العرض الترويجي المرتبط بالسلعة. في حال ضبطها، يتم تجاهل promotion_name على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة promotion_name على مستوى الحدث،
في حال توفّرها.
|
quantity |
number |
لا | 1 |
كمية السلعة |
view_promotion
يشير هذا الحدث إلى أنه تم عرض عرض ترويجي من إحدى القوائم.
المَعلمات
الاسم | Type | عنصر مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
creative_name |
string |
لا | بانر_صيفي2 | اسم تصميم الإعلان الترويجي. يتم تجاهل هذه السمة في حال ضبطها على مستوى السلعة. |
creative_slot |
string |
لا | المميزة_1_ | اسم خانة تصميم الإعلان الترويجي المرتبط بالفعالية. يتم تجاهل هذه السمة في حال ضبطها على مستوى السلعة. |
promotion_id |
string |
لا | P_12345 |
معرّف العرض الترويجي المرتبط بالحدث. يتم تجاهل هذه السمة في حال ضبطها على مستوى السلعة. |
promotion_name |
string |
لا | تخفيضات موسم الصيف |
اسم العرض الترويجي المرتبط بالحدث. يتم تجاهل هذه السمة في حال ضبطها على مستوى السلعة. |
items |
Array<Item> |
نعم* | عناصر الحدث. * من المتوقّع أن تحتوي السمة items على عنصر واحد، وهو العنصر الذي يمثّل العرض الترويجي. وإذا تم توفير
عناصر متعددة، سيتم استخدام العنصر الأول فقط في
items .
|
معلّمات العناصر
الاسم | Type | عنصر مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
item_id |
string |
نعم* | SKU_12345 |
معرّف العنصر.
*يجب استخدام سمة واحدة من |
item_name |
string |
نعم* | قميص مُزيَّن بشخصيات كتاب Stan and Friends |
اسم السلعة.
*يجب استخدام سمة واحدة من |
affiliation |
string |
لا | Google Store |
ارتباط المنتج لتحديد الشركة التي تقدّمه أو الموقع الجغرافي للمتجر الذي يقدّمه ملاحظة: لا تتوفّر سمة "الارتباط" إلا على مستوى السلعة. |
coupon |
string |
لا | الدالة SUMMER_FUN | اسم/رمز القسيمة المرتبطة بالعنصر إنّ مَعلمتَي coupon على مستوى الحدث ومستوى السلعة
مستقلتان.
|
creative_name |
string |
لا | بانر_صيفي2 | اسم تصميم الإعلان الترويجي. في حال ضبطها، يتم تجاهل creative_name على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة creative_name على مستوى الحدث،
في حال توفّرها. |
creative_slot |
string |
لا | المميزة_1_ | اسم خانة تصميم الإعلان الترويجي المرتبط
بالعنصر. في حال ضبطها، يتم تجاهل creative_slot على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة creative_slot على مستوى الحدث،
في حال توفّرها. |
discount |
number |
لا | 2.22 | قيمة الخصم النقدي المرتبطة بالسلعة. |
index |
number |
لا | 5 | تمثّل هذه السمة فهرس/موضع العنصر في القائمة. |
item_brand |
string |
لا | العلامة التجارية للسلعة. | |
item_category |
string |
لا | ملابس | فئة السلعة وإذا تم استخدامها كجزء من التدرج الهرمي أو التصنيف، ستكون هذه هي الفئة الأولى. |
item_category2 |
string |
لا | للبالغين | التدرج الهرمي للفئة الثانية أو التصنيف الإضافي للعنصر. |
item_category3 |
string |
لا | قمصان | التدرج الهرمي للفئة الثالثة أو التصنيف الإضافي للعنصر. |
item_category4 |
string |
لا | طاقم العمل | التدرج الهرمي للفئة الرابعة أو التصنيف الإضافي للعنصر. |
item_category5 |
string |
لا | كُم قصير | التدرج الهرمي للفئة الخامسة أو التصنيف الإضافي للعنصر. |
item_list_id |
string |
لا | ذو صلة_المنتجات | رقم تعريف القائمة التي تم فيها عرض السلعة للمستخدِم في حال ضبطها، يتم تجاهل item_list_id على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة item_list_id على مستوى الحدث،
في حال توفّرها.
|
item_list_name |
string |
لا | منتجات ذات صلة | اسم القائمة التي تم فيها عرض السلعة للمستخدِم في حال ضبطها، يتم تجاهل item_list_name على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة item_list_name على مستوى الحدث،
في حال توفّرها.
|
item_variant |
string |
لا | أخضر | صيغة العنصر أو رمز فريد أو وصف لمزيد من التفاصيل/خيارات العناصر. |
location_id |
string |
لا | ChIJIQBpAG2ahYAR_6128GcTUEo (رقم تعريف المكان في Google لسان فرانسيسكو) |
تمثّل هذه السمة الموقع الجغرافي المرتبط بالعنصر (مثل الموقع الجغرافي للمتجر). ننصحك باستخدام
معرّف المكان من Google الذي يتوافق مع العنصر المرتبط. يمكن أيضًا استخدام معرّف الموقع المخصص. ملاحظة: لا يتوفّر "معرّف الموقع الجغرافي" إلا على مستوى العنصر. |
price |
number |
لا | يورو | السعر النقدي للسلعة، بوحدات معلمة العملة المحدّدة. |
promotion_id |
string |
لا | P_12345 |
معرّف العرض الترويجي المرتبط بالعنصر. في حال ضبطها، يتم تجاهل promotion_id على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة promotion_id على مستوى الحدث،
في حال توفّرها.
|
promotion_name |
string |
لا | تخفيضات موسم الصيف |
اسم العرض الترويجي المرتبط بالسلعة. في حال ضبطها، يتم تجاهل promotion_name على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة promotion_name على مستوى الحدث،
في حال توفّرها.
|
quantity |
number |
لا | 1 |
كمية السلعة |
view_search_results
سجِّل هذا الحدث عندما تظهر للمستخدم نتائج بحث. تجدر الإشارة إلى أنه يمكنك تفعيل حدث view_search_results لجمع البيانات تلقائيًا من خلال قياس الأحداث المحسّن في "إحصاءات Google".
المَعلمات
الاسم | Type | عنصر مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
search_term |
string |
لا | ملابس | العبارة المستخدَمة في البحث. |