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
- In AppsFlyer, go to Experiences & Deep Linking > OneLink Bulk links.
- You will see an intro page with one of the following buttons:
- Get Started - (send to creating your first collection).
- Create a OneLink template - A OneLink template is needed to create a collection. See OneLink templates.
- Upgrade - Bulk links are not available with your current package. Contact your CSM or write to hello@appsflyer.com about upgrading your package.
Creating your first collection
- Click Get started.
- Enter a name for your collection.
Choose a name that reflects the purpose of your collection, so you can easily identify it later. - Select a OneLink template Note: all the collection links will be based on this template
- Click Save & continue.
- 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. - 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.
- Click New collection.
- Follow the instructions.
- 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:
- Click the download icon on the collection row.
- Select the domain for the short URL output.
- 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.
- Links will be added using the same method as described in Creating your first collection from point 5 onwards.
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.
- Click menu options > Edit links.
- Download the collection base CSV. This file contains all the links in the collection you can edit.
- 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.
- Click Next.
- 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.
- 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:
- Hover over the collection name you want to change.
- Click the edit icon next to the collection name.
- 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.