# İçe aktarmalar

Borkol elinizde olanla başladığında daha hızlı öğrenir. Tek bir içe aktarma akışı bir e-tabloyu (CSV, TSV veya Excel `.xlsx`) alır ve satırlarını senaryolara, reklam sonuçlarına, kreatiflere, örnek reklamlara veya müşteri alıntılarına dönüştürür. Akışı verinin ait olduğu ekrandan başlatırsınız; ayrı bir içe aktarma sayfası yoktur.

## İçe aktar düğmesi nerede

| Ekran | Düğme | Neleri içe aktarabilirsiniz |
| --- | --- | --- |
| **Pazarlama** → **Senaryolar** | **Daha fazla** (**İçe aktar** altında) | **Senaryo geçmişi**, **Reklam sonuçları**, **Kreatifler** |
| **Pazarlama** → **Marka** → **Sesiniz** → **Müşterinin sesi** | **İçe aktar** | **Müşteri alıntıları** |
| **Pazarlama** → **Marka** → **Daha fazla** → **Swipe dosyası** | **İçe aktar** | **Örnek reklamlar** |

Sonucu olmayan bir senaryo, "Sonuçlar bir içe aktarma sonrasında burada görünür." satırından reklam sonuçları içe aktarmasına bağlantı verir; Bilgi altındaki boş **Öğrenimler** sekmesinde **Reklam sonuçlarını içe aktar** bulunur.

Her içe aktarma, ekranın üstünde seçili olan markaya gider.

## Dosya

- CSV, TSV veya `.xlsx`, en fazla 5 MB ve 5.000 satır. İlk satır sütun adlarını içerir.
- Ayırıcı olarak virgül, noktalı virgül ve sekme çalışır; bu yüzden Hollandaca veya Türkçe bir e-tablo uygulamasında kaydedilmiş CSV olduğu gibi içe aktarılır. Tarihler `2026-10-20`, `20/10/2026`, `20.10.2026` biçiminde veya e-tablo tarih hücresi olarak yazılabilir; `13/10/2026` gibi açık bir değer tüm sütunun günle başladığını belirler.
- Excel dosyasında ilk sayfa okunur.
- Müşteri alıntıları için düz bir `.txt` dosyası da çalışır: satır başına bir alıntı, sütun adı yok.

Sütun adlarının altında satır olmayan bir dosya "Dosyada sütun adlarının altında satır yok." iletisiyle reddedilir. 5.000'den fazla satırı olan bir dosya "Dosyada 5.000'den fazla satır var. Dosyayı bölün ve parçaları içe aktarın." iletisiyle reddedilir. Her iki durumda da hiçbir şey eklenmez.

## Sütunlar nasıl tanınır

Borkol sütun adlarını okur ve büyük harf, aksan ve parantez içindeki metne bakmadan, İngilizce, Hollandaca ve Türkçe olarak kendi alanlarıyla eşleştirir. `Amount spent (USD)` **Harcama**, `Datum` **Tarih**, `Yorum` **Alıntı** olur. Panel ardından "9 sütundan 9 tanesi tanındı" gösterir ve doğrudan önizlemeye geçer.

Borkol'un tanıdığı sütun adları şunlardır (bir seçki; büyük/küçük harf fark etmez):

