Telemetriyi desteklemek için site sayfalarına komut dosyası kodu ekleme

Makale
03/08/2023

Bu makale, istemci tarafı telemetri topluluğunu desteklemek üzere site sayfalarınıza istemci tarafında komut dosyası kodu ekleme yöntemi açıklanmıştır.

Müşterilerinizin sitem ile nasıl etkileştiğini anlamak ve maksimum dönüştürme deneyimini en iyi duruma getirmeye yardımcı olacak kararlar vermek istediğinizde, Web analizi önemli bir araçtır. Birçok web analizi paketi, Google Analytics, Click, Moz Analytics ve KISSMetrics gibi bu hedeflere ulaşmanıza yardımcı olacak şekilde kullanılabilir. Çoğu web analizi paketi, sitenizin tüm sayfaları için HTML'nin <head> öğesine istemci tarafı kodu eklemenizi gerektirir.

Dekont

Bu makaledeki yönergeler, Microsoft Dynamics 365 Commerce'un doğal olarak sunmadığı diğer özel istemci tarafı işlevleri için de geçerlidir.

Komut dosyası kodunuz için yeniden kullanılabilir bir parça oluşturun

Parça, kendi kullandıkları şablondan bağımsız olarak, sitenizdeki tüm sayfalar arasında satır içi veya harici kod kodunu yeniden kullanmanızı sağlar.

Satır içi Komut dosyası kodunuz için yeniden kullanılabilir parça oluşturma

Site oluşturucuda satır içi betik kodunuz için yeniden kullanılabilir bir parça oluşturmak üzere aşağıdaki adımları izleyin.

Parçalar'a gidin ve Yeni'yi seçin.
Yeni parça iletişim kutusunda, Satır içi betik'i seçin.
Parça adı altında, parça için bir ad girin ve Tamam'ı seçin.
Oluşturduğunuz parçanın altında, varsayılan satır içi kod modülünü seçin.
Özellik bölmesinde, satır içi komut dosyası altında, istemci tarafı komut dosyanızı girin. Daha sonra, istediğiniz şekilde diğer seçenekleri yapılandırın.
Kaydeti seçin ve sonra Düzenlemeyi bitir'i seçin.
Yayımla'yı seçin.

Harici Komut dosyası kodunuz için yeniden kullanılabilir parça oluşturma

Site oluşturucuda harici betik kodunuz için yeniden kullanılabilir bir parça oluşturmak üzere aşağıdaki adımları izleyin.

Parçalar'a gidin ve Yeni'yi seçin.
Yeni parça iletişim kutusunda, Harici betik'i seçin.
Parça adı altında, parça için bir ad girin ve Tamam'ı seçin.
Oluşturduğunuz parçanın altında, Varsayılan harici kod modülünü seçin.
Sağdaki Özellik bölmesinde, komut dosyası kaynağı altında, harici komut dosyası kaynağı için HARICI veya göreli bir URL ekleyin. Daha sonra, istediğiniz şekilde diğer seçenekleri yapılandırın.
Kaydeti seçin ve sonra Düzenlemeyi bitir'i seçin.
Yayımla'yı seçin.

Dekont

Siteniz için içerik güvenliği ilkesi (CSP) etkinse, tüm harici URL'lerin Commerce site oluşturucudaki script-src CSP yönergesine eklendiğinden emin olun. Daha fazla bilgi için bkz. İçerik Güvenlik İlkesini (CSP) yönetme.

Bir şablona komut kodu içeren bir parça ekleme

Site oluşturucuda şablona komut kodu dahil eden bir parça eklemek üzere aşağıdaki adımları izleyin.

Şablonlara gidin ve kodunuzu eklemek istediğiniz sayfaların şablonunu açın.
Sol bölmede, HTML Baş yuvasını göstermek için şablon hiyerarşisini genişletin.
HTML Baş yuvası için üç nokta (...) düğmesini seçin ve Parçası ekle'yi seçin.
Kodunuz için oluşturduğunuz parçayı seçin.
Kaydeti seçin ve sonra Düzenlemeyi bitir'i seçin.
Yayımla'yı seçin.

Bir şablona doğrudan harici bir komut dosyası veya satıriçi komut dosyası ekleme

Bir satır içi veya harici bir kodu, tek bir şablon tarafından denetlenen bir sayfa kümesine doğrudan eklemek istiyorsanız, önce parça oluşturmanız gerekmez.

Bir şablona doğrudan satıriçi komut dosyası ekleme

Site oluşturucuda bir şablona doğrudan satır içi komut dosyası eklemek için aşağıdaki adımları izleyin.

Şablonlara gidin ve kodunuzu eklemek istediğiniz sayfaların şablonunu açın.
Sol bölmede, HTML Baş yuvasını göstermek için şablon hiyerarşisini genişletin.
HTML Baş yuvası için üç nokta (...) düğmesini seçin ve Modül Ekle'yi seçin.
Modül ekle iletişim kutusunda, satır içi betik 'u seçin.
Özellik bölmesinde, satır içi komut dosyası altında, istemci tarafı komut dosyanızı girin. Daha sonra, istediğiniz şekilde diğer seçenekleri yapılandırın.
Kaydeti seçin ve sonra Düzenlemeyi bitir'i seçin.
Yayımla'yı seçin.

Bir şablona doğrudan harici komut dosyası ekleme

Site oluşturucuda bir şablona doğrudan harici komut dosyası eklemek için aşağıdaki adımları izleyin.

Şablonlara gidin ve kodunuzu eklemek istediğiniz sayfaların şablonunu açın.
Sol bölmede, HTML Baş yuvasını göstermek için şablon hiyerarşisini genişletin.
HTML Baş yuvası için üç nokta (...) düğmesini seçin ve Modül Ekle'yi seçin.
Modül ekle iletişim kutusunda, Harici betik 'u seçin.
Sağdaki Özellik bölmesinde, komut dosyası kaynağı altında, harici komut dosyası kaynağı için HARICI veya göreli bir URL ekleyin. Daha sonra, istediğiniz şekilde diğer seçenekleri yapılandırın.
Kaydeti seçin ve sonra Düzenlemeyi bitir'i seçin.
Yayımla'yı seçin.