# FTP Push ve İçe Aktarımlar

Dosyaları FTP’ye bırakarak Netmera’da push bildirimleri gönderin ve kullanıcı verilerini güncelleyin.

API çağrıları olmadan basit ve otomatik bir entegrasyon istediğinizde bunu kullanın.

### Başlamadan önce

Elinizde şunlar olmalı:

* Netmera tarafından uygulamanız için FTP erişimi etkinleştirilmiş olmalı.
* FTP kimlik bilgileri alınmış olmalı.
* IP allowlisting kullanılıyorsa, şunları Netmera ile paylaşın: **genel çıkış IP adresinizi** Netmera ile.

Eğer hedefiniz **rapor dışa aktarımları**ise, ayrı [veri-disa-aktarma](https://user.netmera.com/netmera-user-guide/netmera-user-guide-tr/raporlar-ve-analitik/raporlar/veri-disa-aktarma "mention") modülünü kullanın.

### FTP ile push bildirimleri gönderme (FTP Push)

{% stepper %}
{% step %}

#### FTP Push’u etkinleştirin ve kimlik bilgilerini alın

FTP özelliklerine erişmek ve FTP host, port, path ile kimlik bilgilerini almak için Netmera veya DevOps ekiplerinizle çalışın.
{% endstep %}

{% step %}

#### CSV dosyasını hazırlayın

Bir **UTF-8** UTF-8 kodlu CSV dosyası oluşturun. Ayırıcı olarak **noktalı virgül (`;`)** ) kullanın.

Sütunlar şu sırada olmalıdır:

* `ExternalID`
* `Metin`
* `Deeplink`

Satır başına format:

`ExternalID;Text;Deeplink`
{% endstep %}

{% step %}

#### Dosyayı FTP’ye yükleyin

CSV dosyasını DevOps tarafından sağlanan dizine yükleyin.

Netmera dosyayı işler ve bildirimleri gönderir.
{% endstep %}
{% endstepper %}

{% hint style="warning" %}
**Uyarı: Inbox İçeren FTP Push Bildirimleri**

FTP üzerinden gönderilen tüm push bildirimleri varsayılan olarak **Inbox** seçeneğini içerir. Uygulamanızda Inbox özelliği yoksa bu sizi etkilemez. Ancak uygulamanızda Inbox özelliği varsa, **FTP üzerinden gönderilen bildirimler** **Inbox’ta da görünecektir.**
{% endhint %}

{% hint style="info" %}
**CSV kuralları**

* Kullanın **satır başına bir push**.
* ...’ı koruyun `;` dışında **Metin** değerine bağlıdır.
* Dosya adlarını benzersiz tutun (zaman damgası ekleyin).
  {% endhint %}

{% hint style="info" %}
**Örnek satırlar**

```
12345;Hoş geldiniz! Yeniliklere göz atın.;https://example.com/welcome
67890;Size özel teklifler.;https://example.com/offers
```

{% endhint %}

{% hint style="info" %}
**Push metninde satır sonları**

Kullanın `\n` ile satırları `Metin` alanından.

```
Hoş geldiniz!\nEn yeni özelliklerimizi keşfetmenin keyfini çıkarın.
```

Gösterildiğinde şu şekilde görünür:

```
Hoş geldiniz!  
En yeni özelliklerimizi keşfetmenin keyfini çıkarın.
```

{% endhint %}

{% file src="<https://1655476697-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX6uilbEAw42gqsudlclY%2Fuploads%2FwLUQCIiLSM6AMEsvff2f%2FImporting%20FTP%20Push.csv?alt=media&token=b9daeb41-8248-4c75-aaa5-2dcb480f99d4>" %}
FTP Push içe aktarma
{% endfile %}

### Profil niteliklerini FTP üzerinden içe aktarma

Bunu mevcut kullanıcıların niteliklerini toplu olarak güncellemek için kullanın.

#### 1) Panelde nitelikleri oluşturun

Dosyadaki nitelik adları paneldeki profil nitelikleriyle eşleşmelidir.

Bakınız [Profil Özellikleri](https://app.gitbook.com/s/X6uilbEAw42gqsudlclY/customer-data/profile-attributes).

#### 2) FTP’de `Profil` klasörü oluşturun

DevOps’tan bir `Profil` FTP yolunuz altında bir klasör oluşturmasını isteyin.

#### 3) `.txt` dosyasını hazırlayın

Kullanın `~` ) kullanın.

İlk satır örüntü başlığıdır.

ile başlar `~~~` ve sütunları sırayla listeler.

Gerekli sıra:

* `extID` (zorunlu)
* `e-posta` (isteğe bağlı)
* `deviceToken` (isteğe bağlı)
* `msisdn` (isteğe bağlı)
* güncellenecek bir veya daha fazla profil niteliği

Örnek:

```
~~~extID~email~deviceToken~msisdn~membershipTier
12345~user@example.com~token1234~+905055555555~gold
```

#### 4) `Profil` klasörüne yükleyin

Dosyayı benzersiz bir dosya adıyla yükleyin (tarih-saat ekleyin).

Notlar:

* Dosyadaki nitelik adları paneldeki profil nitelikleriyle eşleşmelidir.
* Yüklemeden önce eksik nitelikleri oluşturun.
* Kullanın `+` (E.164) için `msisdn`. Örnek: `+905XXXXXXXXX`.

{% hint style="info" %}
**İşlemenin nasıl doğrulanacağı**

Dosya başarıyla işlendiğinde klasörden kaybolur; bu da işlemin tamamlandığını gösterir.
{% endhint %}

{% hint style="info" %}
**Ek Öneriler:**

* **Büyük veri yüklemeleri için** (örneğin, 300.000’den fazla profilin niteliklerini güncellerken), veriyi daha küçük dosyalara bölün ve bunları ayrı ayrı yükleyin.
* Şunlardan emin olun: **benzersiz** **dosya adları** her dosya için.
* Dosyaları yüklemenizi öneririz **... sırasında** **mesai saatleri** çünkü gece çalışan işleme görevleri çakışabilir.
  {% endhint %}

{% file src="<https://1655476697-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX6uilbEAw42gqsudlclY%2Fuploads%2F9chNynvPii9jgoVmga6H%2FFTP%20Profile%20Attribute.txt?alt=media&token=e9ea8f4e-632a-4c3c-a965-029b730d5265>" %}
FTP Profil Niteliği İçe Aktarma
{% endfile %}

### Sorun giderme

Bir dosya işlenmezse:

* Ayırıcıyı ve sütun sırasını kontrol edin.
* Dosya kodlamasını kontrol edin (**UTF-8**).
* Profil içe aktarmalarında, nitelik adlarının mevcut olduğunu ve tam olarak eşleştiğini doğrulayın.
* Dosya adlarını benzersiz tutun. Aynı adı iki kez yüklemekten kaçının.

Hâlâ sorun görüyorsanız, dosya adı ve zaman damgasını destek ekibiyle paylaşın.