| Ne | Alan | Sütun adları |
| --- | --- | --- |
| **Reklam sonuçları** | **Reklam adı** (zorunlu) | Ad name, Ad, Ad code, Creative name, Advertentienaam, Reklam adı |
| | **Tarih** | Day, Date, Reporting starts, Datum, Dag, Tarih |
| | **Harcama** (zorunlu) | Amount spent, Spend, Cost, Uitgegeven bedrag, Harcanan tutar |
| | **Video süresi** | Video length, Length, Duration, Video duration, Video süresi, Süre |
| | **Gösterimler** | Impressions, Impr, Vertoningen, Gösterimler |
| | **3 saniyelik oynatmalar** | 3-second video plays, 3s video views, Video plays at 3s |
| | **ThruPlay** | ThruPlays, Video completions, Completed views |
| | **Tıklamalar** | Clicks, Link clicks, Klikken, Tıklamalar |
| | **Satın almalar** | Purchases, Conversions, Orders, Aankopen, Satın almalar |
| | **Gelir** | Purchase conversion value, Revenue, Conversion value, Omzet, Gelir |
| | **Para birimi**, **Kanal** | Currency, Para birimi; Channel, Platform |
| **Senaryo geçmişi** | **Başlık**, **Açı** | Title, Name, Script name; Angle, Concept |
| | **Hook** ile **Hook 5** arası | Hook, Hook 1, Opening line; Hook2 ile Hook5 arası |
| | **Senaryo**, **Eylem çağrısı** | Body, Script, Voiceover; CTA, Call to action |
| | **Reklam metni** ile **Reklam metni 3** arası | Ad copy, Primary text, Caption |
| | **Hook türü**, **Format**, **Farkındalık**, **Müşteri tipi** | Hook type; Format; Awareness; Customer type, Persona, Audience |
| | **Reklam kodu**, **Kimlik**, **Durum**, **Tarih** | Ad code, Code, Ad name; ID, External ID; Status; Date, Created |
| **Kreatifler** | **Reklam kodu** (zorunlu), **Bağlantı** (zorunlu) | Ad code, Ad name; URL, Link, Creative URL, Video URL |
| | **Editör**, **Yayın tarihi**, **Notlar** | Editor, Made by, Creator; Launched, Launch date, Start date; Notes |
| **Örnek reklamlar** | **Başlık**, **Bağlantı**, **Transkript** | Title, Name, Headline; URL, Link, Ad link; Transcript, Copy, Primary text |
| | **Notlar**, **Etiketler**, **Proje** | Notes, Comments; Tags, Labels, Category; Project, Campaign |
| **Müşteri alıntıları** | **Alıntı** (zorunlu), **Tema** | Text, Review, Comment, Quote, Feedback; Theme, Topic, Category |
| | **Müşteri tipi**, **Kaynak** | Customer type, Persona, Segment; Source, Reference, Review ID |

Bir örnek reklamın en az bir başlığı, bağlantısı veya transkripti olmalıdır. Bir senaryo geçmişi satırının en az bir hook'u veya senaryosu olmalıdır.

## Eşleştirme adımı

Bir sütun birden fazla anlama gelebiliyorsa (örneğin hem "comment" hem "theme" içeren `Comment theme`) veya zorunlu bir alanın sütunu yoksa, panel eşleştirme tablosunu sizin için açar: **Dosyanızdaki sütun**, **Örnek** ve **Şu olarak aktar**. Belirsiz sütunlarda **Kontrol edin** görünür. Her biri için bir alan veya **Yok say** seçin. Her zorunlu alanın bir sütunu olana kadar panel "İçe aktarmadan önce Daha fazla altında {fields} için bir sütun seçin." der ve içe aktarma düğmesi kapalı kalır.

Her şey tanındığında tablo **Daha fazla** altında kapalı kalır. Bir sütunu kontrol etmek veya değiştirmek için açın.

Sütunları kendiniz seçtiğinizde Borkol bu seçimi aynı sütun adlarına sahip dosyalar için hatırlar; böylece gelecek haftanın dışa aktarımı kendiliğinden eşleşir. Kayıtlı seçimler işletme başınadır ve **Ayarlar** → **İçe aktarmalar** altında **Kayıtlı sütun eşleştirmeleri** içinde listelenir; **Eşleştirmeyi unut** birini kaldırır.

## Önizleme ve içe aktarma

Önizleme kaç satırın hazır olduğunu ("2 satır hazır") ve kaçının atlanacağını, ilk satırları içe aktarılacakları hâliyle gösterir. Eksik veri bir ipucudur, asla engel değildir: örneğin "Gösterim veya 3 saniyelik oynatma sütunu yok: hook oranları boş kalır." veya "Tarihi olmayan satırlar bugüne kaydedilir."

**2 satırı içe aktar**'a tıklayın. **İçe aktarma tamamlandı** kaç satırın **Eklendi**, **Güncellendi** ve **Atlandı** olduğunu gösterir; **Tüm içe aktarmaları görün** geçmişi açar.

### Atlanan satırlar

Sorunlu bir satır atlanır ve diğer satırlar yine de eklenir. Önizlemenin altındaki **2 atlanan satır** her birini satır numarası, alan ve nedeniyle listeler, örneğin "Satır 14, Harcama: sayı değil". Sık görülen nedenler: **boş** (zorunlu bir hücre), **sayı değil**, **tarih değil**, **sıfırın altında**, **web bağlantısı değil**, **çok uzun**.

