Perform OneLink bulk actions via CSV

For:
Last update:

At a glance: The OneLink Bulk Links page allows you to manage many OneLink custom links with bulk actions.

You can create, view, and edit links generated in bulk. These links are organized into a convenient collection format, allowing you to perform batch actions on the whole collection, such as adding new links, downloading them, and generating QR code image files.

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 - Click to create your first collection.
    2. Create a OneLink template - Make sure you have at least one OneLink template in your account, and a Growth/Enterprise plan. See OneLink templates.
    3. Upgrade - Bulk links are available with the Enterprise or Growth plan. Contact your CSM or write to hello@appsflyer.com 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 quickly 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 collection and perform other actions to your current link collections.
  • You can search and filter your collection list if there are more than seven collections.
  • Each collection can contain up to 2000 links.

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 is not exceeded.

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

Downloading a collection of links

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. In AppsFlyer, from the side menu, select Engage > Bulk links.
  2. In the collection row click the download links icon links.png .
  3. Select the domain for the short URL output.
  4. Click Download.

 Important!,

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

Downloading a collection of QR codes

You can create QR code images for the entire collection.

  1. In AppsFlyer, from the side menu, select Engage > Bulk links.
  2. In the collection row, click the download QR code images icon generate qr.png .
  3. In the Generate QR code images dialog, set the following:
    • Domain: Select the subdomain or the branded domain of the URL that end users will see after they scan the QR code.
    • QR code image format: Choose either PNG or SVG as the format for the QR code image.
    • QR code file name format: Select the parameter whose values will be used as the prefix of the QR code image file names. Ensure that the values from this parameter add a meaningful context to the file names, helping you identify the purpose of each QR image.
  4. Click Generate. You can monitor the file generation process in the Download QR code images panel.
  5. To to download the ZIP file, click the download icon download-bulk.png.

 Note

  • Upon successful generation, the file will be accessible from the panel for 24 hours and then will be automatically deleted.
  • The downloaded file is provided in ZIP format because the payload consists of multiple QR image files. If prompted by your browser to allow ZIP downloads, provide the necessary confirmation to continue.
  • You can run up to 2 QR code generation processes concurrently.

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 to 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.

 Note

If you have downloaded QR code images from this link collection, you can update the link parameters and continue using the same images since the QR codes themselves do not change.

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.
  • QR codes ZIP downloaded: When the QR code images were generated and downloaded for the collection.

Links added and updated also show you how the changes affected your usage amount and allow 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
  • The Custom Link ID is a unique column, that enables the user to set the link short URL ID. The short URL ID cannot be edited after the link is created. To learn more about URL ID, see here.
  • Each column represents a parameter (Maximum 35 parameter columns)
  • Only UTF-8 character encoding is accepted

Parameters in the uploaded CSV

  • 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.
  • 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.