نماذج لواجهة برمجة تطبيقات الخصوصية والمراسلة JavaScript

عرض الرسالة على نموذج عشوائي للزيارات

<script>
  // Make sure that the googlefc property exists on the window.
  window.googlefc = window.googlefc || {};
  // To guarantee functionality, this must go before the tag on the page.
  googlefc.controlledMessagingFunction = (message) => {
    // Show the message to 10% of traffic.
    var percentageToShowTo = 10;

    // Pick a random number between 0 and 100.
    var rand = Math.random() * 100;

    if (rand <= percentageToShowTo) {
      message.proceed(true);
    } else {
      message.proceed(false);
    }
  };
</script>

عدم عرض الرسالة للمشتركين

(على افتراض أنّ لديك وظيفة مع معلومات حول ما إذا كان المستخدم من المشتركين)

<script>
  // Make sure that the googlefc property exists on the window.
  window.googlefc = window.googlefc || {};
  // To guarantee functionality, this must go before the tag on the page.
  googlefc.controlledMessagingFunction = (message) => {
    // checkSubscriptionStatus() is an example of a function that may exist
    // in your codebase that resolves a promise with true or false depending on
    // whether the user on the page is a subscriber.
    checkSubscriptionStatus().then(
      function (isSubscriber) {
        // Do not show the message if a user is a subscriber.
        if (isSubscriber) {
          message.proceed(false);
        } else {
          message.proceed(true);
        }
      }
    );
  }
</script>

عرض الرسالة في كل مكان باستثناء صفحتك الرئيسية

<script>
  // Make sure that the googlefc property exists on the window.
  window.googlefc = window.googlefc || {};
  // To guarantee functionality, this must go before the tag on the page.
  googlefc.controlledMessagingFunction = (message) => {
    var pathname = location.pathname;

    // This assumes other pages on your site are differentiated with a different
    // path. `location.href` can also be used if more information is needed to
    // differentiate between the home page and other pages on the site.
    if (pathname.length > 1) {
      message.proceed(true);
    } else {
      message.proceed(false);
    }
  };
</script>

عدم عرض الرسالة إلا بعد عدد معيّن من مشاهدات الصفحة

(يفترض أن لديك ملف تعريف الارتباط الخاص بك أو آلية أخرى لتتبع عدد مرات مشاهدة الصفحة على الويب)

<script>
  // Make sure that the googlefc property exists on the window.
  window.googlefc = window.googlefc || {};
  // To guarantee functionality, this must go before the tag on the page.
  googlefc.controlledMessagingFunction = (message) => {
    // How many pageviews before the message is shown.
    var freePageviewsLimit = 3;

    // Check how many pages the user has seen.
    var pagesViewed = getPagesViewed();

    // Show the message if the user has seen more pages than the free limit.
    if (pagesViewed >= freePageviewsLimit) {
      message.proceed(true);
    } else {
      message.proceed(false);
    }
  };
</script>

تتبُّع الأحداث المرتبطة بالمستخدمين المسموح لهم بعرض الإعلانات وحظر الإعلانات في "إحصاءات Google" باستخدام دليل وضع العلامات (NTG)

استبدِل UA-xxxxxxxxx-x برقم تعريف تتبّع الحساب الصحيح.

يمكنك الاطّلاع على مزيد من المعلومات حول دليل وضع العلامات هنا.

<!-- Google Analytics -->
<script>
window.ga=window.ga||function(){(ga.q=ga.q||[]).push(arguments)};ga.l=+new Date;
ga('create', 'UA-xxxxxxxxx-x', 'auto');
ga('send', 'pageview');
</script>
<script async src='https://www.google-analytics.com/analytics.js'></script>
<!-- End Google Analytics -->

<script>
  // Make sure that the googlefc property exists on the window.
  window.googlefc = window.googlefc || {};
  googlefc.callbackQueue = googlefc.callbackQueue || [];
  googlefc.callbackQueue.push({
    'AD_BLOCK_DATA_READY': function() {
      switch (googlefc.getAdBlockerStatus()) {
        case googlefc.AdBlockerStatusEnum.EXTENSION_LEVEL_AD_BLOCKER:
        case googlefc.AdBlockerStatusEnum.NETWORK_LEVEL_AD_BLOCKER:
          ga('send', 'event', {
            eventCategory: 'NTG adblock',
            eventAction: 'detected',
            eventLabel: '<page url>',
            nonInteraction: true
          });
          break;
      }
      switch (googlefc.getAllowAdsStatus()) {
        case googlefc.AllowAdsStatusEnum.ADS_ALLOWED:
          ga('send', 'event', {
            eventCategory: 'NTG adblock',
            eventAction: 'allow-ads',
            eventLabel: '<page url>',
            nonInteraction: true
          });
          break;
      }
   }});
</script>

تتبُّع الأحداث في "إحصاءات Google" لتحديد مدى استخدام المستخدمين لحظر الإعلانات

يمكن استخدامها لتحديد النسبة المئوية للمستخدمين الذين يستخدمون أداة حظر الإعلانات على مستوى الشبكة أو أداة حظر الإعلانات على مستوى الإضافة أو ما مِن أداة لحظر الإعلانات.

استبدِل UA-xxxxxxxxx-x برقم تعريف تتبّع الحساب الصحيح.

اطّلع على مستندات "إحصاءات Google" لمزيد من المعلومات عن الإحصاءات.

<!-- Google Analytics -->
<script>
window.ga=window.ga||function(){(ga.q=ga.q||[]).push(arguments)};ga.l=+new Date;
ga('create', 'UA-xxxxxxxxx-x', 'auto');
ga('send', 'pageview');
</script>
<script async src='https://www.google-analytics.com/analytics.js'></script>
<!-- End Google Analytics -->

<script>
  // Make sure that the googlefc property exists on the window.
  window.googlefc = window.googlefc || {};
  googlefc.callbackQueue = googlefc.callbackQueue || [];
  googlefc.callbackQueue.push({
    'AD_BLOCK_DATA_READY': function() {
      var analyticsData = {
          hitType: 'event',
          eventCategory: 'Funding Choices',
          eventAction: 'Ad Blocking Type'
        };
      switch (googlefc.getAdBlockerStatus()) {
        case googlefc.AdBlockerStatusEnum.EXTENSION_LEVEL_AD_BLOCKER:
          analyticsData.eventLabel = 'EXTENSION_LEVEL_AD_BLOCKER';
          ga('send', analyticsData);
          break;
        case googlefc.AdBlockerStatusEnum.NETWORK_LEVEL_AD_BLOCKER:
          analyticsData.eventLabel = 'NETWORK_LEVEL_AD_BLOCKER';
          ga('send', analyticsData);
          break;
        case googlefc.AdBlockerStatusEnum.NO_AD_BLOCKER:
          analyticsData.eventLabel = 'NO_AD_BLOCKER';
          ga('send', analyticsData);
          break;
      }
   }});
</script>