Przejdź do treści

Zmienne wiadomości

Użyj zmiennych, aby personalizować wiadomości kaskadowe za pomocą dynamicznej zawartości, takiej jak nazwy, adresy URL i wartości niestandardowe.

Przegląd

Zmienne umożliwiają:

  • Personalizacja: Wstaw nazwy odbiorców, numery kont
  • Dynamiczne adresy URL: Dołącz unikalne linki dla każdego odbiorcy
  • Skracanie adresów URL: Automatyczne skracanie długich adresów URL
  • Możliwość ponownego użycia szablonu: Jeden szablon, wiele spersonalizowanych wiadomości

Typy zmiennych

Wpisz Składnia Cel Przykład
imię %nazwa=id% Zmienne tekstowe Nazwy, kody, kwoty
url %url=id% Pełne adresy URL Linki, adresy URL
krótki_adres %short_url=id% Skrócone adresy URL Kompaktowe linki

Składnia zmiennej

Zmienne używają formatu: %type=id%

  • typ: typ zmiennej (nazwa, url, krótki_url)
  • id: Unikalny identyfikator (liczba całkowita)

Przykłady

KOD_BLOKU_0

Używanie zmiennych

Krok 1: Prześlij wartości zmiennych

Przed wysłaniem wiadomości prześlij wartości zmiennych do API:

Punkt końcowy: KOD_BLOKU_1

Prośba: KOD_BLOKU_2

Krok 2: Wyślij wiadomość ze zmiennymi

Użyj przesłanych identyfikatorów zmiennych w swojej wiadomości:

KOD_BLOKU_3

Wynik: KOD_BLOKU_4

Kompletny przykład

Prześlij zmienne

KOD_BLOKU_5

Wyślij wiadomość

KOD_BLOKU_6

Dostarczona wiadomość: KOD_BLOKU_7

Przypadki użycia

Potwierdzenie zamówienia

KOD_BLOKU_8

Resetowanie hasła

KOD_BLOKU_9

Kampania promocyjna

KOD_BLOKU_10

Weryfikacja konta

KOD_BLOKU_11

Przykłady implementacji

Pythona

KOD_BLOKU_12

JavaScript (Node.js)

KOD_BLOKU_13

PHP

KOD_BLOKU_14

Najlepsze praktyki

Identyfikatory zmiennych

  • ✅ Używaj kolejnych identyfikatorów (1, 2, 3, ...)
  • ✅ Używaj ponownie identyfikatorów w przypadku wiadomości masowych z tymi samymi zmiennymi
  • ✅ Dokumentuj mapowanie identyfikatorów zmiennych
  • ❌ Nie używaj losowych identyfikatorów
  • ❌ Nie pomijaj numerów identyfikacyjnych

Wartości zmiennych

  • ✅ Sprawdź wartości przed przesłaniem
  • ✅ Prawidłowo obsługuj znaki specjalne
  • ✅ Przetestuj z obudowami Edge
  • ❌ Nie dołączaj kodu HTML do zmiennych nazw
  • ❌ Nie przekraczaj rozsądnych limitów długości

Zmienne URL

  • ✅ W przypadku długich adresów URL używaj short_url
  • ✅ Uwzględnij parametry śledzenia
  • ✅ Korzystaj z protokołu HTTPS
  • ❌ Nie używaj podejrzanie wyglądających adresów URL
  • ❌ Nie umieszczaj wrażliwych danych w adresach URL

Wydajność

  • Prześlij zmienne raz, wyślij wiele wiadomości
  • Przesyłanie zmiennych wsadowych
  • Buforuj często używane zmienne
  • Okresowo czyść stare zmienne

Zaawansowane wzorce

Personalizacja zbiorcza

KOD_BLOKU_15

System szablonów

KOD_BLOKU_16

Rozwiązywanie problemów

Zmienne nie zostały zastąpione

  • Przed wysłaniem sprawdź, czy zmienne zostały przesłane
  • Sprawdź dopasowania identyfikatorów zmiennych w tekście i prześlij
  • Upewnij się, że składnia jest poprawna: %type=id%
  • Sprawdź, czy typ zmiennej odpowiada wartości

Skrócenie adresu URL nie powiodło się

  • Sprawdź, czy adres URL jest prawidłowy i dostępny
  • Sprawdź, czy adres URL zaczyna się od http:// lub https://
  • Upewnij się, że adres URL nie jest już skrócony
  • Spróbuj użyć url zamiast short_url

Przekroczono limit zmiennej

  • Skontaktuj się z pomocą techniczną w sprawie limitów zmiennych
  • Jeśli to możliwe, ponownie używaj identyfikatorów zmiennych
  • Wyczyść stare zmienne
  • Zoptymalizuj zmienne wykorzystanie

Następne kroki