تجارت الکترونیکی پیشرفته

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

انواع داده ها و اقدامات تجارت الکترونیک پیشرفته

انواع مختلفی از داده های تجارت الکترونیک وجود دارد که می توانید ارسال کنید:

داده های برداشت

نشان دهنده اطلاعات مربوط به محصولی است که مشاهده شده است. به آن impressionFieldObject گفته می شود و حاوی مقادیر زیر است:

کلید نوع ارزش ضروری شرح
id متن *آره

شناسه محصول یا SKU (به عنوان مثال P67890).

* یکی از id یا name باید تنظیم شود.

name متن *آره

نام محصول (مثلا تی شرت اندروید).

* یکی از id یا name باید تنظیم شود.

list_name متن خیر لیست یا مجموعه ای که محصول به آن تعلق دارد (مثلاً نتایج جستجو)
brand متن خیر نام تجاری مرتبط با محصول (به عنوان مثال گوگل).
category متن خیر دسته ای که محصول به آن تعلق دارد (مثلاً پوشاک). از / به عنوان یک جداکننده برای تعیین حداکثر 5 سطح سلسله مراتب استفاده کنید (مانند پوشاک / مردانه / تی شرت).
variant متن خیر نوع محصول (به عنوان مثال مشکی).
list_position عدد صحیح خیر موقعیت محصول در یک لیست یا مجموعه (مثلاً 2).
price عدد خیر قیمت یک محصول (به عنوان مثال 29.20).

اطلاعات محصول

داده‌های محصول نشان‌دهنده محصولات فردی است که مشاهده شده، به سبد خرید اضافه شده‌اند، و غیره. به عنوان productFieldObject نامیده می‌شود و حاوی مقادیر زیر است:

کلید نوع ارزش ضروری شرح
id متن *آره

شناسه محصول یا SKU (به عنوان مثال P67890).

* یکی از شناسه یا name باید تنظیم شود.

name متن *آره

نام محصول (مثلا تی شرت اندروید).

* یکی از شناسه یا name باید تنظیم شود.

brand متن خیر نام تجاری مرتبط با محصول (به عنوان مثال گوگل).
category متن خیر دسته ای که محصول به آن تعلق دارد (مثلاً پوشاک). از / به عنوان یک جداکننده برای تعیین حداکثر 5 سطح سلسله مراتب استفاده کنید (مانند پوشاک / مردانه / تی شرت).
variant متن خیر نوع محصول (به عنوان مثال مشکی).
price عدد خیر قیمت یک محصول (به عنوان مثال 29.20).
quantity عدد صحیح خیر مقدار یک محصول (به عنوان مثال 2).
coupon متن خیر کد کوپن مرتبط با یک محصول (به عنوان مثال SUMMER_SALE13).
list_position عدد صحیح خیر موقعیت محصول در یک لیست یا مجموعه (مثلاً 2).

داده های تبلیغاتی

نشان دهنده اطلاعات تبلیغاتی است که مشاهده شده است. به یک promoFieldObject ارجاع داده می شود و حاوی مقادیر زیر است:

کلید نوع ارزش ضروری شرح
id متن *آره

شناسه تبلیغ (به عنوان مثال PROMO_1234).

* یکی از id یا name باید تنظیم شود.

name متن *آره

نام تبلیغات (به عنوان مثال فروش تابستانی).

* یکی از id یا name باید تنظیم شود.

creative_name متن خیر نام خلاق (به عنوان مثال summer_banner2).
creative_slot متن خیر نام اسلات خلاق (به عنوان مثال banner_slot_1).

داده های اقدام

نشان دهنده اطلاعات مربوط به یک اقدام مرتبط با تجارت الکترونیک است که انجام شده است. به آن actionFieldObject گفته می شود و حاوی مقادیر زیر است:

کلید نوع ارزش ضروری شرح
id متن *آره

شناسه تراکنش (به عنوان مثال T1234).

* اگر نوع اقدام purchase یا refund باشد، الزامی است

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. کد اندازه گیری را برای اندازه گیری هر مرحله از فرآیند پرداخت اضافه کنید.
  2. در صورت وجود، کد اندازه گیری را برای ضبط گزینه های پرداخت اضافه کنید.

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'
    }
  ]
});