İYS Entegratör Modu

Şu IYS Entegratör Modu işletmelerin Netmera'yı kullanıcı iletişim izinleri için ana kayıt sistemi olarak ele almasını sağlar. Netmera'nın, IYS portalı üzerinden karşılıklı yetkilendirme sağlandığı takdirde Türkiye’nin resmi İleti Yönetim Sistemi (İYS) ile kullanıcı izin verilerini oluşturmasına, güncellemesine ve senkronize etmesine olanak tanır.

Bu modül, müşteri rızasının web siteleri, uygulamalar veya çağrı merkezleri gibi Netmera tarafından yönetilen kanallar aracılığıyla toplandığı durumlarda özellikle faydalıdır. Bu kurulumla Netmera yalnızca içsel olarak izin verilerini yönetmekle kalmaz, aynı zamanda bunları IYS'ye ileterek merkezi ve uyumlu bir iletişim kontrolü sağlar.

IYS Entegrasyonunun İki Modu

Mod	Açıklama	Temel Davranış
IYS Senkronizasyon Modu	IYS ana kaynaktır ve Netmera düzenli olarak izin verilerini içe aktarır	Netmera şunları yapabilir okumak ve profile attribute IYS'deki mevcut kullanıcı kayıtlarını ancak yeni kullanıcı oluşturamaz.
IYS Entegratör Modu	Netmera izinleri yönetir ve IYS'yi doğrudan günceller	Netmera şunları yapabilir oluşturmak bir kullanıcının IYS profili altında marka girişinizi ve push izni kayıtlarını doğrudan IYS'ye.

💡 Kullanmadan önce IYS Entegratör Modu, kuruluşunuzun IYS portalı üzerinden Netmera'ya Entegratör İzni vermesi ve platform içindeki IYS Bağlayıcı ayarlarında onay kutusunu etkinleştirmesi gerekir.

Başlarken

Adım 1: Entegratör İznini Verin

IYS portalında Netmera'yı IYS Entegratörünüz olarak yetkilendirmeniz gerekir. Bu Netmera'ya şunları yapma yetkisi verir:

• IYS'de kullanıcı oluşturmak

• izin durumlarını güncellemek

• Netmera'yı kaynak olarak kullanarak kullanıcı kayıtlarını senkronize etmek

Ayarın Mutabakat Yönetimi IYS Panelinizde etkin olduğundan emin olun. Bu ayar olmadan Netmera IYS'de kullanıcı izin verilerini oluşturamaz, güncellemez veya senkronize edemez.

Adım 2: 'i Etkinleştirin IYS Entegratör Modu

Netmera Panelinde:

• Git Ayarlar > Bağlayıcılar > IYS

• Onay kutusunu işaretleyin: IYS Entegratör (Netmera kullanıcıları oluşturacak ve yönetecek)

• Değişikliklerinizi kaydedin

Adım 3: IYS Entegrasyonu ile Kişi Yükleme

Kullanıcı verilerini altında CSV veya TXT dosyalarıyla yükleyebilirsiniz Hedefleme > Kişi Yükleme. Aşağıdaki tanımlayıcılardan herhangi birini içeren bir dosya yüklediğinizde, Netmera kullanıcı profiline göre oluşturur veya günceller:

• email

• phonenumber

• external_id

Netmera bu tanımlayıcıyı yeni bir kullanıcı oluşturup oluşturmayacağına veya mevcut bir kullanıcıyı güncelleyeceğine karar vermek için kullanır. Yüklenen dosyalar kaynak olarak kabul edilir — en son yükleme mevcut verilerin üzerine yazar.

Yüklenen dosyalar içermelidir her kullanıcı için IYS'ye özgü alanlar: IYSSource, IYSConsentDateile birlikte görünecektir. IYSStatus

Alan Eşleştirme

Yükleme sırasında, dosyanızdaki sütunları Netmera'daki profil öznitelikleriyle eşleştirmeniz istenecektir. Eğer sütun başlıkları mevcut özniteliklerle eşleşiyorsa (örn., email, external_id, phonenumber), otomatik olarak algılanırlar.

IYS Entegratör Modunda Gerekli Sütunlar

• IYSource: Rıza toplama kanalı. Aşağıdaki değerlerden biri olmalıdır: 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

• IYSStatus: Rıza durumu ya ONAY (kabul) ya da RET (red) olmalıdır.

• IYSConsentDate: Rıza zaman damgası formatında olmalıdır gg.aa.yy ss:dd:ss.

• email / phonenumber: En az birini (email veya telefon numarası) yüklemelisiniz. Her iki bilgiyi de yükleyebilirsiniz, ancak rıza durumu (ONAY / RET) her iki kanal için aynı olmalıdır.

