IYS
Effective Strategies for Synchronizing, Updating, and Reporting User Permissions via Netmera and IYS
Last updated
Effective Strategies for Synchronizing, Updating, and Reporting User Permissions via Netmera and IYS
Last updated
Welcome to the documentation for the IYS Integration with Netmera. This guide provides you with all the information you need to seamlessly integrate and manage the İleti Yönetim Sistemi (IYS) within the Netmera platform.
IYS is a critical system introduced in Turkey to help businesses manage consumer preferences regarding commercial electronic messages (e.g., emails, SMS). It ensures compliance with data protection regulations and provides consumers the ability to opt-in or opt-out of receiving commercial communications.
Once you’ve completed your IYS setup, you’ll be able to manage the following scenarios within Netmera:
Initial IYS User Load: All users will be synchronized with IYS using the initial load feature. This process begins on the night the setup is completed and continues in batches until all users are fully synchronized.
REST API Synchronization: User data sent via REST API will be updated in IYS in real-time, keeping everything aligned across systems.
Email Uploads: You can upload your user lists directly into Netmera, which will then synchronize the data with IYS.
SDK Synchronization: User data coming through the SDK will be automatically synchronized with IYS in real-time.
Permission Updates: Any permission changes made within Netmera will automatically synchronize with IYS in real-time, ensuring your user preferences are always up to date.
Nightly Synchronization: Any permission changes made on IYS will be reviewed and synchronized with the system nightly, ensuring consistent and accurate data.
This integration ensures seamless synchronization between Netmera and IYS, helping you efficiently manage user communication preferences while ensuring full legal compliance.
To integrate IYS with your Netmera account, follow the steps outlined below:
Access the Connectors Page: Navigate to the Panel > Connectors.
Choose Data Security / İleti Yönetim Sistemi: From the available connectors, choose "Data Security" > "İleti Yönetim Sistemi" and click the "Install" button to initiate the integration process.
Configure IYS: In the provided spaces, input your "Brand Code" and "IYS Code".
Access the IYS Panel: Log in to your IYS Panel and verify that the integration setup is successfully completed.
Review and Confirm Configuration: Ensure that all configurations are correct by cross-checking with the provided IYS Panel settings.
For a detailed guide on each configuration step, please refer to the User Guide for IYS Panel documentation. These resources provide step-by-step instructions for configuring both the Netmera and IYS panels correctly.
To match the data received from IYS with your users in Netmera, you must first ensure that email and SMS data for the users has been processed. There are three ways to import this data into Netmera:
You can import the email and SMS data of your users through the Update User Methods for iOS or Android, either via your mobile application or website. For detailed information on how to set this up, please refer to our guide here User.
To upload or update a list of emails in Netmera, use the addEmail method. Here’s an example of how to do it:
addEmail Method Reminders:
If the email already exists (for example, linked to an ExtID or previously added), a new user will not be created.
New users are only created if the email doesn’t already exist in the system. However, these users won’t have an installation ID, and the ID will not be visible when searching by email or user ID in the People section.
Users created with the addEmail service can be viewed in the dashboard, but if the same email is later added via the SDK, the initial user will be replaced by the SDK data. The SDK data is considered the "master" data for targeting.
Note: You can use this service to upload email lists without any maximum upload limit within the KB limit.
To add users with specified MSISDNs (phone numbers) to the Netmera platform, use the addMsisdn method. Make sure to include the country code when adding phone numbers.
Mandatory to include the country codes:
When using this service, it is mandatory to include the country code in the phone numbers, i.e., the phone numbers should be in the format of "+90xxxxxxxx".
Another option is to upload your email lists directly via the Netmera Panel. You can manually upload a file containing your user emails and synchronize them with the system.
Synchronization Details:
After performing these imports, the users will be queried from IYS nightly, and their updated status will be reflected in the Netmera panel. This synchronization will occur on a nightly basis to ensure that the data is always up-to-date.
The following methods allow you to update user permissions and ensure that changes are reflected in the IYS system. These actions are critical for managing opt-ins and opt-outs for SMS and Email communications.
You can update the user’s SMS or email permission status on IYS using the enableMail, disableMail, enableSms, and disableSms services via REST API.
To enable email subscriptions for a user, use the enableMail service:
If a user changes their preference in the Netmera Panel (under Targeting > User Detail), the Opt-out/Opt-in button updates the user's permission status, and these changes are automatically reflected in IYS.
Users can also change their preferences within the mobile application, and the updated status will be sent to IYS through the SDK.
iOS SDK
To check if a user has allowed email subscriptions and to update their preferences, use the following methods:
Check Subscription Status:
Set Subscription Preference:
Android SDK
After Netmera SDK version 3.9.18, you can easily manage email permissions for your users by using the following methods:
Set Email Permission
To set the email permission, use the following method depending on whether email subscriptions are allowed or revoked.
Grant Email Permission: If you want to allow email subscriptions, use the following code:
Revoke Email Permission: If you want to revoke email subscriptions, use the following code:
When a user unsubscribes from email communications, the system automatically updates the user's subscription status in IYS.
Email Unsubscribe Button:
The Unsubscribe button, typically found at the bottom of the email, enables users to directly unsubscribe from email communications. This action is immediately reflected in the IYS system. Below you might see an example of an 'Unsubscribe' button from Netmera emails.
Changes made to permissions in Netmera are immediately transmitted to IYS and processed in real-time. All the changes in the examples above will be reflected to your users instantly. However, if a user makes any permission changes directly in the IYS panel, this information will be updated in Netmera on a nightly basis.
You can also import email and SMS data using the and methods via REST API. Here’s how:
