---
metadata:
- name: generator
content: Diplodoc Platform v5.66.1
alternate:
- https://yandex.com.tr/support/metrica/en/ecommerce/bitrix.md
- https://yandex.com.tr/support/metrica/es/ecommerce/bitrix.md
- https://yandex.com.tr/support/metrica/pt/ecommerce/bitrix.md
- https://yandex.com.tr/support/metrica/ru/ecommerce/bitrix.md
- https://yandex.com.tr/support/metrica/tr/ecommerce/bitrix.md
- href: https://yandex.com.tr/support/metrica/tr/ecommerce/bitrix.md
type: text/markdown
title: Markdown version
- href: https://yandex.com.tr/support/metrica/tr/llms.txt?revision=r22041621
rel: describedby
title: 1C-Bitrix için modül bağlantısı
description: 1C-Bitrix için modül bağlantısı.
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com.tr/support/metrica/tr/llms.txt?revision=r22041621
# 1C-Bitrix için modül bağlantısı
Yandex Metrica ekibi olarak web analiz sayacı sitesine yüklenmek üzere ücretsiz ve resmi bir eklenti geliştirdik. Modül, 1C-Bitrix 18.0 ve üzeri sürümlerde çalışır, “1C-Bitrix: Site Yönetimi” nin tüm sürümlerini destekler.
“Yandex Metrica” modülünün özellikleri:
- Aşağıda sıralanan özelliklere varsayılan olarak sahip Yandex Metrica sayaçlarının eklenmesi:
- [E-ticaret](https://yandex.com.tr/support/metrica/tr/ecommerce/about.md),
- [Oturum kaydı](https://yandex.com.tr/support/metrica/tr/webvisor/info.md),
- [Tıklama haritası](https://yandex.com.tr/support/metrica/tr/behavior/click-map.md).
- Aşağıdaki [e-ticaret eylemlerinin](https://yandex.com.tr/support/metrica/tr/ecommerce/data.md) aktarımı:
- Ürün bilgi kartı görüntüleme,
- Ürünün sepete eklenmesi,
- Ürünün sepetten çıkarılması,
- Satın alma işlemi.
- [Aktarılan ürün verilerinin](https://yandex.com.tr/support/metrica/tr/ecommerce/data.md#product_data) ayrıntılandırılması.
{% cut "Modül güvenliği" %}
1C-Bitrix ile birlikte yapılan analiz sonucunda **yandex.metrika** modülündeki olası güvenlik açıkları tespit edilip giderildi.
Uzmanlar birkaç güvenlik sorunu tespit etti. Kötü niyetli kişiler tarafından verilerin ele geçirilmesi, isteklerin değiştirilmesi veya kötü amaçlı kod eklenmesi riski vardı. Tespit edilen tüm güvenlik açıkları hızla giderildi.
Yapılan değişiklikler:
- AJAX eylemleri çağrılırken kimlik doğrulama güçlendirildi; kritik işlemlere erişim, CSRF tokeni ve istek yöntemi doğrulamasıyla korunuyor.
- Cookie aracılığıyla kullanıcı ID’sinin değiştirilmesi olasılığı ortadan kaldırıldı; kullanıcı tanımlama artık sunucu oturumuna bağlı.
- Güvenli olmayan veri seri durumdan çıkarma ve potansiyel olarak tehlikeli işlevlerin (örneğin extract) kullanılmasıyla ilişkili riskler giderildi.
- JavaScript bağlamında görüntülenen tüm kullanıcı verileri titizlikle doğrulandı ve güvenli biçimde kaçışlandı; böylece siteler arası betik çalıştırma (XSS) saldırıları önlendi.
- Yönetim panelinde modül ayarları kaydedilirken CSRF tokeninin sıkı biçimde doğrulanması sağlandı.
- Ziyaretçinin IP Adresini belirleme yöntemi düzeltildi; artık platformun standart mekanizması kullanılarak HTTP üst bilgileri üzerinden IP sahteciliği önleniyor.
Tüm değişiklikler sitelerin güvenlik düzeyini artırır ve Yandex Metrica’nın standart işlevlerini etkilemez. Güncelleme, yöneticilerin ek işlem yapmasını gerektirmez; modülün güncel sürümünü yüklemek yeterlidir.
Projelerin maksimum düzeyde korunması için **yandex.metrika** modülü kullanıcılarının güncelleme yapmasını öneririz.
{% endcut %}
## Modülün kurulumu ve ayarlanması {#general}
### Başlarken {#start}
1. Henüz bir Yandex Metrica sayacınız yoksa [sayaç oluşturun](https://yandex.com.tr/support/metrica/tr/quick-start.md). Sayaç ayarlarında site adresinin doğru belirtildiğinden emin olun. Bu amaçla Yandex Metrica'da **Ayarlar** sayfasına gidin. **Adres** alanına dikkat edin: Bu alana eklentiyi kurmak istediğiniz sitenin adresi yazılmalıdır.
1.
Sayaç ayarlarında **E-ticaret** seçeneğini etkinleştirin. Veri toplaması için sayaç koduna `dataLayer` taşıyıcısı eklenir.
1. Ayrıca, 1C-Bitrix’te Yandex Metrica sayacını yükleyen benzer başka bir modül etkinleştirilmediğinden emin olun. Bunun için yönetici panelinde **Marketplace** → **Yüklü çözümler** açın ve modülü “Yandex Metrica”, “Metrica” veya “Metrika” adıyla arayın. Eğer böyle bir modül yüklüyse, onu kaldırın.
### Adım 1: Modülün kurulumu {#upload}
1C-Bitrix yönetici paneline gidin, oturum açın ve modülü şu yöntemlerden biriyle ekleyin:
{% cut "Yönetici paneli üzerinden" %}
1. **Marketplace** → **Yüklü çözümler** öğesini açın, “Yandex Metrica” adlı modülü bulun.
1. Simgeye tıklayın ve **Yükle** seçeneğini seçin.
{% endcut %}
{% cut "1C-Bitrix: Marketplace üzerinden" %}
1. [1C-Bitrix: Marketplace](http://marketplace.1c-bitrix.ru/solutions) gidin, “Yandex Metrica” adlı modülü bulun.
1. Modülü açın ve **Yükle** butonuna tıklayın.
{% endcut %}
{% cut "ZIP arşiv yardımı ile" %} {#zip}
1. [UTF8](https://metrika-cms-plugins.s3.yandex.net/1c-bitrix/yandex.metrika.utf8.zip) veya [CP1251](https://metrika-cms-plugins.s3.yandex.net/1c-bitrix/yandex.metrika.cp1251.zip) kodlamalı kurulum ZIP arşivini indirin.
1. 1C-Bitrix yönetici panelinde **İçerik** sayfasına gidin.
1. **Dosyalar ve klasörler** → **bitrix** → **modules** bölümünü seçin ve modüller listesinin son sayfasını açın.
1. **Yükle**→ **Dosya ekle** butonuna tıklayın ve Yandex Metrica modülünün ZIP arşivini seçin.
1. **Kaydet** butonuna tıklayın. Arşiv, sunucunuzdaki `modules` dizinine yüklenecektir.
1. Arşivi açın: modüller listesinde bulun,  simgesine tıklayın ve **Aç** seçeneğini seçin. `yandex.metrika` dizininin listede göründüğünden emin olun.
1. **Marketplace** → **Yüklü çözümler** öğesini açın, “Yandex Metrica” adlı modülü bulun.  Simgeye tıklayın ve **Yükle** seçeneğini seçin.
{% endcut %}
### Adım 2: Modülün kurulumu {#set}
1. **Ayarlar** → **Ürün ayarları** → **Modül ayarları** → **Yandex Metrica** sayfasına gidin.
1. Siteyi seçin.
1. Web sitenizde kurulu olan sayacın numarasını belirtin. Eklenti, sitede bir Yandex Metrica sayacı algılarsa ilgili alanlar otomatik doldurulur. Alanları kontrol edin. [Sayaç numarası nasıl bulunur?](https://yandex.com.tr/support/metrica/tr/general/tag-id.md)
1. Varsayılan olarak **Oturum Kaydı** özelliği açıktır. Ziyaret sırasında [ziyaretçi eylemlerini kaydeden](https://yandex.com.tr/support/metrica/tr/webvisor/info.md) bu özellik sayesinde ziyaret istatistiklerini daha kapsamlı bir şekilde analiz edebilirsiniz. Oturum Kaydı'nı istediğiniz zaman kapatabilirsiniz.
1. Değişiklikleri kaydedin.
{% note tip %}
**Marka Özelliği** alanını doldurmak zorunlu değildir. [Eğer Yandex Metrica’da marka istatistiklerini izlemek istiyorsanız, doldurun onu](#brand). Örneğin, hangi markanın müşteriler arasında en popüler olduğunu.
Bunun yanı sıra, ürünler hakkında daha ayrıntılı istatistikler almak için (örneğin, ziyaretçilerin hangi ürünleri daha sık görüntülediği), [detail etkinliğini ayarlayın](#detail).
{% endnote %}
### Adım 3: Veri gönderimi kontrolü {#check}
Aşağıdaki verilerin Yandex Metrica’ya gönderilip gönderilmediğini kontrol edin:
- [e-ticaret verileri](https://yandex.com.tr/support/metrica/tr/ecommerce/check.md)
- [site ziyaretleri verileri](https://yandex.com.tr/support/metrica/tr/general/check-counter.md)
E-ticaret verileri ilk gönderildikten birkaç saat içinde Yandex Metrica'da görüntülenir. E-ticaret raporlarını görüntülemek için Yandex Metrica'da **Raporlar** → **Standart raporlar E-ticaret** menüsünü açın.
[E-ticaret raporları](https://yandex.com.tr/support/metrica/tr/data/e-commerce-reports.md)
Ziyaret ve görüntüleme verileri, eklenti kurulduktan sonra siteye ilk ziyaretler gerçekleştiğinde Yandex Metrica'da görüntülenir. İstatistikleri görmek için, Yandex Metrica’da **Raporlar** öğesini açın. Raporlarla çalışma hakkında bilgi edinmek için [Rapor ayarları ve görüntülemesi](https://yandex.com.tr/support/metrica/tr/reports/report-general.md) bölümüne gidin.
## Ek ayarlar {#func}
### Modül ayarlarında “Marka Özelliği” alanı nasıl doldurulur {#brand}
Yandex Metrica’ya internet mağazanızın markaları hakkında bilgi aktarabilirsiniz. Bu verilere dayanarak Yandex Metrica’da [bir rapor oluşturulur](https://yandex.com.tr/support/metrica/tr/reports/popular-brands.md), bu da örneğin, müşteriler arasında en popüler markayı belirlemeye veya hangi markanın en fazla kar getirdiğini öğrenmeye yardımcı olur.
{% note info %}
1C-Bitrix şablonlarında birkaç ürün kataloğu olabilir. Yandex Metrica modül ayarlarında sadece aktif katalogların marka özellikleri görüntülenir. Yandex Metrica’ya doğru veri aktarımı için tüm mevcut **Marka Özelliği** alanlarını doldurmanızı öneririz.
{% endnote %}
Özellik değerini bulmak için:
1. 1C-Bitrix yönetici paneline gidin.
1. **İçerik** → **Bilgi blok türleri** → **Kataloglar** bölümüne gidin ve bir katalog seçin.
1. Sağda **Özellikler** sekmesini açın.
1. Listede markadan sorumlu alanı bulun.
1. “Yandex Metrica” modül ayarlarında alan adını belirtin.
### Ürün görüntüleme bilgilerini nasıl iletebilirsiniz (detail özelliği) {#detail}
Yandex Metrica’ya ürün görüntüleme verilerini aktarabilirsiniz, böylece e-ticaret raporları daha ayrıntılı bilgi içerir. Örneğin, bu şekilde [“Popüler Ürünler” Raporu](https://yandex.com.tr/support/metrica/tr/reports/popular-goods.md) oluşturulur.
Ürün görüntüleme ile ilgili olayları ayarlamak için, sitenizdeki `bitrix:catalog` bileşen şablonunda `element.php` dosyasının kodunda değişiklik yapmanız gerekir.
{% note alert %}
Farklı sitelerin şablonlarında `element.php` dosyasının yolu değişebilir.
{% endnote %}
1. Siteye yönetici olarak giriş yapın.
1. **Site** sekmesinde **Düzenleme Modu**nu etkinleştirin.
{% note info %}
Daha önce şablonu düzenlediyseniz, talimatın 6. adımına geçin.
{% endnote %}
1. Sitede ürün kartını açın ve katalog bileşeni alanına fareyi getirin – bir menü belirecektir.
1.  simgesine tıklayın, katalogu seçin ve ardından **Bileşen şablonunu kopyala**yı seçin.
1. **Site şablonuna kopyala** alanında **mevcut** olanı seçin ve değişiklikleri kaydedin.
1. `element.php` dosyasını [bulun](#found-element) ve açın. Kodda şu tür bir satır bulun:
```php
$elementId = $APPLICATION->IncludeComponent('bitrix:catalog.element', 'bootstrap_v4', $componentElementParams,
$component
);
```
Eğer `bitrix:catalog.element` bileşeninden önce `"$elementId = "` yoksa, değişkeni koda kendiniz ekleyin.
1. Ardından `$APPLICATION->IncludeComponent("yandex.metrika:detail", "", array("PRODUCT_ID" => $elementId), $component);` ekleyin.
`detail` kodundaki değişkenlerin ve işlev adlarının büyük/küçük harflerinin `element.php` dosyasındaki değişkenlerin büyük/küçük harfleriyle eşleştiğinden emin olun.
{% cut "Kod örneği" %}
```php
...
$elementId = $APPLICATION->IncludeComponent('bitrix:catalog.element', 'bootstrap_v4', $componentElementParams,
$component
);
$APPLICATION->IncludeComponent("yandex.metrika:detail", "", array("PRODUCT_ID" => $elementId), $component);
...
```
{% endcut %}
1. **Kaydet** butonuna tıklayın.
{% cut "element.php dosyası nasıl bulunabilir" %} {#found-element}
1. **Site** sekmesinde **Düzenleme Modu**nu etkinleştirin.
1. Sitede ürün kartını açın ve katalog bileşeni alanına fareyi getirin – bir menü belirecektir.
1.  simgesine tıklayın, katalogu seçin ve ardından **Bileşen şablonunu düzenle**yi seçin.
1. Açılan pencerede `element.php` dosyasının görüntülendiğinden emin olun. Dosya yolu pencere başlığında belirtilmiştir.
{% endcut %}
Modül kurulum ve ayarlarından sonra hata günlüğünü kontrol edin. Bunun için 1C-Bitrix yönetim panelinde modülü açın. Sorularınızı [aşağıdaki form](#form) veya 1C-Bitrix sitesinde (sağ alt köşede **Destek** butonuna tıklayın) sorabilirsiniz.
{% cut "Sık yapılan hataların görüntülenmesi" %}
- Eski 1C-Bitrix sürümü. Yeni sürümün kuruluma hazır olup olmadığını kontrol edin ve hazırsa indirip kurun. Bunun için yönetim panelinde **Marketplace** → **Platform Güncellemesi** sayfasına gidin.
- Belirttiğiniz marka özelliği sitede mevcut değil.
- Sayaç numarası, rakamlar dışında karakterler içeriyor.
{% endcut %}
## Lisans sözleşmesi {#licens}
1C-Bitrix için “Yandex Metrica” modülünün kullanımına ilişkin [Lisans Sözleşmesi](https://metrika-cms-plugins.s3.yandex.net/1c-bitrix/LICENSE.txt)ni okuyun.
## Modül güncellemesi {#update}
Modülün yeni bir sürümü çıktığında, bu konuda bir mesaj 1C-Bitrix yönetim panelinde görüntülenecektir. Güncellemeyi aşağıdaki yöntemlerden birini kullanarak kurabilirsiniz:
- Bildirimdeki bağlantıdan geçiş yapın.
- **Marketplace** → **Yüklü çözümler** sayfasında modülü seçin.
- [1C-Bitrix: Marketplace](https://marketplace.1c-bitrix.ru/) sayfasında.
- Güncellenmiş ZIP arşivini [UTF8](https://metrika-cms-plugins.s3.yandex.net/1c-bitrix/yandex.metrika.utf8.zip) veya [CP1251](https://metrika-cms-plugins.s3.yandex.net/1c-bitrix/yandex.metrika.cp1251.zip) kodlamasıyla indirin ve [dosya kurulum talimatlarını izleyin](#zip).
{#form}
[Sohbete yaz](https://yandex.com.tr/chat/#/user/036e6a02-3620-9cdc-4c5e-a34667a7379e?utm_source=spravka){.button}
- - -
#|
||
Faydalı bağlantılar
- [Demo sayacı](https://metrica.yandex.com.tr/r/dashboard?)
- [Sayaç ekle](https://metrica.yandex.com.tr/add/)
- [Yandex Metrica API'si](https://tech.yandex.com.tr/metrika/)
- [Fikir öner](https://yandex.com.tr/support/metrica/troubleshooting/idea.html)
- [Telegram sohbeti](https://t.me/yandexmetrika)
|
Çevrimiçi eğitim
- [Yandex Metrica sertifikası al](https://yandex.ru/adv/expert/exam/metrika/?utm_source=metrika_help&utm_medium=web&utm_campaign=static&utm_content=useful_links)
- [Eğitim kursuna katıl](https://yandex.com/adv/edu/online/metrika?utm_source=metrika_help&utm_medium=web&utm_campaign=static&utm_content=useful_links)
||
|#