يسرد هذا المرجع الأحداث المقترحة التي تتوافق مع علامات Google.
add_payment_info
يشير هذا الحدث إلى أن المستخدم قد أرسل معلومات الدفع.
المعلَمات
الاسم | النوع | مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
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> |
نعم | عناصر الحدث. |
معلّمات العناصر
الاسم | النوع | مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
item_id |
string |
نعم* | SKU_12345 |
معرّف العنصر.
*يجب استخدام إحدى السمتَين |
item_name |
string |
نعم* | تي شيرت لأصدقائها وأصدقائها |
اسم السلعة.
*يجب استخدام إحدى السمتَين |
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
يشير هذا الحدث إلى أنّ المستخدم قد أرسل معلومات الشحن.
المعلَمات
الاسم | النوع | مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
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> |
نعم | عناصر الحدث. |
معلّمات العناصر
الاسم | النوع | مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
item_id |
string |
نعم* | SKU_12345 |
معرّف العنصر.
*يجب استخدام إحدى السمتَين |
item_name |
string |
نعم* | تي شيرت لأصدقائها وأصدقائها |
اسم السلعة.
*يجب استخدام إحدى السمتَين |
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
يشير هذا الحدث إلى أنه تمت إضافة عنصر إلى سلة التسوق للشراء.
المعلَمات
الاسم | النوع | مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
currency |
string |
نعم* | USD |
تمثّل هذه السمة عملة العناصر المرتبطة بالفعالية بتنسيق
ISO 4217 المكوّن من 3 أحرف. * إذا ضبطت السمة value ، عليك استخدام السمة currency
لاحتساب إحصاءات الأرباح بدقة.
|
value |
number |
نعم* | 7,77 | القيمة النقدية للحدث. * عادةً ما يكون value مطلوبًا لإعداد تقارير مفيدة.
إذا وضعت علامة
على الحدث كإحالة ناجحة، ننصحك بإعداد
value .
* currency مطلوب في حالة تعيين value .
|
items |
Array<Item> |
نعم | عناصر الحدث. |
معلّمات العناصر
الاسم | النوع | مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
item_id |
string |
نعم* | SKU_12345 |
معرّف العنصر.
*يجب استخدام إحدى السمتَين |
item_name |
string |
نعم* | تي شيرت لأصدقائها وأصدقائها |
اسم السلعة.
*يجب استخدام إحدى السمتَين |
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
يشير الحدث إلى أنه تمت إضافة عنصر إلى قائمة المفضلات. استخدم هذا الحدث لتحديد هدايا شائعة في تطبيقك.
المعلَمات
الاسم | النوع | مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
currency |
string |
نعم* | USD |
تمثّل هذه السمة عملة العناصر المرتبطة بالفعالية بتنسيق
ISO 4217 المكوّن من 3 أحرف. * إذا ضبطت السمة value ، عليك استخدام السمة currency
لاحتساب إحصاءات الأرباح بدقة.
|
value |
number |
نعم* | 7,77 | القيمة النقدية للحدث. * عادةً ما يكون value مطلوبًا لإعداد تقارير مفيدة.
إذا وضعت علامة
على الحدث كإحالة ناجحة، ننصحك بإعداد
value .
* currency مطلوب في حالة تعيين value .
|
items |
Array<Item> |
نعم | عناصر الحدث. |
معلّمات العناصر
الاسم | النوع | مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
item_id |
string |
نعم* | SKU_12345 |
معرّف العنصر.
*يجب استخدام إحدى السمتَين |
item_name |
string |
نعم* | تي شيرت لأصدقائها وأصدقائها |
اسم السلعة.
*يجب استخدام إحدى السمتَين |
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
يشير هذا الحدث إلى أن المستخدم قد بدأ عملية دفع.
المعلَمات
الاسم | النوع | مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
currency |
string |
نعم* | USD |
تمثّل هذه السمة عملة العناصر المرتبطة بالفعالية بتنسيق
ISO 4217 المكوّن من 3 أحرف. * إذا ضبطت السمة value ، عليك استخدام السمة currency
لاحتساب إحصاءات الأرباح بدقة.
|
value |
number |
نعم* | 7,77 | القيمة النقدية للحدث. * عادةً ما يكون value مطلوبًا لإعداد تقارير مفيدة.
إذا وضعت علامة
على الحدث كإحالة ناجحة، ننصحك بإعداد
value .
* currency مطلوب في حالة تعيين value .
|
coupon |
string |
لا | الدالة SUMMER_FUN | اسم/رمز القسيمة المرتبط بالحدث. المعلّمات على مستوى الحدث والسلع على مستوى العنصر coupon
مستقلة.
|
items |
Array<Item> |
نعم | عناصر الحدث. |
معلّمات العناصر
الاسم | النوع | مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
item_id |
string |
نعم* | SKU_12345 |
معرّف العنصر.
*يجب استخدام إحدى السمتَين |
item_name |
string |
نعم* | تي شيرت لأصدقائها وأصدقائها |
اسم السلعة.
*يجب استخدام إحدى السمتَين |
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 لفهم اقتصادك الافتراضي بشكل أفضل.
المعلَمات
الاسم | النوع | مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
virtual_currency_name |
string |
لا | أحجار كريمة | اسم العملة الافتراضية. |
value |
number |
لا | 5 | قيمة العملة الافتراضية. |
الاستثناء
يتم تسجيل حدث استثناء عندما تتم مقاطعة التدفق العادي لتنفيذ التطبيق.
المعلَمات
الاسم | النوع | مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
description |
string |
لا | يجب إدخال الحقل المطلوب. | وصف الاستثناء الذي حدث. |
fatal |
boolean |
لا | true |
ما إذا كان الاستثناء فادحًا أم لا. |
generate_lead
سجّل هذا الحدث عند اكتساب عميل محتمل لاستيعاب مدى فاعلية حملات إعادة الجذب.
المعلَمات
الاسم | النوع | مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
currency |
string |
نعم* | USD |
تمثّل هذه السمة عملة العناصر المرتبطة بالفعالية بتنسيق
ISO 4217 المكوّن من 3 أحرف. * إذا ضبطت السمة value ، عليك استخدام السمة currency
لاحتساب إحصاءات الأرباح بدقة.
|
value |
number |
نعم* | 7,77 | القيمة النقدية للحدث. * عادةً ما يكون value مطلوبًا لإعداد تقارير مفيدة.
إذا وضعت علامة
على الحدث كإحالة ناجحة، ننصحك بإعداد
value .
* currency مطلوب في حالة تعيين value .
|
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 | الشخصية التي وصلت إلى مستوى أعلى. |
login
يمكنك إرسال هذا الحدث للدلالة على تسجيل المستخدم الدخول.
المعلَمات
الاسم | النوع | مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
method |
string |
لا | الطريقة المستخدمة لتسجيل الدخول. |
page_view
يشير هذا الحدث إلى أن المستخدم قد شاهد صفحة.
المعلَمات
الاسم | النوع | مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
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
أرسل هذا الحدث عندما ينشر المستخدم نتيجة. يمكنك استخدام هذا الحدث لفهم مستوى أداء المستخدمين في لعبتك وربط النتائج العالية بالجمهور أو السلوكيات.
المعلَمات
الاسم | النوع | مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
score |
number |
نعم | 10000 | النتيجة المطلوب نشرها. |
level |
number |
لا | 5 | مستوى النتيجة. |
character |
string |
لا | اللاعب رقم 1 | الشخصية التي حققت النتيجة. |
purchase
يشير هذا الحدث إلى الوقت الذي اشترى فيه مستخدم عنصرًا واحدًا أو أكثر.
المعلَمات
الاسم | النوع | مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
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 |
لا | 1,11 | تكلفة الضريبة المرتبطة بالمعاملة. |
items |
Array<Item> |
نعم | عناصر الحدث. |
معلّمات العناصر
الاسم | النوع | مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
item_id |
string |
نعم* | SKU_12345 |
معرّف العنصر.
*يجب استخدام إحدى السمتَين |
item_name |
string |
نعم* | تي شيرت لأصدقائها وأصدقائها |
اسم السلعة.
*يجب استخدام إحدى السمتَين |
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
يشير هذا الحدث إلى ردّ أموال عنصر أو أكثر إلى مستخدم.
المعلَمات
الاسم | النوع | مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
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 |
لا | 1,11 | تكلفة الضريبة المرتبطة بالمعاملة. |
items |
Array<Item>
|
لا* | عناصر الحدث. |
معلّمات العناصر
الاسم | النوع | مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
item_id |
string |
نعم* | SKU_12345 |
معرّف العنصر.
*يجب استخدام إحدى السمتَين |
item_name |
string |
نعم* | تي شيرت لأصدقائها وأصدقائها |
اسم السلعة.
*يجب استخدام إحدى السمتَين |
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
يشير هذا الحدث إلى أنه تمت إزالة عنصر من سلة التسوق.
المعلَمات
الاسم | النوع | مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
currency |
string |
نعم* | USD |
تمثّل هذه السمة عملة العناصر المرتبطة بالفعالية بتنسيق
ISO 4217 المكوّن من 3 أحرف. * إذا ضبطت السمة value ، عليك استخدام السمة currency
لاحتساب إحصاءات الأرباح بدقة.
|
value |
number |
نعم* | 7,77 | القيمة النقدية للحدث. * عادةً ما يكون value مطلوبًا لإعداد تقارير مفيدة.
إذا وضعت علامة
على الحدث كإحالة ناجحة، ننصحك بإعداد
value .
* currency مطلوب في حالة تعيين value .
|
items |
Array<Item> |
نعم | عناصر الحدث. |
معلّمات العناصر
الاسم | النوع | مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
item_id |
string |
نعم* | SKU_12345 |
معرّف العنصر.
*يجب استخدام إحدى السمتَين |
item_name |
string |
نعم* | تي شيرت لأصدقائها وأصدقائها |
اسم السلعة.
*يجب استخدام إحدى السمتَين |
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
استخدم هذا الحدث لوضع سياق لعمليات البحث ضمن السياق. يمكن أن يساعدك هذا الحدث في تحديد المحتوى الأكثر رواجًا في تطبيقك
المعلَمات
الاسم | النوع | مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
search_term |
string |
نعم | قمصان | العبارة التي تم البحث عنها. |
select_content
يشير هذا الحدث إلى أن المستخدم قد اختار بعض المحتوى من نوع معيّن. يمكن أن يساعدك هذا الحدث في تحديد المحتوى وفئات المحتوى الشائعين في تطبيقك.
المعلَمات
الاسم | النوع | مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
content_type |
string |
لا | المنتج | نوع المحتوى المحدد. |
item_id |
string |
لا | I_12345 | معرّف للعنصر الذي تم اختياره. |
select_item
يشير هذا الحدث إلى أنه تم اختيار عنصر من قائمة.
المعلَمات
الاسم | النوع | مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
item_list_id |
string |
لا | منتجات ذات صلة | رقم تعريف القائمة التي تم فيها عرض السلعة للمستخدِم يتم تجاهلها في حال ضبطها على مستوى السلعة. |
item_list_name |
string |
لا | منتجات ذات صلة | اسم القائمة التي تم فيها عرض السلعة للمستخدِم يتم تجاهلها في حال ضبطها على مستوى السلعة. |
items |
Array<Item> |
نعم* | عناصر الحدث. * من المتوقّع أن تحتوي المصفوفة items على عنصر واحد يمثّل العنصر المحدّد. وفي حال تقديم عناصر متعددة،
لن يتم استخدام سوى العنصر الأول في items .
|
معلّمات العناصر
الاسم | النوع | مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
item_id |
string |
نعم* | SKU_12345 |
معرّف العنصر.
*يجب استخدام إحدى السمتَين |
item_name |
string |
نعم* | تي شيرت لأصدقائها وأصدقائها |
اسم السلعة.
*يجب استخدام إحدى السمتَين |
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
يشير هذا الحدث إلى أنه تم اختيار عرض ترويجي من قائمة.
المعلَمات
الاسم | النوع | مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
creative_name |
string |
لا | بانر_صيف2 | اسم تصميم الإعلان الترويجي. يتم تجاهلها في حال ضبطها على مستوى السلعة. |
creative_slot |
string |
لا | التطبيق_المميز_1 | اسم خانة تصميم الإعلان الترويجي المرتبطة بالفعالية. يتم تجاهلها في حال ضبطها على مستوى السلعة. |
promotion_id |
string |
لا | P_12345 |
رقم تعريف العرض الترويجي المرتبط بالحدث. يتم تجاهلها في حال ضبطها على مستوى السلعة. |
promotion_name |
string |
لا | تخفيضات موسم الصيف |
اسم العرض الترويجي المرتبط بالحدث. يتم تجاهلها في حال ضبطها على مستوى السلعة. |
items |
Array<Item>
|
لا | عناصر الحدث. |
معلّمات العناصر
الاسم | النوع | مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
item_id |
string |
نعم* | SKU_12345 |
معرّف العنصر.
*يجب استخدام إحدى السمتَين |
item_name |
string |
نعم* | تي شيرت لأصدقائها وأصدقائها |
اسم السلعة.
*يجب استخدام إحدى السمتَين |
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 |
كمية السلعة. |
مشاركة
استخدم هذا الحدث عندما يشارك المستخدم محتوى.
المعلَمات
الاسم | النوع | مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
method |
string |
لا | الطريقة التي تتم بها مشاركة المحتوى. | |
content_type |
string |
لا | صورة | نوع المحتوى المشترك. |
item_id |
string |
لا | C_12345 | معرّف المحتوى المشترك. |
sign_up
يشير هذا الحدث إلى أن مستخدمًا اشترك في حساب. يمكنك استخدام هذا الحدث لفهم السلوكيات المختلفة للمستخدمين الذين سجّلوا دخولهم وسجّلوا خروجهم.
المعلَمات
الاسم | النوع | مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
method |
string |
لا | الطريقة المستخدمة للاشتراك. |
spend_virtual_currency
يقيس هذا الحدث بيع السلع الافتراضية في تطبيقك ويساعدك في تحديد السلع الافتراضية الأكثر شيوعًا.
المعلَمات
الاسم | النوع | مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
value |
number |
نعم | 5 | قيمة العملة الافتراضية. |
virtual_currency_name |
string |
نعم | أحجار كريمة | اسم العملة الافتراضية. |
item_name |
string |
لا | التحسين للمبتدئين | اسم العنصر الذي يتم استخدام العملة الافتراضية له. |
tutorial_begin
يشير هذا الحدث إلى بداية عملية الإعداد. استخدم هذا في مسار التحويل مع tutorial_complete لمعرفة عدد المستخدمين الذين أكملوا البرنامج التعليمي.
المعلَمات
لا توجد معلمات لهذا الحدث.
tutorial_complete
يشير هذا الحدث إلى إكمال المستخدم لعملية الإعداد. ويمكنك استخدام هذا في مسار التحويل مع tutorial_begin لمعرفة عدد المستخدمين الذين أكملوا البرنامج التعليمي.
المعلَمات
لم يتم اقتراح أي معلّمات لهذا الحدث.
unlock_achievement
سجِّل هذا الحدث عندما يفتح المستخدم إنجازًا. يمكن أن يساعدك هذا الحدث في فهم تجربة المستخدمين للعبتك.
المعلَمات
الاسم | النوع | مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
achievement_id |
string |
نعم | A_12345 | رقم تعريف الإنجاز الذي تم فتحه. |
view_cart
يشير هذا الحدث إلى أن المستخدم شاهد سلة التسوق.
المعلَمات
الاسم | النوع | مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
currency |
string |
نعم* | USD |
تمثّل هذه السمة عملة العناصر المرتبطة بالفعالية بتنسيق
ISO 4217 المكوّن من 3 أحرف. * إذا ضبطت السمة value ، عليك استخدام السمة currency
لاحتساب إحصاءات الأرباح بدقة.
|
value |
number |
نعم* | 7,77 | القيمة النقدية للحدث. * عادةً ما يكون value مطلوبًا لإعداد تقارير مفيدة.
إذا وضعت علامة
على الحدث كإحالة ناجحة، ننصحك بإعداد
value .
* currency مطلوب في حالة تعيين value .
|
items |
Array<Item> |
نعم | عناصر الحدث. |
معلّمات العناصر
الاسم | النوع | مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
item_id |
string |
نعم* | SKU_12345 |
معرّف العنصر.
*يجب استخدام إحدى السمتَين |
item_name |
string |
نعم* | تي شيرت لأصدقائها وأصدقائها |
اسم السلعة.
*يجب استخدام إحدى السمتَين |
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
يشير هذا الحدث إلى أنه تم عرض بعض المحتوى للمستخدم. استخدم هذا الحدث لاكتشاف أكثر العناصر الشائعة مشاهدة.
المعلَمات
الاسم | النوع | مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
currency |
string |
نعم* | USD |
تمثّل هذه السمة عملة العناصر المرتبطة بالفعالية بتنسيق
ISO 4217 المكوّن من 3 أحرف. * إذا ضبطت السمة value ، عليك استخدام السمة currency
لاحتساب إحصاءات الأرباح بدقة.
|
value |
number |
نعم* | 7,77 | القيمة النقدية للحدث. * عادةً ما يكون value مطلوبًا لإعداد تقارير مفيدة.
إذا وضعت علامة
على الحدث كإحالة ناجحة، ننصحك بإعداد
value .
* currency مطلوب في حالة تعيين value .
|
items |
Array<Item> |
نعم | عناصر الحدث. |
معلّمات العناصر
الاسم | النوع | مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
item_id |
string |
نعم* | SKU_12345 |
معرّف العنصر.
*يجب استخدام إحدى السمتَين |
item_name |
string |
نعم* | تي شيرت لأصدقائها وأصدقائها |
اسم السلعة.
*يجب استخدام إحدى السمتَين |
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
سجّل هذا الحدث عند تقديم قائمة بعناصر المستخدم من فئة معينة.
المعلَمات
الاسم | النوع | مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
item_list_id |
string |
لا | منتجات ذات صلة | رقم تعريف القائمة التي تم فيها عرض السلعة للمستخدِم يتم تجاهلها في حال ضبطها على مستوى السلعة. |
item_list_name |
string |
لا | منتجات ذات صلة | اسم القائمة التي تم فيها عرض السلعة للمستخدِم يتم تجاهلها في حال ضبطها على مستوى السلعة. |
items |
Array<Item> |
نعم | عناصر الحدث. |
معلّمات العناصر
الاسم | النوع | مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
item_id |
string |
نعم* | SKU_12345 |
معرّف العنصر.
*يجب استخدام إحدى السمتَين |
item_name |
string |
نعم* | تي شيرت لأصدقائها وأصدقائها |
اسم السلعة.
*يجب استخدام إحدى السمتَين |
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
يشير هذا الحدث إلى مشاهدة عرض ترويجي من قائمة.
المعلَمات
الاسم | النوع | مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
creative_name |
string |
لا | بانر_صيف2 | اسم تصميم الإعلان الترويجي. يتم تجاهلها في حال ضبطها على مستوى السلعة. |
creative_slot |
string |
لا | التطبيق_المميز_1 | اسم خانة تصميم الإعلان الترويجي المرتبطة بالفعالية. يتم تجاهلها في حال ضبطها على مستوى السلعة. |
promotion_id |
string |
لا | P_12345 |
رقم تعريف العرض الترويجي المرتبط بالحدث. يتم تجاهلها في حال ضبطها على مستوى السلعة. |
promotion_name |
string |
لا | تخفيضات موسم الصيف |
اسم العرض الترويجي المرتبط بالحدث. يتم تجاهلها في حال ضبطها على مستوى السلعة. |
items |
Array<Item> |
نعم* | عناصر الحدث. * من المتوقّع أن تحتوي المصفوفة items على عنصر واحد يمثّل العنصر المرتبط بالعرض الترويجي. وفي حال توفير عناصر متعددة، سيتم استخدام العنصر الأول فقط في السمة items .
|
معلّمات العناصر
الاسم | النوع | مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
item_id |
string |
نعم* | SKU_12345 |
معرّف العنصر.
*يجب استخدام إحدى السمتَين |
item_name |
string |
نعم* | تي شيرت لأصدقائها وأصدقائها |
اسم السلعة.
*يجب استخدام إحدى السمتَين |
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
سجّل هذا الحدث عند تقديم نتائج البحث للمستخدم.
المعلَمات
الاسم | النوع | مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
search_term |
string |
لا | ملابس | العبارة المستخدمة في البحث. |