Netmera User Guide
Netmera Docs
  • ⚡Netmera User Guide
  • What's New?
  • Beginner's Guide to Netmera
    • Introduction to Netmera
    • Integrating Netmera
    • App Dashboard
    • Design Guide
    • Troubleshooting and Support
    • FAQs
    • Your Feedback
  • Terms to Know
  • Guided Videos
  • Messages
    • About Push Notifications
    • Mobile Push
      • Creating a Mobile Push
        • Define Message Type: Setup
        • Define Message Content: What
          • Advanced iOS Settings
        • Define the Audience: Who
        • Define Campaign Schedule: When
        • Test and Send: GO!
      • Elements of Push Notifications
      • Message Categories
      • Personalized Messages
      • Button Sets
      • Define Segment
      • Add Custom Sounds
      • Add Image or Video to Push Notifications
      • Banner, Carousel, Slider and Product Discovery Additional Notes
    • SMS
      • SMS Onboarding
      • Creating an SMS campaign
      • Message Categories
    • E-Mail
      • Email Onboarding
        • Upload Email List
        • IYS (İleti Yönetim Sistemi)
        • Email Integrations
        • Mail Delivery Onboarding
      • How to Create a Mail Template
      • Sending a Mail Campaign
    • Automated Messages
    • Transactional Messages
    • Geofence Messages
    • Push A/B Testing
    • FTP Push & Data Transfer
    • Multi-Language Push
    • Recall Campaigns
    • Netmera AI Text Generator
  • Mobile In-App
    • Mobile In-App / Widget
      • Start Creating
        • Customize Components
          • Spin to Win
          • Custom Button Deeplinks
        • Assign Click Actions
      • Publish
      • Analyze
  • Web Tools
    • About Web Tools
    • Web Push
      • Creating a Web Push Campaign
      • Mobile Web Push for iOS
      • Message Categories
      • Personalized Messages
      • Button Sets
      • Define Segment
      • Tags / Upload User List
      • Fancy Box Setup
    • Web Transactional Push
      • Web Transactional Push Deeplink
    • Web Pop-Up / Widget
      • Start Creating
        • Customize Components
          • Spin to Win
        • Assign Click Actions
      • Publish
      • Analyze
    • Web Feedback Button
      • Create a New Web Feedback Button
        • How to Customize Widgets
        • Adding Click Action
    • Web Personalization
      • Web Personalization Dashboard
      • Create a New Experience
        • Setup and Rules
        • Creating Experiences
  • Web Analytics
  • Customer Journeys
    • Journeys
      • Setup
      • Entry Rules
      • Audience
      • Build Journey
        • Journey Components
          • State
          • Branch
          • Action
      • Launch
      • Journey Analytics
      • Journey Examples
        • Action-Based Engagement Journey
  • Customer Data
    • About Customer Data
    • Profile Attributes
      • Creating Custom Profile Attributes
    • Events
      • Netmera Events
      • Creating Custom Events
      • Event Insight
    • Tagless Data Capture
    • IYS Integration
  • Targeting
    • About Targeting
    • People
    • Tags
    • Segments
      • AI-Based Segments
      • Ready to Use Segments
      • Rule Based Segments
        • Create New Rule Based Segment
      • Connector Segments
      • Segment Details
    • File Transfers
    • Geofence
  • Reports & Analytics
    • Reports
      • Glossary
      • Campaigns
        • Push Reports
        • Email Reports
        • SMS Reports
      • Automated, Transactional & Geofence Push Reports
      • Total Users
      • Installs
      • Event Reports
        • Daily Event Count
        • Hourly Usage
      • KPI's Monthly
      • App Tracking
      • Application Version
      • Audit Logs
      • Export
      • Channel Reachability
    • Analytics
      • Funnel Analysis
        • Create New Funnel
      • Profile
      • Event Insight
      • People Insight
      • Uninstall
      • Opt Out
      • Revenue and Conversion
      • Customer Touch
      • Retention and Cohort
      • Web Analytics
  • Panel Settings
    • Netmera Panel Settings
      • General Settings
      • Test Devices
      • Users
      • Roles and Permissions
      • Button Sets
      • Message Categories
      • Message Labels
      • Landing Pages
      • WebHooks
      • App Tracker
      • Reports Settings
      • Business Units
      • Coupon Code Lists
  • Developer Guide
    • Netmera Developer Guide
