---
metadata:
- name: generator
content: Diplodoc Platform v5.52.0
alternate:
- https://www.yandex.com/support/metrica/en/data/chat.md
- https://www.yandex.com/support/metrica/es/data/chat.md
- https://www.yandex.com/support/metrica/pt/data/chat.md
- https://www.yandex.com/support/metrica/ru/data/chat.md
- https://www.yandex.com/support/metrica/tr/data/chat.md
- https://www.yandex.com/support/metrica/zh/data/chat.md
- href: tr/data/chat.md
type: text/markdown
title: Markdown version
- href: ../llms.txt
type: text/markdown
title: llms.txt
title: Sohbetleri içe aktarma
description: Kullanıcılar siteyle etkileşimde bulunurken mesajlaşma uygulamalarını (WhatsApp, Telegram veya Viber) kullanarak bilgi edinmeyi veya sipariş oluşturmayı tercih ediyorsa sohbetlerdeki bu tür başvuruları takip edebilir ve bunları kullanıcıların web sitesindeki eylemleri ile ilişkilendirebilirsiniz.
---
> **Documentation Index:** Fetch the complete configuration index at https://www.yandex.com/support/metrica/tr/llms.txt
# Sohbetleri içe aktarma
Kullanıcılar siteyle etkileşimde bulunurken mesajlaşma uygulamalarını (WhatsApp, Telegram veya Viber) kullanarak bilgi edinmeyi veya sipariş oluşturmayı tercih ediyorsa sohbetlerdeki bu tür başvuruları takip edebilir ve bunları kullanıcıların web sitesindeki eylemleri ile ilişkilendirebilirsiniz.
Sohbetlerin içe aktarılması şunlara yardımcı olur:
- Kaç sohbete dönüşüm olduğunu öğrenmek;
- Bunların kalitesine değerlendirmek (örneğin kaç sohbetin yanıtsız kaldığı);
- Sonucu değerlendirmek (örneğin yazışmanın satın alıma yol yapıp açmadığı);
- Müşterilerle etkileşimler ve mesajlaşma uygulamalarında sohbetlere yol açan reklam kanallarının etkinliği hakkında daha kapsamlı bir resim elde etmek.
## Sohbetlerin Metrica’da takip edilmesi {#follow}
Veri toplamak için [sohbet izleme servislerini](https://metrika.yandex.ru/r/marketplace?filter=68ffa9395e9a080015db1866) veya kendi çözümlerinizi kullanın ve sohbetlerle ilgili verileri [API](https://yandex.com/dev/metrika/ru/data-import/) yardımıyla Metrica’ya aktarın.
{% note info %}
Kendi çözümünüzü kullanıyorsanız ve API üzerinden veri aktarıyorsanız çevrim dışı sohbeti siteye gerçekleştirilen belirli bir ziyaretle ilişkilendirebilmek için sitede ziyaretçi tanımlayıcılarını (`ClientID`, `UserID`, `Yclid`, `EPurchaseID`) toplamaya yönelik bir sistem yapılandırılmış olmalıdır.
{% endnote %}
Yandex Metrica’da sohbetler [hedefler](https://www.yandex.com/support/metrica/tr/general/goals.md) yardımıyla değerlendirilir; sohbete dönüşüm verileri ilk kez yüklendiğinde, otomatik olarak **Sohbet** türünde özel bir hedef oluşturulur. Bu otomatik hedef, Metrica arayüzünde hedef yönetimi sayfasında görünecektir.
Manuel olarak farklı bir hedef belirtilmesine gerek olmaz; Yandex Metrica yüklenen sohbet olaylarını algılar ve başarımlarını hesaplamaya başlar.
**Sohbet** hedefi tüm Yandex Metrica raporlarına eklenebilir. Bu hedef için hedef metrikler (dönüşümler, ulaşılan hedefler vb.) mevcut olacaktır. Hedef ve ulaşılan dönüşümler, reklam optimizasyonu için de kullanılabilir, yalnızca belirli sohbetler için tetiklenecek şekilde düzenlenebilir ve bu türde yeni hedefler eklenebilir.
## Sohbetlerle ilgili aktarılabilecek veriler {#info}
{% note warning %}
Başarılı bir yüklemeden sonra, sohbetlerle ilgili yüklenen veriler 2 saat zarfında Metrica raporlarında görüntülenecektir.
{% endnote %}
API veya [mesaj uygulaması izleme servislerinin](https://metrika.yandex.ru/r/marketplace?filter=68ffa9395e9a080015db1866) yardımıyla Metrica’ya sohbetlerle ilgili temel veya ek bilgiler aktarılabilir. Sohbet olaylarını zamana ve mesajlaşma uygulamasına göre tanımlamaya yönelik veriler ve diyaloğa ait tanımlayıcılar zorunlu nitelikte verilerdir. Bunlara ek olarak kalite ve sohbet değeri göstergeleri de gönderilebilir.
Muhtemel veriler ve bunların raporlarda kullanılması aşağıda belirtilmiştir.
**Sohbet yükleme alanı**
#|
|| **Bilgi** | **Zorunluluk** | **Açıklama** ||
|| Sohbet tarihi ve zamanı (Unix zamanı, UTC) | Evet | Sohbet olaylarının tespiti için kullanılır. Unix timestamp (UTC) cinsinden belirtilmesi zorunludur ||
|| Sohbet platformu (mesajlaşma uygulaması: `whatsapp`, `telegram`, `viber`) | Evet | Mesajlaşma uygulamasının adı, desteklenen uygulamalardan biri olmalıdır: `whatsapp`, `telegram` veya `viber` ||
|| Sohbet tanımlayıcıları (takma ad, ID, telefon) | Evet (en az bir tane) | Şu alanlardan en az biri doldurulmak zorundadır: `ChatUsername`, `ChatUserID` veya `PhoneNumber` ||
|| Sohbet yanıtı (kullanıcının yanıt alıp almadığı) | Hayır | Operatörden bir yanıt alınıp alınmadığını kaydeder. Değer: `1` veya `0` ||
|| Sohbet etiketleri (tag’leri) | Hayır | Sohbet segmentasyonu için 100 karaktere kadar metin etiketi ||
|| Dönüşüm tutarı (sohbet değeri) ve para birimi | Hayır | Gelirin sohbet üzerinden aktarılmasına olanak tanır: sayısal değer ve para birimi kodu (ISO 4217) ||
|| Sohbetin başlatıldığı web sitesi sayfasının URL’si | Hayır | Kullanıcının sohbeti başlattığı sayfanın adresi ||
|| Mesajlaşma uygulaması izleme servisinin bağlantısı | Hayır | İç analiz için izleme sistemindeki sohbete teknik bağlantı ||
|#
## Sohbet verilerini aktarma {#how-send}
Entegrasyon iki yöntemle gerçekleştirilebilir:
- **[Sohbet izleme servisleri aracılığıyla](https://metrika.yandex.ru/r/marketplace?filter=68ffa9395e9a080015db1866)**
Tedarikçi, web sitesine yerleştirilmesi gereken bir kod (bir widget veya betik) sağlar. Kod, gerekli tanımlayıcıları otomatik olarak toplar ve olayları Metrica’ya aktarılmak üzere hazırlar.
- **Doğrudan API üzerinden**
Bu durumda aşağıdaki önerileri takip edin.
### 1. Adım: Ziyaretçi tanımlayıcılarını toplama {#step-1}
**Hedef**: Sohbetin, web sitesini ziyaretle veya reklama tıklama ile ilişkilendirilmesini sağlamak.
- **[Sohbet izleme servisi kullanıldığında](https://metrika.yandex.ru/r/marketplace?filter=68ffa9395e9a080015db1866)**
Sağlanan kodu uygulamak yeterli. Bu kod gerekli Metrica tanımlayıcılarını otomatik olarak hesaplar ve iletir:
- `_ym_uid;` **ClientID**’si;
- Gerektiğinde **UserID**;
- Direct’ten Gülen trafik için **yclid**.
- **Kendi entegrasyonunuza sahip olduğunuzda**
Bir veya birkaç tanımlayıcıyı aktarın:
- **ClientID**: Metrica ziyaretçisinin temel tanımlayıcısı. Siteye ziyaretten sonra sohbet başlatıldığında aktarılmasını öneririz.
- **UserID**: UserID işlevi etkinse kullanıcı iç tanımlayıcınız.
- **Yclid**: Direct tıklaması tanımlayıcısı. Kullanıcı web sitesini pas geçerek doğrudan mesajlaşma uygulamasına geçtiğinde geçerli.
- **PurchaseID**: Sohbet belirli bir işlemle ilgili ise siparişin tanımlayıcısı. Nadir bir senaryo.
Hiçbir tanımlayıcı aktarılmazsa olay, ziyaret veya tıklamayla ilişkilendirilmeden, **atfedilmemiş** olarak yüklenecektir.
### 2. Adım: Mesajlaşma uygulamaları bağlantılarına kendi sohbet tanımlayıcınızı dâhil edin {#step-2}
**Hedef**: Bir diyalog başlatıldığında sohbeti 1. adımdaki Metrica tanımlayıcılarıyla eşleştirmek.
[Sohbet izleme](https://metrika.yandex.ru/r/marketplace?filter=68ffa9395e9a080015db1866) servislerinin kullandığı önerilen bu şemayı kendi entegrasyonunuzda kullanabilirsiniz:
1. **Benzersiz bir sohbet tanımlayıcısı** oluşturun. Örneğin `CT8F2A9`.
2. Sitedeki kod **bu tanımlayıcıyı her mesajlaşma uygulaması bağlantısına ekleyecektir**:
- **Telegram robotu** – deeplink (başlatma parametresi) aracılığıyla. Kullanıcı tanımlayıcıyı göremeyecek ancak bot ilk kez iletişime geçtiğinde onu alacak.
- **Kişisel Telegram, WhatsApp veya Viber hesapları** – daha önce hazırlanan ve tanımlayıcının yer aldığı **ilk mesaj şablonu** aracılığıyla. Örneğin bir mesajın sonunda teknik etiket.
3. Diyaloğun başlamasından sonra servis sohbetin tanımlayıcısını deeplink’ten veya ilk mesajdan alacak ve onu daha önce toplanmış olan `ClientID`, `UserID`, `Yclid` Metrica tanımlayıcılarıyla **karşılaştıracaktır**.
4. Doğru ilişkilendirme için yeterli olan **chat-ID ↔ Metrica tanımlayıcıları** arasına kalıcı bir eşleştirme oluşacaktır.
### 3. Adım: Olayların Metrica’ya içe aktarılması {#step-3}
İlişki oluşturulduğunda, sohbet olaylarını [Metrica sohbetlerini API ile içe aktarma](https://yandex.com/dev/metrika/ru/management/chats) aracılığıyla aktarın. Veri formatı (olay tarihi, izin verilen platform değerleri, alan yapıları vb.) gereklilikleri API spesifikasyonlarında açıklanmıştır.
[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/r/dashboard?)
- [Sayaç ekle](https://metrica.yandex.com/add/)
- [Ücretsiz sayaç ayarları](https://yandex.com/promo/freeservice/metrica?utm_source=help_metrica_en&utm_medium=cpc&utm_campaign=1)
- [Yandex Metrica API'si](https://tech.yandex.com/metrika/)
- [Fikir öner](https://yandex.com/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)
||
|#