تتيح لك هذه الأحداث قياس ميزات وسلوكيات إضافية وإنشاء تقارير أكثر فائدة في "إحصاءات Google 4". ولأن هذه الأحداث تتطلب سياقًا إضافيًا لتحقيق فائدة، فلا يتم إرسالها تلقائيًا. استخدِم هذا المستند للاطّلاع على المَعلمات المطلوبة والاختيارية لكلّ حدث.
add_payment_info
يشير هذا الحدث إلى أنّ المستخدِم قد أرسل معلومات الدفع في عملية دفع مرتبطة بالتجارة الإلكترونية.
المعلمات
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
currency |
string |
نعم* | USD |
عملة السلع المرتبطة بالحدث، بتنسيق ISO 4217 المُكوَّن من 3 أحرف. * في حال ضبط السمة value ، ستكون currency مطلوبة
لاحتساب مقاييس الأرباح بدقة.
|
value |
number |
نعم* | 30.03 | القيمة النقدية للحدث. * اضبط value على مجموع (price * quantity) لكل العناصر في
items . لا تضمِّن shipping أو tax .
* تكون السمة value مطلوبة عادةً لإعداد تقارير ذات مغزى.
في حال وضع علامة
على الحدث كإحالة ناجحة، ننصحك بضبط
value .
* مطلوبة currency في حال ضبط value .
|
coupon |
string |
لا | SUMMER_FUN | اسم/رمز القسيمة المرتبط بالحدث. تكون مَعلمات coupon على مستوى الحدث وعلى مستوى السلعة
مستقلة.
|
payment_type |
string |
لا | بطاقة الائتمان | طريقة الدفع التي تم اختيارها. |
items |
Array<Item> |
Yes | عناصر الحدث. |
مَعلمات العناصر
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
item_id |
string |
نعم* | SKU_12345 |
معرّف السلعة.
*يجب تحديد إما |
item_name |
string |
نعم* | قميص مُزيَّن بشخصيات كتاب Stan and Friends |
اسم السلعة.
*يجب تحديد إما |
affiliation |
string |
لا | Google Store |
ارتباط المنتج لتحديد الشركة التي يتم تقديمها أو الموقع الجغرافي للمتجر ملاحظة: لا يتوفّر "الارتباط" إلا على نطاق العنصر. |
coupon |
string |
لا | SUMMER_FUN | اسم/رمز القسيمة المرتبط بالسلعة. تكون مَعلمات coupon على مستوى الحدث وعلى مستوى السلعة
مستقلة.
|
creative_name |
string |
لا | summer_banner2 | اسم تصميم الإعلان الترويجي في حال ضبط هذه السياسة، يتم تجاهل السمة creative_name على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة creative_name على مستوى الحدث، إن توفّرت. |
creative_slot |
string |
لا | featured_app_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 |
لا | related_products | رقم تعريف القائمة التي تم فيها عرض السلعة للمستخدِم في حال ضبط هذه السياسة، يتم تجاهل السمة 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 |
لا | 10.01 |
سعر الوحدة النقدي للعنصر بوحدات مَعلمة العملة المحدّدة.
إذا كان هناك خصم ينطبق على السلعة، يجب ضبط price على سعر الوحدة المخفّض
وتحديد الخصم على سعر الوحدة في مَعلمة discount .
|
promotion_id |
string |
لا | P_12345 |
معرّف العرض الترويجي المرتبط بالسلعة. في حال ضبط هذه السياسة، يتم تجاهل السمة promotion_id على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة promotion_id على مستوى الحدث، إن توفّرت.
|
promotion_name |
string |
لا | تخفيضات موسم الصيف |
اسم العرض الترويجي المرتبط بالسلعة. في حال ضبط هذه السياسة، يتم تجاهل السمة promotion_name على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة promotion_name على مستوى الحدث، إن توفّرت.
|
quantity |
number |
لا | 3 |
كمية السلعة |
items
.
مثال
add_shipping_info
يشير هذا الحدث إلى أنّ المستخدِم قد أرسل معلومات الشحن في عملية دفع مرتبطة بالتجارة الإلكترونية.
المعلمات
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
currency |
string |
نعم* | USD |
عملة السلع المرتبطة بالحدث، بتنسيق ISO 4217 المُكوَّن من 3 أحرف. * في حال ضبط السمة value ، ستكون currency مطلوبة
لاحتساب مقاييس الأرباح بدقة.
|
value |
number |
نعم* | 30.03 | القيمة النقدية للحدث. * اضبط value على مجموع (price * quantity) لكل العناصر في
items . لا تضمِّن shipping أو tax .
* تكون السمة value مطلوبة عادةً لإعداد تقارير ذات مغزى.
في حال وضع علامة
على الحدث كإحالة ناجحة، ننصحك بضبط
value .
* مطلوبة currency في حال ضبط value .
|
coupon |
string |
لا | SUMMER_FUN | اسم/رمز القسيمة المرتبط بالحدث. تكون مَعلمات coupon على مستوى الحدث وعلى مستوى السلعة
مستقلة.
|
shipping_tier |
string |
لا | شحن بري |
فئة الشحن (مثل Ground أو Air أو
Next-day ) التي تم اختيارها لتسليم السلعة المشتراة.
|
items |
Array<Item> |
Yes | عناصر الحدث. |
مَعلمات العناصر
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
item_id |
string |
نعم* | SKU_12345 |
معرّف السلعة.
*يجب تحديد إما |
item_name |
string |
نعم* | قميص مُزيَّن بشخصيات كتاب Stan and Friends |
اسم السلعة.
*يجب تحديد إما |
affiliation |
string |
لا | Google Store |
ارتباط المنتج لتحديد الشركة التي يتم تقديمها أو الموقع الجغرافي للمتجر ملاحظة: لا يتوفّر "الارتباط" إلا على نطاق العنصر. |
coupon |
string |
لا | SUMMER_FUN | اسم/رمز القسيمة المرتبط بالسلعة. تكون مَعلمات coupon على مستوى الحدث وعلى مستوى السلعة
مستقلة.
|
creative_name |
string |
لا | summer_banner2 | اسم تصميم الإعلان الترويجي في حال ضبط هذه السياسة، يتم تجاهل السمة creative_name على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة creative_name على مستوى الحدث، إن توفّرت. |
creative_slot |
string |
لا | featured_app_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 |
لا | related_products | رقم تعريف القائمة التي تم فيها عرض السلعة للمستخدِم في حال ضبط هذه السياسة، يتم تجاهل السمة 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 |
لا | 10.01 |
سعر الوحدة النقدي للعنصر بوحدات مَعلمة العملة المحدّدة.
إذا كان هناك خصم ينطبق على السلعة، يجب ضبط price على سعر الوحدة المخفّض
وتحديد الخصم على سعر الوحدة في مَعلمة discount .
|
promotion_id |
string |
لا | P_12345 |
معرّف العرض الترويجي المرتبط بالسلعة. في حال ضبط هذه السياسة، يتم تجاهل السمة promotion_id على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة promotion_id على مستوى الحدث، إن توفّرت.
|
promotion_name |
string |
لا | تخفيضات موسم الصيف |
اسم العرض الترويجي المرتبط بالسلعة. في حال ضبط هذه السياسة، يتم تجاهل السمة promotion_name على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة promotion_name على مستوى الحدث، إن توفّرت.
|
quantity |
number |
لا | 3 |
كمية السلعة |
items
.
مثال
add_to_cart
يشير هذا الحدث إلى إضافة سلعة إلى سلة تسوّق للشراء.
المعلمات
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
currency |
string |
نعم* | USD |
عملة السلع المرتبطة بالحدث، بتنسيق ISO 4217 المُكوَّن من 3 أحرف. * في حال ضبط السمة value ، ستكون currency مطلوبة
لاحتساب مقاييس الأرباح بدقة.
|
value |
number |
نعم* | 30.03 | القيمة النقدية للحدث. * اضبط value على مجموع (price * quantity) لكل العناصر في
items . لا تضمِّن shipping أو tax .
* تكون السمة value مطلوبة عادةً لإعداد تقارير ذات مغزى.
في حال وضع علامة
على الحدث كإحالة ناجحة، ننصحك بضبط
value .
* مطلوبة currency في حال ضبط value .
|
items |
Array<Item> |
Yes | عناصر الحدث. |
مَعلمات العناصر
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
item_id |
string |
نعم* | SKU_12345 |
معرّف السلعة.
*يجب تحديد إما |
item_name |
string |
نعم* | قميص مُزيَّن بشخصيات كتاب Stan and Friends |
اسم السلعة.
*يجب تحديد إما |
affiliation |
string |
لا | Google Store |
ارتباط المنتج لتحديد الشركة التي يتم تقديمها أو الموقع الجغرافي للمتجر ملاحظة: لا يتوفّر "الارتباط" إلا على نطاق العنصر. |
coupon |
string |
لا | SUMMER_FUN | اسم/رمز القسيمة المرتبط بالسلعة. تكون مَعلمات coupon على مستوى الحدث وعلى مستوى السلعة
مستقلة.
|
creative_name |
string |
لا | summer_banner2 | اسم تصميم الإعلان الترويجي في حال ضبط هذه السياسة، يتم تجاهل السمة creative_name على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة creative_name على مستوى الحدث، إن توفّرت. |
creative_slot |
string |
لا | featured_app_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 |
لا | related_products | رقم تعريف القائمة التي تم فيها عرض السلعة للمستخدِم في حال ضبط هذه السياسة، يتم تجاهل السمة 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 |
لا | 10.01 |
سعر الوحدة النقدي للعنصر بوحدات مَعلمة العملة المحدّدة.
إذا كان هناك خصم ينطبق على السلعة، يجب ضبط price على سعر الوحدة المخفّض
وتحديد الخصم على سعر الوحدة في مَعلمة discount .
|
promotion_id |
string |
لا | P_12345 |
معرّف العرض الترويجي المرتبط بالسلعة. في حال ضبط هذه السياسة، يتم تجاهل السمة promotion_id على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة promotion_id على مستوى الحدث، إن توفّرت.
|
promotion_name |
string |
لا | تخفيضات موسم الصيف |
اسم العرض الترويجي المرتبط بالسلعة. في حال ضبط هذه السياسة، يتم تجاهل السمة promotion_name على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة promotion_name على مستوى الحدث، إن توفّرت.
|
quantity |
number |
لا | 3 |
كمية السلعة |
items
.
مثال
add_to_wishlist
يشير الحدث إلى إضافة عنصر إلى قائمة الأمنيات. استخدم هذا الحدث لتحديد عناصر الهدايا الشائعة في تطبيقك.
المعلمات
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
currency |
string |
نعم* | USD |
عملة السلع المرتبطة بالحدث، بتنسيق ISO 4217 المُكوَّن من 3 أحرف. * في حال ضبط السمة value ، ستكون currency مطلوبة
لاحتساب مقاييس الأرباح بدقة.
|
value |
number |
نعم* | 30.03 | القيمة النقدية للحدث. * اضبط value على مجموع (price * quantity) لكل العناصر في
items . لا تضمِّن shipping أو tax .
* تكون السمة value مطلوبة عادةً لإعداد تقارير ذات مغزى.
في حال وضع علامة
على الحدث كإحالة ناجحة، ننصحك بضبط
value .
* مطلوبة currency في حال ضبط value .
|
items |
Array<Item> |
Yes | عناصر الحدث. |
مَعلمات العناصر
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
item_id |
string |
نعم* | SKU_12345 |
معرّف السلعة.
*يجب تحديد إما |
item_name |
string |
نعم* | قميص مُزيَّن بشخصيات كتاب Stan and Friends |
اسم السلعة.
*يجب تحديد إما |
affiliation |
string |
لا | Google Store |
ارتباط المنتج لتحديد الشركة التي يتم تقديمها أو الموقع الجغرافي للمتجر ملاحظة: لا يتوفّر "الارتباط" إلا على نطاق العنصر. |
coupon |
string |
لا | SUMMER_FUN | اسم/رمز القسيمة المرتبط بالسلعة. تكون مَعلمات coupon على مستوى الحدث وعلى مستوى السلعة
مستقلة.
|
creative_name |
string |
لا | summer_banner2 | اسم تصميم الإعلان الترويجي في حال ضبط هذه السياسة، يتم تجاهل السمة creative_name على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة creative_name على مستوى الحدث، إن توفّرت. |
creative_slot |
string |
لا | featured_app_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 |
لا | related_products | رقم تعريف القائمة التي تم فيها عرض السلعة للمستخدِم في حال ضبط هذه السياسة، يتم تجاهل السمة 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 |
لا | 10.01 |
سعر الوحدة النقدي للعنصر بوحدات مَعلمة العملة المحدّدة.
إذا كان هناك خصم ينطبق على السلعة، يجب ضبط price على سعر الوحدة المخفّض
وتحديد الخصم على سعر الوحدة في مَعلمة discount .
|
promotion_id |
string |
لا | P_12345 |
معرّف العرض الترويجي المرتبط بالسلعة. في حال ضبط هذه السياسة، يتم تجاهل السمة promotion_id على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة promotion_id على مستوى الحدث، إن توفّرت.
|
promotion_name |
string |
لا | تخفيضات موسم الصيف |
اسم العرض الترويجي المرتبط بالسلعة. في حال ضبط هذه السياسة، يتم تجاهل السمة promotion_name على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة promotion_name على مستوى الحدث، إن توفّرت.
|
quantity |
number |
لا | 3 |
كمية السلعة |
items
.
مثال
begin_checkout
يشير هذا الحدث إلى أنّ المستخدم قد بدأ عملية الدفع.
المعلمات
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
currency |
string |
نعم* | USD |
عملة السلع المرتبطة بالحدث، بتنسيق ISO 4217 المُكوَّن من 3 أحرف. * في حال ضبط السمة value ، ستكون currency مطلوبة
لاحتساب مقاييس الأرباح بدقة.
|
value |
number |
نعم* | 30.03 | القيمة النقدية للحدث. * اضبط value على مجموع (price * quantity) لكل العناصر في
items . لا تضمِّن shipping أو tax .
* تكون السمة value مطلوبة عادةً لإعداد تقارير ذات مغزى.
في حال وضع علامة
على الحدث كإحالة ناجحة، ننصحك بضبط
value .
* مطلوبة currency في حال ضبط value .
|
coupon |
string |
لا | SUMMER_FUN | اسم/رمز القسيمة المرتبط بالحدث. تكون مَعلمات coupon على مستوى الحدث وعلى مستوى السلعة
مستقلة.
|
items |
Array<Item> |
Yes | عناصر الحدث. |
مَعلمات العناصر
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
item_id |
string |
نعم* | SKU_12345 |
معرّف السلعة.
*يجب تحديد إما |
item_name |
string |
نعم* | قميص مُزيَّن بشخصيات كتاب Stan and Friends |
اسم السلعة.
*يجب تحديد إما |
affiliation |
string |
لا | Google Store |
ارتباط المنتج لتحديد الشركة التي يتم تقديمها أو الموقع الجغرافي للمتجر ملاحظة: لا يتوفّر "الارتباط" إلا على نطاق العنصر. |
coupon |
string |
لا | SUMMER_FUN | اسم/رمز القسيمة المرتبط بالسلعة. تكون مَعلمات coupon على مستوى الحدث وعلى مستوى السلعة
مستقلة.
|
creative_name |
string |
لا | summer_banner2 | اسم تصميم الإعلان الترويجي في حال ضبط هذه السياسة، يتم تجاهل السمة creative_name على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة creative_name على مستوى الحدث، إن توفّرت. |
creative_slot |
string |
لا | featured_app_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 |
لا | related_products | رقم تعريف القائمة التي تم فيها عرض السلعة للمستخدِم في حال ضبط هذه السياسة، يتم تجاهل السمة 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 |
لا | 10.01 |
سعر الوحدة النقدي للعنصر بوحدات مَعلمة العملة المحدّدة.
إذا كان هناك خصم ينطبق على السلعة، يجب ضبط price على سعر الوحدة المخفّض
وتحديد الخصم على سعر الوحدة في مَعلمة discount .
|
promotion_id |
string |
لا | P_12345 |
معرّف العرض الترويجي المرتبط بالسلعة. في حال ضبط هذه السياسة، يتم تجاهل السمة promotion_id على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة promotion_id على مستوى الحدث، إن توفّرت.
|
promotion_name |
string |
لا | تخفيضات موسم الصيف |
اسم العرض الترويجي المرتبط بالسلعة. في حال ضبط هذه السياسة، يتم تجاهل السمة promotion_name على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة promotion_name على مستوى الحدث، إن توفّرت.
|
quantity |
number |
لا | 3 |
كمية السلعة |
items
.
مثال
close_convert_lead
يقيس هذا الحدث الوقت الذي يتم فيه تحويل عميل محتمل وإغلاقه (على سبيل المثال، من خلال عملية شراء).
المعلمات
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
currency |
string |
نعم* | USD |
عملة السلع المرتبطة بالحدث، بتنسيق ISO 4217 المُكوَّن من 3 أحرف. * في حال ضبط السمة value ، ستكون currency مطلوبة
لاحتساب مقاييس الأرباح بدقة.
|
value |
number |
نعم* | 30.03 | القيمة النقدية للحدث. * اضبط value على مجموع (price * quantity) لكل العناصر في
items . لا تضمِّن shipping أو tax .
* تكون السمة value مطلوبة عادةً لإعداد تقارير ذات مغزى.
في حال وضع علامة
على الحدث كإحالة ناجحة، ننصحك بضبط
value .
* مطلوبة currency في حال ضبط value .
|
items |
Array<Item>
|
لا | عناصر الحدث. |
مَعلمات العناصر
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
item_id |
string |
نعم* | SKU_12345 |
معرّف السلعة.
*يجب تحديد إما |
item_name |
string |
نعم* | قميص مُزيَّن بشخصيات كتاب Stan and Friends |
اسم السلعة.
*يجب تحديد إما |
affiliation |
string |
لا | Google Store |
ارتباط المنتج لتحديد الشركة التي يتم تقديمها أو الموقع الجغرافي للمتجر ملاحظة: لا يتوفّر "الارتباط" إلا على نطاق العنصر. |
coupon |
string |
لا | SUMMER_FUN | اسم/رمز القسيمة المرتبط بالسلعة. تكون مَعلمات coupon على مستوى الحدث وعلى مستوى السلعة
مستقلة.
|
creative_name |
string |
لا | summer_banner2 | اسم تصميم الإعلان الترويجي في حال ضبط هذه السياسة، يتم تجاهل السمة creative_name على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة creative_name على مستوى الحدث، إن توفّرت. |
creative_slot |
string |
لا | featured_app_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 |
لا | related_products | رقم تعريف القائمة التي تم فيها عرض السلعة للمستخدِم في حال ضبط هذه السياسة، يتم تجاهل السمة 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 |
لا | 10.01 |
سعر الوحدة النقدي للعنصر بوحدات مَعلمة العملة المحدّدة.
إذا كان هناك خصم ينطبق على السلعة، يجب ضبط price على سعر الوحدة المخفّض
وتحديد الخصم على سعر الوحدة في مَعلمة discount .
|
promotion_id |
string |
لا | P_12345 |
معرّف العرض الترويجي المرتبط بالسلعة. في حال ضبط هذه السياسة، يتم تجاهل السمة promotion_id على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة promotion_id على مستوى الحدث، إن توفّرت.
|
promotion_name |
string |
لا | تخفيضات موسم الصيف |
اسم العرض الترويجي المرتبط بالسلعة. في حال ضبط هذه السياسة، يتم تجاهل السمة promotion_name على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة promotion_name على مستوى الحدث، إن توفّرت.
|
quantity |
number |
لا | 3 |
كمية السلعة |
items
.
مثال
close_unconvert_lead
يقيس هذا الحدث الحالات التي يتم فيها وضع علامة على المستخدم على أنّه لا يصبح عميلاً محتملاً أجرى إحالة ناجحة، مع السبب.
المعلمات
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
currency |
string |
نعم* | USD |
عملة السلع المرتبطة بالحدث، بتنسيق ISO 4217 المُكوَّن من 3 أحرف. * في حال ضبط السمة value ، ستكون currency مطلوبة
لاحتساب مقاييس الأرباح بدقة.
|
value |
number |
نعم* | 30.03 | القيمة النقدية للحدث. * اضبط value على مجموع (price * quantity) لكل العناصر في
items . لا تضمِّن shipping أو tax .
* تكون السمة value مطلوبة عادةً لإعداد تقارير ذات مغزى.
في حال وضع علامة
على الحدث كإحالة ناجحة، ننصحك بضبط
value .
* مطلوبة currency في حال ضبط value .
|
unconvert_lead_reason |
string |
لا | لم يتم الرد مطلقًا | سبب عدم إجراء إحالة ناجحة من العميل المحتمل. |
items |
Array<Item>
|
لا | عناصر الحدث. |
مَعلمات العناصر
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
item_id |
string |
نعم* | SKU_12345 |
معرّف السلعة.
*يجب تحديد إما |
item_name |
string |
نعم* | قميص مُزيَّن بشخصيات كتاب Stan and Friends |
اسم السلعة.
*يجب تحديد إما |
affiliation |
string |
لا | Google Store |
ارتباط المنتج لتحديد الشركة التي يتم تقديمها أو الموقع الجغرافي للمتجر ملاحظة: لا يتوفّر "الارتباط" إلا على نطاق العنصر. |
coupon |
string |
لا | SUMMER_FUN | اسم/رمز القسيمة المرتبط بالسلعة. تكون مَعلمات coupon على مستوى الحدث وعلى مستوى السلعة
مستقلة.
|
creative_name |
string |
لا | summer_banner2 | اسم تصميم الإعلان الترويجي في حال ضبط هذه السياسة، يتم تجاهل السمة creative_name على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة creative_name على مستوى الحدث، إن توفّرت. |
creative_slot |
string |
لا | featured_app_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 |
لا | related_products | رقم تعريف القائمة التي تم فيها عرض السلعة للمستخدِم في حال ضبط هذه السياسة، يتم تجاهل السمة 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 |
لا | 10.01 |
سعر الوحدة النقدي للعنصر بوحدات مَعلمة العملة المحدّدة.
إذا كان هناك خصم ينطبق على السلعة، يجب ضبط price على سعر الوحدة المخفّض
وتحديد الخصم على سعر الوحدة في مَعلمة discount .
|
promotion_id |
string |
لا | P_12345 |
معرّف العرض الترويجي المرتبط بالسلعة. في حال ضبط هذه السياسة، يتم تجاهل السمة promotion_id على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة promotion_id على مستوى الحدث، إن توفّرت.
|
promotion_name |
string |
لا | تخفيضات موسم الصيف |
اسم العرض الترويجي المرتبط بالسلعة. في حال ضبط هذه السياسة، يتم تجاهل السمة promotion_name على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة promotion_name على مستوى الحدث، إن توفّرت.
|
quantity |
number |
لا | 3 |
كمية السلعة |
items
.
مثال
disqualify_lead
يقيس هذا الحدث عندما يتم وضع علامة على المستخدم على أنه غير مؤهل ليصبح عميلاً محتملاً، بالإضافة إلى سبب عدم الأهلية.
المعلمات
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
currency |
string |
نعم* | USD |
عملة السلع المرتبطة بالحدث، بتنسيق ISO 4217 المُكوَّن من 3 أحرف. * في حال ضبط السمة value ، ستكون currency مطلوبة
لاحتساب مقاييس الأرباح بدقة.
|
value |
number |
نعم* | 30.03 | القيمة النقدية للحدث. * اضبط value على مجموع (price * quantity) لكل العناصر في
items . لا تضمِّن shipping أو tax .
* تكون السمة value مطلوبة عادةً لإعداد تقارير ذات مغزى.
في حال وضع علامة
على الحدث كإحالة ناجحة، ننصحك بضبط
value .
* مطلوبة currency في حال ضبط value .
|
disqualified_lead_reason |
string |
لا | لا أريد الشراء | سبب وضع علامة على العميل المحتمل على أنّه غير مؤهَّل. |
items |
Array<Item>
|
لا | عناصر الحدث. |
مَعلمات العناصر
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
item_id |
string |
نعم* | SKU_12345 |
معرّف السلعة.
*يجب تحديد إما |
item_name |
string |
نعم* | قميص مُزيَّن بشخصيات كتاب Stan and Friends |
اسم السلعة.
*يجب تحديد إما |
affiliation |
string |
لا | Google Store |
ارتباط المنتج لتحديد الشركة التي يتم تقديمها أو الموقع الجغرافي للمتجر ملاحظة: لا يتوفّر "الارتباط" إلا على نطاق العنصر. |
coupon |
string |
لا | SUMMER_FUN | اسم/رمز القسيمة المرتبط بالسلعة. تكون مَعلمات coupon على مستوى الحدث وعلى مستوى السلعة
مستقلة.
|
creative_name |
string |
لا | summer_banner2 | اسم تصميم الإعلان الترويجي في حال ضبط هذه السياسة، يتم تجاهل السمة creative_name على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة creative_name على مستوى الحدث، إن توفّرت. |
creative_slot |
string |
لا | featured_app_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 |
لا | related_products | رقم تعريف القائمة التي تم فيها عرض السلعة للمستخدِم في حال ضبط هذه السياسة، يتم تجاهل السمة 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 |
لا | 10.01 |
سعر الوحدة النقدي للعنصر بوحدات مَعلمة العملة المحدّدة.
إذا كان هناك خصم ينطبق على السلعة، يجب ضبط price على سعر الوحدة المخفّض
وتحديد الخصم على سعر الوحدة في مَعلمة discount .
|
promotion_id |
string |
لا | P_12345 |
معرّف العرض الترويجي المرتبط بالسلعة. في حال ضبط هذه السياسة، يتم تجاهل السمة promotion_id على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة promotion_id على مستوى الحدث، إن توفّرت.
|
promotion_name |
string |
لا | تخفيضات موسم الصيف |
اسم العرض الترويجي المرتبط بالسلعة. في حال ضبط هذه السياسة، يتم تجاهل السمة promotion_name على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة promotion_name على مستوى الحدث، إن توفّرت.
|
quantity |
number |
لا | 3 |
كمية السلعة |
items
.
مثال
earn_virtual_currency
يقيس هذا الحدث عندما يتم منح المستخدم عملة افتراضية في لعبة. سجِّل ذلك مع spend_virtual_currency لفهم اقتصادك الافتراضي بشكل أفضل.
المعلمات
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
virtual_currency_name |
string |
لا | مجموعات تعليمات Gem | اسم العملة الافتراضية. |
value |
number |
لا | 5 | قيمة العملة الافتراضية. |
مثال
generate_lead
يقيس هذا الحدث وقت إنشاء عميل محتمل (على سبيل المثال، من خلال نموذج). عليك تسجيل ذلك لفهم مدى فعالية حملاتك التسويقية وعدد العملاء الذين يعيدون جذب العملاء إلى نشاطك التجاري بعد تجديد النشاط التسويقي.
المعلمات
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
currency |
string |
نعم* | USD |
عملة السلع المرتبطة بالحدث، بتنسيق ISO 4217 المُكوَّن من 3 أحرف. * في حال ضبط السمة value ، ستكون currency مطلوبة
لاحتساب مقاييس الأرباح بدقة.
|
value |
number |
نعم* | 30.03 | القيمة النقدية للحدث. * اضبط value على مجموع (price * quantity) لكل العناصر في
items . لا تضمِّن shipping أو tax .
* تكون السمة value مطلوبة عادةً لإعداد تقارير ذات مغزى.
في حال وضع علامة
على الحدث كإحالة ناجحة، ننصحك بضبط
value .
* مطلوبة currency في حال ضبط value .
|
lead_source |
string |
لا | معرض تجاري | مصدر العميل المحتمل. |
items |
Array<Item>
|
لا | عناصر الحدث. |
مَعلمات العناصر
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
item_id |
string |
نعم* | SKU_12345 |
معرّف السلعة.
*يجب تحديد إما |
item_name |
string |
نعم* | قميص مُزيَّن بشخصيات كتاب Stan and Friends |
اسم السلعة.
*يجب تحديد إما |
affiliation |
string |
لا | Google Store |
ارتباط المنتج لتحديد الشركة التي يتم تقديمها أو الموقع الجغرافي للمتجر ملاحظة: لا يتوفّر "الارتباط" إلا على نطاق العنصر. |
coupon |
string |
لا | SUMMER_FUN | اسم/رمز القسيمة المرتبط بالسلعة. تكون مَعلمات coupon على مستوى الحدث وعلى مستوى السلعة
مستقلة.
|
creative_name |
string |
لا | summer_banner2 | اسم تصميم الإعلان الترويجي في حال ضبط هذه السياسة، يتم تجاهل السمة creative_name على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة creative_name على مستوى الحدث، إن توفّرت. |
creative_slot |
string |
لا | featured_app_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 |
لا | related_products | رقم تعريف القائمة التي تم فيها عرض السلعة للمستخدِم في حال ضبط هذه السياسة، يتم تجاهل السمة 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 |
لا | 10.01 |
سعر الوحدة النقدي للعنصر بوحدات مَعلمة العملة المحدّدة.
إذا كان هناك خصم ينطبق على السلعة، يجب ضبط price على سعر الوحدة المخفّض
وتحديد الخصم على سعر الوحدة في مَعلمة discount .
|
promotion_id |
string |
لا | P_12345 |
معرّف العرض الترويجي المرتبط بالسلعة. في حال ضبط هذه السياسة، يتم تجاهل السمة promotion_id على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة promotion_id على مستوى الحدث، إن توفّرت.
|
promotion_name |
string |
لا | تخفيضات موسم الصيف |
اسم العرض الترويجي المرتبط بالسلعة. في حال ضبط هذه السياسة، يتم تجاهل السمة promotion_name على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة promotion_name على مستوى الحدث، إن توفّرت.
|
quantity |
number |
لا | 3 |
كمية السلعة |
items
.
مثال
join_group
يمكنك تسجيل هذا الحدث عندما ينضم مستخدم إلى مجموعة، مثل رابطة أو فريق أو عائلة. استخدِم هذا الحدث لتحليل مدى رواج مجموعات أو ميزات اجتماعية معيّنة.
المعلمات
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
group_id |
string |
لا | G_12345 | رقم تعريف المجموعة. |
مثال
level_end
يشير هذا الحدث إلى وصول اللاعب إلى نهاية مستوى في لعبة.
المعلمات
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
level_name |
string |
لا | تبدأ الرحلة... | تمثّل هذه السمة اسم المستوى. |
success |
boolean |
لا | صحيح | اضبط القيمة على true في حال إكمال المستوى بنجاح. |
مثال
level_start
يشير هذا الحدث إلى بدء لاعب أحد المستويات في لعبة.
المعلمات
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
level_name |
string |
لا | تبدأ الرحلة... | تمثّل هذه السمة اسم المستوى. |
مثال
level_up
يشير هذا الحدث إلى انتقال اللاعب إلى مستوى أعلى في لعبة. ويمكنك استخدامه لقياس توزيع مستويات قاعدة المستخدمين وتحديد المستويات التي يصعب إكمالها.
المعلمات
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
level |
number |
لا | 5 | مستوى الشخصية. |
character |
string |
لا | لاعب رقم 1 | الشخصية التي ارتقت إلى مستوى أعلى. |
مثال
تسجيل دخول
أرسِل هذا الحدث للإشارة إلى أنّ المستخدِم قد سجَّل الدخول إلى موقعك الإلكتروني أو تطبيقك.
المعلمات
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
method |
string |
لا | الطريقة المستخدمة لتسجيل الدخول. |
مثال
post_score
يمكنك إرسال هذا الحدث عندما ينشر المستخدم نتيجة. يمكنك الاستفادة من هذا الحدث لفهم أداء المستخدمين في لعبتك وربط أعلى النتائج بالجماهير أو السلوكيات.
المعلمات
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
score |
number |
Yes | 10000 | النتيجة التي سيتم نشرها. |
level |
number |
لا | 5 | تمثّل هذه السمة مستوى النتيجة. |
character |
string |
لا | لاعب رقم 1 | الشخصية التي حققت النتيجة. |
مثال
purchase
يشير هذا الحدث إلى شراء المستخدِم لسلعة واحدة أو أكثر.
المعلمات
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
currency |
string |
نعم* | USD |
عملة السلع المرتبطة بالحدث، بتنسيق ISO 4217 المُكوَّن من 3 أحرف. * في حال ضبط السمة value ، ستكون currency مطلوبة
لاحتساب مقاييس الأرباح بدقة.
|
value |
number |
نعم* | 30.03 | القيمة النقدية للحدث. * اضبط value على مجموع (price * quantity) لكل العناصر في
items . لا تضمِّن shipping أو tax .
* تكون السمة value مطلوبة عادةً لإعداد تقارير ذات مغزى.
في حال وضع علامة
على الحدث كإحالة ناجحة، ننصحك بضبط
value .
* مطلوبة currency في حال ضبط value .
|
transaction_id |
string |
Yes | T_12345 | المعرّف الفريد للمعاملة. تساعدك المَعلمة transaction_id في تجنُّب الحصول على أحداث مكرّرة لعملية شراء. |
coupon |
string |
لا | SUMMER_FUN | اسم/رمز القسيمة المرتبط بالحدث. تكون مَعلمات coupon على مستوى الحدث وعلى مستوى السلعة
مستقلة.
|
shipping |
number |
لا | 3.33 | تكلفة الشحن المرتبطة بمعاملة معيّنة |
tax |
number |
لا | 1.11 | تكلفة الضريبة المرتبطة بمعاملة معيّنة. |
items |
Array<Item> |
Yes | عناصر الحدث. |
مَعلمات العناصر
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
item_id |
string |
نعم* | SKU_12345 |
معرّف السلعة.
*يجب تحديد إما |
item_name |
string |
نعم* | قميص مُزيَّن بشخصيات كتاب Stan and Friends |
اسم السلعة.
*يجب تحديد إما |
affiliation |
string |
لا | Google Store |
ارتباط المنتج لتحديد الشركة التي يتم تقديمها أو الموقع الجغرافي للمتجر ملاحظة: لا يتوفّر "الارتباط" إلا على نطاق العنصر. |
coupon |
string |
لا | SUMMER_FUN | اسم/رمز القسيمة المرتبط بالسلعة. تكون مَعلمات coupon على مستوى الحدث وعلى مستوى السلعة
مستقلة.
|
creative_name |
string |
لا | summer_banner2 | اسم تصميم الإعلان الترويجي في حال ضبط هذه السياسة، يتم تجاهل السمة creative_name على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة creative_name على مستوى الحدث، إن توفّرت. |
creative_slot |
string |
لا | featured_app_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 |
لا | related_products | رقم تعريف القائمة التي تم فيها عرض السلعة للمستخدِم في حال ضبط هذه السياسة، يتم تجاهل السمة 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 |
لا | 10.01 |
سعر الوحدة النقدي للعنصر بوحدات مَعلمة العملة المحدّدة.
إذا كان هناك خصم ينطبق على السلعة، يجب ضبط price على سعر الوحدة المخفّض
وتحديد الخصم على سعر الوحدة في مَعلمة discount .
|
promotion_id |
string |
لا | P_12345 |
معرّف العرض الترويجي المرتبط بالسلعة. في حال ضبط هذه السياسة، يتم تجاهل السمة promotion_id على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة promotion_id على مستوى الحدث، إن توفّرت.
|
promotion_name |
string |
لا | تخفيضات موسم الصيف |
اسم العرض الترويجي المرتبط بالسلعة. في حال ضبط هذه السياسة، يتم تجاهل السمة promotion_name على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة promotion_name على مستوى الحدث، إن توفّرت.
|
quantity |
number |
لا | 3 |
كمية السلعة |
items
.
مثال
qualify_lead
يقيس هذا الحدث عندما يتم وضع علامة على مستخدم على أنّه يستوفي المعايير ليصبح عميلاً محتملاً مؤهَّلاً.
المعلمات
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
currency |
string |
نعم* | USD |
عملة السلع المرتبطة بالحدث، بتنسيق ISO 4217 المُكوَّن من 3 أحرف. * في حال ضبط السمة value ، ستكون currency مطلوبة
لاحتساب مقاييس الأرباح بدقة.
|
value |
number |
نعم* | 30.03 | القيمة النقدية للحدث. * اضبط value على مجموع (price * quantity) لكل العناصر في
items . لا تضمِّن shipping أو tax .
* تكون السمة value مطلوبة عادةً لإعداد تقارير ذات مغزى.
في حال وضع علامة
على الحدث كإحالة ناجحة، ننصحك بضبط
value .
* مطلوبة currency في حال ضبط value .
|
items |
Array<Item>
|
لا | عناصر الحدث. |
مَعلمات العناصر
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
item_id |
string |
نعم* | SKU_12345 |
معرّف السلعة.
*يجب تحديد إما |
item_name |
string |
نعم* | قميص مُزيَّن بشخصيات كتاب Stan and Friends |
اسم السلعة.
*يجب تحديد إما |
affiliation |
string |
لا | Google Store |
ارتباط المنتج لتحديد الشركة التي يتم تقديمها أو الموقع الجغرافي للمتجر ملاحظة: لا يتوفّر "الارتباط" إلا على نطاق العنصر. |
coupon |
string |
لا | SUMMER_FUN | اسم/رمز القسيمة المرتبط بالسلعة. تكون مَعلمات coupon على مستوى الحدث وعلى مستوى السلعة
مستقلة.
|
creative_name |
string |
لا | summer_banner2 | اسم تصميم الإعلان الترويجي في حال ضبط هذه السياسة، يتم تجاهل السمة creative_name على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة creative_name على مستوى الحدث، إن توفّرت. |
creative_slot |
string |
لا | featured_app_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 |
لا | related_products | رقم تعريف القائمة التي تم فيها عرض السلعة للمستخدِم في حال ضبط هذه السياسة، يتم تجاهل السمة 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 |
لا | 10.01 |
سعر الوحدة النقدي للعنصر بوحدات مَعلمة العملة المحدّدة.
إذا كان هناك خصم ينطبق على السلعة، يجب ضبط price على سعر الوحدة المخفّض
وتحديد الخصم على سعر الوحدة في مَعلمة discount .
|
promotion_id |
string |
لا | P_12345 |
معرّف العرض الترويجي المرتبط بالسلعة. في حال ضبط هذه السياسة، يتم تجاهل السمة promotion_id على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة promotion_id على مستوى الحدث، إن توفّرت.
|
promotion_name |
string |
لا | تخفيضات موسم الصيف |
اسم العرض الترويجي المرتبط بالسلعة. في حال ضبط هذه السياسة، يتم تجاهل السمة promotion_name على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة promotion_name على مستوى الحدث، إن توفّرت.
|
quantity |
number |
لا | 3 |
كمية السلعة |
items
.
مثال
refund
يشير هذا الحدث إلى ردّ أموال عنصر واحد أو أكثر إلى أحد المستخدمين.
المعلمات
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
currency |
string |
نعم* | USD |
عملة السلع المرتبطة بالحدث، بتنسيق ISO 4217 المُكوَّن من 3 أحرف. * في حال ضبط السمة value ، ستكون currency مطلوبة
لاحتساب مقاييس الأرباح بدقة.
|
transaction_id |
string |
Yes | T_12345 | المعرّف الفريد للمعاملة. |
value |
number |
نعم* | 30.03 | القيمة النقدية للحدث. * اضبط value على مجموع (price * quantity) لكل العناصر في
items . لا تضمِّن shipping أو tax .
* تكون السمة value مطلوبة عادةً لإعداد تقارير ذات مغزى.
في حال وضع علامة
على الحدث كإحالة ناجحة، ننصحك بضبط
value .
* مطلوبة currency في حال ضبط value .
|
coupon |
string |
لا | SUMMER_FUN | اسم/رمز القسيمة المرتبط بالحدث. تكون مَعلمات coupon على مستوى الحدث وعلى مستوى السلعة
مستقلة.
|
shipping |
number |
لا | 3.33 | تكلفة الشحن المرتبطة بمعاملة معيّنة |
tax |
number |
لا | 1.11 | تكلفة الضريبة المرتبطة بمعاملة معيّنة. |
items |
Array<Item>
|
لا* | عناصر الحدث. |
مَعلمات العناصر
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
item_id |
string |
نعم* | SKU_12345 |
معرّف السلعة.
*يجب تحديد إما |
item_name |
string |
نعم* | قميص مُزيَّن بشخصيات كتاب Stan and Friends |
اسم السلعة.
*يجب تحديد إما |
affiliation |
string |
لا | Google Store |
ارتباط المنتج لتحديد الشركة التي يتم تقديمها أو الموقع الجغرافي للمتجر ملاحظة: لا يتوفّر "الارتباط" إلا على نطاق العنصر. |
coupon |
string |
لا | SUMMER_FUN | اسم/رمز القسيمة المرتبط بالسلعة. تكون مَعلمات coupon على مستوى الحدث وعلى مستوى السلعة
مستقلة.
|
creative_name |
string |
لا | summer_banner2 | اسم تصميم الإعلان الترويجي في حال ضبط هذه السياسة، يتم تجاهل السمة creative_name على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة creative_name على مستوى الحدث، إن توفّرت. |
creative_slot |
string |
لا | featured_app_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 |
لا | related_products | رقم تعريف القائمة التي تم فيها عرض السلعة للمستخدِم في حال ضبط هذه السياسة، يتم تجاهل السمة 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 |
لا | 10.01 |
سعر الوحدة النقدي للعنصر بوحدات مَعلمة العملة المحدّدة.
إذا كان هناك خصم ينطبق على السلعة، يجب ضبط price على سعر الوحدة المخفّض
وتحديد الخصم على سعر الوحدة في مَعلمة discount .
|
promotion_id |
string |
لا | P_12345 |
معرّف العرض الترويجي المرتبط بالسلعة. في حال ضبط هذه السياسة، يتم تجاهل السمة promotion_id على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة promotion_id على مستوى الحدث، إن توفّرت.
|
promotion_name |
string |
لا | تخفيضات موسم الصيف |
اسم العرض الترويجي المرتبط بالسلعة. في حال ضبط هذه السياسة، يتم تجاهل السمة promotion_name على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة promotion_name على مستوى الحدث، إن توفّرت.
|
quantity |
number |
لا | 3 |
كمية السلعة |
items
.
مثال
remove_from_cart
يشير هذا الحدث إلى إزالة سلعة من سلة تسوّق.
المعلمات
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
currency |
string |
نعم* | USD |
عملة السلع المرتبطة بالحدث، بتنسيق ISO 4217 المُكوَّن من 3 أحرف. * في حال ضبط السمة value ، ستكون currency مطلوبة
لاحتساب مقاييس الأرباح بدقة.
|
value |
number |
نعم* | 30.03 | القيمة النقدية للحدث. * اضبط value على مجموع (price * quantity) لكل العناصر في
items . لا تضمِّن shipping أو tax .
* تكون السمة value مطلوبة عادةً لإعداد تقارير ذات مغزى.
في حال وضع علامة
على الحدث كإحالة ناجحة، ننصحك بضبط
value .
* مطلوبة currency في حال ضبط value .
|
items |
Array<Item> |
Yes | عناصر الحدث. |
مَعلمات العناصر
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
item_id |
string |
نعم* | SKU_12345 |
معرّف السلعة.
*يجب تحديد إما |
item_name |
string |
نعم* | قميص مُزيَّن بشخصيات كتاب Stan and Friends |
اسم السلعة.
*يجب تحديد إما |
affiliation |
string |
لا | Google Store |
ارتباط المنتج لتحديد الشركة التي يتم تقديمها أو الموقع الجغرافي للمتجر ملاحظة: لا يتوفّر "الارتباط" إلا على نطاق العنصر. |
coupon |
string |
لا | SUMMER_FUN | اسم/رمز القسيمة المرتبط بالسلعة. تكون مَعلمات coupon على مستوى الحدث وعلى مستوى السلعة
مستقلة.
|
creative_name |
string |
لا | summer_banner2 | اسم تصميم الإعلان الترويجي في حال ضبط هذه السياسة، يتم تجاهل السمة creative_name على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة creative_name على مستوى الحدث، إن توفّرت. |
creative_slot |
string |
لا | featured_app_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 |
لا | related_products | رقم تعريف القائمة التي تم فيها عرض السلعة للمستخدِم في حال ضبط هذه السياسة، يتم تجاهل السمة 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 |
لا | 10.01 |
سعر الوحدة النقدي للعنصر بوحدات مَعلمة العملة المحدّدة.
إذا كان هناك خصم ينطبق على السلعة، يجب ضبط price على سعر الوحدة المخفّض
وتحديد الخصم على سعر الوحدة في مَعلمة discount .
|
promotion_id |
string |
لا | P_12345 |
معرّف العرض الترويجي المرتبط بالسلعة. في حال ضبط هذه السياسة، يتم تجاهل السمة promotion_id على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة promotion_id على مستوى الحدث، إن توفّرت.
|
promotion_name |
string |
لا | تخفيضات موسم الصيف |
اسم العرض الترويجي المرتبط بالسلعة. في حال ضبط هذه السياسة، يتم تجاهل السمة promotion_name على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة promotion_name على مستوى الحدث، إن توفّرت.
|
quantity |
number |
لا | 3 |
كمية السلعة |
items
.
مثال
search
يمكنك تسجيل هذا الحدث للإشارة إلى الوقت الذي أجرى فيه المستخدم عملية بحث. يمكنك استخدام هذا الحدث لتحديد ما يبحث عنه المستخدِمون على موقعك الإلكتروني أو تطبيقك. على سبيل المثال، يمكنك إرسال هذا الحدث عندما يطّلع مستخدم على صفحة نتائج بحث بعد إجراء عملية بحث.
المعلمات
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
search_term |
string |
Yes | قمصان | العبارة التي تم البحث عنها. |
مثال
select_content
يشير هذا الحدث إلى أنّ المستخدم قد اختار بعض المحتوى من نوع معيّن. يمكن أن يساعدك هذا الحدث في تحديد المحتوى الرائج وفئات المحتوى على موقعك الإلكتروني أو تطبيقك.
المعلمات
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
content_type |
string |
لا | المنتج | نوع المحتوى المحدد. |
content_id |
string |
لا | C_12345 | معرّف للمحتوى الذي تم اختياره |
مثال
select_item
يشير هذا الحدث إلى أنّه تم اختيار عنصر من قائمة.
المعلمات
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
item_list_id |
string |
لا | related_products | رقم تعريف القائمة التي تم فيها عرض السلعة للمستخدِم يتم تجاهل السياسة في حال ضبطها على مستوى العنصر. |
item_list_name |
string |
لا | منتجات ذات صلة | اسم القائمة التي تم فيها عرض السلعة للمستخدِم يتم تجاهل السياسة في حال ضبطها على مستوى العنصر. |
items |
Array<Item> |
نعم* | عناصر الحدث. * من المتوقّع أن يحتوي المصفوفة items على عنصر
واحد يمثّل العنصر الذي تم اختياره. وإذا توفّرت عدة عناصر، سيتم استخدام العنصر الأول فقط في items .
|
مَعلمات العناصر
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
item_id |
string |
نعم* | SKU_12345 |
معرّف السلعة.
*يجب تحديد إما |
item_name |
string |
نعم* | قميص مُزيَّن بشخصيات كتاب Stan and Friends |
اسم السلعة.
*يجب تحديد إما |
affiliation |
string |
لا | Google Store |
ارتباط المنتج لتحديد الشركة التي يتم تقديمها أو الموقع الجغرافي للمتجر ملاحظة: لا يتوفّر "الارتباط" إلا على نطاق العنصر. |
coupon |
string |
لا | SUMMER_FUN | اسم/رمز القسيمة المرتبط بالسلعة. تكون مَعلمات coupon على مستوى الحدث وعلى مستوى السلعة
مستقلة.
|
creative_name |
string |
لا | summer_banner2 | اسم تصميم الإعلان الترويجي في حال ضبط هذه السياسة، يتم تجاهل السمة creative_name على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة creative_name على مستوى الحدث، إن توفّرت. |
creative_slot |
string |
لا | featured_app_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 |
لا | related_products | رقم تعريف القائمة التي تم فيها عرض السلعة للمستخدِم في حال ضبط هذه السياسة، يتم تجاهل السمة 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 |
لا | 10.01 |
سعر الوحدة النقدي للعنصر بوحدات مَعلمة العملة المحدّدة.
إذا كان هناك خصم ينطبق على السلعة، يجب ضبط price على سعر الوحدة المخفّض
وتحديد الخصم على سعر الوحدة في مَعلمة discount .
|
promotion_id |
string |
لا | P_12345 |
معرّف العرض الترويجي المرتبط بالسلعة. في حال ضبط هذه السياسة، يتم تجاهل السمة promotion_id على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة promotion_id على مستوى الحدث، إن توفّرت.
|
promotion_name |
string |
لا | تخفيضات موسم الصيف |
اسم العرض الترويجي المرتبط بالسلعة. في حال ضبط هذه السياسة، يتم تجاهل السمة promotion_name على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة promotion_name على مستوى الحدث، إن توفّرت.
|
quantity |
number |
لا | 3 |
كمية السلعة |
items
.
مثال
select_promotion
يشير هذا الحدث إلى أنّه تم اختيار عرض ترويجي من قائمة.
المعلمات
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
creative_name |
string |
لا | summer_banner2 | اسم تصميم الإعلان الترويجي يتم تجاهل السياسة في حال ضبطها على مستوى العنصر. |
creative_slot |
string |
لا | featured_app_1 | اسم خانة تصميم الإعلان الترويجي المرتبطة بالفعالية. يتم تجاهل السياسة في حال ضبطها على مستوى العنصر. |
promotion_id |
string |
لا | P_12345 |
رقم تعريف العرض الترويجي المرتبط بالحدث. يتم تجاهل السياسة في حال ضبطها على مستوى العنصر. |
promotion_name |
string |
لا | تخفيضات موسم الصيف |
اسم العرض الترويجي المرتبط بالحدث. يتم تجاهل السياسة في حال ضبطها على مستوى العنصر. |
items |
Array<Item>
|
لا | عناصر الحدث. |
مَعلمات العناصر
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
item_id |
string |
نعم* | SKU_12345 |
معرّف السلعة.
*يجب تحديد إما |
item_name |
string |
نعم* | قميص مُزيَّن بشخصيات كتاب Stan and Friends |
اسم السلعة.
*يجب تحديد إما |
affiliation |
string |
لا | Google Store |
ارتباط المنتج لتحديد الشركة التي يتم تقديمها أو الموقع الجغرافي للمتجر ملاحظة: لا يتوفّر "الارتباط" إلا على نطاق العنصر. |
coupon |
string |
لا | SUMMER_FUN | اسم/رمز القسيمة المرتبط بالسلعة. تكون مَعلمات coupon على مستوى الحدث وعلى مستوى السلعة
مستقلة.
|
creative_name |
string |
لا | summer_banner2 | اسم تصميم الإعلان الترويجي في حال ضبط هذه السياسة، يتم تجاهل السمة creative_name على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة creative_name على مستوى الحدث، إن توفّرت. |
creative_slot |
string |
لا | featured_app_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 |
لا | related_products | رقم تعريف القائمة التي تم فيها عرض السلعة للمستخدِم في حال ضبط هذه السياسة، يتم تجاهل السمة 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 |
لا | 10.01 |
سعر الوحدة النقدي للعنصر بوحدات مَعلمة العملة المحدّدة.
إذا كان هناك خصم ينطبق على السلعة، يجب ضبط price على سعر الوحدة المخفّض
وتحديد الخصم على سعر الوحدة في مَعلمة discount .
|
promotion_id |
string |
لا | P_12345 |
معرّف العرض الترويجي المرتبط بالسلعة. في حال ضبط هذه السياسة، يتم تجاهل السمة promotion_id على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة promotion_id على مستوى الحدث، إن توفّرت.
|
promotion_name |
string |
لا | تخفيضات موسم الصيف |
اسم العرض الترويجي المرتبط بالسلعة. في حال ضبط هذه السياسة، يتم تجاهل السمة promotion_name على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة promotion_name على مستوى الحدث، إن توفّرت.
|
quantity |
number |
لا | 3 |
كمية السلعة |
items
.
مثال
مشاركة
استخدِم هذا الحدث عندما يشارك المستخدم محتوى.
المعلمات
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
method |
string |
لا | تمثّل هذه السمة الطريقة التي تتم بها مشاركة المحتوى. | |
content_type |
string |
لا | صورة | نوع المحتوى الذي تمت مشاركته. |
item_id |
string |
لا | C_12345 | رقم تعريف المحتوى الذي تمت مشاركته. |
مثال
sign_up
يشير هذا الحدث إلى اشتراك مستخدِم في حساب. استخدِم هذا الحدث لفهم السلوكيات المختلفة للمستخدمين الذين سجّلوا دخولهم أو خروجهم.
المعلمات
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
method |
string |
لا | الطريقة المستخدمة للاشتراك. |
مثال
spend_virtual_currency
يقيس هذا الحدث بيع السلع الافتراضية في تطبيقك ويساعدك على تحديد السلع الافتراضية الأكثر شيوعًا.
المعلمات
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
value |
number |
Yes | 5 | قيمة العملة الافتراضية. |
virtual_currency_name |
string |
Yes | مجموعات تعليمات Gem | اسم العملة الافتراضية. |
item_name |
string |
لا | تعزيز التفعيل | اسم العنصر الذي يتم استخدام العملة الافتراضية له. |
مثال
tutorial_begin
تشير هذه الفعالية إلى بدء عملية الإعداد. يمكنك استخدام هذا المسار في مسار إحالة ناجحة يتضمّن tutorial_complete لمعرفة عدد المستخدمين الذين أكملوا الدليل التوجيهي.
المعلمات
ما مِن مَعلمات لهذا الحدث.
مثال
tutorial_complete
يشير هذا الحدث إلى أنّ المستخدم قد أكمل عملية الإعداد. يمكنك استخدام ذلك في مسار إحالة ناجحة يتضمّن tutorial_begin لمعرفة عدد المستخدمين الذين أكملوا البرنامج التعليمي.
المعلمات
لم يتم اقتراح مَعلمات لهذا الحدث.
مثال
unlock_achievement
تسجيل هذا الحدث عندما فتح المستخدم إنجازًا يمكن أن يساعدك هذا الحدث في فهم تجربة المستخدمين للعبتك.
المعلمات
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
achievement_id |
string |
Yes | A_12345 | رقم تعريف الإنجاز الذي تم فتحه. |
مثال
view_cart
يشير هذا الحدث إلى أنّ أحد المستخدمين قد شاهد سلة التسوّق.
المعلمات
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
currency |
string |
نعم* | USD |
عملة السلع المرتبطة بالحدث، بتنسيق ISO 4217 المُكوَّن من 3 أحرف. * في حال ضبط السمة value ، ستكون currency مطلوبة
لاحتساب مقاييس الأرباح بدقة.
|
value |
number |
نعم* | 30.03 | القيمة النقدية للحدث. * اضبط value على مجموع (price * quantity) لكل العناصر في
items . لا تضمِّن shipping أو tax .
* تكون السمة value مطلوبة عادةً لإعداد تقارير ذات مغزى.
في حال وضع علامة
على الحدث كإحالة ناجحة، ننصحك بضبط
value .
* مطلوبة currency في حال ضبط value .
|
items |
Array<Item> |
Yes | عناصر الحدث. |
مَعلمات العناصر
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
item_id |
string |
نعم* | SKU_12345 |
معرّف السلعة.
*يجب تحديد إما |
item_name |
string |
نعم* | قميص مُزيَّن بشخصيات كتاب Stan and Friends |
اسم السلعة.
*يجب تحديد إما |
affiliation |
string |
لا | Google Store |
ارتباط المنتج لتحديد الشركة التي يتم تقديمها أو الموقع الجغرافي للمتجر ملاحظة: لا يتوفّر "الارتباط" إلا على نطاق العنصر. |
coupon |
string |
لا | SUMMER_FUN | اسم/رمز القسيمة المرتبط بالسلعة. تكون مَعلمات coupon على مستوى الحدث وعلى مستوى السلعة
مستقلة.
|
creative_name |
string |
لا | summer_banner2 | اسم تصميم الإعلان الترويجي في حال ضبط هذه السياسة، يتم تجاهل السمة creative_name على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة creative_name على مستوى الحدث، إن توفّرت. |
creative_slot |
string |
لا | featured_app_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 |
لا | related_products | رقم تعريف القائمة التي تم فيها عرض السلعة للمستخدِم في حال ضبط هذه السياسة، يتم تجاهل السمة 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 |
لا | 10.01 |
سعر الوحدة النقدي للعنصر بوحدات مَعلمة العملة المحدّدة.
إذا كان هناك خصم ينطبق على السلعة، يجب ضبط price على سعر الوحدة المخفّض
وتحديد الخصم على سعر الوحدة في مَعلمة discount .
|
promotion_id |
string |
لا | P_12345 |
معرّف العرض الترويجي المرتبط بالسلعة. في حال ضبط هذه السياسة، يتم تجاهل السمة promotion_id على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة promotion_id على مستوى الحدث، إن توفّرت.
|
promotion_name |
string |
لا | تخفيضات موسم الصيف |
اسم العرض الترويجي المرتبط بالسلعة. في حال ضبط هذه السياسة، يتم تجاهل السمة promotion_name على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة promotion_name على مستوى الحدث، إن توفّرت.
|
quantity |
number |
لا | 3 |
كمية السلعة |
items
.
مثال
view_item
يشير هذا الحدث إلى أنّه تم عرض بعض المحتوى للمستخدم. استخدِم هذا الحدث للاطّلاع على العناصر الأكثر رواجًا التي تمت مشاهدتها.
المعلمات
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
currency |
string |
نعم* | USD |
عملة السلع المرتبطة بالحدث، بتنسيق ISO 4217 المُكوَّن من 3 أحرف. * في حال ضبط السمة value ، ستكون currency مطلوبة
لاحتساب مقاييس الأرباح بدقة.
|
value |
number |
نعم* | 30.03 | القيمة النقدية للحدث. * اضبط value على مجموع (price * quantity) لكل العناصر في
items . لا تضمِّن shipping أو tax .
* تكون السمة value مطلوبة عادةً لإعداد تقارير ذات مغزى.
في حال وضع علامة
على الحدث كإحالة ناجحة، ننصحك بضبط
value .
* مطلوبة currency في حال ضبط value .
|
items |
Array<Item> |
Yes | عناصر الحدث. |
مَعلمات العناصر
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
item_id |
string |
نعم* | SKU_12345 |
معرّف السلعة.
*يجب تحديد إما |
item_name |
string |
نعم* | قميص مُزيَّن بشخصيات كتاب Stan and Friends |
اسم السلعة.
*يجب تحديد إما |
affiliation |
string |
لا | Google Store |
ارتباط المنتج لتحديد الشركة التي يتم تقديمها أو الموقع الجغرافي للمتجر ملاحظة: لا يتوفّر "الارتباط" إلا على نطاق العنصر. |
coupon |
string |
لا | SUMMER_FUN | اسم/رمز القسيمة المرتبط بالسلعة. تكون مَعلمات coupon على مستوى الحدث وعلى مستوى السلعة
مستقلة.
|
creative_name |
string |
لا | summer_banner2 | اسم تصميم الإعلان الترويجي في حال ضبط هذه السياسة، يتم تجاهل السمة creative_name على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة creative_name على مستوى الحدث، إن توفّرت. |
creative_slot |
string |
لا | featured_app_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 |
لا | related_products | رقم تعريف القائمة التي تم فيها عرض السلعة للمستخدِم في حال ضبط هذه السياسة، يتم تجاهل السمة 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 |
لا | 10.01 |
سعر الوحدة النقدي للعنصر بوحدات مَعلمة العملة المحدّدة.
إذا كان هناك خصم ينطبق على السلعة، يجب ضبط price على سعر الوحدة المخفّض
وتحديد الخصم على سعر الوحدة في مَعلمة discount .
|
promotion_id |
string |
لا | P_12345 |
معرّف العرض الترويجي المرتبط بالسلعة. في حال ضبط هذه السياسة، يتم تجاهل السمة promotion_id على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة promotion_id على مستوى الحدث، إن توفّرت.
|
promotion_name |
string |
لا | تخفيضات موسم الصيف |
اسم العرض الترويجي المرتبط بالسلعة. في حال ضبط هذه السياسة، يتم تجاهل السمة promotion_name على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة promotion_name على مستوى الحدث، إن توفّرت.
|
quantity |
number |
لا | 3 |
كمية السلعة |
items
.
مثال
view_item_list
يمكنك تسجيل هذا الحدث عندما يتم عرض قائمة بالعناصر من فئة معيّنة للمستخدم.
المعلمات
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
item_list_id |
string |
لا | related_products | رقم تعريف القائمة التي تم فيها عرض السلعة للمستخدِم يتم تجاهل السياسة في حال ضبطها على مستوى العنصر. |
item_list_name |
string |
لا | منتجات ذات صلة | اسم القائمة التي تم فيها عرض السلعة للمستخدِم يتم تجاهل السياسة في حال ضبطها على مستوى العنصر. |
items |
Array<Item> |
Yes | عناصر الحدث. |
مَعلمات العناصر
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
item_id |
string |
نعم* | SKU_12345 |
معرّف السلعة.
*يجب تحديد إما |
item_name |
string |
نعم* | قميص مُزيَّن بشخصيات كتاب Stan and Friends |
اسم السلعة.
*يجب تحديد إما |
affiliation |
string |
لا | Google Store |
ارتباط المنتج لتحديد الشركة التي يتم تقديمها أو الموقع الجغرافي للمتجر ملاحظة: لا يتوفّر "الارتباط" إلا على نطاق العنصر. |
coupon |
string |
لا | SUMMER_FUN | اسم/رمز القسيمة المرتبط بالسلعة. تكون مَعلمات coupon على مستوى الحدث وعلى مستوى السلعة
مستقلة.
|
creative_name |
string |
لا | summer_banner2 | اسم تصميم الإعلان الترويجي في حال ضبط هذه السياسة، يتم تجاهل السمة creative_name على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة creative_name على مستوى الحدث، إن توفّرت. |
creative_slot |
string |
لا | featured_app_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 |
لا | related_products | رقم تعريف القائمة التي تم فيها عرض السلعة للمستخدِم في حال ضبط هذه السياسة، يتم تجاهل السمة 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 |
لا | 10.01 |
سعر الوحدة النقدي للعنصر بوحدات مَعلمة العملة المحدّدة.
إذا كان هناك خصم ينطبق على السلعة، يجب ضبط price على سعر الوحدة المخفّض
وتحديد الخصم على سعر الوحدة في مَعلمة discount .
|
promotion_id |
string |
لا | P_12345 |
معرّف العرض الترويجي المرتبط بالسلعة. في حال ضبط هذه السياسة، يتم تجاهل السمة promotion_id على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة promotion_id على مستوى الحدث، إن توفّرت.
|
promotion_name |
string |
لا | تخفيضات موسم الصيف |
اسم العرض الترويجي المرتبط بالسلعة. في حال ضبط هذه السياسة، يتم تجاهل السمة promotion_name على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة promotion_name على مستوى الحدث، إن توفّرت.
|
quantity |
number |
لا | 3 |
كمية السلعة |
items
.
مثال
view_promotion
يشير هذا الحدث إلى أنّه تم عرض عرض ترويجي من قائمة.
المعلمات
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
creative_name |
string |
لا | summer_banner2 | اسم تصميم الإعلان الترويجي يتم تجاهل السياسة في حال ضبطها على مستوى العنصر. |
creative_slot |
string |
لا | featured_app_1 | اسم خانة تصميم الإعلان الترويجي المرتبطة بالفعالية. يتم تجاهل السياسة في حال ضبطها على مستوى العنصر. |
promotion_id |
string |
لا | P_12345 |
رقم تعريف العرض الترويجي المرتبط بالحدث. يتم تجاهل السياسة في حال ضبطها على مستوى العنصر. |
promotion_name |
string |
لا | تخفيضات موسم الصيف |
اسم العرض الترويجي المرتبط بالحدث. يتم تجاهل السياسة في حال ضبطها على مستوى العنصر. |
items |
Array<Item> |
نعم* | عناصر الحدث. * من المتوقّع أن تحتوي المصفوفة items على عنصر
واحد يمثّل السلعة المرتبطة بالعرض الترويجي. وإذا توفّرت عدة عناصر، سيتم استخدام العنصر الأول فقط في items .
|
مَعلمات العناصر
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
item_id |
string |
نعم* | SKU_12345 |
معرّف السلعة.
*يجب تحديد إما |
item_name |
string |
نعم* | قميص مُزيَّن بشخصيات كتاب Stan and Friends |
اسم السلعة.
*يجب تحديد إما |
affiliation |
string |
لا | Google Store |
ارتباط المنتج لتحديد الشركة التي يتم تقديمها أو الموقع الجغرافي للمتجر ملاحظة: لا يتوفّر "الارتباط" إلا على نطاق العنصر. |
coupon |
string |
لا | SUMMER_FUN | اسم/رمز القسيمة المرتبط بالسلعة. تكون مَعلمات coupon على مستوى الحدث وعلى مستوى السلعة
مستقلة.
|
creative_name |
string |
لا | summer_banner2 | اسم تصميم الإعلان الترويجي في حال ضبط هذه السياسة، يتم تجاهل السمة creative_name على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة creative_name على مستوى الحدث، إن توفّرت. |
creative_slot |
string |
لا | featured_app_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 |
لا | related_products | رقم تعريف القائمة التي تم فيها عرض السلعة للمستخدِم في حال ضبط هذه السياسة، يتم تجاهل السمة 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 |
لا | 10.01 |
سعر الوحدة النقدي للعنصر بوحدات مَعلمة العملة المحدّدة.
إذا كان هناك خصم ينطبق على السلعة، يجب ضبط price على سعر الوحدة المخفّض
وتحديد الخصم على سعر الوحدة في مَعلمة discount .
|
promotion_id |
string |
لا | P_12345 |
معرّف العرض الترويجي المرتبط بالسلعة. في حال ضبط هذه السياسة، يتم تجاهل السمة promotion_id على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة promotion_id على مستوى الحدث، إن توفّرت.
|
promotion_name |
string |
لا | تخفيضات موسم الصيف |
اسم العرض الترويجي المرتبط بالسلعة. في حال ضبط هذه السياسة، يتم تجاهل السمة promotion_name على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة promotion_name على مستوى الحدث، إن توفّرت.
|
quantity |
number |
لا | 3 |
كمية السلعة |
items
.
مثال
working_lead
يقيس هذا الحدث الحالات التي يتواصل فيها المستخدم مع أحد ممثليه أو عندما يتواصل معه أحد ممثليه.
المعلمات
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
currency |
string |
نعم* | USD |
عملة السلع المرتبطة بالحدث، بتنسيق ISO 4217 المُكوَّن من 3 أحرف. * في حال ضبط السمة value ، ستكون currency مطلوبة
لاحتساب مقاييس الأرباح بدقة.
|
value |
number |
نعم* | 30.03 | القيمة النقدية للحدث. * اضبط value على مجموع (price * quantity) لكل العناصر في
items . لا تضمِّن shipping أو tax .
* تكون السمة value مطلوبة عادةً لإعداد تقارير ذات مغزى.
في حال وضع علامة
على الحدث كإحالة ناجحة، ننصحك بضبط
value .
* مطلوبة currency في حال ضبط value .
|
lead_status |
string |
لا | المحادثات التي تم بدؤها | حالة العميل المحتمل. |
items |
Array<Item>
|
لا | عناصر الحدث. |
مَعلمات العناصر
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
item_id |
string |
نعم* | SKU_12345 |
معرّف السلعة.
*يجب تحديد إما |
item_name |
string |
نعم* | قميص مُزيَّن بشخصيات كتاب Stan and Friends |
اسم السلعة.
*يجب تحديد إما |
affiliation |
string |
لا | Google Store |
ارتباط المنتج لتحديد الشركة التي يتم تقديمها أو الموقع الجغرافي للمتجر ملاحظة: لا يتوفّر "الارتباط" إلا على نطاق العنصر. |
coupon |
string |
لا | SUMMER_FUN | اسم/رمز القسيمة المرتبط بالسلعة. تكون مَعلمات coupon على مستوى الحدث وعلى مستوى السلعة
مستقلة.
|
creative_name |
string |
لا | summer_banner2 | اسم تصميم الإعلان الترويجي في حال ضبط هذه السياسة، يتم تجاهل السمة creative_name على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة creative_name على مستوى الحدث، إن توفّرت. |
creative_slot |
string |
لا | featured_app_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 |
لا | related_products | رقم تعريف القائمة التي تم فيها عرض السلعة للمستخدِم في حال ضبط هذه السياسة، يتم تجاهل السمة 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 |
لا | 10.01 |
سعر الوحدة النقدي للعنصر بوحدات مَعلمة العملة المحدّدة.
إذا كان هناك خصم ينطبق على السلعة، يجب ضبط price على سعر الوحدة المخفّض
وتحديد الخصم على سعر الوحدة في مَعلمة discount .
|
promotion_id |
string |
لا | P_12345 |
معرّف العرض الترويجي المرتبط بالسلعة. في حال ضبط هذه السياسة، يتم تجاهل السمة promotion_id على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة promotion_id على مستوى الحدث، إن توفّرت.
|
promotion_name |
string |
لا | تخفيضات موسم الصيف |
اسم العرض الترويجي المرتبط بالسلعة. في حال ضبط هذه السياسة، يتم تجاهل السمة promotion_name على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة promotion_name على مستوى الحدث، إن توفّرت.
|
quantity |
number |
لا | 3 |
كمية السلعة |
items
.