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

يقدِّم هذا المستند نظرة عامة عن كيفية التأكّد من أنّ "إحصاءات Google" تجمع أحداث التجارة الإلكترونية من موقعك الإلكتروني عند استخدام gtag.js. يفترض المستند أنّك قد قرأت قياس التجارة الإلكترونية.

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

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

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

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

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

تحقق من الفواصل

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

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

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

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

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

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

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

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