Tworzenie zmiennej niestandardowej

Z tego przewodnika dowiesz się, jak utworzyć szablon zmiennej niestandardowej. Kiedy będzie używana ta zmienna, pobierze tablicę wartości i zwróci je jako rozdzielany przecinkami.

1. Aby rozpocząć tworzenie pierwszego szablonu zmiennej, kliknij po lewej stronie Szablony. i kliknij przycisk Nowy w sekcji Szablony zmiennych. .

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

   Nazwa to element, który zostanie przedstawiony użytkownikom przy wdrażaniu tej funkcji. w interfejsie Menedżera tagów.

   Opis musi być krótki (200 znaków lub mniej szczegółów) wraz z opisem działania tej zmiennej.

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

   Po prawej stronie danych wejściowych w polach znajduje się okno Podgląd szablonu. Po każdej zmianie wprowadzonej w edytorze przycisk Odśwież będzie . Kliknij Odśwież, aby sprawdzić, jak zmiany wpłyną na wygląd .

4. Aby dodać pola do szablonu zmiennych, kliknij Pola.

   Karta Pola edytora szablonów umożliwia tworzenie i edytowanie pól w szablonu zmiennej. Pola służą do wprowadzania danych niestandardowych, np. konta ID. Możesz dodać standardowe elementy formularza, takie jak pola tekstowe, menu, przyciski i pola wyboru.

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

   Powtórz ten krok w przypadku opcji Dane wejściowe i nazwij ją „tablica” oraz dwa pola wyboru. o nazwie „use_array”. i „sort”, a także w polu tekstowym o nazwie „separator”. W polu „separator” nadaj mu wartość domyślną „,”. kliknij ikonę koła zębatego włącz opcję „Wartość domyślna”, a następnie wpisz nową wartość domyślną. pola do wprowadzania danych.

6. Kliknij kartę Kod i wpisz w edytorze JavaScript w 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 zawiera kilka o których warto zwrócić uwagę.

   • data pól.

     Do niektórych pól uzyskuje się dostęp poza globalną grupę data. Pole data będzie zawierać wartości skonfigurowane w poprzednim kroku. Dlatego mamy dostęp do usług data.use_array, data.sort, data.list i data.delimiter.

   • delimiter ma domyślną wartość ",", jeśli data.delimiter ma wartość nie podano. Warto ustawić wartości domyślne pola, jeśli ma sens. Ułatwia to użytkownikom korzystanie ze zmiennej szablonu, ponieważ nie muszą one wypełniać wszystkich pól, tę zmienną.

7. Kliknij Zapisz, aby zapisać postępy. Spowoduje to wczytanie wszystkich wykrytych uprawnień. w Edytorze szablonów.

   Niektóre interfejsy API szablonów mają powiązane uprawnienia, które określają, co mogą, a czego nie mogą zrobić. Jeśli używasz interfejsu API szablonów, takiego jak sendPixel Twojego kodu, Menedżer tagów wyświetli odpowiednie uprawnienia w sekcji Uprawnienia. .

8. Na karcie Podgląd szablonu dodaj wartości w polach „Wartości”. dane wejściowe, należy kliknąć Uruchom kod i sprawdź w Konsoli dane wyjściowe zmiennej.

   Jeśli wystąpią błędy, pojawią się one w oknie Konsola.

9. Kliknij Zapisz i zamknij Edytor szablonów.

   Szablon zmiennej powinien być gotowy do użycia.