این صفحه نحوه استفاده از gtag.js را برای جمع آوری داده های تجارت الکترونیک پیشرفته توضیح می دهد. اگر Google Analytics را در gtag.js پیکربندی کردهاید و تجارت الکترونیک پیشرفته را در Google Analytics فعال کردهاید ، میتوانید از gtag.js برای ارسال دادههای نمایش، دادههای محصول، دادههای تبلیغات و دادههای اقدام به Google Analytics استفاده کنید.
انواع داده ها و اقدامات تجارت الکترونیک پیشرفته
انواع مختلفی از داده های تجارت الکترونیک وجود دارد که می توانید ارسال کنید:
داده های برداشت
نشان دهنده اطلاعات مربوط به محصولی است که مشاهده شده است. به آن impressionFieldObject
گفته می شود و حاوی مقادیر زیر است:
کلید | نوع ارزش | ضروری | شرح |
---|---|---|---|
id | متن | *آره | شناسه محصول یا SKU (به عنوان مثال P67890). * یکی از |
name | متن | *آره | نام محصول (مثلا تی شرت اندروید). * یکی از |
list_name | متن | خیر | لیست یا مجموعه ای که محصول به آن تعلق دارد (مثلاً نتایج جستجو) |
brand | متن | خیر | نام تجاری مرتبط با محصول (به عنوان مثال گوگل). |
category | متن | خیر | دسته ای که محصول به آن تعلق دارد (مثلاً پوشاک). از / به عنوان یک جداکننده برای تعیین حداکثر 5 سطح سلسله مراتب استفاده کنید (مانند پوشاک / مردانه / تی شرت). |
variant | متن | خیر | نوع محصول (به عنوان مثال مشکی). |
list_position | عدد صحیح | خیر | موقعیت محصول در یک لیست یا مجموعه (مثلاً 2). |
price | عدد | خیر | قیمت یک محصول (به عنوان مثال 29.20). |
اطلاعات محصول
دادههای محصول نشاندهنده محصولات فردی است که مشاهده شده، به سبد خرید اضافه شدهاند، و غیره. به عنوان productFieldObject
نامیده میشود و حاوی مقادیر زیر است:
کلید | نوع ارزش | ضروری | شرح |
---|---|---|---|
id | متن | *آره | شناسه محصول یا SKU (به عنوان مثال P67890). * یکی از شناسه یا |
name | متن | *آره | نام محصول (مثلا تی شرت اندروید). * یکی از شناسه یا |
brand | متن | خیر | نام تجاری مرتبط با محصول (به عنوان مثال گوگل). |
category | متن | خیر | دسته ای که محصول به آن تعلق دارد (مثلاً پوشاک). از / به عنوان یک جداکننده برای تعیین حداکثر 5 سطح سلسله مراتب استفاده کنید (مانند پوشاک / مردانه / تی شرت). |
variant | متن | خیر | نوع محصول (به عنوان مثال مشکی). |
price | عدد | خیر | قیمت یک محصول (به عنوان مثال 29.20). |
quantity | عدد صحیح | خیر | مقدار یک محصول (به عنوان مثال 2). |
coupon | متن | خیر | کد کوپن مرتبط با یک محصول (به عنوان مثال SUMMER_SALE13). |
list_position | عدد صحیح | خیر | موقعیت محصول در یک لیست یا مجموعه (مثلاً 2). |
داده های تبلیغاتی
نشان دهنده اطلاعات تبلیغاتی است که مشاهده شده است. به یک promoFieldObject
ارجاع داده می شود و حاوی مقادیر زیر است:
کلید | نوع ارزش | ضروری | شرح |
---|---|---|---|
id | متن | *آره | شناسه تبلیغ (به عنوان مثال PROMO_1234). * یکی از |
name | متن | *آره | نام تبلیغات (به عنوان مثال فروش تابستانی). * یکی از |
creative_name | متن | خیر | نام خلاق (به عنوان مثال summer_banner2). |
creative_slot | متن | خیر | نام اسلات خلاق (به عنوان مثال banner_slot_1). |
داده های اقدام
نشان دهنده اطلاعات مربوط به یک اقدام مرتبط با تجارت الکترونیک است که انجام شده است. به آن actionFieldObject
گفته می شود و حاوی مقادیر زیر است:
کلید | نوع ارزش | ضروری | شرح |
---|---|---|---|
id | متن | *آره | شناسه تراکنش (به عنوان مثال T1234). * اگر نوع اقدام |
affiliation | متن | خیر | فروشگاه یا وابستگی که این تراکنش از آن انجام شده است (مثلاً فروشگاه Google). |
ارزش | عدد | خیر | ارزش (یعنی درآمد) مرتبط با رویداد. |
tax | عدد | خیر | کل مالیات مربوط به معامله. |
shipping | عدد | خیر | هزینه حمل و نقل مرتبط با معامله. |
items | آرایه | خیر | آرایه حاوی محصولات مرتبط |
checkout_step | عدد صحیح | خیر | عددی که نمایانگر مرحله ای از فرآیند پرداخت است. |
checkout_option | متن | خیر | گزینه پرداخت (یعنی روش پرداخت انتخاب شده). |
کلید | نوع ارزش | ضروری | شرح |
---|---|---|---|
coupon | رشته | خیر | کد کوپن برای یک کالای قابل خرید. |
محصولات و اقدامات ترویجی
اقدامات نحوه تفسیر محصول و داده های تبلیغاتی را که به Google Analytics ارسال می کنید مشخص می کند.
رویداد | شرح |
---|---|
add_to_cart | کاربر یک یا چند محصول را به سبد خرید اضافه می کند. |
begin_checkout | کاربر فرآیند پرداخت را برای یک یا چند محصول آغاز می کند. |
checkout_progress | یک کاربر مراحل پرداخت را پس از اولین مرحله تسویه حساب کامل می کند. |
purchase | یک کاربر خرید را تکمیل می کند. |
refund | برای یک یا چند محصول به کاربر بازپرداخت داده می شود. |
remove_from_cart | کاربر یک یا چند محصول را از سبد خرید حذف می کند. |
select_content | کاربر روی لینک محصول یا محصول کلیک می کند. |
set_checkout_option | مرحله پرداختی که کاربر در حال تکمیل آن است. |
view_item | کاربر جزئیات یک محصول را مشاهده می کند. |
view_item_list | کاربر فهرستی از یک یا چند محصول را مشاهده می کند. |
view_promotion | کاربر روی یک تبلیغ داخلی کلیک می کند. |
view_refund | کاربر بازپرداخت یک یا چند محصول را مشاهده می کند. |
مثال ها
اندازه گیری برداشت محصول
برای اندازه گیری نمایش محصول، یک view_item_list
همراه با اطلاعات محصول ارسال کنید:
gtag('event', 'view_item_list', {
"items": [
{
"id": "P12345",
"name": "Android Warhol T-Shirt",
"list_name": "Search Results",
"brand": "Google",
"category": "Apparel/T-Shirts",
"variant": "Black",
"list_position": 1,
"quantity": 2,
"price": 2
},
{
"id": "P67890",
"name": "Flame challenge TShirt",
"list_name": "Search Results",
"brand": "MyBrand",
"category": "Apparel/T-Shirts",
"variant": "Red",
"list_position": 2,
"quantity": 1,
"price": 3
}
]
});
اندازه گیری کلیک محصول
برای اندازه گیری کلیک محصول، یک رویداد select_content
ارسال کنید، product
به عنوان content_type
مشخص کنید و اطلاعات محصول را ارائه دهید:
gtag('event', 'select_content', {
"content_type": "product",
"items": [
{
"id": "P12345",
"name": "Android Warhol T-Shirt",
"list_name": "Search Results",
"brand": "Google",
"category": "Apparel/T-Shirts",
"variant": "Black",
"list_position": 1,
"quantity": 2,
"price": 2
}
]
});
نماهای جزئیات محصول را اندازه گیری کنید
پس از کلیک بر روی فهرست محصول، کاربر ممکن است صفحه جزئیات محصول را مشاهده کند. برای اندازهگیری بازدیدهای جزئیات محصول، یک رویداد view_item
با جزئیات محصول ارسال کنید:
gtag('event', 'view_item', {
"items": [
{
"id": "P12345",
"name": "Android Warhol T-Shirt",
"list_name": "Search Results",
"brand": "Google",
"category": "Apparel/T-Shirts",
"variant": "Black",
"list_position": 1,
"quantity": 2,
"price": '2.0'
}
]
});
موارد اضافه و حذف از سبد خرید را اندازه گیری کنید
برای اندازه گیری اضافه شدن یک محصول به سبد خرید، یک رویداد add_to_cart
را با اطلاعات محصول ارسال کنید:
gtag('event', 'add_to_cart', {
"items": [
{
"id": "P12345",
"name": "Android Warhol T-Shirt",
"list_name": "Search Results",
"brand": "Google",
"category": "Apparel/T-Shirts",
"variant": "Black",
"list_position": 1,
"quantity": 2,
"price": '2.0'
}
]
});
برای اندازه گیری میزان حذف یک محصول از سبد خرید، رویداد remove_from_cart
را با اطلاعات محصول ارسال کنید:
gtag('event', 'remove_from_cart', {
"items": [
{
"id": "P12345",
"name": "Android Warhol T-Shirt",
"list_name": "Search Results",
"brand": "Google",
"category": "Apparel/T-Shirts",
"variant": "Black",
"list_position": 1,
"quantity": 2,
"price": '2.0'
}
]
});
پرداخت ها را اندازه گیری کنید
برای اندازه گیری هر مرحله در فرآیند پرداخت:
- کد اندازه گیری را برای اندازه گیری هر مرحله از فرآیند پرداخت اضافه کنید.
- در صورت وجود، کد اندازه گیری را برای ضبط گزینه های پرداخت اضافه کنید.
1. مراحل پرداخت را اندازه گیری کنید
برای اندازهگیری اولین مرحله پرداخت، یک رویداد begin_checkout
را با موارد پرداخت ارسال کنید:
gtag('event', 'begin_checkout', {
"items": [
{
"id": "P12345",
"name": "Android Warhol T-Shirt",
"list_name": "Search Results",
"brand": "Google",
"category": "Apparel/T-Shirts",
"variant": "Black",
"list_position": 1,
"quantity": 2,
"price": '2.0'
}
],
"coupon": ""
});
برای اندازهگیری هر مرحله تسویهحساب بعدی، یک رویداد checkout_progress
را با موارد پرداخت ارسال کنید:
gtag('event', 'checkout_progress', {
"items": [
{
"id": "P12345",
"name": "Android Warhol T-Shirt",
"list_name": "Search Results",
"brand": "Google",
"category": "Apparel/T-Shirts",
"variant": "Black",
"list_position": 1,
"quantity": 2,
"price": '2.0'
}
],
"coupon": "SUMMER_DISCOUNT"
});
2. گزینه های پرداخت را اندازه گیری کنید
برای اندازه گیری گزینه پرداخت، یک رویداد set_checkout_option
را با گزینه پرداخت ارسال کنید:
gtag('event', 'set_checkout_option', {
"checkout_step": 1,
"checkout_option": "shipping method",
"value": 3
});
اندازه گیری برداشت های تبلیغاتی
برای اندازهگیری نمایشهای تبلیغاتی، یک رویداد view_promotion
همراه با اطلاعات تبلیغاتی ارسال کنید:
gtag('event', 'view_promotion', {
"promotions": [
{
"id": "abc123",
"name": "summer_promo"
},
{
"id": "xyz987",
"name": "spring savings"
}
]
});
اندازه گیری کلیک های تبلیغاتی
برای اندازه گیری کلیک تبلیغاتی، یک رویداد select_content
ارسال کنید و تبلیغ را ارائه دهید:
gtag('event', 'select_content', {
"promotions": [
{
"id": "abc123",
"name": "summer_promo"
}
]
});
خریدها را اندازه گیری کنید
برای اندازه گیری تراکنش، یک رویداد purchase
را با موارد موجود در تراکنش ارسال کنید:
gtag('event', 'purchase', {
"transaction_id": "24.031608523954162",
"affiliation": "Google online store",
"value": 23.07,
"currency": "USD",
"tax": 1.24,
"shipping": 0,
"items": [
{
"id": "P12345",
"name": "Android Warhol T-Shirt",
"list_name": "Search Results",
"brand": "Google",
"category": "Apparel/T-Shirts",
"variant": "Black",
"list_position": 1,
"quantity": 2,
"price": '2.0'
},
{
"id": "P67890",
"name": "Flame challenge TShirt",
"list_name": "Search Results",
"brand": "MyBrand",
"category": "Apparel/T-Shirts",
"variant": "Red",
"list_position": 2,
"quantity": 1,
"price": '3.0'
}
]
});
بازپرداخت را اندازه گیری کنید
برای اندازهگیری بازپرداخت کامل تراکنش، رویداد refund
را با شناسه تراکنش ارسال کنید:
gtag('event', 'refund', { "transaction_id": "T12345" })
برای اندازهگیری بازپرداخت جزئی، یک رویداد refund
با شناسه تراکنش و مواردی که باید بازپرداخت شوند ارسال کنید:
gtag('event', 'refund', {
"transaction_id": "79.18502354114992",
"affiliation": "Google online store",
"value": 23.07,
"currency": "USD",
"tax": 1.24,
"shipping": 0,
"items": [
{
"id": "P12345",
"name": "Android Warhol T-Shirt",
"list_name": "Search Results",
"brand": "Google",
"category": "Apparel/T-Shirts",
"variant": "Black",
"list_position": 1,
"quantity": 2,
"price": '2.0'
},
{
"id": "P67890",
"name": "Flame challenge TShirt",
"list_name": "Search Results",
"brand": "MyBrand",
"category": "Apparel/T-Shirts",
"variant": "Red",
"list_position": 2,
"quantity": 1,
"price": '3.0'
}
]
});