Library
The Creatives of your organization and the files that they use. Group the files of one ad idea, then use the Creative in a Campaign Plan.
The Library holds what your organization brings to its ads. An Asset is one file: an image or a video. A Creative is one ad idea, and it keeps the files of that idea together. Each file of a Creative is a Variation, for example the 9:16 video and the square image of the same idea.
A Creative of the Library changes no ad account. It is not the creative that an ad account holds. To put a file into an ad account, register the Asset.
The Library page
In the Browse tab of the console sidebar, select Library. The page has three tabs. Each tab shows its count beside its name. A tab shows no count while the console reads the list.
| Tab | Address | What it shows |
|---|---|---|
| Creatives | /library |
A gallery of the Creatives, with a picture of their Variations, their formats and the day of the last change. |
| Assets | /library/assets |
Each Asset, with its dimensions, its size, and the ad accounts that it is sent to. |
| Placements | /library/placements |
The slots where a provider shows an ad, with the rules that a file should meet. |
Creatives
The Creatives tab shows a gallery of the Creatives, newest first. A Creative with no name shows Untitled creative.
Each card shows:
- Thumbnails of the first Variations of the Creative. A card shows up to three thumbnails, and then a + badge with the number of the others. A thumbnail keeps the shape of its Asset. A video shows its length. A Creative with no Variation shows an empty tile.
- The name, and the number of Variations.
- The progress of its slots, for example 2 of 5 filled. A Creative with no required placement shows no progress.
- One badge for each format that the Variations have:
9:16,4:5,1:1,1.91:1or16:9. The console computes the format from the width and the height of the Asset of each Variation. An Asset with an unknown size, or with a ratio that is near no format, has no format. - The day of the last change.
Select a card to open the page of the Creative.
The console reads the thumbnails and the formats of a card when the card comes near the screen. A card shows no format and no thumbnail until the console has read them.
Use the Search creatives field to filter the gallery by name. The search runs in the console.
Select New creative to create a Creative. See Create a Creative.
Create a Creative
A Creative can require placements. A required placement is a placement that the Creative needs a file for. Each one becomes an empty slot on the page of the Creative.
The New creative dialog has these parts:
- Name. The name is optional. A Creative with no name shows Untitled creative.
- Presets. A preset is a named set of placements, for example all the placements of Meta. Select a tile to choose its placements. Each tile shows the shape of its placements, and the number of placements. A preset of your organization shows Yours. The tile that matches your selection shows Selected.
- Or adjust the placements. Open this section to turn each placement on or off, grouped by channel. Each placement is a toggle button. It shows its state as text and as a check, not as a colour alone. When you change the selection, the dialog shows Custom selection. A preset only chooses the placements: a Creative keeps no link to it, and a later change of the preset changes no Creative.
- Create. One button creates the Creative with the name and the placements, then opens its page. Its label says what it creates, for example Create with 3 placements. Under the count, the dialog names the placements that you chose. A Creative requires 50 placements at most. Above that, the button is off, and the dialog says how many to remove.
- No placements. With no placement selected, the button reads Create with no placements. A Creative with no required placement is valid, and you can add placements on its page later.
If the creation fails, the dialog stays open with your choices, and shows the reason.
The page of a Creative
Select the name of a Creative to open its page. The address of the page holds the id of the Creative, so you can send it to a teammate.
- Name and description. The name and the description show at the top of the page. Select the text to edit it in place. The console saves a field when you leave it or press Enter. An empty name removes the name, and an empty description removes the description. A description has 1000 characters at most.
- The board. The page shows one card for each required placement, grouped by the shape that the placement asks for: 9:16 vertical, 4:5 / 1:1 feed, 16:9 wide, or Any shape. A line above the board sums up the progress, for example 2 of 5 filled. A filled card shows its file: a thumbnail, the name, and the facts of the file. An empty card is a dashed frame with Add file. A mark for each slot in the line above the board shows the state: a solid dot for a filled slot, a dashed outline for an empty slot. A warning triangle marks a slot whose file breaks a rule. A screen reader reads the name of the placement with “filled” or “empty”. Select a mark to go to its slot. On a wide screen, the line stays at the top of the page when you scroll.
- Fill a slot. Select Add file to choose from the Assets that are ready, or to upload a new file. The files that fit the rules of the placement come first, and the files of Other files lead them: a pick moves such a file into the slot. A file that breaks a rule of the placement is still allowed: the rule is advice.
- Slot menu. Each card has a menu. It can show the file, move it to Other files, or remove it from the Creative. It can also stop requiring the placement. The console asks you to confirm a remove, and a stop. When you stop requiring a placement, its files stay in the Creative, under Other files.
- Drag and drop. Drag a file from your computer onto a card to put it in that slot, or onto Other files to add it with no placement. Drag a card of Other files onto a slot to set its placement. A drop on a slot uses the first file only. The console refuses a file or a card of the wrong type before it uploads the file or moves the card. Each drag has a click path: Add file and Add files. Add file also lists the files of Other files, and a pick moves the file into the slot.
- Add a placement. Select Add a placement to require one more placement. Each one becomes an empty slot.
- Other files. The files that fill no slot show here as small cards. Each card shows the thumbnail, the name, and the size. When the file names a placement that the Creative does not require, the card shows that placement. A click on the thumbnail opens the file. The button in the corner of the thumbnail removes the file.
- Variations. A card shows a thumbnail of the file, the name of its Asset, its dimensions, its aspect ratio and, for a video, its length. The aspect ratio comes from the dimensions: a file of 1080×1920 shows
9:16. - Broken rules. A placement has rules, for example a ratio of 9:16 or a length of 3 minutes at most. When the file of a Variation breaks a rule of its placement, the card shows a warning icon and the broken rules as text, under Does not fit this placement. A rule that the console cannot check, because the file has no known size or length, shows nothing. The warning is advice. It blocks nothing, and you can keep the Variation.
- The file. Select the thumbnail of a card to open the panel of its Asset. The panel shows the preview of the file and its registrations.
- Remove. Select the × in the corner of a card to remove that Variation. The Asset stays in the Library.
Add files
Select Add files. The dialog lists the files that are ready. Each file is an Asset of the Library, and it becomes one Variation of the Creative.
- Select each file that you want in the Creative.
- To use a file that is not in the Library yet, select Upload. When the upload ends, the file shows in the list, already selected.
- Select Add.
The dialog adds each file with no placement, so the file shows under Other files. To put a file into a slot, use Add file on the slot, or drag the file onto the slot.
A file that is in the Creative already shows In this creative. A Creative holds the same file with the same placement one time only, and the dialog shows the refusal if you add it again. One file can be in several Creatives.
Delete a Creative
On the page of a Creative, select Delete, then confirm. The console deletes the Creative and its Variations. The Assets stay in the Library, and no ad account changes.
A Campaign Plan or a Line Item that uses the Creative no longer shows it.
Assets
The Assets tab is where you upload files and send them to your ad accounts. Select Upload to add files. Select the name of a file to open its panel, where you can rename it.
A registration is a send of an Asset to an ad account. Select Send to account, then choose the ad account. AdCrunch sends a copy of the file to that account. The column Sent to shows each account, and the progress of the send. If a send fails, the badge reads stored, not sent: AdCrunch keeps the file, and you can select the retry button. A Creative does not need a registration.
If no connected ad account takes files, the tab shows a link to the page where you connect one.
Placements
A placement is a slot where a provider shows an ad, for example a Meta Stories video. A placement has a channel, a type (image or video), and a list of rules. A rule says what a file should be, for example “Ratio is 9:16” or “Length is at most 180 s”. The Variations of a Creative can name a placement. See the page of a Creative.
The Placements tab lists the placements that your organization sees. The count beside the name of the tab is the number of your own placements. The global placements are not counted.
Each row shows the name, the description, the channel, the type, and each rule as a short phrase. A size shows in MB and a length in seconds, with the same number as the form, for example “Size is at most 0.25 MB” and “Length is at most 2.4 s”. A row can have a Global mark. A global placement comes with AdCrunch. You can read it and use it, but you cannot edit it or delete it. Your own placements come first, by name. The global placements come after them, by channel.
Use the Channel and Type filters to narrow the list. The address of the page keeps the filters, so you can send it to a teammate. If your organization has no placement of its own, the tab says so and shows New placement. The global placements show below.
Create a placement
- Select New placement.
- Enter a name. The name has 80 characters at most. It must be new among the placements of the same channel that you see, with no regard to case.
- Optional: enter a description.
- Select the channel and the type. You cannot change them after you create the placement.
- Select Add rule for each rule. A placement has 20 rules at most.
- Select Create.
The rules
A rule is one line with a fact, a condition and a value.
| Fact | Value |
|---|---|
| Width, Height | A whole number of pixels. |
| Ratio | Two whole numbers with a colon, for example 9:16. For is one of, enter several, for example 4:5, 1:1. |
| Size | A number of MB, for example 500 or 1.5. 1 MB is 1,048,576 bytes, as in the Assets tab. |
| File type | One or more of JPEG, PNG, WebP, GIF, MP4 and MOV. |
| Length | A number of seconds. A video placement only. |
The conditions are is, is one of, at least and at most. A file type has is and is one of only.
For a Width, a Height, a Size or a Length, is one of takes a list that you separate with commas.
If you change the type to image while the form holds a length rule, the form removes the length rule and tells you.
Each error shows next to its line, and nothing is sent until you fix it. If AdCrunch refuses the placement, the form stays open and shows the reason. For example, the name can be taken, or the organization can hold the most placements that it can hold (200).
A rule is advice. A Variation that breaks a rule is still saved, and the Creative page shows the broken rule as a warning.
A rule that the form cannot edit shows as text with no field. An agent or the API can write such a rule, for example “Width is not 1080 px”. When you save the placement, the rule stays as it is. Select the × of the line to remove it.
Edit a placement
Select the pencil of one of your own placements. You can change the name, the description and the rules. You can edit a placement that Variations name. The Variations show the new rules when they load again.
Delete a placement
Select the bin of one of your own placements, then confirm. AdCrunch refuses the delete while a Variation names the placement. The confirmation stays open and shows the reason. Remove the Variation, or change its placement, then delete again.
Use a Creative in a Campaign Plan
A Campaign Plan holds the Creatives that it can use, and each Line Item picks its Creatives from them. See Creatives of a Campaign Plan.
Agents
An agent reads and writes the Library with the MCP tools: library_creative_list, library_creative_get, library_variation_add and the others. Bring your own creative walks the whole job.