قياس التجارة الإلكترونية

يمكنك إعداد أحداث التجارة الإلكترونية لجمع معلومات عن سلوك التسوّق للمستخدمين. تتيح لك الفعاليات تحديد قيمة منتجاتك الأكثر رواجًا ومعرفة تأثير العروض الترويجية ووضع المنتجات في الأرباح.

يوضّح هذا المستند كلّ حدث من أحداث التجارة الإلكترونية وحالات إعداد الحدث. للحصول على مثال مفصّل عن كيفية إعداد حدث للتجارة الإلكترونية، اطّلِع على مقالة إعداد حدث شراء.

هل لديك 3 دقائق؟ ساعدنا في تحسين مستندات التجارة الإلكترونية في "إحصاءات Google" من خلال المشاركة في استطلاع سريع على الإنترنت.

gtag.js إدارة العلامات من Google

قبل البدء

تأكَّد من إضافة علامة Google إلى موقعك الإلكتروني ومن أنّه يمكنك الوصول إلى "إحصاءات Google" ورمز مصدر الموقع الإلكتروني.

اقتراحات

• فعِّل وضع تصحيح الأخطاء حتى تتمكّن من الاطّلاع على الأحداث في الوقت الفعلي وتحديد المشاكل وحلّها.
• راجِع حدود السمات والمقاييس المخصّصة عند إرسال مَعلمات مخصّصة مع أحداث التجارة الإلكترونية.
• اضبط currency عند إرسال بيانات value (الأرباح) لضمان احتساب مقاييس الأرباح بشكل صحيح.
• اضبط كل مَعلمة تجارة إلكترونية تتوفّر لديك بيانات لها، بغض النظر عمّا إذا كانت المَعلمة اختيارية.
• استخدِم نموذج موقع إلكتروني للتجارة الإلكترونية للاطّلاع على مثال على كيفية وضع علامة على موقعك الإلكتروني.

التنفيذ

تقيس عملية تنفيذ التجارة الإلكترونية المعتادة أيًا من الإجراءات التالية:

• اختيار عنصر من قائمة
• عرض تفاصيل العنصر
• إضافة منتج أو إزالته من سلّة التسوّق
• بدء عملية الدفع
• إجراء عمليات شراء أو ردّ الأموال
• تطبيق العروض الترويجية

تضع المنتجات والخدمات التي تبيعها في صميم هذه الإجراءات. يمكنك تمثيل المنتجات والخدمات على أنّها مصفوفة من السلع التي يمكن إضافتها إلى أحداث التجارة الإلكترونية. يمكنك تضمين ما يصل إلى 27 مَعلمة مخصّصة في مصفوفة السلع، بالإضافة إلى المَعلمات المخصّصة.

يوضّح المثال التالي كيفية إنشاء مجموعة items التي تتم الإشارة إليها في هذا الدليل. يمكن أن تتضمّن صفيف items ما يصل إلى 200 عنصر.

items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    },
    {
      item_id: "SKU_12346",
      item_name: "Google Grey Women's Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 3.33,
      index: 1,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "gray",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 21.01,
      quantity: 2
    }
]

اختيار عنصر من قائمة

عندما يتم عرض قائمة بالنتائج على المستخدم، أرسِل حدث view_item_list بما في ذلك مَعلمة صفيف items تحتوي على العناصر المعروضة. للاطّلاع على تفاصيل عن المَعلمات المطلوب إرسالها، اطّلِع على مرجع الأحداث.

gtag("event", "view_item_list", {
  item_list_id: "related_products",
  item_list_name: "Related products",
  items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    }
  ]
});

بعد أن يختار أحد المستخدمين عنصرًا من القائمة، أرسِل الحدث select_item مع العنصر المحدّد في مَعلمة مصفوفة items. للحصول على تفاصيل عن المعلَمات المُراد إرسالها، يُرجى الاطّلاع على مرجع الأحداث.

gtag("event", "select_item", {
  item_list_id: "related_products",
  item_list_name: "Related products",
  items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    }
  ]
});

عرض تفاصيل السلعة

لقياس عدد المرات التي يتم فيها عرض تفاصيل السلع، أرسِل حدث view_item عندما يعرض المستخدم شاشة تفاصيل السلعة. للاطّلاع على تفاصيل عن المَعلمات التي يجب إرسالها، اطّلِع على مرجع الأحداث.

gtag("event", "view_item", {
  currency: "USD",
  value: 30.03,
  items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    }
  ]
});

إضافة سلعة إلى سلة تسوّق أو إزالتها منها

يمكنك قياس سلعة تتم إضافتها إلى سلة تسوّق من خلال إرسال حدث add_to_cart مع السلع ذات الصلة في مصفوفة items. للاطّلاع على تفاصيل عن المَعلمات التي يجب إرسالها، اطّلِع على مرجع الأحداث.

gtag("event", "add_to_cart", {
  currency: "USD",
  value: 30.03,
  items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    }
  ]
});

يمكنك أيضًا قياس الحالات التي تتم فيها إضافة سلعة إلى قائمة الأمنيات من خلال إرسال حدث add_to_wishlist يتضمّن السلع ذات الصلة في مصفوفة items. للاطّلاع على تفاصيل عن المَعلمات المطلوب إرسالها، اطّلِع على مرجع الأحداث.

gtag("event", "add_to_wishlist", {
  currency: "USD",
  value: 30.03,
  items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    }
  ],
});

عندما يرى المستخدم سلة التسوّق في وقت لاحق، أرسِل الحدث view_cart مع جميع السلع المضمّنة في سلة التسوّق. للاطّلاع على تفاصيل عن المَعلمات المطلوب إرسالها، اطّلِع على مرجع الأحداث.

