Bulk Links

At a glance: OneLink bulk links page allows you to generate a large number of OneLink custom links instantly and view them in one location for future use.

Why

Bulk links enable you to create and view links created in bulk. These bulk links are grouped in a convenient collection format allowing you to perform actions on the whole collection such as adding new links or downloading them.

Getting started

  1. In AppsFlyer, go to Experiences & Deep Linking > OneLink Bulk links.
  2. You will see an intro page with one of the following buttons:
    1. Get Started - (send to creating your first collection).
    2. Create a OneLink template - A OneLink template is needed to create a collection. See OneLink templates
    3. Upgrade -  Bulk links are not available with your current package. Contact your CSM or write to about upgrading your package.

Creating your first collection

  1. Click Get started.
  2. Enter a name for your collection.
    Choose a name that reflects the purpose of your collection, so you can easily identify it later.
  3. Select a OneLink template  Note: all the collection links will be based on this template
  4. Click Save & continue.
  5. Upload your CSV file. You can use the following Sample CSV as a guide.
    See Upload format to make sure your CSV is compatible and uploads successfully. Once the CSV file is uploaded it gets validated. If there are invalid rows, a validity report CSV will be available for download to help fix your file. Follow the instructions in the UI and upload a corrected file.
  6. Click Create collection.

Managing your bulk links with collections

Bulk links are managed in collections.

  • At the top of the page, the Bulk link usage this month widget shows the number of link requests (that includes link creations and updates) out of the monthly quota for the current month.
    • Currently, the default limit is 20,000 link creations per month
  • The Collections section allows you to create a new collection and perform other actions to your current link collections.
  • If there are more than seven collections, you can search and filter your collection list.

Other actions

Following are the other actions that can be performed on a collection:

Creating a new collection

Creating a new collection is available when the monthly usage has not been exceeded.

  1. Click New collection.
  2. Follow the instructions.
    1. The process follows the same steps as Creating your first collection. 

Downloading a collection

The download collection option is available when:

  • There are active links in that collection.
  • You have app access permissions to at least one of the mobile apps of the OneLink template related to the collection.

To Download a collection:

  1. Click the download icon on the collection row.
  2. Select the domain for the short URL output.
  3. Click Download.

 Important!

AppsFlyer recommends using Branded Domains as they can improve campaign performance by driving trust and promoting brand awareness. Learn more here.

Adding links to a collection

The adding links option is available when:

  • You have app access permissions to at least one of the mobile apps of the OneLink template related to the collection.
  • There are under 2000 active links in the collection.
  • Monthly usage has not been exceeded.

To add links to a collection, click menu options > Add links to collection.

Editing links in a collection

The editing links option is available when:

  • There are active links in that collection.
  • You have app access permissions to at least one of the mobile apps of the OneLink template related to the collection.
  • Monthly usage has not been exceeded.
To edit links in a collection: 
  1. Click menu options > Edit links.
  2. Download the collection base CSV. This file contains all the links in the collection you can edit. 
  3. Follow the instructions in the first step to edit link parameters. For any links you want to update, make sure Mark for update is set as true.
  4. Click Next.
  5. Upload your edited CSV. See Upload format to make sure your CSV is compatible and uploads successfully.
    • Once the CSV file is uploaded, it gets validated.
    • If there are invalid rows, a validity report CSV is available for download to help fix your file. Follow the instructions in the UI and upload a corrected file.
  6. Click Update links.

Viewing the collection history

To view the history of a collection, click menu options > View collection history.

The history window will show you the following actions as well as the date and time the action was performed and by whom:

  • Name changes: The changes to the name of the collection.
  • Links added: When links were added to the collection.
  • Links updated: When links in the collection were edited and updated.
  • Collection created: When the collection was created.

Links added and updated also show you how the changes affected your usage amount and allows you to download an action report on that change. 

    • Action reports can only be downloaded if you have app access permissions to at least one of the mobile apps of the OneLink template related to the collection.

Editing the collection name

The editing collection name option is available when:

  • You have app access permissions to at least one of the mobile apps of the OneLink template related to the collection.

To edit a collection name:

  1. Hover over the collection name you want to change.
  2. Click the edit icon next to the collection name.
  3. After you have edited the name, click enter or click elsewhere on the screen.

Deleting empty collections

If a collection is empty, and you have app access permissions to at least one of the mobile apps of the OneLink template related to the collection, it can be deleted by clicking on menu options -> Delete collection.

Collections can be empty due to:

  • The TTL (time to live) of all links in the collection expired.
  • The New collection process was aborted or failed to complete before links were created. This creates an empty collection.

General information

 Note

Bulk links created before April 2023 will not show or be managed on the bulk link page.

Upload format

In order to make sure your CSV uploads without any errors, make sure that your file meets the following standards.

  • The file must be in a CSV format
  • The file cannot be bigger than 4 MB
  • The file should only contain content for the links you are creating/updating
  • Each link should be in their own row
  • Each column represents a parameter
    • Maximum 35 parameter columns
  • Only UTF-8 character encoding is accepted
  • Maximum of 2000 links per collection

CSV parameters

  • Parameters in the CSV can be any parameter that is acceptable in an AppsFlyer link. It could be reserved parameters for attribution (e.g: c, af_channel, af_adset, etc.), for redirection & deep-linking (e.g: af_ios_url, af_dp, deep_link_value, etc.), or custom parameters.
  • The media source (pid) parameter is mandatory. 
  • Agencies need to manually add the af_prt parameter to their links.
  • Even if a URI scheme is set in the OneLink template, for links created in bulk, the af_dp parameter with the URI scheme must be specified in your CSV file.