التحقّق من صحة إعداد التجارة الإلكترونية (gtag.js)

يقدم هذا المستند نظرة عامة حول كيفية التحقق من أن Analytics جمع أحداث التجارة الإلكترونية من موقعك الإلكتروني عند استخدام gtag.js. المستند أنك قرأت مقالة قياس التجارة الإلكترونية.

الاطّلاع على أحداث التجارة الإلكترونية في الوقت الفعلي

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

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

تحديد وحلّ مشاكل أحداث التجارة الإلكترونية المفقودة

في ما يلي بعض الأسباب المُحتمَلة لعدم ظهور حدث تجارة إلكترونية في "إحصاءات YouTube"

يُرجى التحقّق من الفواصل.

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

gtag("event", "refund", {
  currency: "USD",
  transaction_id: "T_12345" // Missing a trailing comma
  value: 30.03,
  coupon: "SUMMER_FUN",
  shipping: 3.33,
  tax: 1.11
});

التحقّق من موضع الإعلان

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

جيدة:

<body>
  <p>Hello, World!</p>
  <script>
    gtag("event", "<event-name>");
  </script>
</body>

جيدة:

<body>
  <p>Hello, World!</p>
  <script src="my_events.js"></script>
</body>

سيئة:

<body>
  <p>Hello, World!</p>
  gtag("event", "<event-name>");
</body>

سيئة:

<head>
  <script>
    gtag("event", "<event-name>");
  </script>
  <!-- the Google tag -->
</head>

التحقّق من بنية الحدث

يستخدم حدث purchase التالي البنية الصحيحة:

gtag('event', 'purchase', {
    transaction_id: "T_12345",
    value: 72.05,
    currency: "USD",
    items: [
     {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
     },
     {
      item_id: "SKU_12346",
      item_name: "Google Grey Women's Tee",
     }]
});

تحقَّق من إدراج الفواصل في الحدث بشكل صحيح:

  • القوسان بعد gtag وقبل الفاصلة المنقوطة للإغلاق
  • الأقواس المعقوفة قبل مَعلمات الأحداث وبعدها
  • الأقواس المربّعة قبل مَعلمات الأحداث على مستوى المنتج أو الخدمة وبعدها

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

التحقّق من اسم الحدث

عند إعداد أحداث التجارة الإلكترونية، احرِص على استخدام القيمة المقترَحة الصحيحة اسم الحدث. على سبيل المثال، استخدِم اسم الحدث "add_to_cart" بدلاً من &quot;add_to_basket&quot; للتأكّد من أنّ "إحصاءات Google" تسجِّل الحدث باعتباره أحد أحداث التجارة الإلكترونية المقترَحة. بالإضافة إلى ذلك، تأكَّد من تهجئة أسماء الأحداث. بشكل صحيح ولا تحتوي على أي أخطاء إملائية.

التحقّق من معرِّف المعاملة

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

إذا لم يظهر لك حدث للتجارة الإلكترونية أثناء الاختبار، حاوِل تغيير المعاملة. معرِّف المعاملة أو إزالة معرِّفها أثناء الاختبار حتى يظهر لك كل إصدار فعالية.

تحديد وحلّ المشاكل المتعلّقة بأحداث التجارة الإلكترونية المكرّرة

في ما يلي السبب المحتمل لظهور أحداث تجارة إلكترونية مكرّرة. في "إحصاءات Google"

استخدام علامة واحدة في كل صفحة

تأكّد من إضافة مقتطف علامة Google إلى كل صفحة من صفحات موقعك الإلكتروني. إضافةً إلى ذلك، تأكّد من استخدام علامة Google (gtag.js) أو أداة "إدارة العلامات من Google". ولكن ليس كليهما. سيؤدي استخدام كلا الخيارين إلى مضاعفة احتساب أحداث معينة عواقب غير مقصودة.