Rules

قوانین یک ظرف. قوانین در طول زمان اجرا به درست یا نادرست ارزیابی می شوند. آنها می توانند برای کنترل زمانی که یک برچسب فعال می شود یا از شلیک مسدود می شود و برای کنترل زمانی که ماکروها در یک کانتینر سیار فعال یا غیرفعال می شوند استفاده شوند. برای جزئیات بیشتر، به ترتیب به قوانین شلیک و غیرفعال کردن پیکربندی برچسب و قوانین فعال و غیرفعال کردن پیکربندی یک ماکرو مراجعه کنید.

برای لیست روش های این منبع، انتهای این صفحه را ببینید.

بازنمایی منابع

نشان دهنده یک قانون Google Tag Manager است.

{
  "accountId": string,
  "containerId": string,
  "ruleId": string,
  "name": string,
  "notes": string,
  "condition": [
    {
      "type": string,
      "parameter": [
        {
          "type": string,
          "key": string,
          "value": string,
          "list": [
            (Parameter)
          ],
          "map": [
            (Parameter)
          ]
        }
      ]
    }
  ],
  "fingerprint": string
}
نام ملک ارزش شرح یادداشت
accountId string شناسه حساب GTM.
condition[] list فهرست شرایطی که این قانون را تشکیل می‌دهند (و ضمنی بین آنها). قابل نوشتن
condition[]. parameter[] list لیستی از پارامترهای نامگذاری شده (کلید/مقدار)، بسته به نوع شرایط. یادداشت:
  • برای عملگرهای باینری، پارامترهایی به نام‌های arg0 و arg1 را برای تعیین عملوند چپ و راست به ترتیب درج کنید.
  • در این زمان، عملوند سمت چپ ( arg0 ) باید مرجع یک ماکرو باشد.
  • برای تطبیق Regex غیر حساس به حروف بزرگ، یک پارامتر بولی به نام ignore_case که روی true تنظیم شده است، اضافه کنید. اگر مقدار دیگری مشخص یا تنظیم نشده باشد، تطبیق به حروف بزرگ و کوچک حساس خواهد بود.
  • برای نفی یک عملگر، یک پارامتر بولی به نام negate اضافه کنید و آن را روی true تنظیم کنید.
 قابل نوشتن
condition[].parameter[]. key string کلید نامگذاری شده که به طور منحصر به فرد یک پارامتر را شناسایی می کند. برای پارامترهای سطح بالا و همچنین مقادیر نقشه مورد نیاز است. برای مقادیر لیست نادیده گرفته شد. قابل نوشتن
condition[].parameter[]. list[] list پارامترهای این پارامتر فهرست (کلیدها نادیده گرفته خواهند شد). قابل نوشتن
condition[].parameter[]. map[] list پارامترهای این پارامتر نقشه (باید کلید داشته باشد؛ کلیدها باید منحصر به فرد باشند). قابل نوشتن
condition[].parameter[]. type string نوع پارامتر مقادیر معتبر عبارتند از:
  • boolean : مقدار یک بولی را نشان می دهد که به صورت "درست" یا "نادرست" نمایش داده می شود.
  • integer : این مقدار یک مقدار عدد صحیح امضا شده 64 بیتی را در پایه 10 نشان می دهد
  • list : لیستی از پارامترها باید مشخص شود
  • map : یک نقشه از پارامترها باید مشخص شود
  • template : مقدار هر متنی را نشان می دهد. این می تواند شامل ارجاعات کلان باشد (حتی مراجع کلان که ممکن است انواع غیر رشته ای را برگردانند)


مقادیر قابل قبول عبارتند از:
  • " boolean "
  • " integer "
  • " list "
  • " map "
  • " template "
 قابل نوشتن
condition[].parameter[]. value string مقدار یک پارامتر (ممکن است حاوی ارجاعات کلان مانند "") متناسب با نوع مشخص شده باشد. قابل نوشتن
condition[]. type string نوع اپراتور برای این شرایط.

مقادیر قابل قبول عبارتند از:
  • " contains "
  • " cssSelector "
  • " endsWith "
  • " equals "
  • " greater "
  • " greaterOrEquals "
  • " less "
  • " lessOrEquals "
  • " matchRegex "
  • " startsWith "
  • " urlMatches "
 قابل نوشتن
containerId string شناسه کانتینر GTM.
fingerprint string اثر انگشت قانون GTM همانطور که در زمان ذخیره سازی محاسبه می شود. هر زمان که قانون اصلاح شود، این مقدار مجدداً محاسبه می شود.
name string نام نمایش قانون قابل نوشتن
notes string یادداشت های کاربر در مورد نحوه اعمال این قانون در ظرف. قابل نوشتن
ruleId string شناسه قانون به طور منحصر به فرد قانون GTM را شناسایی می کند.

مواد و روش ها

از روش های زیر برای ایجاد، تغییر، حذف یا بازیابی قوانین استفاده کنید.

ايجاد كردن
یک قانون GTM ایجاد می کند.
حذف
یک قانون GTM را حذف می کند.
گرفتن
یک قانون GTM دریافت می کند.
فهرست
تمام قوانین GTM یک کانتینر را فهرست می کند.
به روز رسانی
یک قانون GTM را به روز می کند.