تتبُّع التجارة الإلكترونية - تتبُّع الويب (ga.js)

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

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

العمليات العامة

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

1. إنشاء كائن معاملة:

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

   ملاحظة: لا يتم استخدام المعلومات الجغرافية الاختيارية التي يمكن تضمينها في عنصر المعاملة لتعبئة البيانات الجغرافية في تقارير "إحصاءات Google"، ولكن يمكن استخدامها في فلتر الملفات الشخصية.
2. أضِف عناصر إلى المعاملة.

   تتتبّع طريقة _addItem() المعلومات المتعلّقة بكل سلعة في سلّة التسوّق، وتربط السلعة بكل معاملة من خلال الحقل transactionId. تتتبّع هذه الطريقة تفاصيل سلعة معيّنة، مثل رمز التخزين التعريفي والسعر والفئة والكمية.

3. أرسِل المعاملة إلى خوادم "إحصاءات Google".

   تؤكّد الطريقة _trackTrans() حدوث عملية شراء، ويتم إنهاء جميع البيانات التي تم إنشاؤها في كائن المعاملة على أنها معاملة.

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

الإرشادات

يجب أخذ ما يلي في الاعتبار عند تنفيذ تتبُّع التجارة الإلكترونية.

• رمز التخزين التعريفي هو معلّمة مطلوبة لكل سلعة تتم إضافتها إلى المعاملة.
  إذا كانت المعاملة تحتوي على عناصر متعدّدة ولم يتم توفير رمز التخزين التعريفي لكل سلعة، يتم إرسال طلب ملف GIF فقط للسلعة الأخيرة التي تمت إضافتها إلى المعاملة التي يتم تقديم رمز تخزين تعريفي لها. بالإضافة إلى ذلك، إذا كان مستودعك يتضمّن سلعًا مختلفة تحمل رمز التخزين التعريفي نفسه، واشترى الزائر كليهما، ستتلقّى بيانات لأحدث المنتجات التي تمت إضافتها فقط. لهذا السبب، يجب التأكّد من أنّ كل سلعة تقدّمها لها رمز تخزين تعريفي فريد.
• تتطابق قائمة الوسيطات مع _addTrans() و_addItem() حسب الموضع.
  على الرغم من أنّ جميع الوسيطات غير مطلوبة، يجب توفير عنصر نائب فارغ للوسيطات غير المحدّدة لتجنّب الأخطاء. على سبيل المثال، يمكنك إضافة سلعة تتضمّن معرِّف المعاملة ورمز التخزين التعريفي والسعر والكمية مثل ما يلي:

  _addItem("54321", "12345", "", "", "55.95", "1");

• لا تلتزم قيمتا المعلَمات price وtotal بأي تنسيق عملة.
  بالنسبة إلى المعلّمتَين، يشير المثال الأول إلى فاصلة أو نقطة إلى قيمة كسور. على سبيل المثال، إذا قدّمت 1,996.00 كقيمة للمعلمة total، يتم تسجيلها كـ 1.996، وليس بقيمة 1,996.00 دولار أمريكي. بما أنّ القيمة غير مرتبطة بأي عملة، يجب أن يعالج برنامج التجارة الإلكترونية أي تحويل عملة قبل تمرير البيانات إلى "إحصاءات Google".
• في حال تنفيذ تتبُّع التجارة الإلكترونية واستخدام سلة تسوّق من جهة خارجية، من المحتمل أن تحتاج أيضًا إلى ضبط التتبّع عبر النطاقات أيضًا.
  يُرجى الاطّلاع على القسم الذي يتناول "التتبّع على جميع النطاقات" لمعرفة التفاصيل.
• علمًا أنّ هذا الإجراء ليس إلزاميًا، ننصحك بالاتصال بالرقم _trackPageview() على صفحة الإيصال إذا أردت ربط هذه الصفحة تحديدًا ببيانات المعاملة.

مثال كامل

يوضح المثال التالي نموذجًا لإعداد تتبُّع التجارة الإلكترونية على صفحة الإيصالات باستخدام جميع الطرق الثلاث. يربط استخدام _trackPageview() المعاملة بالصفحة التي تحمل عنوان إيصال شراء الملابس من Acme Clothing.

البنية غير المتزامنة (مقترَحة)

<html>
<head>
<title>Receipt for your clothing purchase from Acme Clothing</title>
<script type="text/javascript">

  var _gaq = _gaq || [];
  _gaq.push(['_setAccount', 'UA-XXXXX-X']);
  _gaq.push(['_trackPageview']);
  _gaq.push(['_addTrans',
    '1234',           // transaction ID - required
    'Acme Clothing',  // affiliation or store name
    '11.99',          // total - required
    '1.29',           // tax
    '5',              // shipping
    'San Jose',       // city
    'California',     // state or province
    'USA'             // country
  ]);

   // add item might be called for every item in the shopping cart
   // where your ecommerce engine loops through each item in the cart and
   // prints out _addItem for each
  _gaq.push(['_addItem',
    '1234',           // transaction ID - required
    'DD44',           // SKU/code - required
    'T-Shirt',        // product name
    'Green Medium',   // category or variation
    '11.99',          // unit price - required
    '1'               // quantity - required
  ]);
  _gaq.push(['_trackTrans']); //submits transaction to the Analytics servers

  (function() {
    var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
    ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
    var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
  })();

</script>
</head>
<body>

  Thank you for your order.  You will receive an email containing all your order details.

</body>
</html>

البنية التقليدية

<html>
<head>
<title>Receipt for your clothing purchase from Acme Clothing</title>
</head>

<body>

  Thank you for your order.  You will receive an email containing all your order details.


<script type="text/javascript">
  var gaJsHost = (("https:" == document.location.protocol ) ? "https://ssl." : "http://www.");
  document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));
</script>
<script type="text/javascript">
try{
  var pageTracker = _gat._getTracker("UA-xxxxx-x");
  pageTracker._trackPageview();
  pageTracker._addTrans(
      "1234",            // transaction ID - required
      "Womens Apparel",  // affiliation or store name
      "11.99",           // total - required
      "1.29",            // tax
      "15.00",           // shipping
      "San Jose",        // city
      "California",      // state or province
      "USA"              // country
    );


   // add item might be called for every item in the shopping cart
   // where your ecommerce engine loops through each item in the cart and
   // prints out _addItem for each 
   pageTracker._addItem(
      "1234",           // transaction ID - necessary to associate item with transaction
      "DD44",           // SKU/code - required
      "T-Shirt",        // product name
      "Olive Medium",   // category or variation
      "11.99",          // unit price - required
      "1"               // quantity - required
   );

   pageTracker._trackTrans(); //submits transaction to the Analytics servers
} catch(err) {}
</script>
</body>
</html>

 

الرجوع إلى أعلى الصفحة

العملات المحلية

يمكنك تلقائيًا ضبط عملة شائعة وعالمية لجميع المعاملات والعناصر من خلال واجهة إدارة "إحصاءات Google". يتمّ استخدام العملة العالمية تلقائيًا لكلّ السلع والمعاملات. بالنسبة إلى المواقع الإلكترونية التي تُجري معاملات بعدة عملات، تتيح لك ميزة تتبُّع التجارة الإلكترونية في ga.js تحديد العملة المحلية للمعاملة باستخدام الأمر التالي: قبل تنفيذ الطلب على _trackTrans:

_gaq.push(['_set', 'currencyCode', 'EUR']);

يجب تحديد العملة المحلية في معيار ISO 4217. اطّلِع على المستند مرجع رموز العملات للحصول على قائمة كاملة بعملات الإحالات الناجحة المتوافقة.