Tworzenie zmiennej niestandardowej

Z tego przewodnika dowiesz się, jak utworzyć szablon zmiennej niestandardowej. Gdy użyjesz tej zmiennej, zostanie pobrana tablica wartości, która zostanie zwrócona jako ciąg rozdzielany przecinkami.

1. Aby rozpocząć pierwszy szablon zmiennej, w menu nawigacyjnym po lewej stronie kliknij „Szablony”, a potem w sekcji Szablony zmiennych kliknij przycisk Nowy.

2. Na karcie Informacje określ Nazwę i Opis zmiennej.

   Nazwa to nazwa, która będzie pokazywana użytkownikom podczas wdrażania tej zmiennej w interfejsie Menedżera tagów.

   Opis jest bardzo zwięzłym, krótkim opisem (maksymalnie 200 znaków) opisującym tę zmienną.

3. Kliknij Odśwież, by wyświetlić podgląd szablonu.

   Po prawej stronie danych wejściowych pojawi się okno Podgląd szablonu. Po każdej zmianie w edytorze pojawi się przycisk Odśwież. Aby zobaczyć, jak zmiany wpływają na wygląd zmiennej, kliknij Odśwież.

4. Kliknij Pola, aby dodać pola do szablonu zmiennej.

   Na karcie Pola w edytorze szablonów możesz tworzyć i edytować pola w szablonie zmiennej. Pola są używane do wpisywania danych niestandardowych, np. identyfikatora konta. Możesz dodać standardowe elementy formularza, takie jak pola tekstowe, menu, przyciski i pola wyboru.

5. Kliknij Dodaj pole i wybierz Prosta tabela. Zastąp nazwę domyślną (np. "simpleTable1) wartością "list". W sekcji Podgląd szablonu kliknij Odśwież.

   Powtórz ten krok w przypadku wprowadzania tekstu o nazwie "tablica", dwóch polach wyboru o nazwach „use_array” i "sort" oraz danych wejściowych o nazwie "separator. W polu „separator” wpisz domyślną wartość „,” – kliknij ikonę koła zębatego, włącz opcję „Wartość domyślna”, a potem wypełnij nowe pole „Wartość domyślna”.

6. Kliknij kartę Kod i wpisz kod JavaScript w trybie piaskownicy:

   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 || ',');
   

   Kod tej zmiennej jest dość prosty, ale warto zwrócić uwagę na kilka elementów.

   • data pól.

     Poza polem data są dostępne niektóre pola używane globalnie. data będzie zawierać wartości skonfigurowane w poprzednim kroku. Dlatego mamy dostęp do tych usług: data.use_array, data.sort, data.list i data.delimiter.

   • Jeśli nie podano data.delimiter, delimiter ma wartość domyślną ",". Dobrym pomysłem jest ustawienie wartości domyślnych w przypadku danego pola. Ułatwia to użytkownikom korzystanie z szablonu zmiennej, ponieważ w celu korzystania ze zmiennej nie trzeba wypełniać wszystkich pól.

7. Kliknij Zapisz, aby zapisać postęp. Spowoduje to wczytanie wszelkich wykrytych uprawnień do edytora szablonów.

   Niektóre interfejsy API szablonów mają przypisane uprawnienia określające, co mogą robić, a czego nie. Gdy użyjesz w kodzie interfejsu API szablonów, np. sendPixel, Menedżer tagów wyświetli odpowiednie uprawnienia na karcie Uprawnienia.

8. Na karcie Podgląd szablonu dodaj wartości wejściowe „wartości”, kliknij Uruchom kod i sprawdź Konsolę, aby zobaczyć dane wyjściowe zmiennej.

   Ewentualne błędy pojawią się w oknie Konsola.

9. Kliknij Zapisz i zamknij Edytor szablonów.

   Szablon zmiennej powinien być gotowy do użycia.