gtag("event", "view_cart", {
  currency: "USD",
  value: 30.03,
  items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    }
  ]
});

لقياس الحالات التي يزيل فيها المستخدِم سلعة من سلة التسوّق، أرسِل الحدث remove_from_cart. للاطّلاع على تفاصيل عن المَعلمات المطلوب إرسالها، اطّلِع على مرجع الأحداث.

gtag("event", "remove_from_cart", {
  currency: "USD",
  value: 30.03,
  items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    }
  ]
});

بدء عملية الدفع

يمكنك قياس الخطوة الأولى في عملية الدفع من خلال إرسال حدث begin_checkout مع سلعة واحدة أو أكثر محدّدة باستخدام الحقول ذات الصلة. ويمكن أيضًا إضافة قسيمة في هذه المرحلة إلى الطلب بأكمله من خلال إضافتها إلى الحدث أو تطبيقها على عنصر معيّن من خلال إضافتها إلى عناصر محدّدة في المصفوفة items. للحصول على تفاصيل عن المَعلمات المطلوب إرسالها، اطّلِع على مرجع الأحداث.

gtag("event", "begin_checkout", {
  currency: "USD",
  value: 30.03,
  coupon: "SUMMER_FUN",
  items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    }
  ]
});

عندما ينتقل المستخدِم إلى الخطوة التالية في عملية الدفع ويضيف معلومات الشحن، أرسِل حدث add_shipping_info. استخدِم المَعلمة shipping_tier لتحديد خيار التسليم لدى المستخدم، مثل "برّي" أو "طيران" أو "اليوم التالي". للاطّلاع على تفاصيل عن المَعلمات المطلوب إرسالها، اطّلِع على مرجع ملفّات ملفّات log4j4.log.

gtag("event", "add_shipping_info", {
  currency: "USD",
  value: 30.03,
  coupon: "SUMMER_FUN",
  shipping_tier: "Ground",
  items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    }
  ]
});

أرسِل الحدث add_payment_info عندما يُرسِل أحد المستخدِمين معلومات الدفع. يمكنك تضمين payment_type مع هذا الحدث، إن أمكن، لطريقة الدفع التي تم اختيارها. للحصول على تفاصيل عن المَعلمات المطلوب إرسالها، يُرجى الاطّلاع على مرجع الأحداث.

gtag("event", "add_payment_info", {
  currency: "USD",
  value: 30.03,
  coupon: "SUMMER_FUN",
  payment_type: "Credit Card",
  items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    }
  ]
});

إجراء عملية شراء أو ردّ الأموال

يمكنك قياس عملية شراء من خلال إرسال حدث purchase يتضمّن سلعة واحدة أو أكثر محدّدة باستخدام الحقول ذات الصلة. للاطّلاع على تفاصيل عن المَعلمات المطلوب إرسالها، اطّلِع على مرجع الأحداث.

gtag("event", "purchase", {
    transaction_id: "T_12345",
    // Sum of (price * quantity) for all items.
    value: 72.05,
    tax: 3.60,
    shipping: 5.99,
    currency: "USD",
    coupon: "SUMMER_SALE",
    items: [
     {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    },
    {
      item_id: "SKU_12346",
      item_name: "Google Grey Women's Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 3.33,
      index: 1,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "gray",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 21.01,
      promotion_id: "P_12345",
      promotion_name: "Summer Sale",
      quantity: 2
    }]
});

ملاحظة: يحل حدث purchase محل ecommerce_purchase ويختلف عن حدث in_app_purchase الذي يتم تسجيله تلقائيًا.

يمكنك قياس عمليات ردّ الأموال من خلال إرسال حدث refund مع transaction_id المحدّد ذي الصلة وعنصر واحد أو أكثر محدّد باستخدام item_id وquantity. ننصحك بتضمين معلومات السلعة في حدث refund للاطّلاع على مقاييس ردّ الأموال على مستوى السلعة في "إحصاءات Google".

للاطّلاع على تفاصيل عن المَعلمات المطلوب إرسالها، اطّلِع على مرجع الأحداث.

gtag("event", "refund", {
  currency: "USD",
  transaction_id: "T_12345", // Transaction ID. Required for purchases and refunds.
  value: 30.03,
  coupon: "SUMMER_FUN",
  shipping: 3.33,
  tax: 1.11,
  items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    }
  ]
});

ملاحظة: سيحلّ حدث ردّ الأموال محلّ ecommerce_refund.

تطبيق العروض الترويجية

تشمل التجارة الإلكترونية إتاحة قياس مرات ظهور ونقرات العروض الترويجية الداخلية، مثل إعلانات البانر المعروضة للترويج لعملية بيع.

يتم عادةً قياس مرّات ظهور العرض الترويجي من خلال مرّات الظهور على الشاشة الأولية من خلال إرسال الحدث view_promotion مع مَعلمة items لتحديد السلعة المُعلَن عنها. للاطّلاع على تفاصيل عن المَعلمات المطلوب إرسالها، اطّلِع على مرجع الأحداث.

gtag("event", "view_promotion", {
  creative_name: "Summer Banner",
  creative_slot: "featured_app_1",
  promotion_id: "P_12345",
  promotion_name: "Summer Sale",
  items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    }
  ]
});

للإشارة إلى أنّ مستخدِمًا نقر على عرض ترويجي، أرسِل حدث select_promotion مع تضمين هذا العنصر كمَعلمة للسلع. للاطّلاع على تفاصيل عن المَعلمات المطلوب إرسالها، اطّلِع على مرجع الأحداث.

gtag("event", "select_promotion", {
  creative_name: "Summer Banner",
  creative_slot: "featured_app_1",
  promotion_id: "P_12345",
  promotion_name: "Summer Sale",
  items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    }
  ],
});