İsteğe Bağlı Sütunlar

• External ID: Kullanıcı için bir external ID. Sağlanmazsa, kullanıcılar e-posta veya telefon numarasına göre eşleştirilir.

1. IYS Senkronizasyon durumunda, gerekli IYS alanlarından herhangi biri eksikse yükleme engellenir. Alanlar kısmen doldurulmuş veya hatalıysa, etkilenen kullanıcılar olarak oluşturulur optout.

2. Telefon numarası değerlerinde ülke kodu zorunludur (ör. +905XXXXXXXXX)

3. Eğer e-posta ve telefon numarasının farklı rıza durumları varsa, aynı dosyada yüklemeyin.

Profil Öznitelikleri Ekleme

Gerekli tanımlayıcıları belirledikten sonra (email, phonenumber, veya external_id) ve IYS'ye özgü alanları (IYSSource, IYSStatus, IYSConsentDate), yükleme dosyanıza ek sütunlar olarak ilave profile attribute’ları ekleyebilirsiniz.

Dosyayı yüklemeden önce kullanmayı planladığınız tüm profil özniteliklerinin önceden yapılandırılmış Netmera Panelinde altında olması gerekir Developers > Profile Attributes. Önceden yapılandırılmamışlarsa, hangi sütunların eşleşmediğini veya görmezden gelindiğini belirten bir hata bildirimini sonuç ekranında alacaksınız.

Durum Seçimi

Yükleme sırasında aşağıdaki durumlardan birini seçin:

Abone / Abone Değil

• Bu durum seçilirse:

  • IYS alanları isteğe bağlıdır

  • Sabit rıza değerlerine sahip kullanıcıları (tümü optin veya tümü optout) yüklerken kullanın

  Not: Bu akışla oluşturulan kullanıcılar IYS'de oluşturulmayacaktır.

IYS Senkronize Et ✅

• Netmera ile IYS arasında izin senkronizasyonunu etkinleştirir. Dosya IYS alanlarını içermelidir.

• Siz seçmelisiniz verilerinizi yüklediğiniz dosya aracılığıyla IYS ile senkronize etmek için bu seçeneği.

Adım 4: İletişim Bilgilerinin Eşleştirilmesi

Kişi dosyanızı yükledikten sonra Profil Öznitelikleri ekranına yönlendirileceksiniz. Bu adım, dosyanızdaki sütunların Netmera'nın profil özniteliklerine doğru şekilde eşlendiğini doğrular.

Bu ekranda:

• Sistem tarafından gerekli alanlar gibi IYSSource, IYSStatusile birlikte görünecektir. IYSConsentDate doğru adlandırılmışsa otomatik olarak eşleştirilecektir.

• Ek alanlar gibi soyadı, veya adres ayrıca profil öznitelikleri olarak listelenecektir.

• İçe aktarılacak sütunların toplam sayısı altta gösterilir.

Bir Alan Kırmızı Görünürse Ne Yapmalı

• Herhangi bir alan görüntülereiçinde görünüyorsa, bu sütun başlığının Netmera'da önceden yapılandırılmış herhangi bir profil özniteliğiyle eşleşmediği anlamına gelir.

• Bunu çözmek için ✏️ simgesine tıklayın Düzenle ve açılır menüden uygun profil özniteliğini seçin.

• Tüm eşleştirmeler doğru olduğunda, devam etmek için ve sonra tıklayın.

Dosyanızdaki herhangi bir custom attribute Netmera’nın panelinde önceden yapılandırılmadıysa (Developers > Profile Attributes) yüklemeden önce oluşturulmalıdır. Aksi halde içe aktarılmayacak ve yükleme özetinde bir hata uyarısı alacaksınız.

Dosyalarınızı Netmera'ya yükledikten sonra, işlem süreleri IYS sistemlerine bağlıdır:

• Yeni kullanıcılar: Kullanıcı ilk kez oluşturuluyorsa, süreç genellikle içinde tamamlanır 30 dakika.

• Mevcut kullanıcılar: Mevcut bir kişiyi güncelliyorsanız, tamamlanması 2–3 saat sürebilir.

Vaka Senaryoları

Vaka 1: Aynı E-posta/SMS İzinleri

Yükleme hem email ve phonenumber sütunlarını aynı IYS değerleri ile içerir. Rıza durumu tutarlı olarak uygulanır.

Hem e-posta hem de SMS aynı rıza değerlerine sahiptir. Durum uygulanır ile her iki raporlarınıza dahil etmek istediğiniz.

Eğer e-posta ve telefon numarasının (SMS) farklı rıza durumları varsa, aynı dosyada yüklemeyin.

