---
metadata:
  - name: generator
    content: Diplodoc Platform v5.54.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: tr/ecommerce/bitrix.md
    type: text/markdown
    title: Markdown version
  - href: ../llms.txt
    type: text/markdown
    title: llms.txt
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


# 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ı.

## 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. <!-- source: tr/_includes/ecommerce/enabling/id-enabling/3.md -->
   Sayaç ayarlarında **E-ticaret** seçeneğini etkinleştirin. Veri toplaması için sayaç koduna `dataLayer` taşıyıcısı eklenir.
   <!-- endsource: tr/_includes/ecommerce/enabling/id-enabling/3.md -->
    
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, ![](../_assets/bitrix-menu.png) 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. ![](../_assets/bitrix-menu.png) 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 %}


### 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. ![](../_assets/bitrix-set-icon.png) 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. ![](../_assets/bitrix-set-icon.png) 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).

<!-- source: tr/_includes/buttons/chat-button.md -->
[Sohbete yaz](https://yandex.com.tr/chat/#/user/036e6a02-3620-9cdc-4c5e-a34667a7379e?utm_source=spravka){.button}

<!-- source: tr/_includes/styles/href-to-button.md -->

<!-- endsource: tr/_includes/styles/href-to-button.md -->
<!-- endsource: tr/_includes/buttons/chat-button.md -->

<!-- source: tr/_includes/support-2.md -->
<div class="cut-button">

{% cut "E-posta yaz" %}

<!-- source: tr/_includes/popup/id-popup/wrong-sup.md -->
Lütfen, dikkatli olun: Destek Ekibi kullanıcıları aramaz. Dolayısıyla Yandex Metrica Destek Ekibi adına sizi telefonla arayan yabancıları yok sayın ve talimatlarını kesinlikle izlemeyin.
<!-- endsource: tr/_includes/popup/id-popup/wrong-sup.md -->

<div style="padding: 15px;
     margin: 10px 0;
     background: #FFFFFF;
     border-radius: 10px;
     border: 1px solid var(--yc-color-line-generic);">
  <iframe style="background: #FFFFFF;"
        height="700"
        width="100%"
        frameborder="0"
        src="https://forms.yandex.com.tr/surveys/10011833/?&iframe=1&lang=tr">
  </iframe>
</div>

{% endcut %}

</div>

<!-- source: tr/_includes/styles/cut-button.md -->

<!-- endsource: tr/_includes/styles/cut-button.md -->
<!-- endsource: tr/_includes/support-2.md -->

<!-- source: tr/_includes/footer-links.md -->
- - -

<div class="borderless-table">

#|
||
Faydalı bağlantılar

- [Demo sayacı](https://metrica.yandex.com.tr/r/dashboard?)
- [Sayaç ekle](https://metrica.yandex.com.tr/add/)
- [Ücretsiz sayaç ayarları](https://yandex.com.tr/promo/freeservice/metrica?utm_source=help_metrica_tr&utm_medium=cpc&utm_campaign=1)
- [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)

||
|#

</div>

<!-- source: tr/_includes/styles/table-style.md -->

<!-- endsource: tr/_includes/styles/table-style.md -->
<!-- endsource: tr/_includes/footer-links.md -->
