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 registered 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.
- 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. The console opens its page. A new Creative has no name and no Variation.
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. Type a name in the field. The console saves the name when you leave the field or press Enter. An empty field removes the name.
- Variations. The list shows each Variation: the kind of its 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. - Placement. Each row has a picker for the placement of the Variation, or No placement. A placement is a spot where an ad runs, for example a Meta Stories video. The picker lists the placements of the same kind as the file, with the placements of AdCrunch first, by channel, and then your own. The change is saved when you pick.
- 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 row 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 name of an Asset to open its panel. The panel shows the preview of the file and where it is registered.
- Remove. Select the × of a row to remove that Variation. The Asset stays in the Library.
Add Variations
Select Add variations. The dialog lists the Assets that are ready.
- Select each Asset that you want in the Creative. Each Asset becomes one Variation.
- For each selected Asset, the dialog shows a picker with the placements that the file fits. It lists only the placements of the same kind as the file, and only those whose rules the file meets. The picker starts on No placement. The console never picks a placement for you. If no placement fits, the dialog says so.
- 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.
An Asset that is in the Creative already shows In this creative. You can select it again with a different placement. A Creative holds the same Asset with the same placement one time only, and the dialog shows the refusal if you add it again. One Asset can be in several Creatives. The suggestion is advice: a rule that the console cannot check, because the file has no known size or length, does not remove a placement from the list.
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 place them in your ad accounts. Select Upload to add files. Select the name of a file to open its panel, where you can rename it.
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, variation_add and the others. Bring your own creative walks the whole job.