email	phoneNumber	IYSSource	IYSStatus	IYSConsentDate
[email protected]	[phone]	HS_WEB	ONAY	01.08.2025 14:23:45
[email protected]	[phone]	HS_MOBIL	RET	28.07.2025 09:15:10

Vaka 2: Sadece E-posta Yüklemesi

Dosya tanımlayıcı olarak e-posta içerir ve eksiksiz IYS alanlarına sahiptir.

• SMS izni sağlanmamışsa varsayılan olarak optout olur.

• Sadece e-posta izinlerini topluyorsanız önerilir.

Sadece e-posta sağlanmıştır. Bilgi daha önce yoksa SMS varsayılan olarak opt-out olur, daha önce varsa olduğu gibi kalır.

email	IYSSource	IYSStatus	IYSConsentDate
[email protected]	HS_WEB	ONAY	05.08.2025 11:05:30
[email protected]	HS_EPOSTA	RET	30.07.2025 16:45:12

Vaka 2.1: Aynı Kullanıcı Altında E-posta ve SMS Mevcut

Sadece e-posta izni güncellenir. Mevcut telefon numarası verileri, dosyada açıkça güncellenmedikçe değişmeden kalır.

Sadece e-posta izni güncellenir; SMS değişmeden kalır dosyada belirtilmedikçe.

email	IYSSource	IYSStatus	IYSConsentDate
[email protected]	HS_WEB	ONAY	08.08.2025 13:10:22

Vaka 3: Sadece SMS Yüklemesi

Yüklemede phonenumber ilk sütundur ve IYS alanlarını içerir.

Telefon numarası değerlerinde ülke kodu zorunludur (ör. +905XXXXXXXXX)

Ülke kodlu SMS; e-posta sağlanmamış. E-posta önce yoksa varsayılan olarak opt-out olur, daha önce varsa olduğu gibi kalır değişmeden kalır dosyada belirtilmedikçe.

phoneNumber	IYSSource	IYSStatus	IYSConsentDate
[phone]	HS_CAGRI_MERKEZI	ONAY	07.08.2025 10:25:00
[phone]	HS_MOBIL	RET	02.08.2025 19:15:40

Vaka 4: External ID ile Yükleme

Yükleme external_id anahtar olarak kullanır ve email, phonenumberve IYS alanlarını içerir.

Olarak kullanır external_id birincil eşleşme anahtarı.

email	phoneNumber	IYSSource	IYSStatus	IYSConsentDate	extId
[email protected]	[phone]	HS_WEB	ONAY	03.08.2025 09:00:00	2001
[email protected]	[phone]	HS_MOBIL	RET	04.08.2025 17:35:55	2002

Vaka 5: Profil Öznitelikleri ile Yükleme

Netmera panelinde önceden tanımlanmış herhangi bir profil özniteliği, iletişim ve IYS rıza alanlarıyla birlikte dosyaya eklenebilir.

email	phoneNumber	IYSSource	IYSStatus	IYSConsentDate	extId	isim	şehir
[email protected]	[phone]	HS_WEB	ONAY	03.08.2025 09:00:00	2001	Emir	İstanbul
[email protected]	[phone]	HS_MOBIL	RET	04.08.2025 17:35:55	2002	Aslı	Kocaeli

1. Case5_Profile_Attributes.csv — Bu dosya yalnızca iletişim bilgileri ve profil öznitelikleri ile birlikte IYS rıza alanlarını içerir.

2. Case5_External_ID_and_Profile_Attributes.csv — Bu dosya, kullanıcıları external ID'lere göre açıkça eşleştirmek veya oluşturmak için extId sütununu içerir.

Vaka 6: Geçersiz Format

Herhangi bir IYS alanı eksik veya yanlış formatlanmışsa:

• Netmera kullanıcıyı olarak oluşturur optout

• Eğer mevcut IYS kayıtlarıyla eşleşirse, rıza durumu daha sonra güncellenir

Eksik veya yanlış formatlanmış IYS alanları → Kullanıcı başlangıçta opt-out olarak oluşturulur. (Aşağıdaki tabloda Mobil ve Onaylandı girişleri hatalıdır.)

email	phoneNumber	IYSSource	IYSStatus	IYSConsentDate	exId
[email protected]	[phone]	Mobil	ONAY	07.08.2025 17:35:55	1008
[email protected]	[phone]	HS_WEB	ONAYLANDI	12.10.2025 14:00:00	1009

En İyi Uygulamalar

• Tarih alanları ve telefon numarası (SMS) için tutarlı ve doğru bir format kullanın.

• Karışık-rıza kullanıcılarını yüklüyorsanız, bunları ayrı dosyalara ayırın.

• Kullanırken IYS Entegratör Modu, IYS ile entegrasyon izninizin aktif olduğundan ve gerekli alanların mevcut olduğundan emin olun.