تگ Google را در CMS یا سازنده وب سایت خود ادغام کنید

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

این راهنما نحوه ادغام برچسب گوگل در سیستم مدیریت محتوا (CMS) یا سازنده وب‌سایت شما را شرح می‌دهد تا کاربران نهایی شما به محصولات اندازه‌گیری گوگل دسترسی داشته باشند.

مخاطب

این راهنما برای دارندگان سیستم‌های مدیریت محتوا (CMS) یا سازندگان وب‌سایت در نظر گرفته شده است که می‌خواهند به کاربران خود امکان ادغام با محصولات اندازه‌گیری گوگل را ارائه دهند. این راهنما برای کاربران CMS یا سازنده وب‌سایت در نظر گرفته نشده است.

قبل از اینکه شروع کنی

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

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

نمای کلی

برای ادغام پلتفرم خود با محصولات گوگل، این مراحل را دنبال کنید:

1. ایجاد یکپارچگی با تگ گوگل
2. ساختار ورودی کاربر خود را به‌روزرسانی کنید
3. پیاده‌سازی API رضایت‌نامه
4. تنظیم داده‌های رویداد
5. ادغام به‌روز شده خود را تأیید کنید
6. دستورالعمل‌های استقرار کاربر را به‌روزرسانی کنید

ایجاد یکپارچگی با تگ گوگل

با ایجاد یکپارچه‌سازی با تگ گوگل، مشتریان شما می‌توانند محصولات اندازه‌گیری گوگل (از طریق gtag.js) را در هر صفحه از سایت خود مستقر کنند. قبل از ایجاد یکپارچه‌سازی با gtag.js، حتماً هرگونه یکپارچه‌سازی تگ قدیمی موجود (به عنوان مثال، analytics.js) را حذف کنید.

برای ایجاد یکپارچه‌سازی با تگ گوگل، قطعه کد موجود خود را با قطعه کد زیر جایگزین کنید. مطمئن شوید که کاربران می‌توانند TAG_ID با شناسه تگ خود جایگزین کنند.

<!-- Google tag (gtag.js) -->
<script async src="https://www.googletagmanager.com/gtag/js?id=GOOGLE_TAG_ID"></script>
<script>
  window.dataLayer = window.dataLayer || [];
  function gtag(){dataLayer.push(arguments);}
  gtag('set', 'developer_id.<developer ID>', true); // Replace with your Google tag Developer ID
  gtag('js', new Date());

  gtag('config', 'GOOGLE_TAG_ID');
</script>

به موارد زیر توجه کنید:

• تبلیغ‌کنندگان می‌توانند با پارامتر allow_ad_personalization_signals از ویژگی‌های شخصی‌سازی تبلیغات مانند بازاریابی مجدد انصراف دهند ( به غیرفعال کردن جمع‌آوری داده‌های تبلیغات شخصی‌سازی‌شده مراجعه کنید).
• در حالت ایده‌آل، قطعه کد تگ گوگل باید فقط یک بار در هر صفحه ظاهر شود. این قطعه کد می‌تواند چندین شناسه تگ را در خود جای دهد. اگر نمونه‌ای از gtag.js وجود دارد، باید شناسه‌های تگ جدیدی را به تگ موجود اضافه کنید. اطلاعات بیشتر .

ساختار ورودی کاربر خود را به‌روزرسانی کنید

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

برای مثال، شکل زیر یک ورودی ساده تگ گوگل را نشان می‌دهد. این ادغام باید به عنوان یک استقرار برای تگ گوگل در نظر گرفته شود. این می‌تواند به عنوان روشی برای استقرار گوگل ادز و گوگل آنالیتیکس نیز عنوان فرعی داشته باشد.

از طرف دیگر، نمودار زیر نشان می‌دهد که چگونه یک پلتفرم ممکن است جریان‌های کاربری جداگانه‌ای برای Analytics و Ads داشته باشد، اما هر جریان به یک رابط کاربری منتهی می‌شود که در آن کاربران شناسه تگ گوگل خود را ارائه می‌دهند.

ورودی شناسه برچسب باید چندین نوع شناسه را با استفاده از الگوی عبارت منظم [AZ]{1,3}\\w{5,}[\w]* بپذیرد.

