ویژگی‌های استاندارد Universal Analytics (UA) پردازش داده‌ها را در 1 ژوئیه 2023 متوقف کردند . دارایی‌های UA 360 پردازش داده‌ها را در تاریخ 1 ژوئیه 2024 متوقف خواهند کرد و برخی از ویژگی‌های UA 360 قبل از آن منسوخ خواهند شد ، زیرا ما به Google Analytics 4 منتقل می‌شویم . Google Analytics 4 را به پیاده سازی موجود خود اضافه کنید .

این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

اندازه گیری تجارت الکترونیک، اندازه گیری تجارت الکترونیک

این راهنما نحوه جمع آوری داده های تجارت الکترونیک را با استفاده از analytics.js شرح می دهد.

بررسی اجمالی

اندازه گیری تجارت الکترونیک به شما امکان می دهد تعداد تراکنش ها و درآمدی که وب سایت شما ایجاد می کند را اندازه گیری کنید. در یک سایت تجارت الکترونیک معمولی، هنگامی که کاربر روی دکمه "خرید" در مرورگر کلیک می کند، اطلاعات خرید کاربر به وب سرور ارسال می شود که تراکنش را انجام می دهد. در صورت موفقیت، سرور کاربر را به صفحه «متشکرم» یا رسید با جزئیات تراکنش و رسید خرید هدایت می کند. می‌توانید از کتابخانه analytics.js برای ارسال داده‌های تجارت الکترونیک از صفحه «متشکرم» به Google Analytics استفاده کنید.

دو نوع داده تجارت الکترونیک وجود دارد که می توانید با استفاده از analytics.js ارسال کنید: داده های تراکنش و داده های مورد .

داده های تراکنش

تراکنش کل معامله ای را که در سایت شما انجام می شود نشان می دهد و حاوی مقادیر زیر است:

کلید	نوع ارزش	ضروری	شرح
`id`	متن	آره	شناسه تراکنش (مثلا 1234)
`affiliation`	متن	خیر	فروشگاه یا وابستگی که این معامله از آنجا انجام شده است (به عنوان مثال Acme Clothing).
`revenue`	واحد پول	خیر	کل درآمد یا کل کل مرتبط با تراکنش را مشخص می کند (مثلاً 11.99). این مقدار ممکن است شامل هزینه‌های حمل و نقل، مالیات یا سایر تنظیمات مربوط به کل درآمد باشد که می‌خواهید به عنوان بخشی از محاسبات درآمد خود لحاظ کنید.
`shipping`	واحد پول	خیر	کل هزینه حمل و نقل معامله را مشخص می کند. (مثلا 5)
`tax`	واحد پول	خیر	کل مالیات معامله را مشخص می کند. (به عنوان مثال 1.29)

داده مورد

یک آیتم نشان دهنده تک تک محصولاتی است که در سبد خرید بودند و حاوی مقادیر زیر است:

کلید	نوع ارزش	ضروری	شرح
`id`	متن	آره	شناسه تراکنش این شناسه چیزی است که اقلام را به تراکنش هایی که به آن تعلق دارند پیوند می دهد. (مثلا 1234)
`name`	متن	آره	نام مورد. (مثلاً خرگوش های صورتی کرکی)
`sku`	متن	خیر	SKU یا کد مورد را مشخص می کند. (به عنوان مثال SKU47)
`category`	متن	خیر	دسته ای که کالا به آن تعلق دارد (مثلاً اسباب بازی های مهمانی)
`price`	واحد پول	خیر	فرد، واحد، قیمت برای هر کالا. (به عنوان مثال 11.99)
`quantity`	عدد صحیح	خیر	تعداد واحدهای خریداری شده در معامله. اگر یک مقدار غیر صحیح به این قسمت ارسال شود (مثلا 1.5)، به نزدیکترین مقدار صحیح گرد می شود.

پیاده سازی

شما معمولاً زمانی که کاربر فرآیند پرداخت را تکمیل کرد، اندازه گیری تجارت الکترونیک را اجرا می کنید. این معمولاً در صفحه "متشکرم" رخ می دهد. پس از ارسال داده‌های تجارت الکترونیک به Google Analytics، و آماده شدن برای ارسال داده‌های تجارت الکترونیک، چند مرحله وجود دارد که باید طی کنید:

افزونه تجارت الکترونیک را بارگیری کنید
افزودن تراکنش
افزودن موارد
ارسال داده ها
پاک کردن داده ها

افزونه تجارت الکترونیک را بارگیری کنید

برای کاهش اندازه کتابخانه analytics.js، اندازه‌گیری تجارت الکترونیک در کتابخانه پیش‌فرض ارائه نشده است. در عوض به عنوان یک ماژول پلاگین ارائه شده است که باید قبل از استفاده بارگیری شود.

برای بارگذاری افزونه تجارت الکترونیک، از دستور زیر استفاده کنید:

ga('require', 'ecommerce');

این دستور باید بعد از ایجاد شی ردیاب خود و قبل از استفاده از هر یک از عملکردهای خاص تجارت الکترونیک اعمال شود.

پس از بارگیری، چند دستور جدید مخصوص اندازه گیری تجارت الکترونیک به ردیاب پیش فرض اضافه می شود.

افزودن تراکنش

پس از بارگیری افزونه، یک شیء سبد خرید شفاف ایجاد می کند. می‌توانید داده‌های تراکنش و کالا را به سبد خرید اضافه کنید و پس از پیکربندی کامل، همه داده‌ها را به یکباره ارسال کنید.

داده های تراکنش را با استفاده از دستور ecommerce:addTransaction به سبد خرید اضافه می کنید:

ga('ecommerce:addTransaction', {
  'id': '1234',                     // Transaction ID. Required.
  'affiliation': 'Acme Clothing',   // Affiliation or store name.
  'revenue': '11.99',               // Grand Total.
  'shipping': '5',                  // Shipping.
  'tax': '1.29'                     // Tax.
});

افزودن موارد

در مرحله بعد، برای افزودن اقلام به سبد خرید، از دستور ecommerce:addItem استفاده می کنید:

ga('ecommerce:addItem', {
  'id': '1234',                     // Transaction ID. Required.
  'name': 'Fluffy Pink Bunnies',    // Product name. Required.
  'sku': 'DD23444',                 // SKU/code.
  'category': 'Party Toys',         // Category or variation.
  'price': '11.99',                 // Unit price.
  'quantity': '1'                   // Quantity.
});

ارسال داده ها

در نهایت، هنگامی که تمام داده های تجارت الکترونیک خود را در سبد خرید پیکربندی کردید، داده ها را با استفاده از دستور ecommerce:send به Google Analytics ارسال می کنید:

ga('ecommerce:send');

این دستور هر تراکنش و کالای موجود در سبد خرید را مرور می کند و داده های مربوطه را به Google Analytics ارسال می کند. پس از تکمیل، سبد خرید پاک شده و آماده ارسال داده ها برای تراکنش جدید است. اگر فرمان قبلی ecommerce:send صادر شده باشد، فقط داده های تراکنش و آیتم جدید ارسال می شود.

پاک کردن داده ها

در صورت نیاز به پاکسازی دستی سبد خرید از تمامی تراکنش ها و اقلام، از دستور زیر استفاده می کنید:

ga('ecommerce:clear');

مشخص کردن ارزهای محلی

به‌طور پیش‌فرض، می‌توانید از طریق رابط وب مدیریت Google Analytics، یک واحد پول رایج، جهانی را برای همه تراکنش‌ها و موارد پیکربندی کنید. به طور پیش فرض، ارز جهانی برای همه اقلام و معاملات استفاده می شود. برای وب‌سایت‌هایی که معاملات را با چندین ارز انجام می‌دهند، افزونه تجارت الکترونیک به شما امکان می‌دهد واحد پول محلی تراکنش و همچنین محصولات جداگانه را مشخص کنید.

واحد پول محلی باید در استاندارد ISO 4217 مشخص شود. برای فهرست کامل ارزهای تبدیل پشتیبانی شده، سند مرجع کدهای ارز را بخوانید.

برای تنظیم واحد پول محلی یک تراکنش خاص و همه موارد آن، فقط باید واحد پول تراکنش را مشخص کنید:

ga('ecommerce:addTransaction', {
  'id': '1234',
  'affiliation': 'Acme Clothing',
  'revenue': '11.99',
  'shipping': '5',
  'tax': '1.29',
  'currency': 'EUR'  // local currency code.
});

در نهایت، شما همچنین می توانید واحد پول را برای هر مورد مشخص کنید:

  ga('ecommerce:addItem', {
    'id': '1234',
    'name': 'Fluffy Pink Bunnies',
    'sku': 'DD23444',
    'category': 'Party Toys',
    'price': '11.99',
    'quantity': '1',
    'currency': 'GBP' // local currency code.
  });

پشتیبانی از ردیاب چندگانه

همچنین اگر چندین ردیاب (با نام) را در صفحه خود پیاده سازی کرده اید، می توانید از افزونه تجارت الکترونیک استفاده کنید. این افزونه دقیقاً مانند ردیاب پیش‌فرض کار می‌کند، با این تفاوت که فرمت آن عبارت است از: trackerName.pluginName:method . به عنوان مثال اگر یک ردیاب به نام myTracker ایجاد کرده اید:

ga('create', 'UA-XXXXX-Y', 'auto', {'name': 'myTracker'});

سپس افزونه تجارت الکترونیک را برای آن ردیاب نامگذاری شده با استفاده از:

ga('myTracker.require', 'ecommerce');

