> For the complete documentation index, see [llms.txt](https://user.netmera.com/netmera-user-guide/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://user.netmera.com/netmera-user-guide/netmera-user-guide-tr/targeting/contact-upload.md).

# İletişim yükleme

Bir iletişim dosyası yükleyerek kullanıcı profillerini ve izinlerini toplu olarak oluşturun veya güncelleyin; buna İYS senkronizasyon seçenekleri, önizleme adımı ve eşleşmeyen öznitelik düzeltmeleri dahildir.

`Hedefleme > İletişim Dosyası Yükleme`

Bu **İletişim Dosyası Yükleme** sayfası, dosya tabanlı yükleme aracılığıyla kullanıcı profili verisi oluşturmanıza veya güncellemenize ve onay bilgilerini yönetmenize olanak tanır. Bu özellik, Netmera kanalları genelinde hedefleme için kitleler hazırlamaya yardımcı olur.

Yükleme sırasında, onay verilerinin nasıl işleneceğini; Netmera içinde kalıp kalmayacağını, İYS’den çekilip çekilmeyeceğini ya da İYS’ye gönderilip gönderilmeyeceğini onay yönetimi stratejinize göre seçebilirsiniz. Yüklenen veriler işleme alınmadan önce doğrulanır.

İşlendikten sonra bu iletişimler, push, e-posta, SMS, web push ve diğer etkileşim kanalları genelinde segmentasyon, hedefleme ve otomasyon için kullanılabilir.

#### İYS nedir?

**İYS (İleti Yönetim Sistemi)** SMS ve e-posta için iletişim izinlerine yönelik Türkiye’nin ulusal onay yönetim sistemidir. Daha fazla bilgi için resmi İYS web sitesine bakın: <https://iys.org.tr>

#### İletişim dosyası yükleme yalnızca İYS için mi?

Hayır. İletişim Dosyası Yükleme sayfası **İYS entegrasyonu ile veya olmadan kullanılabilir**.

* İYS kullanılmadığında, sayfa kullanıcı profili verilerinin yüklenmesini ve güncellenmesini ve onay bilgilerinin yalnızca Netmera içinde yönetilmesini destekler.
* İYS entegrasyonu etkinleştirildiğinde, sayfa seçilen yükleme seçeneğine göre Netmera ve İYS arasındaki onay verilerinin eşzamanlanmasını destekler: [#pull-consents-from-iys](#pull-consents-from-iys "mention") veya [#push-consents-to-iys](#push-consents-to-iys "mention").

İYS ile ilgili ayarlar isteğe bağlıdır ve yalnızca İYS ile onay eşzamanlaması gerektiğinde uygulanır.

#### İYS olmadan iletişim dosyası yüklemeyi ne için kullanabilirim?

İYS entegrasyonu kullanılmadığında, İletişim Dosyası Yükleme sayfası kullanıcı verilerini yönetmek için kullanılır **yalnızca Netmera içinde**. İYS’den hiçbir onay verisi okunmaz veya İYS’ye yazılmaz. Bu sayfayı şunlar için kullanabilirsiniz:

* Yeni kullanıcı profilleri oluşturma
* Mevcut kullanıcı profili bilgilerini güncelleme
* Profil özniteliklerini yükleme veya yenileme (şehir, dil, sadakat seviyesi veya özel öznitelikler gibi)
* Segmentasyon ve hedefleme için etiket atama
* Kampanyalar ve otomasyon akışları için iletişim listeleri hazırlama

Bu [#iys-sync-off](#iys-sync-off "mention") modunda, yüklenen dosya **tek doğru kaynaktır**, ve en son yükleme, eşleşen kullanıcılar için mevcut Netmera verilerinin her zaman üzerine yazar. Bu seçenek, onay yönetimi İYS dışında yönetildiğinde veya İYS entegrasyonu gerekmediğinde uygundur.

### Gösterge Paneli Genel Bakışı

Gösterge paneli, her yükleme için ayrıntılı işleme meta verileriyle birlikte yüklenen iletişim dosyalarını listeler.

<figure><img src="https://1642824329-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX6uilbEAw42gqsudlclY%2Fuploads%2F6ir3enN28oNpQIxzx4ob%2FScreenshot%202026-01-22%20at%2014.15.51.png?alt=media&#x26;token=1c894831-ba8b-4599-873f-4d6a92ebad8a" alt=""><figcaption></figcaption></figure>

<table><thead><tr><th width="194.21954345703125">Sütun</th><th>Açıklama</th></tr></thead><tbody><tr><td><strong>Liste Adı</strong></td><td>Yüklenen iletişim listesinin adı.</td></tr><tr><td><strong>Yükleme Tarihi</strong></td><td>İletişim dosyasının yüklendiği tarih.</td></tr><tr><td><strong>İşlem Başlangıç Zamanı</strong></td><td>İletişim işleme sürecinin başladığı saat.</td></tr><tr><td><strong>İşlem Bitiş Zamanı</strong></td><td>İletişim işleme sürecinin tamamlandığı saat.</td></tr><tr><td><strong>Kullanıcı Sayısı</strong></td><td>İşleme sonrası başarıyla oluşturulan veya güncellenen kullanıcı sayısı.</td></tr><tr><td><strong>Toplam İçe Aktarılan Kayıt Sayısı</strong></td><td>Yüklenen dosyadan okunan toplam kayıt sayısı.</td></tr><tr><td><strong>Durum</strong></td><td>Yükleme sürecinin mevcut durumu (örn. <em>Onay Bekliyor</em>, <em>Tamamlandı</em>).</td></tr><tr><td><strong>Yükleme İşlemi</strong></td><td>Yükleme sırasında uygulanan onay işleme (örn. <em>İYS Eşzamanlaması Kapalı</em>, <em>İYS’den Onayları Çek, Onayları İYS’ye Gönder</em>).</td></tr><tr><td><strong>İşlemler</strong></td><td>Yükleme için kullanılabilir işlemler (örn. ayrıntılar için görüntüleme, bekleyen yüklemeler için düzenleme).</td></tr></tbody></table>

### İletişim Yükleme

Bu **İletişim Yükleme** sayfası, dosya tabanlı bir içe aktarma kullanarak Netmera’ya iletişim verisi yüklemenizi sağlar. Yükleme sırasında, herhangi bir İYS kaydını güncellememeyi seçebilir veya onay davranışını **İYS**ile eşzamanlamayı seçebilirsiniz; yüklenen veriler işleme alınmadan önce doğrulanır.

#### Sayfa Yapısı

İletişim Yükleme sayfası iki adımdan oluşur:

1. **Yükleme**
2. **Önizleme**

### Yükleme Adımı

Bu adımda temel yükleme bilgileri ve onay davranışı yapılandırılır, ardından iletişim dosyası yüklenir.

<figure><img src="https://1642824329-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX6uilbEAw42gqsudlclY%2Fuploads%2FecXefmJXHPPDDdToR5Lc%2FScreenshot%202026-01-22%20at%2014.19.42.png?alt=media&#x26;token=2b1a49ad-3857-4b11-be75-1c2dbb7f3e04" alt=""><figcaption></figcaption></figure>

**Liste Adı**

Bu yükleme tarafından oluşturulan iletişim listesinin adını tanımlar.

* Maksimum uzunluk: **50 karakter**
* Zorunlu alan
* şurada görünür: **İletişim Yükleme Gösterge Paneli** ve ilgili raporlar

**Etiket Adı (İsteğe Bağlı)**

Bu yüklemede içe aktarılan tüm iletişimlere bir etiket ekler.

* Maksimum uzunluk: **50 karakter**
* İsteğe bağlı
* Daha sonra segmentasyon veya hedefleme için etiket olarak kullanılabilir

**Dosya**

İletişim veri dosyasını yükler.

**Desteklenen biçimler:** `.csv` , `.txt`

**Dosya kuralları:**

* Her satır tek bir iletişimi temsil etmelidir
* Dosya yapısı gerekli şablonla eşleşmelidir

Kullanıcıları eşleştirebilmek için dosyanız bir tanımlayıcı içermelidir:

* `extID` (Dış Kimlik)
* `e-posta`
* `telefonnumarası`

{% hint style="info" %}

#### Telefon Numarası Biçim Gereksinimi

Telefon numaraları **uluslararası biçimde** ve **artı işareti (+) ile başlamalıdır**.

* Doğru: `+905XXXXXXXXX`
* Yanlış: `905XXXXXXXXX`

Bir telefon numarası **+ işareti olmadan**yüklenirse, sistem numarayı doğru şekilde tanımlayamaz ve iletişim **kullanıcıyla ilişkilendirilemez**.
{% endhint %}

#### Yükleme İşlemi

Onay bilgilerinin yükleme sırasında nasıl işlendiğini tanımlar, özellikle **İYS**.

<figure><img src="https://1642824329-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX6uilbEAw42gqsudlclY%2Fuploads%2FkOwPAHKAf3rdp5H94N3F%2FScreenshot%202026-01-22%20at%2014.19.12.png?alt=media&#x26;token=b983796a-c52f-47a0-93ad-cc17d53f26d3" alt=""><figcaption></figcaption></figure>

### İYS Eşzamanlaması Kapalı <a href="#iys-sync-off" id="iys-sync-off"></a>

İYS ile hiçbir onay eşzamanlaması yapılmaz.

* Yüklenen iletişimler yalnızca Netmera’daki verilere göre işlenir
* İYS ne sorgulanır ne de güncellenir

Bu seçeneği şu durumlarda kullanın:

* Kampanyalarınız için İYS onay kontrolleri gerekli değilse
* Onay yönetimi İYS dışında yürütülüyorsa
* Yalnızca Netmera onay verileri güncellenmeli
* Netmera’da kullanıcı profilleri oluşturmak veya güncellemek istiyorsanız
* Profil özniteliklerini yüklemek veya yenilemek istiyorsanız (şehir, dil, sadakat seviyesi veya özel öznitelikler gibi)
* Segmentasyon ve hedefleme için etiket atamak istiyorsanız
* İYS onay kontrolleri olmadan kampanyalar ve otomasyon akışları için iletişim listeleri hazırlamak istiyorsanız

{% hint style="info" %}

#### Kullanıcı oluşturma ve güncelleme mantığı (İYS Eşzamanlaması Kapalı)

Yükleme sırasında:

**Kullanıcı Netmera’da zaten mevcutsa**

* Kullanıcı profili yüklenen verilerle güncellenir

**Kullanıcı Netmera’da mevcut değilse**

* Yeni bir kullanıcı profili oluşturulur
  {% endhint %}

#### Örnek Dosya

{% file src="/files/b179e0e819b5a46527a95caae2127a484a58be1f" %}

### Onayları İYS’den çek <a href="#pull-consents-from-iys" id="pull-consents-from-iys"></a>

İYS’den **en güncel onay durumunu alır** ve bunu Netmera’ya uygular.

* Sistem, yüklenen dosyada tanımlanan kullanıcılar için İYS’yi sorgular
* Netmera’daki onay bilgileri İYS verilerine göre güncellenir
* Onay için İYS tek doğru kaynak olarak kabul edilir

Bu seçeneği şu durumda kullanın

* İYS, onay yönetimi için yetkili sistemdir
* Netmera onay verileri, İYS’de saklanan güncel durumu yansıtmalıdır

{% hint style="info" %}

#### Kullanıcı oluşturma ve güncelleme mantığı (Onayları İYS’den Çek)

Yükleme sırasında sistem **onay durumunu İYS’de kontrol eder** dosyadaki tanımlayıcıları kullanarak,

**Kullanıcı Netmera’da zaten mevcutsa**

* Kullanıcı profili en güncel verilerle güncellenir, onay değerleri İYS’ye göre üzerine yazılır

**Kullanıcı Netmera’da mevcut değilse**

* Netmera’da yeni bir kullanıcı profili oluşturulur, onay değerleri İYS’den doldurulur

Bu seçenekte İYS’ye geri hiçbir onay verisi yazılmaz.
{% endhint %}

#### Örnek Dosya

{% file src="/files/dd069970a162b717c4aa3960350e58d06475bccf" %}

### Onayları İYS’ye Gönder <a href="#push-consents-to-iys" id="push-consents-to-iys"></a>

Yüklenen dosyadaki onay bilgilerini **İYS**.

* Dosyadaki onay verileri İYS’ye gönderilir
* Onay durumu **oluşturulur veya güncellenir** hem İYS’de hem Netmera’da
* gerektirir **geçerli ve eksiksiz onay alanları** yükleme dosyasında

**Bu seçeneği şu durumda kullanın**

* Yerel olarak toplanan onay verileri İYS ile eşzamanlanmalıdır
* İYS kayıtları yüklenen verilere göre güncellenmelidir

{% hint style="info" %}

#### Kullanıcı oluşturma ve güncelleme mantığı (Onayları İYS’ye Gönder)

Yükleme sırasında sistem **onay verilerini yüklenen dosyadan okur**

**Kullanıcı Netmera’da zaten mevcutsa**

* Kullanıcı profili güncellenir, onay durumu hem Netmera’da hem İYS’de güncellenir

**Kullanıcı mevcut değilse**

* Netmera’da yeni bir kullanıcı profili oluşturulur, yüklenen veriler kullanılarak İYS’de yeni bir onay kaydı oluşturulur

Bu seçenekte, yüklenen dosya **tek doğru kaynaktır** için tek doğru kaynaktır
{% endhint %}

### Onayları İYS’ye Gönder – Zorunlu dosya başlıkları

Ne zaman **Onayları İYS’ye Gönder** yükleme işlemi olarak seçildiğinde, yükleme dosyası belirli onayla ilgili sütunları içermelidir. Bu alanlar, onay bilgilerinin İYS’ye başarıyla gönderilebilmesi için gereklidir.

E-posta ve SMS onayları **aynı dosyada**.

<figure><img src="https://1642824329-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX6uilbEAw42gqsudlclY%2Fuploads%2F69ZD5HRuoz39OfWN3TVW%2FScreenshot%202026-01-22%20at%2016.32.51.png?alt=media&#x26;token=8ac96e8f-0026-40c8-ad34-8dfdf7001fa8" alt=""><figcaption></figcaption></figure>

#### E-posta onayı için zorunlu başlıklar

Aşağıdaki sütunlar, e-posta onayını **İYS’ye göndermek için** eklenmelidir:

<table><thead><tr><th width="99.06732177734375">E-posta</th><th>İYS E-posta Durumu</th><th>İYS E-posta Onay Tarihi</th><th>İYS E-posta Kaynağı</th></tr></thead><tbody><tr><td>İletişimin e-posta adresi.</td><td>E-posta iletişimi için onay durumu. ONAY veya RET olmalıdır.</td><td>E-posta onayının alındığı tarih.</td><td>E-posta onayının toplandığı kaynak.</td></tr></tbody></table>

#### SMS onayı için zorunlu başlıklar

Aşağıdaki sütunlar, e-posta onayını **SMS onayı** eklenmelidir:

<table><thead><tr><th width="113.671875">Telefon Numarası</th><th>İYS SMS Durumu</th><th>İYS SMS Onay Tarihi</th><th>İYS SMS Kaynağı</th></tr></thead><tbody><tr><td>İletişimin telefon numarası.</td><td>SMS iletişimi için onay durumu. ONAY veya RET olmalıdır.</td><td>SMS onayının alındığı tarih.</td><td>SMS onayının toplandığı kaynak.</td></tr></tbody></table>

Bu **İYS E-posta Kaynağı** ve **İYS SMS Kaynağı** alanları aşağıdaki önceden tanımlanmış değerlerden birini içermelidir:

* `HS_FIZIKSEL_ORTAM`
* `HS_ISLAK_IMZA`
* `HS_WEB`
* `HS_CAGRI_MERKEZI`
* `HS_SOSYAL_MEDYA`
* `HS_EPOSTA`
* `HS_MESAJ`
* `HS_MOBIL`
* `HS_EORTAM`
* `HS_ETKINLIK`
* `HS_2015`
* `HS_ATM`
* `HS_KARAR`

#### Örnek Dosya

{% file src="/files/498e1388a5e83611f6e7e44d740a0de012a36f12" %}

### Önizleme Adımı

Yüklemeden sonra, **Profil Öznitelikleri Eşleştirme** ekranına yönlendirileceksiniz. Bu adım, dosyanızdaki sütunların Netmera’nın dahili öznitelikleriyle doğru şekilde eşleşmesini sağlar.

#### Bu ekranda

* Dosyanızdaki her sütun, eşleştirildiği profil özniteliğiyle birlikte görünür.
* Eşleştirmeyi **✏️ Düzenle** simgesini kullanarak inceleyebilir veya değiştirebilirsiniz.
* gibi ek öznitelikler `soyad`, `adres`, veya `şehir` dosyanıza bağlı olarak görünebilir.
* Bu **içe aktarılan toplam sütun sayısı** sayfanın altında görüntülenir.

<figure><img src="https://1642824329-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX6uilbEAw42gqsudlclY%2Fuploads%2Fx8hHbD5cFCeS1MMCZnkG%2FScreenshot%202025-10-21%20at%2013.40.01.png?alt=media&#x26;token=9b946fdd-99d1-412c-9a76-9ef12b0da152" alt=""><figcaption></figcaption></figure>

### Kırmızı Alanların İşlenmesi (Eşleşmeyen Öznitelikler)

Herhangi bir alan **kırmızı renkte**görünüyorsa, dosyanızdaki sütun başlığı bilinen bir profil özniteliğiyle eşleşmiyor demektir.

<figure><img src="https://1642824329-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX6uilbEAw42gqsudlclY%2Fuploads%2FEofRkQ3ocDYWkqpCglmL%2FScreenshot%202025-10-21%20at%2013.37.55.png?alt=media&#x26;token=49f6ecd6-d30a-4fcc-94b0-b9b7de39413a" alt=""><figcaption></figcaption></figure>

#### Düzeltmek için

1. şuna tıklayın **✏️ Düzenle** kırmızı alanın yanındaki simgeye.
2. Açılır listeden uygun özniteliği seçin.
3. Öznitelik listede yoksa, önce **oluşturulmalıdır** altında\
   `Geliştiriciler > Profil Öznitelikleri`.
4. Oluşturulduktan sonra, yüklemeyi tekrarlayın veya alanı yeniden eşleştirin.

<figure><img src="https://1642824329-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX6uilbEAw42gqsudlclY%2Fuploads%2FpszGkB1jTEBWYKZWDgI2%2FScreenshot%202025-10-21%20at%2013.39.10.png?alt=media&#x26;token=0bc81685-3726-4e26-86e2-8ce8477f5232" alt="" width="563"><figcaption></figcaption></figure>

> Dosyanızdaki herhangi bir özel öznitelik Netmera’nın panelinde önceden yapılandırılmamışsa (`Geliştiriciler > Profil Öznitelikleri`), önce oluşturulmalıdır **yüklemeden** önce. Aksi takdirde içe aktarılmaz ve yükleme özeti sırasında bir hata uyarısı alırsınız.

### Yüklemeyi Tamamlama

Tüm eşleştirmeleri doğruladıktan sonra:

1. Tıklayın **Kaydet**.
2. Yüklemenin işlendiğine dair onay gelene kadar bekleyin.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://user.netmera.com/netmera-user-guide/netmera-user-guide-tr/targeting/contact-upload.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.