پیاده‌سازی API رضایت (معروف به حالت رضایت)

تگ گوگل دارای یک API رضایت داخلی برای مدیریت رضایت کاربر است. این API می‌تواند رضایت کاربر برای کوکی‌ها برای اهداف تبلیغاتی را از کوکی‌ها برای اهداف تحلیلی متمایز کند.

نتیجه مورد انتظار این است که مشتریان حداقل فراخوانی gtag('consent', 'update' {...}) بدون نیاز به هیچ اقدامی از سوی مشتری دریافت کنند. این باید تضمین کند که برچسب‌های گوگل (Google Ads، Floodlight، Google Analytics، Conversion Linker) قادر به خواندن آخرین وضعیت رضایت کاربر و لحاظ کردن این وضعیت در درخواست‌های شبکه به گوگل (از طریق پارامتر &gcs ) هستند.

مراحل پیاده‌سازی اضافی شامل استقرار یا کمک به تبلیغ‌کنندگان در استقرار (مثلاً از طریق رابط کاربری) حالت gtag('consent', default' {...}) و رفع انسداد تگ‌های گوگل (یعنی عدم فعال‌سازی مشروط مبتنی بر رضایت) برای فعال کردن حالت رضایت برای فعال‌سازی آنها به شیوه‌ای آگاهانه از رضایت است.

برای جزئیات پیاده‌سازی، به مدیریت تنظیمات رضایت (وب) مراجعه کنید.

تنظیم داده‌های رویداد

شما باید داده‌های غنی از رویدادها را از وب‌سایت مشتری به حساب گوگل او ارسال کنید، بدون اینکه مشتری نیازی به انجام کاری داشته باشد. برای مثال، می‌توانید رویدادها را در امتداد قیف خرید (مثلاً add_to_cart ، begin_checkout ، add_payment_info ، add_shipping_info و purchase )، تولید سرنخ (lead generation) و ثبت‌نام‌ها اضافه کنید.

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

• همه چیز ممکن را ثبت کنید
• حداقل ۸ رویداد اصلی را تنظیم کنید
• رویدادهای تجارت الکترونیک را در اولویت قرار دهید

همه چیز ممکن را ثبت کنید

در صورت امکان، باید رویدادها را به صورت پیش‌فرض تنظیم کنید. این شامل موارد زیر است:

• رویدادهای کلیدی، مانند purchase یا sign_up
• رویدادهای قبل از رویدادهای کلیدی مانند add_to_cart
• تعاملات رفتاری مانند تعاملات رسانه‌ای که به مشتریان کمک می‌کند تا نحوه تعامل با کاربران نهایی خود را درک کنند.

شما باید اسنیپت‌های رویدادهای کلیدی را فقط به صفحات رویدادهای کلیدی اضافه کنید (مثلاً تأیید خرید، تأیید ارسال فرم). توجه داشته باشید که همچنان باید برچسب گوگل را در هر صفحه از سایت اضافه کنید.

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

gtag('event', 'my_event', {
  'developer_id.<developer ID>': true,
  // Additional event parameters
});

برای مثال، می‌توانید از دستور event برای ارسال یک رویداد login با مقدار method "Google" استفاده کنید:

gtag('event', 'login', {
  'developer_id.<developer ID>': true,
  'method': 'Google'
});

<!-- Event snippet for sales conversion page -->
<script>
  gtag('event', 'conversion', {
      'developer_id.<developer ID>': true,
      'value': <value>,
      'currency': '<currency>',
      'transaction_id': '<transaction_id>'
  });
</script>

به موارد زیر توجه کنید:

• شناسه توسعه‌دهنده شما <developer ID> منحصر به فرد و مختص پلتفرم شماست. این شناسه را به هر رویداد پیوست کنید.
• پارامترهای زیر اختیاری هستند و می‌توان آنها را حذف کرد:
  • 'value' مقدار عددی رویداد کلیدی است (مثلاً قیمت یک خرید)
  • 'currency' یک کد ارزی سه حرفی است که برای تبلیغ‌کنندگانی که چندین ارز را می‌پذیرند مفید است.
  • 'transaction_id' یک شناسه منحصر به فرد برای تراکنش است (مثلاً شناسه سفارش)؛ از آن برای جلوگیری از تکرار استفاده می‌شود.
• اگرچه برخی از پارامترها اختیاری هستند، توصیه می‌شود تا حد امکان اطلاعات مربوط به هر رویداد را وارد کنید.
  • پارامترها اطلاعات بیشتری در مورد روش‌های تعامل کاربران با وب‌سایت یا برنامه شما ارائه می‌دهند. به عنوان مثال، وقتی کسی محصولی را که می‌فروشید مشاهده می‌کند، می‌توانید پارامترهایی را که محصول مشاهده شده را توصیف می‌کنند، مانند نام، دسته بندی و قیمت، در نظر بگیرید.
  • برخی پارامترها به طور خودکار ابعاد و معیارهای از پیش ساخته شده در گوگل آنالیتیکس را پر می‌کنند و به کاربران درک بهتری از مشتریانشان می‌دهند.

اگر می‌خواهید یک رویداد کلیدی را بر اساس کلیک اندازه‌گیری کنید (مثلاً کلیک روی یک دکمه یا یک پاسخ پویا برای یک سایت با استفاده از AJAX)، می‌توانید از قطعه کد زیر نیز استفاده کنید:

<!-- Event snippet for sales conversion page
    In your HTML page, add the snippet and call gtag_report_conversion
    when someone clicks on the chosen link or button. -->
<script>
  function gtag_report_conversion(url) {
  var callback = function () {
    if (typeof(url) != 'undefined') {
      window.location = url;
    }
  };
  gtag('event', 'conversion', {
    'developer_id.<developer ID>': true,
    'value': <value>,
    'currency': '<currency>',
    'transaction_id': '<transaction_id>',
    'event_callback': callback
  });
  return false;
}
</script>

حداقل ۸ رویداد اصلی را تنظیم کنید

توصیه می‌کنیم مجموعه‌ای از رویدادهای اصلی را تنظیم کنید که بیشترین ارزش را برای صاحبان سایت داشته باشند. حداقل توصیه می‌کنیم رویدادهای زیر را تنظیم کنید:

• view_item_list : زمانی که کاربر لیستی از آیتم‌ها (مثلاً لیست محصولات) را مشاهده می‌کند. اطلاعات بیشتر

  gtag('event', 'view_item_list', {
    item_list_id: "related_products",
    item_list_name: "Related products",
    items: [{
      item_id: "SKU_123",
      item_name: "Test Item",
      currency: "USD",
      discount: 2.22,
      price: 99.9,
      quantity: 1
    }]
  });
  

• add_to_cart : وقتی کاربر یک یا چند محصول را به سبد خرید اضافه می‌کند. اطلاعات بیشتر

  gtag('event', 'add_to_cart', {
    value: 99.0,
    currency: "USD",
    items: [{
      item_id: "SKU_123",
      item_name: "Test Product",
      price: 99.0,
      currency: 'USD',
      quantity: 1,
      item_category: "All Products"
    }]
  });
  

• begin_checkout : زمانی که کاربر فرآیند پرداخت یک یا چند محصول را آغاز می‌کند. اطلاعات بیشتر

  gtag('event', 'begin_checkout') {
    value: 99.0,
    currency: "USD",
    items: [{
      item_id: "SKU_123",
      item_name: "Test Product",
      price: 99.0,
      currency: 'USD',
      quantity: 1,
      item_category: "All Products"
    }]
  });
  

