Skip to main content

Customer files

Add or update customer files​

Add or delete customer files​

API description​

  • Adds a certain adid to the existing customer file target or delete it from the existing customer file target.
  • The API specification is described on the Add or delete customer files page.
  • The upload process has a file size limit of 100 MB and a timeout limit of 20 seconds.
  • Customer files should be 600 MB or smaller for adding.

How the callback works​

  • You can add 'callbackUrl' to verify whether the analysis operation has successfully completed or failed.
  • When making a request to add or delete customer files, the response indicating the success or failure of the validation check and upload is returned, and the analysis result is sent to the callbackUrl.
  • Requests to add or delete customer files for the same adidLibraryNo cannot proceed until the analysis is completed.
  • The target population does not change immediately after the callback. (Segment updates will occur 'N' hour(s) later.)

Callback specification​

Sends an HTTP POST request with the body formatted as Content-Type: application/json and receives the analysis result for adding/deleting customer files as a callback.
The following values can be specified in the status field.

  • COMPLETED: The analysis has successfully completed.
  • FAILED: The analysis has failed.
  1. Completion of adding or deleting customer files
POST
Url : {callbackUrl}
Content-Type: application/json
{
    "adidLibraryNo": 1,
    "status": "COMPLETED",
    "message": "Analyze success"
    "requestedAt": "2024-01-01T01:59:59.000+0000"
}
  1. Failure of adding or deleting customer files
POST
Url : {callbackUrl}
Content-Type: application/json
{
    "adidLibraryNo": 1,
    "status": "FAILED",
    "message": "Processing cannot proceed because the analysis result file does not exist or the adid count value is set to zero."
    "requestedAt": "2024-01-01T01:59:59.000+0000",
}