## Yeniden içe aktarma

İçe aktarmaları güvenle tekrarlayabilirsiniz. Her hafta o haftanın sonuç tablosunu yükleyin: Borkol'da zaten olan satırlar iki kez eklenmez, güncellenir.

| Ne | Bir satır aynı sayılır |
| --- | --- |
| **Reklam sonuçları** | Aynı reklam kodu ve aynı gün |
| **Senaryo geçmişi** | Aynı **Kimlik**, yoksa aynı **Reklam kodu** |
| **Kreatifler** | Aynı senaryo ve aynı bağlantı |
| **Örnek reklamlar** | Aynı bağlantı |
| **Müşteri alıntıları** | Aynı alıntı metni |

İçe aktarılan bir senaryo, Borkol'un yazdığı bir senaryoyu asla değiştirmez: reklam kodu Borkol'da yapılan bir senaryoya ait olan satır "Borkol'da yapılan bir senaryonun kodu, değiştirilmedi" ile atlanır. Birinin onayladığı, reddettiği veya altın sete koyduğu bir senaryo da olduğu gibi kalır: satırı "incelenmiş veya altın senaryo, değiştirilmedi" ile atlanır.

[Meta reklamları bağlantısının](/tr/docs/marketing/settings#meta-reklamlar) zaten eşitlediği bir reklam ve güne ait reklam sonuçları satırı "Meta reklamlarından zaten senkronize edildi" ile atlanır: eşitlenen rakamlar doğrudan Meta'dan gelir, böylece hiçbir şey iki kez sayılmaz.

Bağlantısı [Meta Ad Library](/tr/docs/marketing/brand-context#rakipleri-izleyin)'den gelen bir reklama ait olan swipe reklamı satırı "Meta Ad Library'den gelen bir reklama ait" ile atlanır: bu reklamlar her senkronizasyonda güncellenir ve bir içe aktarma onları asla değiştirmez.

## Her içe aktarma ne yapar

- **Reklam sonuçları** reklam adındaki reklam kodu üzerinden ait oldukları senaryoya bağlanır, ardından senaryoda **Sonuçlar** altında görünür ve [öğrenimleri](/tr/docs/marketing/learning) besler. Reklam adında bilinen bir kod olmayan sonuç saklanır ve senaryo oluştuğunda (örneğin senaryo geçmişinizi içe aktardıktan sonra) bağlanır.
- **Senaryo geçmişi** geçmiş senaryoları kaynağı **İçe aktarıldı** olarak ekler. Reklam kodu olmayan bir satır yeni bir Borkol kodu alır. **Durum** sütunu `live`, `winner` veya `aktif` gibi sözcükleri **Onaylandı**, `paused`, `durduruldu` veya `loser` gibi sözcükleri **Reddedildi** ile eşler; diğer her şey **Onaylandı** olarak içe aktarılır.
- **Kreatifler** bitmiş reklamlarınızı (reklam kodu başına bir video bağlantısı) senaryolarına bağlar; senaryoda **Kreatifler** altında görünürler. Reklam kodu hiçbir senaryoya uymayan satır "bu koda ait senaryo yok" ile atlanır.
- **Örnek reklamlar** ve **Müşteri alıntıları** [Swipe dosyası ve Müşterinin sesi](/tr/docs/marketing/brand-context) bölümlerine eklenir. Markada olmayan bir proje veya müşteri tipi bir ipucuyla boş bırakılır.

İçe aktardığınız her şey veri olarak ele alınır. Bir brifte alıntı olarak yer alır, asla talimat olarak izlenmez.

## Ayarlar → İçe aktarmalar

**Pazarlama** → **Ayarlar** → **İçe aktarmalar** (`/m/marketing/settings/imports`), seçili markaya içe aktarılan her dosyayı listeler: **Dosya**, **Tür**, **Satır**, **Eklendi**, **Güncellendi**, **Atlandı**, **Durum** (**İçe aktarıldı**, **İçe aktarılmadı** veya **Başarısız**), **Yapan** ve **Tarih**. **Tür** ve **Durum** üzerinden filtreleyin. Altında **Kayıtlı sütun eşleştirmeleri** bulunur.

İçe aktarmak pazarlama düzenleme erişimi gerektirir. Yüklenen dosyalar içe aktarmayla birlikte gizli olarak saklanır ve asla herkese açık değildir.