• purchase : زمانی که کاربر یک یا چند محصول یا خدمات را خریداری می‌کند. اطلاعات بیشتر

  gtag('event', 'purchase', {value: XX, currency: 'USD', items: [{xx},{xx}]});
  

• sign_up : زمانی که یک کاربر ثبت نام می‌کند، کاربر نهایی می‌تواند محبوب‌ترین روش‌های ثبت نام (مثلاً حساب گوگل، آدرس ایمیل) را مشاهده کند. اطلاعات بیشتر

  gtag('event', 'sign_up', {method: 'web'});
  

• generate_lead : زمانی که کاربر فرمی را ارسال می‌کند. اطلاعات بیشتر

  gtag('event', 'generate_lead', {value: XX, currency: 'USD'});
  

• subscribe : زمانی که یک کاربر در یک سرویس یا خبرنامه مشترک می‌شود.

  gtag('event', 'subscribe', {value: XX, currency: 'USD', coupon: 'XX'});
  

• book_appointment : زمانی که کاربر یک قرار ملاقات رزرو می‌کند.

  gtag('event', 'book_appointment', {value: XX, currency: 'USD', coupon: 'XX'});
  

توصیه‌های اضافی

گوگل از رویدادها و پارامترهای بسیار بیشتری، به ویژه برای تجارت الکترونیک، پشتیبانی می‌کند. به طور کلی، توصیه می‌کنیم موارد زیر را ثبت کنید:

