رمز التتبّع: التجارة الإلكترونية

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

طرق التجارة الإلكترونية في GATC

  • _addItem(transactionId, sku, name, category, price, quantity)
  • _addTrans(transactionId, affiliation, total, tax, shipping, city, state, country)
  • _trackTrans()

تفاصيل الطريقة

_addItem()

    _addItem(transactionId, sku, name, category, price, quantity)

    استخدِم هذه الطريقة لتتبُّع السلع التي اشتراها زوّار موقعك الإلكتروني للتجارة الإلكترونية. تتتبّع هذه الطريقة السلع الفردية حسب رمز التخزين التعريفي الخاص بها. وهذا يعني أنّ المعلَمة sku مطلوبة. بعد ذلك، تربط هذه الطريقة السلعة بالعنصر الرئيسي للمعاملة باستخدام الوسيطة transactionId.

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

    لا تُجري هذه الطريقة أي عمليات حسابية إضافية، مثل العمليات الحسابية للكميات. وبالتالي، عليك مراعاة أفضل الممارسات التالية:

    • حساب الكميات باستخدام برنامجك الخاص.
      • في الجلسة نفسها، لا تؤثِّر العناصر المكرّرة التي تمت إضافتها (حسب رمز التخزين التعريفي) في احتساب الكمية.
      • في الجلسة نفسها، إذا تمت إضافة عنصرَين وكان لكل منهما رمز التخزين التعريفي نفسه، يتم استبدال معلومات السلعة الأولى بالعنصر الثاني.
    • تأكَّد من أنّ كل سلعة في المستودع لها رمز تخزين تعريفي فريد.
      • إذا كان مستودعك يحتوي على سلع مختلفة لها رمز التخزين التعريفي نفسه، واشترى الزائر كلاً منها، ستتلقى بيانات لأحدث المنتجات المُضافة فقط.
    • تأكَّد من إعداد عنصر المعاملة الرئيسي للعناصر المُضافة.
      • وفي حال عدم توفُّر عنصر معاملة رئيسي لعنصر مُضاف، يتم إرفاق العنصر بعنصر معاملة فارغ بدلاً من ذلك.
      • في حال إضافة سلعة بدون عنصر معاملة رئيسي، ستعرض تقاريرك المنتجات حسب رمز التخزين التعريفي غير المرتبطة بأي معاملة.
    • أدخِل قيمة للمَعلمة name في كلّ الأوقات.
      • علمًا أنّ المَعلمة name غير مطلوبة، فإنّ السلع المُضافة إلى معاملة بدون مَعلمة name لا تظهر في تفاصيل المنتج للمعاملة. وسيظل بإمكانك الاطّلاع على إجمالي الأرباح للمعاملة، ولكنّك لن تتمكن من الاطّلاع على مقدار الأرباح التي ساهم بها عنصر معيّن في إجمالي المعاملة.
       _gaq.push(['_addItem',
      '1234',         // transaction ID - necessary to associate item with transaction
      'DD44',         // SKU/code - required
      'T-Shirt',      // product name - necessary to associate revenue with product
      'Olive Medium', // category or variation
      '11.99',        // unit price - required
      '1'             // quantity - required
   ]);

    المَعلَمات

      String   transactionId اختياري مُعرّف الطلب للمعاملة لربطها بالسلعة.
      String   sku مطلوبة رمز رمز التخزين التعريفي للعنصر
      String   name مطلوبة. اسم المنتج مطلوبة للاطّلاع على البيانات في تقرير تفاصيل المنتج.
      String   category اختيارية. فئة المنتج:
      String   price مطلوبة. سعر المنتج.
      String   quantity مطلوبة كمية الشراء:

_addTrans()

    _addTrans(transactionId, affiliation, total, tax, shipping, city, state, country)
    تُنشئ كائن معاملة بالقيم المحددة. وكما هي الحال في _addItem()، تعالج هذه الطريقة تتبُّع المعاملات فقط، ولا توفّر أي وظائف إضافية للتجارة الإلكترونية. وبالتالي، إذا كانت المعاملة نسخة مكرّرة من معاملة حالية لتلك الجلسة، يتم استبدال قيم المعاملات القديمة بقيم المعاملات الجديدة. وتتم مطابقة الوسيطات الخاصة بهذه الطريقة حسب الموضع، لذا احرص على توفير جميع المَعلمات، حتى إذا كان لبعضها قيمة فارغة. 
       _gaq.push(['_addTrans',
      '1234',           // transaction ID - required
      'Womens Apparel', // affiliation or store name
      '28.28',          // total - required; Shown as "Revenue" in the
                        // Transactions report. Does not include Tax and Shipping.
      '1.29',           // tax
      '15.00',          // shipping
      'San Jose',       // city
      'California',     // state or province
      'USA'             // country
   ]);

    المَعلَمات

      String   transactionId مطلوبة. رقم تعريف المعاملة الفريد الداخلي لهذه المعاملة.
      String   affiliation اختيارية: ارتباط الشريك أو المتجر (بطريقة غير محدّدة في حال عدم توفّرها).
      String   total مطلوبة. إجمالي المبلغ بالدولار الأمريكي للمعاملة. لا يشمل السعر الضريبة والشحن، ويجب اعتباره "الإجمالي الكلي" فقط إذا كنت تضمّن بشكل صريح الشحن والضريبة.
      String   tax اختيارية: مبلغ الضريبة للمعاملة.
      String   shipping اختيارية: رسوم الشحن للمعاملة.
      String   city اختيارية: المدينة المطلوب ربطها بالمعاملة.
      String   state اختيارية: الولاية لربطها بالمعاملة
      String   country اختيارية: البلد الذي تريد ربطه بالمعاملة.

    returns

      _gat.GA_EComm_.Transactions_ عنصر المعاملة الذي تم إنشاؤه أو تعديله.

_trackTrans()

    _trackTrans()
    تُرسِل هذه الميزة بيانات المعاملات والسلع إلى خادم "إحصاءات Google". يجب طلب هذه الطريقة بعد _trackPageview()، واستخدامها بالتزامن مع الطريقتَين _addItem() وaddTrans(). ومن المفترض أن يتم طلبه بعد إعداد العناصر والمعاملات. 
    _gaq.push(['_setAccount', 'UA-XXXXX-X']);
_gaq.push(['_trackPageview']);
_gaq.push(['_addTrans',
   '1234',           // transaction ID - required
   'Womens Apparel', // affiliation or store name
   '28.28',          // total - required
   '1.29',           // tax
   '15.00',          // shipping
   'San Jose',       // city
   'California',     // state or province
   'USA'             // country
]);
_gaq.push(['_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
]);
_gaq.push(['_trackTrans']);