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 are 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 following 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. Define an Object Key

Structure
 

• Define your CSV Object Key in the following format:
  
  /list-import/<APP ID>/<SEGMENT ID>/file.csv
  

Please note: The implementation of the /list-import/ within the Object Key (/list-import/<APP ID>/<SEGMENT ID>/file.csv) facilitates Remerge with sustaining an organized and efficient bucket structure. 

Enter Data

• Adhere to the below (/list-import/<APP ID>/<SEGMENT ID>/file.csv) data entry requirements:
  
  
  • APP ID - ID of an app associated with a particular segment:
    
    
    • DO NOT Mix Users - Ensure your user list is associated with a UNIQUE Application.
      
      
  • SEGMENT ID - Segment name (identifier):
    
    
    • DO NOT Mix Segments - Ensure your segment is associated with a UNIQUE Application.
    • Ensure to name your segment ID with a UNIQUE name that reflects its type. Segment name examples:
      
      
      • purchasers
      • AB-whales
      • holdout_90+
      • exclusion_list_users

A Directory Structure Example

• Maintain the following CSV file guidelines:
  
  
  • You may be flexible with the selection of your CSV file name. 
  • Ensure to include VALID USER IDS ONLY- IDFA for iOS segments and AAID for Android segments ONLY (Add NO additional information to your file).
  • Adhere to the below formatting ONLY:
    • IDFA (uppercased)
    • AAID (lowercased)
    • (NO IDFV)

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 Path 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 your S3 Remerge Path (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 Path.
  • 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 path. 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)

Please note: If you are employing the services of a third-party data partner to generate the list, we suggest adding another folder to the path to indicate the selected partner. This step is beneficial in case of multiple partners or should a change of providers occur.

• 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. Should 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, and 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 and 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