• هر رویداد موفقیت‌آمیزی که مستقیماً با ارزش مرتبط باشد
• رویدادهای موفقیت‌آمیزی که به رویدادهای کلیدی اصلی (افزودن به سبد خرید، ثبت نام و غیره) کمک می‌کنند
• تعاملات و تعاملات کاربر که به تبلیغ‌کنندگان کمک می‌کند تا بفهمند چگونه کاربران نهایی خود را درگیر می‌کنند

منابع اضافی زیر، جمع‌آوری رویدادها را بیشتر توضیح می‌دهند:

• رویدادها
• رویدادهای توصیه‌شده بر اساس مورد استفاده
• تجارت الکترونیک را برای ویژگی‌های گوگل آنالیتیکس اندازه‌گیری کنید

ما علاقه‌مند به بحث در مورد افزونه‌های احتمالی این طرح هستیم، بنابراین لطفاً اگر پیشنهادی دارید به ما اطلاع دهید.

ادغام به‌روز شده خود را تأیید کنید

قبل از اینکه تغییرات خود را به محیط عملیاتی (production) منتقل کنید، سازگاری آنها را با موارد زیر بررسی کنید:

• برچسب گوگل شما با یک مقصد گوگل آنالیتیکس
• برچسب گوگل شما برای بازاریابی مجدد و اندازه‌گیری تبدیل

علاوه بر این، با استفاده از هر یک از این ابزارها، تأیید کنید که تگ به درستی در تمام صفحات، از جمله صفحات رویدادهای کلیدی، فعال می‌شود:

• دستیار برچسب گوگل : دستیار برچسب به شما امکان می‌دهد ببینید کدام برچسب‌های گوگل و به چه ترتیبی فعال شده‌اند. حالت اشکال‌زدایی دستیار برچسب نشان می‌دهد چه داده‌هایی به لایه داده منتقل می‌شوند و چه رویدادهایی باعث ایجاد این تبادلات داده شده‌اند.
• ابزارهای توسعه‌دهنده کروم : از تب شبکه برای فیلتر کردن درخواست‌هایی که حاوی «google» هستند استفاده کنید تا نحوه ارسال داده‌ها را تأیید کنید.
• گزارش بلادرنگ گوگل آنالیتیکس (سمت سرور): یک حساب کاربری رایگان گوگل آنالیتیکس ایجاد کنید و از گزارش بلادرنگ برای بررسی دریافت تگ‌های دریافتی توسط سرورهای گوگل استفاده کنید.

برای گزارش اشکال یا ارائه بازخورد در مورد اطلاعات ناقص، فرم پشتیبانی سیستم مدیریت محتوا را پر کنید.

در صورت امکان، لطفاً دسترسی آزمایشی را برای تأیید مداوم با Google به اشتراک بگذارید.

دستورالعمل‌های استقرار کاربر را به‌روزرسانی کنید

مستندات خود را به‌روزرسانی کنید تا دستورالعمل‌های روشنی در مورد نحوه پیاده‌سازی محصولات اندازه‌گیری گوگل با استفاده از پیاده‌سازی شما ارائه شود. با پر کردن فرم بررسی مستندات راه‌اندازی یکپارچه‌سازی CMS، پیش‌نویس این دستورالعمل‌ها را به اشتراک بگذارید تا بتوانیم بازخورد ارائه دهیم.