کد رهگیری: شی جهانی _gaq، کد رهگیری: شی جهانی _gaq

شی سراسری _gaq می توان مستقیماً برای ردیابی صفحه ناهمزمان از طریق روش push(...) استفاده کرد. همچنین روش هایی برای ایجاد اشیاء ردیاب دارد، اما این روش ها فقط باید در موارد نادر مورد استفاده قرار گیرند.

برای ردیابی صفحه سنتی ، به جای آن از شی سراسری _gat استفاده کنید.

_gaq روش های شی

جزئیات روش

_createAsyncTracker()

    _createAsyncTracker(accountId, opt_name)
    به جای آن از _gat._createTracker (opt_account, opt_name) استفاده کنید.
      یک شی ردیاب ایجاد می‌کند که هنگام برقراری تماس‌های ردیابی ناهمزمان می‌توان به آن اشاره کرد. اگر نامی داده نشود، رشته خالی
    '' خواهد بود که نشان دهنده ردیاب پیش فرض در نحو ناهمزمان است. اگر یک ردیاب ناهمزمان از قبل برای نام داده شده وجود داشته باشد، با ردیاب جدید بازنویسی می شود.

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

        پارامترهای

      _gaq._createAsyncTracker('UA-65432-1');
      String accountId شناسه کامل ویژگی وب (به عنوان مثال UA-65432-1) برای شی ردیاب.
      String opt_name نامی که شی ردیاب در آن ذخیره می شود. از این نام برای اشاره به شی ردیاب در تماس‌های ردیابی ناهمزمان بعداً استفاده کنید.

      برمی گرداند

        Tracker شی ردیابی ایجاد شده.

        _getAsyncTracker()

          _getAsyncTracker(opt_name)
          به جای آن از _gat._getTrackerByName (opt_name) استفاده کنید.
            شی ردیاب را که قبلاً تحت نام داده شده ایجاد شده بود برمی گرداند. اگر نامی داده نشود، از نام پیش‌فرض ردیاب (رشته خالی
          '' ) استفاده می‌شود. اگر هیچ شی ردیاب با نام داده شده وجود نداشته باشد، یک ردیاب جدید ایجاد می شود، به آن نام اختصاص داده می شود و برگردانده می شود.

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

              پارامترهای

            _gaq._getAsyncTracker();
            String opt_name نام شی ردیاب برای بازیابی.

            برمی گرداند

              Tracker شی ردیابی بازیابی شده یا ایجاد شده.

              فشار دادن

                push(commandArray)
                command array داده شده را اجرا می کند، که به سادگی یک آرایه جاوا اسکریپت است که با فرمت زیر مطابقت دارد. اولین عنصر آرایه باید نام یک متد شی ردیاب باشد که به عنوان رشته ارسال می شود. بقیه عناصر آرایه مقادیری هستند که باید به عنوان آرگومان به تابع منتقل شوند.

                استفاده زیر معمولی است:
                var _gaq = _gaq || [];
                _gaq.push(['_setAccount', 'UA-65432-1']);
                _gaq.push(['_trackPageview']);

                این تابع نامگذاری شده است فشار دهید تا قبل از بارگیری کامل Analytics، یک آرایه در جای _gaq استفاده شود. در حالی که Analytics در حال بارگیری است، دستورات به آرایه فشار داده می شوند/در صف قرار می گیرند. هنگامی که Analytics بارگیری را به پایان می رساند، آرایه را با شی _gaq جایگزین می کند و تمام دستورات در صف را اجرا می کند. فراخوانی های بعدی به _gaq.push به این تابع حل می شود، که دستورات را با فشار دادن آنها اجرا می کند.

                ردیاب‌ها را می‌توان با قرار دادن نام ردیاب (همراه با یک نقطه) در جلوی نام روش نام‌گذاری کرد. اگر نام یک تابع با نام یک ردیاب واجد شرایط باشد، روی آن ردیاب اجرا می شود.

                مثال زیر یک ردیاب را به صورت دلخواه به نام myTracker ایجاد و استفاده می کند.
                var _gaq = _gaq || [];
                _gaq.push(['myTracker._setAccount', 'UA-65432-2']);
                _gaq.push(['myTracker._setDomainName', 'foo.com']);
                _gaq.push(['myTracker._trackPageview']);

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

                علاوه بر فشار دادن آرایه های دستوری، می توانید اشیاء تابع را نیز فشار دهید. این می تواند به ویژه برای روش های ردیاب که مقادیر را برمی گرداند مفید باشد. این توابع می توانند هم به _gat و هم _gaq اشاره کنند.
                var _gaq = _gaq || [];
                _gaq.push(function() {
                  var tracker = _gat._getTracker('UA-65432-1');
                  tracker._trackPageview();
                });

                همچنین می توانید از دستور فشار مستقیماً در HTML صفحه خود استفاده کنید.
                onclick="_gaq.push(['_trackEvent', 'name', value]);"

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

                در نهایت، به جای تایپ _gaq.push(...) برای هر آرایه دستوری، می توانید همه دستورات خود را به یکباره فشار دهید. کد زیر این تکنیک را نشان می دهد. برای جزئیات بیشتر به راهنمای استفاده از قطعه Async مراجعه کنید.

                _gaq.push(
                  ['_setAccount', 'UA-XXXXX-X'],
                  ['_setDomainName', 'example.com'],
                  ['_setCustomVar', 1, 'Section', 'Life & Style', 3],
                  ['_trackPageview']
                );

                  مولفه های

                    Array commandArray فرمانی که باید اجرا شود. یک یا چند مورد از اینها را می توان در همان فراخوانی هل داد.

                  برمی گرداند

                    Number تعداد دستوراتی که اجرا نشدند.

                ،

                شی سراسری _gaq می توان مستقیماً برای ردیابی صفحه ناهمزمان از طریق روش push(...) استفاده کرد. همچنین روش هایی برای ایجاد اشیاء ردیاب دارد، اما این روش ها فقط باید در موارد نادر مورد استفاده قرار گیرند.

                برای ردیابی سنتی صفحه ، به جای آن از شی سراسری _gat استفاده کنید.

                _gaq روش های شی

                جزئیات روش

                _createAsyncTracker()

                  _createAsyncTracker(accountId, opt_name)
                  به جای آن از _gat._createTracker (opt_account, opt_name) استفاده کنید.
                    یک شی ردیاب ایجاد می‌کند که هنگام برقراری تماس‌های ردیابی ناهمزمان می‌توان به آن اشاره کرد. اگر نامی داده نشود، رشته خالی
                  '' خواهد بود که نشان دهنده ردیاب پیش فرض در نحو ناهمزمان است. اگر یک ردیاب ناهمزمان از قبل برای نام داده شده وجود داشته باشد، با ردیاب جدید بازنویسی می شود.

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

                      پارامترهای

                    _gaq._createAsyncTracker('UA-65432-1');
                    String accountId شناسه کامل ویژگی وب (به عنوان مثال UA-65432-1) برای شی ردیاب.
                    String opt_name نامی که شی ردیاب در آن ذخیره می شود. از این نام برای اشاره به شی ردیاب در تماس‌های ردیابی ناهمزمان بعداً استفاده کنید.

                    برمی گرداند

                      Tracker شی ردیابی ایجاد شده.

                      _getAsyncTracker()

                        _getAsyncTracker(opt_name)
                        به جای آن از _gat._getTrackerByName (opt_name) استفاده کنید.
                          شی ردیاب را که قبلاً تحت نام داده شده ایجاد شده بود برمی گرداند. اگر نامی داده نشود، از نام پیش‌فرض ردیاب (رشته خالی
                        '' ) استفاده می‌شود. اگر هیچ شی ردیاب با نام داده شده وجود نداشته باشد، یک ردیاب جدید ایجاد می شود، به آن نام اختصاص داده می شود و برگردانده می شود.

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

                            پارامترهای

                          _gaq._getAsyncTracker();
                          String opt_name نام شی ردیاب برای بازیابی.

                          برمی گرداند

                            Tracker شی ردیابی بازیابی شده یا ایجاد شده.

                            فشار دادن

                              push(commandArray)
                              command array داده شده را اجرا می کند، که به سادگی یک آرایه جاوا اسکریپت است که با فرمت زیر مطابقت دارد. اولین عنصر آرایه باید نام یک متد شی ردیاب باشد که به عنوان رشته ارسال می شود. بقیه عناصر آرایه مقادیری هستند که باید به عنوان آرگومان به تابع منتقل شوند.

                              استفاده زیر معمولی است:
                              var _gaq = _gaq || [];
                              _gaq.push(['_setAccount', 'UA-65432-1']);
                              _gaq.push(['_trackPageview']);

                              این تابع نامگذاری شده است فشار دهید تا قبل از بارگیری کامل Analytics، یک آرایه در جای _gaq استفاده شود. در حالی که Analytics در حال بارگیری است، دستورات به آرایه فشار داده می شوند/در صف قرار می گیرند. هنگامی که Analytics بارگیری را به پایان می رساند، آرایه را با شی _gaq جایگزین می کند و تمام دستورات در صف را اجرا می کند. فراخوانی های بعدی به _gaq.push به این تابع حل می شود، که دستورات را با فشار دادن آنها اجرا می کند.

                              ردیاب‌ها را می‌توان با قرار دادن نام ردیاب (همراه با یک نقطه) در جلوی نام روش نام‌گذاری کرد. اگر نام یک تابع با نام یک ردیاب واجد شرایط باشد، روی آن ردیاب اجرا می شود.

                              مثال زیر یک ردیاب را به صورت دلخواه به نام myTracker ایجاد و استفاده می کند.
                              var _gaq = _gaq || [];
                              _gaq.push(['myTracker._setAccount', 'UA-65432-2']);
                              _gaq.push(['myTracker._setDomainName', 'foo.com']);
                              _gaq.push(['myTracker._trackPageview']);

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

                              علاوه بر فشار دادن آرایه های دستوری، می توانید اشیاء تابع را نیز فشار دهید. این می تواند به ویژه برای روش های ردیاب که مقادیر را برمی گرداند مفید باشد. این توابع می توانند هم به _gat و هم _gaq اشاره کنند.
                              var _gaq = _gaq || [];
                              _gaq.push(function() {
                                var tracker = _gat._getTracker('UA-65432-1');
                                tracker._trackPageview();
                              });

                              همچنین می توانید از دستور فشار مستقیماً در HTML صفحه خود استفاده کنید.
                              onclick="_gaq.push(['_trackEvent', 'name', value]);"

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

                              در نهایت، به جای تایپ _gaq.push(...) برای هر آرایه دستوری، می توانید همه دستورات خود را به یکباره فشار دهید. کد زیر این تکنیک را نشان می دهد. برای جزئیات بیشتر به راهنمای استفاده از قطعه Async مراجعه کنید.

                              _gaq.push(
                                ['_setAccount', 'UA-XXXXX-X'],
                                ['_setDomainName', 'example.com'],
                                ['_setCustomVar', 1, 'Section', 'Life & Style', 3],
                                ['_trackPageview']
                              );

                                مولفه های

                                  Array commandArray فرمانی که باید اجرا شود. یک یا چند مورد از اینها را می توان در همان فراخوانی هل داد.

                                برمی گرداند

                                  Number تعداد دستوراتی که اجرا نشدند.