Method & Instructions

The Recurring List Import method is a unique option that clients may utilize to provide Remerge with their Regularly Updated Data. For your convenience, we have gathered a list of cases in which you may employ Recurring List Imports:

• You wish to provide Remerge with a daily list of users for targeting.
• You wish to provide Remerge with a weekly list of segments for targeting.
• Creation of exclusion user lists (i.e., users you wish to refrain from targeting).
• Business Intelligence data that is unavailable via in-app events (e.g., whale or churn users).

The Recurring List Import method is recurring and automatable via any of the following options: Amazon S3 Bucket, URL, Audience Builder (Adjust), or Audiences (AppsFlyer). 

Ensure to share the below guidelines, file requirements, and examples with your Business Intelligence Team. In case of any questions on the method or adequate data volume, please reach out to your Remerge Account Manager.

Amazon S3 Bucket

You may regularly upload a CSV file representing a unique user segment to an Amazon S3 Bucket, hosted and created by your company or provided by Remerge.

1. Connect to an Amazon S3 Bucket

Select 

Determine your designated Amazon S3 Bucket and take the corresponding step, as follows:

• Your Amazon S3 Bucket - In that case, ensure to provide your Remerge Account Manager with the below login credentials to your Amazon S3 Bucket: 
  
  
  • Your Access Key ID
  • Your Secret Access Key
  • Your Server Instance Region
    
    
• The Remerge Amazon S3 Bucket - In that case, ensure to obtain the login credentials to our Amazon S3 Bucket from your Remerge Account Manager, as per the below example: 
  
  
  • The Remerge Access Key ID: PLKR6XORH5XQRXYSLZ1B 
  • The Remerge Secret Access Key: 23R52F5678NDFT4L44G23R52M9086NDUT4M44N
  • The Remerge Server Instance Region (which is ALWAYS: us-east-1)

Automate 

• Consult your internal team to ensure the automation of recurring file uploads to the previously selected Amazon S3 Bucket. 

2. Create your Directory

Structure

• List Import
  
  
  • Connect to the selected Amazon S3 Bucket by entering its respective login credentials.
  • Create a List Import folder. 
    
    
    
    
• Partner Folder (Optional)
  
  
• Application Folder
  
  
  • Go to the List Import folder and create a unique folder per application (i.e., a folder for an Android application and a folder for an iOS application).
  • Retrieve your app ID from its respective digital store and incorporate it in the folder name. Folder name example:
    
    
    • com.android.appname (Android- Google Play Store)
    • id123458980 (iOS- Apple App Store)
      
      
       
• Segment Folder
  
  
  • Go to your previously added application folder and add a designated segment folder.
    
    
    
    
  • DO NOT Mix Segments - Ensure your segment is associated with a single Application.
  • Ensure to name your segment folder with a unique name that reflects its type. Folder name examples:
    
    
    • purchasers
    • AB-whales
    • holdout_90+
    • exclusion_list_users
      
      
• User List File
  
  
  • Go to the previously added segment folder and add a CSV formatted file that contains relevant user IDs ONLY.
    
    
    
    
  • DO NOT Mix Users - Ensure your user list is associated with a single Application.
  • Ensure your file name reflects the segmentation strategy and the date of the last uploaded file. File name examples:
    
    
    • purchasers.csv
    • AB-whales.csv
    • holdout_90+.csv
    • exclusion_list_users.csv
      
      

A Directory Structure example

Format

• ID - Enter data in the IDFA (uppercased) or GAID (lowercased) format ONLY (NO IDFV).

Content

• Ensure to include valid user IDS ONLY- Add No additional information should be added to your file.
  
  

A CSV File example

3. Provide & Obtain Information

• Upon completion, comply with the guidelines that correspond with your previously selected Amazon S3 Bucket option, and follow the accompanying instructions:
  
  
  • To utilize Your Amazon S3 Bucket:
    
    
    • Provide your Remerge Account Manager with Your Path to the Segment Folder per Application.
      
    • Provide your Remerge Account Manager with the login credentials listed in our Connect to an Amazon S3 Bucket step to your Remerge Account Manager.
      
      
  • To utilize the Remerge Amazon S3 Bucket:
    
    
    • Obtain the Path to the Remerge Folder (the location of your uploaded directory. E.g., remerge-customers/remerge-abcd12) from your Remerge Account Manager.
    • Obtain the login credentials listed in our Connect to an Amazon S3 Bucket step from your Remerge Account Manager.
      
      
  • Add any Partner-specific data in a designated Partner Folder.
  • Communicate the update frequency to your Remerge Account Manager.
  • DO NOT break down segments into multiple files.
  • Upload a single file per update. Please note: Our system ONLY reads the latest modified file in a folder. Should you attempt to upload multiple files simultaneously, our system will ONLY use the LAST file in this upload and disregard the rest. 

An Amazon S3 Bucket Path example (Client)

• https://s3.amazonaws.com/remerge-customers/client/list-import/app/user-list.csv 
  

An Amazon S3 Bucket Path example (Partner)

• https://s3.amazonaws.com/remerge-customers/client/list-import/partner/app/user-list.csv

 

URL

You may provide Remerge with a URL that leads to a CSV file, representing a unique user segment. 

1. Create your Importing User List

• Ensure your file meets the following prerequisites:
  
  
  • Each file contains a unique segment of users per application (i.e., a user segment for an iOS application OR a user segment for an Android application). DO NOT mix various user segments in a file.
  • Each file contains a CSV formatted list of device IDs per segment (no additional information is required).
  • The file content is updated regularly with device IDs for the specific segment. Ensure to communicate the update frequency to your Remerge Account Manager.

2. Forward the URL Path to Remerge

• Ensure your URL meets the following prerequisites: 
  
  
  • The URL leads directly to the relevant file - The location of the file plays no role in the method's success and is thus subject to your preference. The URL, however, MUST lead directly to the specific file. Each time our system calls said URL, it pulls an updated CSV file of users.
  • You have provided Remerge with the segment and application identification per URL.
  • Remerge DOES NOT require a password or IP whitelisting to access the path. In case that you need to include Remerge in your permit list, please reach out to your Remerge Account Manager to obtain our public IP address. 

 

Audience Builder (Adjust)

You may utilize the Adjust Audience Builder feature, which Remerge has integrated to automate recurring user list imports. Please note: This feature is available to particular clients and the Adjust price plans ONLY.

1. Implement Feature

• For step-by-step implementation instructions, please visit our Audience Builder page.

2. Forward the URL Path to Remerge

• Upon completion, ensure to provide Remerge with the final URL that leads to your created Audience, as well as any additional information regarding your preferred targeting strategy.

A Final URL example

• https://api.adjust.com/audience_builder/v1/data/6f98d163-ad56-01be-b6c5-f611b967ba19
  
  

Audiences (AppsFlyer)

You may utilize the AppsFlyer Audiences remarketing tool, which Remerge has integrated to automate recurring user list imports. Please note: This feature is available to particular clients and the AppsFlyer price plans ONLY.

1. Implement Feature

• For step-by-step implementation instructions, please visit our Audiences page.

2. Forward the Path to Remerge

• Upon completion, ensure to provide Remerge with the final path that leads to your created Audience, as well as any additional information regarding your preferred targeting strategy.

A Final Path example

• https://s3.amazonaws.com/remerge-customers/client/list-import/app/user-list.csv