Üye Listesi Yükleme
Data Warehouse Tabloları, RMC arayüzü aracılığıyla sıkıştırılmış .ZIP bir .CSV dosyası yükleyerek veya RMC tarafından sizlere verilen SFTP'ye dosya bırakılarak yaratılabilir. İhtiyaçlarınıza göre dilediğiniz sayıda Data Warehouse Tablo’su yaratabilirsiniz. Data Warehouse Tablolarında herhangi bir alan limiti bulunmamaktadır.
Yaratılan her Data Warehouse tablosunda yer alan üyeler, CUQA üye künyesi tablosunda bulunmuyorsa, bu kullanıcılar yeni üye olarak eklenir. CUQA Tablosu, üye veritabanınızın bulunduğu temel tablodur.
Panel |
---|
|
Data Warehouse tablosunda Status |
---|
| |
---|
subtle | true |
---|
colour | Red |
---|
title | EMAIL |
---|
| , Status |
---|
| |
---|
subtle | true |
---|
colour | Red |
---|
title | Ad |
---|
| , Status |
---|
| |
---|
subtle | true |
---|
colour | Red |
---|
title | Soyad |
---|
| alanlarının olduğunu varsayalım. Bu durumda Data Warehouse tablosuna eklediğiniz her kayıt, üye mevcut değil ise CUQA tablosuna yeni kayıt olarak eklenir. Status |
---|
| |
---|
subtle | true |
---|
colour | Red |
---|
title | Ad |
---|
| ve Status |
---|
| |
---|
subtle | true |
---|
colour | Red |
---|
title | Soyad |
---|
|
bilgileri CUQA tablosuna eklenmeyecektir. Sadece üyeye ait Status |
---|
| |
---|
subtle | true |
---|
colour | Red |
---|
title | EMAIL |
---|
| alanı eklenir. |
Note |
---|
Veri aktarımı için kullanacağınız SFTP RMC tarafından sağlanmaktadır. |
Adımlar
RMC Data Warehouse platformuna veri aktarmak için; .ZIP dosyasının içinde aşağıda tanımlanan dosyalar yer almalıdır:
- .TXT // .CSV: veriyi içeren text dosyası ZORUNLU
- .XML: kampanya tanımlamalarının yer aldığı .XML dosyası OPSIYONEL
Geliştiriciler, veri yüklemek ve bu veriler üzerinden kampanya başlatmak için aşağıdaki adımlardan sorumludurlar:
- Veri tabanından veri seçmek ve bu verileri kullanarak text dosyası hazırlamak. Dosya uzantıları .TXT ya da .CSV formatında olmalıdır.
- Mevcut ise, kampanya tanımlamalarının yer aldığı .XML dosyası hazırlamak.
- İlk iki adımda hazırlanan dosyaları tek bir .ZIP dosyasında tutup isimlendirmek.
- .ZIP dosyasını RMC Datawarehouse SFTP alanına sftp://file.euromsg.com, RMC Teknik Destek ekibi tarafından iletilen Kullanıcı Adı ve Şifre kullanılarak göndermek.
Note |
---|
Eğer .ZIP dosyasının içinde tek bir metin dosyası varsa, Data Warehouse sistemi yalnızca verileri yükleyecek ve müşteri verileri ile ilgili bir tablo hazırlayacaktır. Eğer .ZIP dosyasının içinde bir XML dosyası varsa, sistem, kayıtları yüklediğinde, XML dosyasında yer alan kampanyaları başlatacaktır. |
Aşağıda ki tabloda yer alan alanlar, CUQA tablosunda güncellenecek alanları gösterir:
Alan Adı | Açıklama |
---|
KEY_ID | Referans Anahtarı |
EMAIL | E-posta adresi |
GSM_NO | Üye cep telefonu numarası |
EMAIL_PERMIT | Üyenin e-posta gönderim izni |
GSM_PERMIT | Üyenin SMS gönderim izni |
Kalıcı olarak işaretlenmiş bir Data Warehouse tablosuna yeni üye eklemek veya üye bilgilerini güncellemek için, SFTP ile toplu bir şekilde güncelleyebilir, /wiki/spaces/RMCKBT/pages/428802196 ile tek tek güncelleyebilir veya yeni üye ekleyebilirsiniz. Toplu güncelleme veya yeni üye eklemelerde her zaman SFTP kullanmanız tavsiye edilir. /wiki/spaces/RMCKBT/pages/428802196 üzerinden sadece tek tek istek yapılarak, her defasında bir üye eklenebilir veya güncellenebilir.
Veri Tipleri
- Alan adlarınızda veri tipi belirlemediğiniz takdirde tüm alanlar
Status |
---|
| |
---|
subtle | true |
---|
colour | Red |
---|
title | varchar(100) |
---|
|
olarak yaratılacaktır.
- Alan adlarına alan tipi belirtebilirsiniz. Örneğin Fiyat alanı için
Status |
---|
| |
---|
subtle | true |
---|
colour | Red |
---|
title | float |
---|
|
belirtebilirsiniz.
- Maksimum alan uzunluğu 1024 olmalıdır.
Status |
---|
| |
---|
subtle | true |
---|
colour | Red |
---|
title | money |
---|
|
, Status |
---|
| |
---|
subtle | true |
---|
colour | Red |
---|
title | float |
---|
|
, Status |
---|
| |
---|
subtle | true |
---|
colour | Red |
---|
title | datetime |
---|
|
, Status |
---|
| |
---|
subtle | true |
---|
colour | Red |
---|
title | string(length) |
---|
|
ve Status |
---|
| |
---|
subtle | true |
---|
colour | Red |
---|
title | integer |
---|
|
veri tiplerini kullanabilirsiniz.
Status |
---|
| |
---|
subtle | true |
---|
colour | Red |
---|
title | string |
---|
|
veri tipi için maksimum uzunluk 1024 olmalıdır.
- MAIN DW tablosunu kullanırsanız, artımlı (incremental) yüklemelerde sütun başlıklarına veri tipleri eklemeniz gerekmez. Yalnızca, ilk MAIN tablodaki yüklemede veri tipini belirtmeniz gerekir.
Code Block |
---|
language | xml |
---|
title | Örnek Header (Veri Tipi ile birlikte) |
---|
|
EMAIL|NAME[string(50)]|BIRTH_DATE[datetime]|LOYALTY_POINT[float]|AGE[int]|INCOME_LEVEL[money] |
Code Block |
---|
language | xml |
---|
title | Örnek TXT Veri Dosyası |
---|
linenumbers | true |
---|
|
EMAIL|NAME|SURNAME|BIRTH_DATE[datetime]|SEGMENT[combo.string(5)]|LOYALTY_POINT[float]
it@euromsg.com|IT|EuroMessage|2003-01-01|A|09
jason@hotmail.com|Jason|Goodwill|1977-03-17|B|77
hans@yahoo.com|Hans|Muller|1983-03-26|A|63 |
Bu örnek dosya, RMC Data Warehouse hesabınızda 6 kolonlu bir tablo oluşturacaktır. Diğer adımlar:
- Sistem, verileriniz için aynı kolonları ve verileri içeren bir Data Warehouse tablosu oluşturacaktır. Tablo adının, SFTP dizinine yüklediğiniz ZIP'teki metin dosyasının adıyla aynı olacağını lütfen unutmayın.
Warning |
---|
LOYALTY_POINT kolonu 2 karakterden oluşan tamsayı kolonudur ve verilerin buna göre hazırlanır. İlk satırın kolon adlarını içermesi gerektiğini lütfen unutmayınız. |
Artımlı Veri Yükleme (Incremental Data Upload)
Varolan tablolarda artımlı veri yüklemesi ile yeni üyeler ekleyebilir veya kullanıcı bilgilerini güncelleyebilirsiniz.
Note |
---|
Artımlı veri yükleme için REST ve SOAP metodlarını kullanabilirsiniz. |
SFTP ile yeni bir kalıcı Veri Ambarı tablosu yaratmak için, .CSV veya .TXT dosyası .ZIP ile sıkıştırılarak, SFTP’ye bırakılır. Bırakılan dosya anında işlenir ve RMC hesabınız üzerinde Veri Ambarı Tablosu yaratılır. Aynı tabloya farklı veriler eklemek veya varolan verileri güncellemek için aynı işlem tekrarlanır ve ziplediğiniz dosya adının sonuna
Status |
---|
| |
---|
subtle | true |
---|
colour | Red |
---|
title | _inc.zip |
---|
|
eklenir. Bu şekilde sistem aynı tabloda yer alacak
INCREMENTAL verilerinin olduğunu algılar.
Panel |
---|
|
- RMC, taban ve artımlı dosyaları ZIP dosya adı notasyonuyla belirler.
- Taban tablosu adı
Status |
---|
| |
---|
subtle | true |
---|
colour | Red |
---|
title | all_member_data.zip |
---|
| ise artan dosya adı Status |
---|
| |
---|
subtle | true |
---|
colour | Red |
---|
title | all_member_data_20141225_inc.zip |
---|
| olmalıdır. Böylelikle sistem Status |
---|
| |
---|
subtle | true |
---|
colour | Red |
---|
title | _inc |
---|
| tanımlamasını görüp incremental yükleme olduğunu anlar ve ana dosya adı olarak Status |
---|
| |
---|
subtle | true |
---|
colour | Red |
---|
title | all_member_data_20141225_inc.zip |
---|
| yı alır.
- Versiyon numarası olarak
Status |
---|
| |
---|
subtle | true |
---|
colour | Red |
---|
title | 20141225 |
---|
| verilir. Versiyon numarası olarak her hangi bir unique değer kullanabilirsiniz. Status |
---|
| |
---|
subtle | true |
---|
colour | Red |
---|
title | YYYYMMDD |
---|
| tarih formatı en çok kullanılan versiyon değerlerindendir.
- Veriler her zaman taban tabloda toplanmaktadır, bu nedenle e-posta kampanyasını gönderirken yalnızca hedef kitle dosyası olarak temel dosyayı kullanmalısınız.
|
Code Block |
---|
language | text |
---|
title | Örnek Taban Dosyası |
---|
|
EMAIL|NAME|SURNAME
email1@test.com|name1|surname1
email2@test.com|name2|surname2
email3@test.com|name3|surname3 |
Code Block |
---|
language | text |
---|
title | Örnek Artımlı Veri Dosyası |
---|
|
EMAIL|NAME|SURNAME
email1@test.com|updated_name1|surname1 (Bu satır ilk üyenin adını güncellemektedir)
email4@test.com|name4|surname4 (Bu satır taban tablosuna yeni bir üye eklemektedir)
email5@test.com|name5|surname5 (Bu satır taban tablosuna yeni bir üye eklemektedir) |
Uyarılar
- Dosya her zaman .ZIP olarak SFTP’ye yerleştirilmelidir. ZIP içindeki üye verileri .CSV veya .TXT dosyası olarak yer almalıdır.
- Dosyanın ilk satırında her zaman alan adları yer almalıdır. Alan adlarında sadece ASCII karakterler kullanılabilir. (A-Z, a-z, _.) Örneğin; BIRTH_DATE, BIRTHDATE, BirthDate, Birth_Date, birth_date.
- Alan adları en az 2 karakterden oluşmalıdır.
- Alan adlarında Türkçe karakter kullanılmamalıdır.
- Yükleyeceğiniz dosyalara her zaman tarih bilgisi ekleyin. Aynı isimli tablolar oluşturabilirsiniz, fakat tavsiye edilmemektedir.
- Bazı alanlar belirli kelimeler için ayrılmıştır:
Lütfen e-posta adreslerini içeren sütun için
Status |
---|
| |
---|
subtle | true |
---|
colour | Red |
---|
title | EMAIL |
---|
|
alan adını kullanın
GSM numaralarını içeren alan için lütfen
Status |
---|
| |
---|
subtle | true |
---|
colour | Red |
---|
title | GSM_NO |
---|
|
alan adını kullanın.
GSM_NO alan değerleri aşağıdaki biçimde olmalıdır:530.4444444, 905304444444 or 05304444444.
Uluslararası numaralarınız olacaksa hesabınızda gerekli yükleme düzenlemesi yapılmasını istedikten sonra 90.5304444444 veya 49.1111222233 şeklinde atabilirsiniz.Lütfen, Key ID değerlerin bulunduğu
Status |
---|
subtle | true |
---|
colour | Red |
---|
title | memberID |
---|
|
ve Status |
---|
subtle | true |
---|
colour | Red |
---|
title | customerID |
---|
|
gibi alanlar için Status |
---|
| |
---|
subtle | true |
---|
colour | Red |
---|
title | KEY_ID |
---|
|
kullanın. Sistem, Status |
---|
subtle | true |
---|
colour | Red |
---|
title | KEY_ID |
---|
|
alanındaki değeri unique anahtar olarak algılar ve yüklemeleri bu anahtara göre yapar. Eğer bu alan dosya içinde yer almıyorsa, sistem Status |
---|
| |
---|
subtle | true |
---|
colour | Red |
---|
title | EMAIL |
---|
|
alanını unique anahtar olarak seçer ve veri yüklemelerini bu anahtara göre yapar. Veri yüklemelerinizde, unique anahtar olarak Status |
---|
| |
---|
subtle | true |
---|
colour | Red |
---|
title | EMAIL |
---|
|
veya Status |
---|
subtle | true |
---|
colour | Red |
---|
title | KEY_ID |
---|
|
seçilmeli ve bir sonraki veri yüklemelerinizde de referans anahtarı değiştirilmelidir. Dosya yüklemelerinizi gerçekleştirmek için Status |
---|
| |
---|
subtle | true |
---|
colour | Red |
---|
title | EMAIL |
---|
|
veya Status |
---|
subtle | true |
---|
colour | Red |
---|
title | KEY_ID |
---|
|
değerlerini unique anahtar olarak belirlemelisiniz.
Üyeleriniz için izin bilgileri içeren sütunlarınız için lütfen
Status |
---|
subtle | true |
---|
colour | Red |
---|
title | EMAIL_PERMIT |
---|
|
ve Status |
---|
subtle | true |
---|
colour | Red |
---|
title | GSM_PERMIT |
---|
|
kullanın.
Lütfen CRM / ERP aktivite ID'leri için
Status |
---|
subtle | true |
---|
colour | Red |
---|
title | EMAIL_PERMIT |
---|
|
kullanın.
- Dosyada
Status |
---|
| |
---|
subtle | true |
---|
colour | Red |
---|
title | KEY_ID |
---|
|
alanı yer alıyorsa, bu alan referans olarak kullanılır.
- Ayırıcı karakter olarak
Status |
---|
| |
---|
subtle | true |
---|
colour | Red |
---|
title | | |
---|
|
(boru) veya Status |
---|
| |
---|
subtle | true |
---|
colour | Red |
---|
title | ; |
---|
|
(noktalı virgül) kullanabilirsiniz ancak yüklediğiniz verilerin içinde bu karakterlerin yer almadığına emin olun.
- Doğum Tarihi ve benzeri tarih formatlı alanlar,
Status |
---|
subtle | true |
---|
colour | Red |
---|
title | yyyy-aa-gg |
---|
|
(Örn: 1977-03-17, 17 Mart 1977) formatında gönderilmesi gerekir.
- .ZIP dosyası içinde yer alan text dosyası oldukça önemlidir. Bu dosya adları, RMC hesabınızda yaratılan tabloları ayrıştırmaya yarar. Text dosyasında kullandığınız ad ile sistemde yaratılan tablo adı aynı olacaktır.
- RMC platformunda dosya kodlaması ISO-8859-9 olmalıdır. Eğer kodlama olarak UTF-8 kullanıyorsanız, destek ekibimiz hesabınızı bu şekilde yapılandırabilmektedir. Ardından, UTF-8 kodlamasını BOM (byte order mark) ile kullanabilirsiniz.
- RMC Data Warehouse platformundaki bu tablolarda filtreleme ve karşılaştırma, String Search ile yapılır. Bu nedenle, tamsayı (Integer) alanlarınız buna göre bu tablolara aktarılmalıdır.
Veritabanınızda alışveriş noktaları tutmak için bir tamsayı (Integer) alanınız varsa ve bu rakamlar 1 ila 999 arasında gidiyorsa, bu numaraları 001, 002, 003, ..., 999 gibi veri dosyanıza ayıklayarak aktarmanız gerekir. Çünkü sadece bu yöntemi kullanarak, RMC platformunda alışveriş noktaları '050' ile '099' arasında olan hedef grubunuzu seçebilirsiniz. Sayısal sütun türlerini kullanırsanız, padleft işlevine ihtiyaç duymazsınız. Nümerik alanlar için böyle bir işlem yapmanıza gerek yoktur.
- Yükleyeceğiniz dosya adları,
Status |
---|
| |
---|
subtle | true |
---|
colour | Red |
---|
title | File_123456.txt |
---|
|
ve Status |
---|
| |
---|
subtle | true |
---|
colour | Red |
---|
title | File_123456.xml |
---|
|
olmalı ve bu iki dosyayı .ZIP ile sıkıştırıp, Status |
---|
| |
---|
subtle | true |
---|
colour | Red |
---|
title | File_123456.zip |
---|
|
olarak yüklemelisiniz.
Validasyon ve Hata Bilgilendirme
Hazırlamış olduğunuz dosyayı RMC tarafından sağlanan SFTP adresine yükleyebilirsiniz. Yüklediğiniz dosyaların mevcut durumunu; Audience > Veri Ambarı Tabloları seçerek kontrol edebilirsiniz.
Data Warehouse tablo yüklemelerinizin durumunu kontrol etmek için RMC Report Web Service içerisinde REPORT.ASMX‘de bulunan QUERYDATAWAREHOUSEUPLOADPROGRESS fonksiyonunu kullanabilirsiniz.
SFTP’ye atacağınız dosyanın herhangi bir hata durumunda veya başarılı bir yükleme olduğunda bir email adresine bilgilendirme emaili gönderilmesini istiyorsanız, .ZIP dosyası için aynı dosya adıyla bir .XML dosyası eklemeniz yeterli olacaktır.
Code Block |
---|
|
<euro.message>
<NOTIFICATION_EMAIL>yourvalid@email.com</NOTIFICATION_EMAIL>
</euro.message> |
Ek Bilgiler
Ürün Katalog Dosyanızı ve kampanyalarınızda yer alacak Promosyon Kodlarını, Data Warehouse aracını kullanarak yükleyebilirsiniz. Detaylı bilgiye aşağıdaki sayfalardan ulaşabilirsiniz:
Data Warehouse Tabloları ile Kampanya Gönderimi
Data Warehouse Tablolarını kullanarak sisteme aktarmış olduğunuz üyelere farklı kanallarda kampanyalar gönderebilirsiniz:
Ana Başlık: Üye Veritabanının Aktarılması