Skip to Content
Elido is in closed beta — APIs are stable but rate-limits and quotas may change before GA. Request access →
KılavuzlarUTM templates

UTM şablonları

Planlandı. Henüz kullanılamaz; yol haritasına bakın. Çalışma alanı düzeyinde UTM şablonları, {{ placeholder }} yer değiştirmesi ve aşağıda anlatılan /utm-template uç noktası bugün API’de yoktur. Şu anda çalışanlar: bir kampanya düz utm_source, utm_medium, utm_campaign, utm_content ve utm_term alanlarını saklar (Campaigns & A/B’ye bakın), panonun UTM oluşturucusu hedef URL’yi istemci tarafında etiketler ve hedef URL’de zaten bulunan ?utm_* korunur. Bu sayfanın geri kalanı, yönelmekte olduğumuz tasarımdır.

UTM şablonu (planlandı), bir çalışma alanına veya tek bir kampanyaya bağlı, adlandırılmış bir utm_* varsayılanları kümesidir. O kapsamda oluşturulan her bağlantı şablonun değişkenlerini devralır; bağlantı başına geçersiz kılmaya izin verilir ve denetim günlüğüne kaydedilir. Şablon değişkenleri tıklama anında değil, bağlantı oluşturulurken çözülür; böylece analitik aracınıza düşen her zaman amaçlanandır.

Akış şöyledir:

  1. Bir çalışma alanı şablonu tanımlayın (makul varsayılanlarınız).
  2. İsteğe bağlı olarak üstüne bir kampanya şablonu ekleyin (geçersiz kılmalar + ekler).
  3. Bağlantıları oluşturun: Elido, kısa bağlantı yayınlanmadan önce utm_* sorgu dizesini doldurur.
  4. Gerçek durum gerektirdiğinde bağlantı başına geçersiz kılın; fark denetim günlüğüne yakalanır.

1. Çalışma alanı şablonunu tanımlayın

curl -X PUT \
  https://api.elido.app/v1/workspaces/1/utm-template \
  -H "Authorization: Bearer $ELIDO_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "utm_source":   "{{ channel }}",
    "utm_medium":   "{{ medium }}",
    "utm_campaign": "{{ campaign }}",
    "utm_content":  "{{ creative }}",
    "utm_term":     "{{ audience.segment }}"
  }'

Sabit bir değer ("utm_medium": "email") her bağlantı için sabittir. Bir yer tutucu ({{ … }}), bağlantı oluşturma yükünden veya aynı adlı toplu içe aktarma sütunundan doldurulur.

Bilinmeyen yer tutucular hemen hata verir: API, çözülemeyen değişken adıyla birlikte 422 döndürür.

2. Kampanya şablonu ekleyin

Kampanya şablonları çalışma alanı şablonunu devralır ve değişkenlerin herhangi bir alt kümesini değiştirebilir. Bir ekibin kampanyaları kuruluşun geri kalanından farklı bir adlandırma kuralı izlediğinde kullanışlıdır.

curl -X POST \
  https://api.elido.app/v1/campaigns \
  -H "Authorization: Bearer $ELIDO_TOKEN" \
  -d '{
    "name": "Spring 2026 - DACH",
    "utm_template": {
      "utm_campaign": "spring_2026_dach",
      "utm_term":     "{{ audience.locale }}"
    }
  }'

Kampanyada ayarlanmayan her şey çalışma alanı varsayılanlarına düşer.

3. Değişkenler

Yer tutucuKaynakNotlar
{{ channel }}POST /v1/links üzerindeki channel alanıKullanıldığında zorunlu
{{ medium }}POST /v1/links üzerindeki medium alanı-
{{ campaign }}campaign alanı veya kampanya adıKampanyaya geri düşer
{{ creative }}creative alanı veya CSV’deki creative sütunu-
{{ audience.segment }}Klaviyo / Mailchimp segment kimliğiİsteğe bağlı
{{ audience.locale }}Tarayıcı tarzı dil etiketi, ör. de-DE-
{{ link.tag.<name> }}Bağlantı başına etiket değeriÖr. {{ link.tag.team }}

Özel anahtarlar ({{ link.tag.* }}), bağlantının tags dizisine ne koyduysanız onu okur; her URL’ye bir müşteri tanımlayıcısı gömmesi gereken çok kiracılı ajanslar için uygundur.

4. Toplu içe aktarmada uygulama

Şablonlar toplu içe aktarmalara otomatik uygulanır. CSV sütun adları yer tutucu adlarıyla eşleşmelidir (büyük/küçük harfe duyarsız); Elido’nun tanımadığı sütunlar sessizce kopyalanmak yerine bir uyarıyla atılır.

destination_url,channel,medium,creative
https://shop.example.com/de,newsletter,email,hero_a
https://shop.example.com/fr,newsletter,email,hero_a
https://shop.example.com/de,paid_social,meta,carousel_v2

Bunu multipart/form-data olarak POST edin:

curl -X POST \
  https://api.elido.app/v1/links/bulk \
  -H "Authorization: Bearer $ELIDO_TOKEN" \
  -F "csv=@launch_q2.csv" \
  -F "campaign_id=cmp_8a2f"

Bugün toplu satırlar birbirinden bağımsız işlenir: hatalı bir satır raporlanır ve diğerlerini engellemez (atomik ya hep ya hiç işlemi yoktur ve henüz UTM sütunları yoktur). Atomik işlem, planlanan tasarımın parçasıdır.

5. Bağlantı başına geçersiz kılmalar

POST /v1/links üzerindeki herhangi bir utm_* alanı, o tek bağlantı için çözümlenmiş şablonu geçersiz kılar. Geçersiz kılma; kimin yaptığı, zaman damgası ve çözümlenen ile nihai değer arasındaki farkla birlikte denetim günlüğüne kaydedilir; böylece haftalar sonra bile sapmayı izleyebilirsiniz.

curl -X POST \
  https://api.elido.app/v1/links \
  -H "Authorization: Bearer $ELIDO_TOKEN" \
  -d '{
    "destination_url": "https://shop.example.com/de/launch",
    "campaign_id": "cmp_8a2f",
    "utm_content": "hero_a_OVERRIDE_for_test"
  }'

Panoda geçersiz kılınan alanlar küçük bir ⤴ işaretiyle gösterilir ve özgün şablon değeri araç ipucunda yer alır.

6. Uç durumlar

  • Hedef URL’de zaten olan ?utm_*: korunur. Elido, hedefe kendiniz koyduğunuz parametrelerin üzerine asla yazmaz. Şablon yalnızca eksik alanları doldurur.
  • Tekrarlayan kampanyalar: bir kampanyayı klonlayın ve utm_campaign sonekini artırın. Eski bağlantılar özgün UTM’lerini korur, yeni bağlantılar yeni değeri alır.
  • Diğer kısaltıcılardan geçiş: bulk uç noktası önceden etiketlenmiş URL’leri olduğu gibi kabul eder; şablon yalnızca CSV’nin zaten sağlamadığı sütunlara uygulanır.

Ayrıca bakın

Campaigns & A/BBio pages