یک متغیر سفارشی ایجاد کنید

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

1. برای شروع اولین الگوی متغیر خود، روی Templates در ناوبری سمت چپ کلیک کنید و روی دکمه New در زیر بخش Variable Templates کلیک کنید.

2. در تب اطلاعات ، نام و توضیحات متغیر را تعریف کنید.

   نام چیزی است که وقتی کاربران برای پیاده سازی این متغیر در سرتاسر رابط کاربری تگ منیجر می روند به آنها ارائه می شود.

   توضیحات دقیقاً همان چیزی است که به نظر می رسد - شرح مختصری (200 کاراکتر یا کمتر) از آنچه این متغیر انجام می دهد.

3. برای پیش نمایش الگوی خود روی Refresh کلیک کنید.

   در سمت راست ورودی های فیلد، یک پنجره پیش نمایش الگو وجود دارد. هر بار که تغییری در ویرایشگر ایجاد می شود، دکمه Refresh ظاهر می شود. روی Refresh کلیک کنید تا ببینید تغییرات شما با ظاهر متغیر شما چه می کند.

4. برای افزودن فیلدها به قالب متغیر خود، روی فیلدها کلیک کنید.

   تب Template Editor's Fields به شما امکان می دهد فیلدهایی را در قالب متغیر ایجاد و ویرایش کنید. از فیلدها برای وارد کردن داده های سفارشی مانند شناسه حساب استفاده می شود. می‌توانید عناصر فرم استاندارد مانند فیلدهای متنی، منوهای کشویی، دکمه‌های رادیویی و کادرهای انتخاب را اضافه کنید.

5. روی افزودن فیلد کلیک کنید و جدول ساده را انتخاب کنید. نام پیش‌فرض (مانند "simpleTable1" ) را با "list" جایگزین کنید. در پیش نمایش الگو ، روی Refresh کلیک کنید.

   این مرحله را برای یک ورودی متن تکرار کنید و آن را "آرایه" ، دو چک باکس به نام‌های " use_array " و "sort" و یک ورودی متن به نام "delimiter" نام ببرید. برای «جداکننده» ، مقدار پیش‌فرض «» را با کلیک کردن روی نماد چرخ‌دنده، روشن کردن «مقدار پیش‌فرض» و سپس پر کردن فیلد ورودی مقدار پیش‌فرض جدید به آن بدهید.

6. روی تب Code کلیک کنید و جاوا اسکریپت sandboxed را در ویرایشگر وارد کنید:

   var input = data.array;
   
   if (!data.use_array) {
     input = [];
     for (var i = 0; i < data.list.length; i++) {
       input.push(data.list[i].values);
     }
   }
   
   if (data.sort) {
     input.sort();
   }
   
   return input.join(data.delimiter || ',');
   

   کد این متغیر نسبتاً ساده است، اما چند نکته قابل ذکر است.

   • فیلدهای data

     چند فیلد وجود دارد که خارج از data سراسری به آنها دسترسی پیدا می کند. data حاوی مقادیری هستند که در مرحله قبل تنظیم کرده اید. به همین دلیل است که می‌توانیم به data.use_array ، data.sort ، data.list و data.delimiter دسترسی داشته باشیم.

   • اگر data.delimiter ارائه نشده باشد، delimiter روی مقدار پیش‌فرض "," تنظیم می‌شود. اگر منطقی باشد، تنظیم مقادیر پیش فرض برای یک فیلد تمرین خوبی است. این کار استفاده از الگوی متغیر را برای کاربران آسان‌تر می‌کند، زیرا برای استفاده از متغیر لازم نیست همه فیلدها را پر کنند.

7. برای ذخیره پیشرفت خود روی ذخیره کلیک کنید. با این کار هر مجوز شناسایی شده در ویرایشگر الگو بارگیری می شود.

   برخی از APIهای الگو دارای مجوزهای مرتبط با آنها هستند که به آنها دیکته می کند که چه کاری می توانند یا نمی توانند انجام دهند. وقتی از یک API الگو مانند sendPixel در کد خود استفاده می کنید، Tag Manager مجوزهای مربوطه را در برگه Permissions نشان می دهد.

8. در برگه پیش‌نمایش الگو ، مقداری برای ورودی «مقدار» اضافه کنید، روی Run Code کلیک کنید و به کنسول نگاه کنید تا خروجی متغیر خود را ببینید.

   اگر خطایی وجود داشته باشد، در پنجره کنسول ظاهر می شود.

9. روی ذخیره کلیک کنید و ویرایشگر الگو را ببندید

   اکنون قالب متغیر باید برای استفاده آماده باشد.