İçeriğe atla
NETMETRİKDokümantasyon

DokümantasyonGömme kodu ve izinli alan adları

Gömme kodu ve izinli alan adları

Widget'ı sitenize iki şekilde gömebilirsiniz: script veya iframe. İzinli alan adları listesi, kodunuzun yalnızca sizin sitelerinizde çalışmasını sağlar.

Son güncelleme: 12 Temmuz 2026

Script ile gömme (önerilir)

Script yöntemi, testi sayfanızdaki bir kapsayıcının içine yerleştirir ve sayfanın düzenine uyum sağlar. Kodu, testin görünmesini istediğiniz yere ekleyin:

HTML
<!-- HIZTESTI Custom -->
<div id="hiztesti-test"></div>
<script src="https://hiztesticustom.com/v1/widget.js" data-id="<WIDGET-ID>" async></script>

<div id="hiztesti-test"> testin çizileceği kapsayıcıdır; data-idise widget'ınızın kimliğidir (portalda gömme kodunda size hazır verilir).

iframe ile gömme

Sayfaya script ekleyemediğiniz ortamlar (bazı içerik yönetim sistemleri, e-posta panoları, kısıtlı editörler) için iframe alternatifi kullanın:

HTML
<iframe width="100%" height="650" frameborder="0"
  src="https://hiztesticustom.com/v1/embed/<WIDGET-ID>"
  title="Hız Testi"></iframe>
Yükseklik
Yükseklik değerini (650) sayfanıza göre ayarlayabilirsiniz. Script yöntemi kapsayıcının genişliğine uyum sağladığından çoğu düzen için daha esnektir.

İzinli alan adları (allowlist)

Widget yalnızca sizin belirlediğiniz alan adlarında çalışır — bu, başkalarının kodunuzu kendi sitesinde kullanıp kotanızı tüketmesini (hotlink) engeller. Yapılandırmadaki İzinli alan adları bölümüne şu biçimlerde giriş yapabilirsiniz:

GirişAnlamı
kurum.comYalnız bu alan adı
*.kurum.comTüm alt alan adları (ör. www.kurum.com, test.kurum.com)
kurum.com:8080Belirli bir portla

Alan adı yalnızca ana bilgisayar adıdır; başında https:// veya sonunda yol yazmayın.

Boş liste = her yerde çalışır
İzinli alan adları listesi boşsa widget herhangi bir sitede çalışır. Kotanızı ve markanızı korumak için üretimde mutlaka kendi alan adınızı ekleyin. İzin verilmeyen bir alan adından yükleme yapıldığında test başlatılmaz.

Canlı önizleme ve deneme

Yapılandırma ekranındaki Canlı test sayfasını açbağlantısı, widget'ı gerçek bir sayfada tam boyutuyla açar. Böylece siteye gömmeden önce görünümü ve test akışını doğrulayabilirsiniz. Sağdaki önizleme paneli ise ayar değişikliklerini anında yansıtır.

Sık karşılaşılan durumlar

  • Test başlamıyor / "alan adına izin verilmiyor": Sayfanın yayınlandığı alan adı izin listesinde değildir; ekleyin veya *. ile alt alan adlarını kapsayın.
  • Widget görünmüyor: Script yönteminde <div id="hiztesti-test"> kapsayıcısının sayfada bulunduğundan emin olun.
  • Kota doldu: Paylaşımlı ağ modunda aylık kota bitmiştir; dönem yenilenince ya da kotayı artırınca testler yeniden başlar.