برای ارسال یک تراکنش، می‌توانید یک شی تراکنش ایجاد کنید و آن را به صورت زیر به ردیاب نام‌گذاری شده ارسال کنید:

var transaction = {
  'id': '1234',                    // Transaction ID.
  'affiliation': 'Acme Clothing',  // Affiliation or store name.
  'revenue': '11.99',              // Grand Total.
  'shipping': '5' ,                // Shipping.
  'tax': '1.29'                    // Tax.
};

ga('myTracker.ecommerce:addTransaction', transaction);

با استفاده از این نحو، شی تراکنش را می توان بر روی ردیاب های متعدد استفاده کرد.

در نهایت، داده های تراکنش را به صورت زیر ارسال می کنید:

ga('myTracker.ecommerce:send');

مثال

اکثر سایت های تجارت الکترونیک تراکنش ها را روی سرور انجام می دهند، در حالی که کتابخانه analytics.js داده ها را از مرورگر به Google Analytics ارسال می کند. بنابراین کمی هماهنگی بین سرور و مشتری برای ارسال صحیح داده های تجارت الکترونیک به Google Analytics لازم است.

اکثر سایت‌های تجارت الکترونیک صفحه «متشکرم» خود را با استفاده از موتور قالب سمت سرور ارائه می‌کنند. در این مورد، کد اندازه گیری تجارت الکترونیک را به قالب سمت سرور اضافه می کنید و از منطق سرور برای نوشتن پویا مقادیر داده های تجارت الکترونیک در صفحه نهایی استفاده می کنید. در اینجا مثالی از این است که چگونه در PHP به نظر می رسد.

در PHP، شما معمولاً نمایشی از داده های تجارت الکترونیک دارید. در این مثال، داده ها در یک آرایه انجمنی ذخیره می شوند:

<?php
// Transaction Data
$trans = array('id'=>'1234', 'affiliation'=>'Acme Clothing',
               'revenue'=>'11.99', 'shipping'=>'5', 'tax'=>'1.29');

// List of Items Purchased.
$items = array(
  array('sku'=>'SDFSDF', 'name'=>'Shoes', 'category'=>'Footwear', 'price'=>'100', 'quantity'=>'1'),
  array('sku'=>'123DSW', 'name'=>'Sandals', 'category'=>'Footwear', 'price'=>'87', 'quantity'=>'1'),
  array('sku'=>'UHDF93', 'name'=>'Socks', 'category'=>'Footwear', 'price'=>'5.99', 'quantity'=>'2')
);
?>

اولین قدم نوشتن منطقی برای تبدیل داده های تجارت الکترونیک به رشته جاوا اسکریپت مورد نیاز analytics.js است:

<?php
// Function to return the JavaScript representation of a TransactionData object.
function getTransactionJs(&$trans) {
  return <<<HTML
ga('ecommerce:addTransaction', {
  'id': '{$trans['id']}',
  'affiliation': '{$trans['affiliation']}',
  'revenue': '{$trans['revenue']}',
  'shipping': '{$trans['shipping']}',
  'tax': '{$trans['tax']}'
});
HTML;
}

// Function to return the JavaScript representation of an ItemData object.
function getItemJs(&$transId, &$item) {
  return <<<HTML
ga('ecommerce:addItem', {
  'id': '$transId',
  'name': '{$item['name']}',
  'sku': '{$item['sku']}',
  'category': '{$item['category']}',
  'price': '{$item['price']}',
  'quantity': '{$item['quantity']}'
});
HTML;
}
?>

سپس در تگ <script> می‌توانید منطق PHP اضافی را برای خروجی پویا تراکنش و داده آیتم اضافه کنید:

<!-- Begin HTML -->
<script>
ga('require', 'ecommerce');

<?php
echo getTransactionJs($trans);

foreach ($items as &$item) {
  echo getItemJs($trans['id'], $item);
}
?>

ga('ecommerce:send');
</script>

پس از اجرای اسکریپت PHP، داده های تراکنش و آیتم مورد نیاز analytics.js در صفحه چاپ می شود. هنگامی که جاوا اسکریپت در صفحه در مرورگر ارائه شد، تمام داده های تجارت الکترونیک به Google Analytics ارسال می شود.

انواع ارز

نوع ارز پیش فرض را می توان از طریق رابط مدیریت پیکربندی کرد. وقتی مقادیر ارز را با استفاده از analytics.js ارسال می کنید، این مقدار ارزش کل یک ارز را نشان می دهد.

نقطه اعشار را می توان به عنوان جداکننده بین کل و بخش کسری ارز استفاده کرد. دقت تا 6 رقم اعشار است. موارد زیر برای یک فیلد ارز معتبر است:

1000.000001

پس از ارسال مقدار به Google Analytics، تمام متن تا اولین رقم، کاراکتر - یا . کاراکتر (اعشاری). بنابراین:

$-55.00

خواهد شد:

-55.00