دليل المطوّرين حول التجارة الإلكترونية (GA4)

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

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

قبل البدء

تأكّد من أنّك أضفت علامة 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 لتحديد خيار التسليم لدى المستخدم، مثل "برّي" أو "هواء" أو "اليوم التالي". لمعرفة تفاصيل عن المَعلمات المطلوب إرسالها، يُرجى الاطّلاع على مرجع الأحداث.

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
    }]
});

يمكنك قياس عمليات ردّ الأموال عن طريق إرسال حدث 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
    }
  ]
});

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

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

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

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
    }
  ],
});