Purpose
This article describes the Creative Bridge API assigning Innovid links to Box assets. The API automatically pulls these assets into a campaign's asset library, eliminating the need to upload videos manually and, therefore, ensuring faster delivery of creative materials.
API process
To assign Innovid links to Box assets, you need to do the following:
- Complete the Box Creatives tab within the Media Brief.
- Validate the Box Share Link.
Step 1: Complete the Box Creatives tab within the Media Brief
| IMPORTANT |
|
The API's ability to process these creative assets depends on accurate information in the Box Creative Tab in the media brief. Any discrepancies in the tab, such as mismatched names or broken links, can cause the API to fail to fetch the intended creative. |
- Enter the Creative Asset Name.
-
Enter the Box Share Link.
Folder access Each folder needs to be given access to the following emails:
This helps with retrieving the assets and using the Campaign Submission Form. Before the API can be used, Innovid will run a test to confirm that we have access to the folders.
- Mark Yes in the New Creative column for any new creative assets that must be fetched. This triggers the API to process and retrieve the asset.
The API only processes rows marked Yes under New Creative. Failure to update this column accurately will result in skipped assets. The API operates solely on the information provided in the tab. - Mark No in the Update Asset column to replace old or obsolete assets. Mark Yes for new assets that need to be swapped in.
Step 2: Validate the Box Share Link
- Ensure the Box Share Link is directly linked to the creative asset specified under the corresponding creative name.
| Top tips |
|
Step 3: Submit
- Submit the completed Media Brief in the Campaign Submission Form. The API fetches the assets, and they will appear in Campaign Creatives.
Step 4: QA monitoring
Within Campaign Creatives, the assets will have their status (pass or fail) visible.
- Review whether each creative asset has passed or failed QA.
- Address any failures promptly by revising and resubmitting the creative through the abovementioned process.
Note: While our team monitors creative submissions during processing, you play a critical role in catching and addressing issues early. Regularly check Campaign Creatives for updates on the status of submissions to ensure no delays in campaign readiness.
Error messages
| Error | Workaround |
| Service account is missing download permissions. Contact support. | Ensure cse-box@innovid.com is set as a collaborator in the asset's Box folder. If the problem persists, contact Innovid. |
| Wrongly formatted asset. [object Object] | Contact CSE with the issue. Upload assets manually until informed otherwise. |
| File already exists. |
Files larger than 600mb may return an error stating that the file already exists. Check the campaign on the platform and check if the creative asset is present by looking for the review status:
|
FAQs
Am I a good fit for the Box API?
You can benefit from using Box to manage your creative assets and use the Campaign Submission Form.
Is the Box API part of the Creative Bridge?
No. The Box API integration is a solution offered by the Custom Solutions team, which leverages Creative Bridge.
Can the Box API upload display assets currently?
No, at this point, it can only upload video assets. If you need to include display assets, contact Innovid.
Where do the uploaded assets show?
Assets are uploaded into the campaign's General Creatives section.
Do you need the Campaign Submission Form to leverage this offering?
Yes, the Campaign Submission Form is needed.
Are there plans to roll this out to self-service clients?
Yes, this solution will be expanded to other self-service clients in the future.
Related content
Getting started with Innovid's Open Creative API