Powered by GitBook
On this page
  • Setting Up FTP for Importing Data
  • Step 1. Enabling the FTP Offer
  • Step 2. Creating an FTP User
  • Step 3. Preparing the CSV File
  • Step 4. Uploading the CSV File
  • Importing FTP Push
  • Importing Profile Attributes with FTP
  • Setting Up FTP for Exporting Data
  • Step 1. Creating an FTP User
  • Step 2. Panel Setup
  • Sample Export Files

Was this helpful?

  1. Messages

FTP Push & Data Transfer

Ditch the Manual Work & Embrace Automation

PreviousPush A/B TestingNextMulti-Language Push

Last updated 4 months ago

Was this helpful?

Netmera FTP integration is a secure and automated solution for managing data transfers between your systems and the Netmera platform. Designed to simplify data import and export processes, this feature enables tasks such as sending personalized push notifications, updating user profile attributes, and exporting campaign or transactional reports with ease.

By leveraging FTP, you can connect your data workflows to Netmera, ensuring timely, accurate, and reliable operations. Whether importing customer data for targeted engagement or exporting detailed insights for analysis, Netmera FTP provides the tools to enhance your application’s performance and customer engagement strategy.

Netmera FTP integration provides a flexible and efficient way to manage data, offering two key functionalities:

This guide is designed to help you with both use cases. You can follow the relevant sections depending on whether you want to set up FTP for importing or exporting data. Each section provides detailed, step-by-step instructions to ensure a smooth and secure setup process tailored to your needs.

Setting Up FTP for Importing Data

Step 1. Enabling the FTP Offer

To begin, contact your assigned Customer Success Manager (CSM). They will assist in enabling the FTP offer on your Netmera account, specifically for your application. The CSM will help with the necessary configurations and ensure that FTP functionality is activated, setting up automated data imports.

Step 2. Creating an FTP User

There are two methods for creating an FTP user:

  • Option 1: Customer-Created FTP User

    • If you choose to create the FTP user on your own server, please provide Netmera with the necessary server information so we can connect and upload files. Ensure your server configuration aligns with this setup.

  • Option 2: Netmera-Created FTP User

    • If you prefer, Netmera can create the FTP user for you. In this case, you will connect to Netmera’s server using the provided details. For secure access, please provide the IP address you will use to connect, as Netmera restricts connections to pre-approved IPs.

Step 3. Preparing the CSV File

Your DevOps team will handle creating the FTP user account specifically for your application. Once set up, they will receive secure login credentials, facilitating encrypted, reliable data transfers between Netmera and your server.

Step 4. Uploading the CSV File

Once your CSV file is prepared, follow these steps to upload it to the designated FTP server:

  1. Establish a Secure FTP Connection: Use the FTP credentials provided by your DevOps team to connect securely to the designated server.

  2. Initiate File Transfer: Upload the CSV file to the specified FTP directory. Ensure it follows the required format for seamless processing.

  3. Automatic Data Processing: After the file is successfully uploaded, Netmera will automatically process the data and send push notifications based on the instructions within the CSV file.

This streamlined process enables the automated delivery of notifications, ensuring timely engagement based on the uploaded data.

Importing FTP Push

  1. In the application panel, the FTP Push offer is provided by the Customer Success Manager (CSM).

  2. An FTP user is created specifically for the application and shared with the customer by the DevOps team.

  3. Prepare a CSV file with the following fields: External ID, Push Text, and Deeplink.

  4. Upload the CSV file to the designated FTP using the provided FTP credentials. Once uploaded, the push notifications will be sent out accordingly.

Warning: FTP Push Notifications with Inbox Inclusion

All push notifications sent via FTP includes the Inbox option by default. If your application does not have an Inbox feature, this will not affect you. However, if your application does have the Inbox feature, notifications sent via FTP will also appear in the Inbox.

CSV File Format: Ensure the CSV file follows this format:

Each entry must include a unique External ID, a personalized Text message, and an appropriate Deeplink as ExternalID;Text;Deeplink

Example Push Entries:

  1. 12345;Welcome to our platform! Enjoy exploring our latest features.;https://example.com/welcome

  2. 67890;Check out exclusive offers available just for you!;https://example.com/offers

  3. 54321;Get started by updating your profile to enhance your experience.;https://example.com/update-profile

  4. 98765;New articles are available in your feed. Click to read more.;https://example.com/articles

  5. 13579;Your account setup is complete! Discover what's next.;https://example.com/next-steps

Using Line Breaks in Push Notifications:

To include line breaks within a push notification, you can use \n, which creates a new line in the text. For instance:

