Last Updated: Sep, 2026
Is there a limit to processing API audiences?
There are no constraints on the number of API calls. However, for optimal audience updates through API, it is required to limit it to 2,000 devices per API call.
What are the recommended practices when utilizing a CSV file for First Party audiences?
Ensure that the file is stored in .csv format (not a similar format like .csv_sorted). For further clarity, download the sample file from the audience creation page. The file should contain a single column with valid device IDs, either in RAW or SHA1 format. For ex:
Raw :96bd03b6-defc-4203-83d3-dc1c730801f7 and SHA1: 7f9527d6d0590683ba17e19ec12ec7c1e7dff0d9
What types of URLs are compatible with file URLs for First Party audiences?
We support various 3rd party file URLs for audience creation, including Dropbox, Amazon S3, etc. Both Public URLs (enabling direct file download when the URL is accessed) and URLs with credentials are supported.
How to address audience processing failure due to an invalid file?
Ensure that the file contains data as expected (refer to #2). Remove the invalid file from the audience page and upload a new, valid file.
Does the status of any audience impact campaign serving?
In cases where audiences are created with invalid files, campaigns associated with the respective audience will not perform. To activate your campaign, rectify the issues with the invalid file.
How do I use an Adjust Audience Builder link to create an audience in Kayzen?
Adjust's Audience Builder generates a file URL, for example https://api.adjust.com/audience_builder/v1/data/<audience-uuid>, that Kayzen uses to fetch your audience. Add this link using the File URL method on the audience creation page, the same way you would add any other third-party file URL. The most common issues with Adjust links are covered in the two questions below, and both are easy to resolve.
Why does my Adjust audience link return "Invalid segment group uuid" or fail to process?
This almost always means the link was not copied in full. Adjust audience links end in a standard UUID in the format xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx (five groups of hexadecimal characters). If a few characters at the end are missing, the link no longer points to a valid audience: opening it directly returns an error such as {"errors":["Invalid segment group uuid"]}, and the upload fails on Kayzen's side for the same reason.
To resolve this, re-copy the entire URL from Adjust, making sure you select the complete link and not just the part visible on screen, and confirm the trailing UUID is complete before adding it to the audience. You can verify the link by opening it in your browser: a valid link returns file content or starts a download, while an incomplete link returns the error above.
My Adjust link is correct but the audience sometimes fails with "Too many requests for this URL" or "File is not accessible." Why?
This is expected behaviour on Adjust's side and does not indicate a problem with your audience or with Kayzen's processing. Adjust builds the audience file on demand and keeps it available for a limited period after it is first generated. When the file is already prepared, Kayzen fetches it and the audience processes normally. When it is not, for example just after the file has refreshed, Adjust has to query and rebuild it, which can take some time, and the link may be temporarily inaccessible during that window. Sending many requests to the same link in a short span can also cause Adjust to temporarily rate-limit it, which is when you see "Too many requests for this URL."
If you run into this, try the following:
Open the Adjust link once in your browser and let it finish downloading the file. Browsers do not enforce a fetch timeout, so this gives Adjust the time it needs to build the file and make it available. Once the download completes, return to Kayzen and add the link again.
Avoid opening or refreshing the link repeatedly, as this can trigger the "Too many requests" block.
If the link still does not load, wait a while and try again once it opens successfully in the browser.
Note: A valid Adjust link that fails to load will usually resolve on its own once Adjust has regenerated the file. If the same link keeps returning an error after retrying, reach out to Kayzen Support with the audience name and the Adjust link so the team can investigate.