إنشاء متغيّر مخصّص

سيرشدك هذا الدليل إلى كيفية إنشاء نموذج متغيّر مخصّص. فعندما يُستخدم هذا المتغير، فسيأخذ صفيفًا من القيم ويعرضها سلسلة مفصولة بفواصل.

1. لبدء نموذج المتغيّر الأول، انقر على "النماذج" على يمين الصفحة. وانقر على الزر جديد ضمن نماذج المتغيّر. .

2. في علامة التبويب المعلومات، حدِّد اسم المتغيّر والوصف الخاص به.

   الاسم هو ما سيتم عرضه للمستخدمين عند تنفيذ هذا الإجراء. المتغير في جميع أنحاء واجهة مستخدم أداة "إدارة العلامات من Google".

   الوصف هو كما يبدو بالضبط - وهو موجز (200 حرف أو أقل) وصف لما يفعله هذا المتغير.

3. انقر على إعادة التحميل لمعاينة النموذج.

   على يسار إدخالات الحقل، توجد نافذة معاينة نموذج. وفي كل مرة يتم فيها إجراء تغيير في المحرر، سيظهر الزر إعادة تحميل موضع الإعلان. انقر على "إعادة تحميل" لرؤية تأثير التغييرات التي أجريتها على مظهر المتغير.

4. انقر على الحقول لإضافة حقول إلى نموذج المتغيّر.

   تسمح لك علامة التبويب الحقول في محرر النماذج بإنشاء حقول وتعديلها في نموذج المتغير. تُستخدَم الحقول لإدخال بيانات مخصّصة، مثل حساب رقم التعريف يمكنك إضافة عناصر النموذج العادية، مثل الحقول النصية والقوائم المنسدلة. والقوائم وأزرار الاختيار ومربعات الاختيار.

5. انقر على إضافة حقل، واختَر جدول بسيط. استبدل الاسم التلقائي (على سبيل المثال، "simpleTable1") مع "list". في معاينة النموذج، انقر على إعادة التحميل.

   كرِّر هذه الخطوة مع إدخال النص وأطلق عليه اسم "الصفيف"، وهو عبارة عن مربّعَي اختيار. باسم "use_array" و"sort" وإدخال نص باسم "delimiter". بالنسبة إلى "المُحدِّد"، اضبط القيمة التلقائية على "," من خلال النقر على رمز الترس، تفعيل "القيمة التلقائية"، ثم ملء حقل إدخال القيمة التلقائية الجديد.

6. انقر على علامة التبويب الرمز وأدخِل JavaScript في وضع الحماية في المحرِّر:

   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.

   • يتم ضبط delimiter على قيمة تلقائية هي "," إذا كانت قيمة data.delimiter هي لم يتم توفيره. من الممارسات الجيدة تعيين القيم الافتراضية للحقل إذا فإن أحدهما منطقي. هذا يجعل من السهل على المستخدمين استخدام المتغير قالب دقيق، حيث إنه لا يضطر إلى ملء كل حقل من أجل استخدام المتغير.

7. انقر على حفظ لحفظ مستوى التقدّم. سيؤدي هذا الإجراء إلى تحميل أي أذونات تم رصدها. في محرر النماذج.

   تحتوي بعض واجهات برمجة تطبيقات النماذج على أذونات مرتبطة بها تحدد ما يمكنه فعله أو لا يمكنه فعله. عند استخدام واجهة برمجة تطبيقات نموذجية مثل sendPixel في الرمز، ستعرض أداة "إدارة العلامات من Google" الأذونات ذات الصلة في الأذونات .

8. في علامة التبويب معاينة النموذج، أضِف بعض القيم "للقيم". إدخال، انقر يمكنك تشغيل الرمز والاطّلاع على وحدة التحكّم للاطّلاع على ناتج المتغيّر.

   في حال حدوث أي أخطاء، ستظهر في نافذة وحدة التحكّم.

9. انقر على حفظ، ثم أغلِق "محرِّر النماذج".

   من المفترض أن يكون نموذج المتغيّر جاهزًا للاستخدام الآن.