Welcome to our platform!\nEnjoy exploring our latest features.

When displayed, it will appear as:

Welcome to our platform!  
Enjoy exploring our latest features.

This formatting makes your notifications more readable and visually appealing for users.

Importing Profile Attributes with FTP

  1. Create a 'Profile' Folder in FTP (with DevOps Assistance):

Work with DevOps to set up a dedicated “Profile” folder in the FTP directory.

  1. Prepare a .txt File with Required Format:

Use a text (.txt) file formatted as shown below, where the first line defines the pattern:

Pattern Line: Begin with three ~ symbols, followed by the profile attributes to be updated. Each profile attribute should be separated by a single ~.

Order: The first three fields must always be in this order:

  • extID (required)

  • email (optional)

  • device token (optional)

Subsequent lines should include the values for these attributes, formatted according to the data type of each attribute (e.g., wrap strings in " " if necessary).

Example:

extID~email~device token~attribute1~attribute2
12345~~token123~"example data"~25
67890~user@example.com~~"more data"~30
  1. Upload the .txt File to the 'Profile' Folder in FTP:

Place the file in the "Profile" folder. Ensure that each file has a unique filename by adding the current date and time to avoid errors. Verify that all attribute values adhere to the required data types to avoid processing issues.

To confirm that the file has been processed successfully:

When the file is processed successfully, it will disappear from the folder, indicating completion.

Additional Recommendations:

  • For large data uploads (e.g., updating attributes for over 300,000 profiles), split the data into smaller files and upload them individually.

  • Ensure unique filenames for each file.

  • We recommend uploading files during business hours as nighttime processing jobs may interfere.

Setting Up FTP for Exporting Data

Step 1. Creating an FTP User

When setting up an FTP connection for data export, you have two options for creating an FTP user:

  • Option 1: Customer-Created FTP User

    • If you prefer to create the FTP user on your own server, Netmera will need the provided connection information to upload files. Please ensure your server’s configuration supports the connection.

  • Option 2: Netmera-Created FTP User

    • If you request Netmera to create the FTP user, you will connect to Netmera’s server using the details provided. Ensure you supply the IP address from which you will connect to Netmera's server, as connections are restricted to predefined IPs for security.

Once the FTP user is created, either by you or by Netmera, your DevOps team will receive secure login credentials, enabling encrypted data transfers between Netmera and the server of choice.

Step 2. Panel Setup

The Customer Success Manager (CSM) will assign specific offers to your account on the Netmera Panel. To configure FTP export settings:

  • Go to the Reports > Export page on the Netmera Panel.

  • Set up the export settings for FTP, ensuring all required paths and server credentials are accurately entered. Please visit our page Export for further information.

After setup, Netmera will automatically transfer your reports to the configured FTP server.

FTP Report Sending Schedule

Reports are sent nightly between 3:00 AM and 6:00 AM to ensure timely data availability.

In Case of FTP Transfer Failures

If the report fails to reach your FTP server, please contact Netmera at support@netmera.com for manual assistance and troubleshooting.

Sample Export Files

To export files via FTP from the Netmera Panel, follow these steps:

  1. Navigate to the Export screen on the Netmera Panel. You may visit Export for further information on the report options.

  2. Select the desired report or data set to export.

  3. Trigger the FTP transfer by clicking the 'Send' button.

  4. Once initiated, the report will be automatically transferred to your designated server.

Upon completion, the files will be named as follows:

  • appkey_PUSH_REPORTS_date

  • appkey_msgID_PUSH_REPORTS_date (with external ID)

These files will be automatically transferred to your designated server.

Upload data to the Netmera platform for tasks such as sending push notifications or updating user profiles.

Automatically transfer reports, including campaign and transactional data, from Netmera to your FTP server for analysis and record-keeping.

Importing Data:
Exporting Data:
296B
Importing FTP Push.csv
Importing FTP Push
128B
FTP Profile Attribute.txt
Importing FTP Profile Attribute
306KB
Sample Campaign Report.xlsx
Sample Campaign Report
338KB
Sample Campaign Report with External IDs.xlsx
Sample Campaign Report with Ex IDs
338KB
Sample Automated Campaign Reports.xlsx
Sample Automated Campaign Report
338KB
Sample Transactional Campaign Report.xlsx
Sample Transactional Campaign Report
869B
Add Tracking Sample.csv
Add Tracking Sample
652B
Installation & Permission Sample Data File.csv
Installation & Permission Sample Data File
306KB
Events Sample.xlsx
Events Sample