Macros

ماکروهای یک ظرف. ماکروها مقادیری را نشان می دهند که در زمان اجرا ارزیابی می شوند. هنگام پیکربندی قوانین و برچسب ها می توانید به ماکروها ارجاع دهید. برای جزئیات، ویژگی‌هایی را که می‌توان برای ماکروهای Google Tag Manager تنظیم کرد، به مرجع فرهنگ لغت ماکرو مراجعه کنید. برای اطلاعات در مورد نحوه تنظیم و استفاده کاربران از ماکروها، ماکروها را در مرکز راهنمای Google Tag Manager ببینید.

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

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

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

{
  "accountId": string,
  "containerId": string,
  "macroId": string,
  "name": string,
  "type": string,
  "notes": string,
  "scheduleStartMs": long,
  "scheduleEndMs": long,
  "parameter": [
    {
      "type": string,
      "key": string,
      "value": string,
      "list": [
        (Parameter)
      ],
      "map": [
        (Parameter)
      ]
    }
  ],
  "enablingRuleId": [
    string
  ],
  "disablingRuleId": [
    string
  ],
  "fingerprint": string,
  "parentFolderId": string
}

نام ملک	ارزش	شرح	یادداشت
accountId	string	شناسه حساب GTM.
containerId	string	شناسه کانتینر GTM.
disablingRuleId[]	list	فقط برای کانتینرهای موبایل: فهرستی از شناسه‌های قانون برای غیرفعال کردن ماکروهای شرطی. اگر یکی از قوانین فعال کننده درست باشد، ماکرو فعال می شود در حالی که همه قوانین غیرفعال نادرست هستند. به عنوان یک مجموعه نامرتب رفتار می شود.	قابل نوشتن
enablingRuleId[]	list	فقط برای کانتینرهای موبایل: فهرستی از شناسه‌های قانون برای فعال کردن ماکروهای شرطی. اگر یکی از قوانین فعال کننده درست باشد، ماکرو فعال می شود در حالی که همه قوانین غیرفعال نادرست هستند. به عنوان یک مجموعه نامرتب رفتار می شود.	قابل نوشتن
fingerprint	string	اثر انگشت GTM Macro همانطور که در زمان ذخیره سازی محاسبه می شود. هر زمان که ماکرو اصلاح شود، این مقدار مجدداً محاسبه می شود.
macroId	string	شناسه ماکرو به طور منحصر به فرد GTM Macro را شناسایی می کند.
name	string	نام نمایشی ماکرو	قابل نوشتن
notes	string	یادداشت های کاربر در مورد نحوه اعمال این ماکرو در ظرف.	قابل نوشتن
parameter[]	list	پارامترهای ماکرو	قابل نوشتن
parameter[]. key	string	کلید نامگذاری شده که به طور منحصر به فرد یک پارامتر را شناسایی می کند. برای پارامترهای سطح بالا و همچنین مقادیر نقشه مورد نیاز است. برای مقادیر لیست نادیده گرفته شد.	قابل نوشتن
parameter[]. list[]	list	پارامترهای این پارامتر فهرست (کلیدها نادیده گرفته خواهند شد).	قابل نوشتن
parameter[]. map[]	list	پارامترهای این پارامتر نقشه (باید کلید داشته باشد؛ کلیدها باید منحصر به فرد باشند).	قابل نوشتن
parameter[]. type	string	نوع پارامتر مقادیر معتبر عبارتند از: boolean : مقدار یک بولی را نشان می دهد که به صورت "درست" یا "نادرست" نمایش داده می شود. integer : این مقدار یک مقدار عدد صحیح امضا شده 64 بیتی را در پایه 10 نشان می دهد list : لیستی از پارامترها باید مشخص شود map : یک نقشه از پارامترها باید مشخص شود template : مقدار هر متنی را نشان می دهد. این می تواند شامل ارجاعات کلان باشد (حتی مراجع کلان که ممکن است انواع غیر رشته ای را برگردانند) مقادیر قابل قبول عبارتند از: " boolean " " integer " " list " " map " " template "	قابل نوشتن
parameter[]. value	string	مقدار یک پارامتر (ممکن است حاوی ارجاعات کلان مانند "") متناسب با نوع مشخص شده باشد.	قابل نوشتن
parentFolderId	string	شناسه پوشه والد
scheduleEndMs	long	مهر زمان پایان در میلی ثانیه برای برنامه ریزی یک ماکرو.	قابل نوشتن
scheduleStartMs	long	مهر زمان شروع در میلی ثانیه برای برنامه ریزی یک ماکرو.	قابل نوشتن
type	string	نوع ماکرو GTM.	قابل نوشتن

مواد و روش ها

از روش های زیر برای ایجاد، اصلاح، حذف یا بازیابی ماکروها استفاده کنید.

ايجاد كردن

یک ماکرو GTM ایجاد می کند.

حذف

یک ماکرو GTM را حذف می کند.

گرفتن

یک ماکرو GTM دریافت می کند.

فهرست

همه ماکروهای GTM یک کانتینر را فهرست می کند.

به روز رسانی

یک ماکرو GTM را به روز می کند.