Create products from ad-server inventory

Once your ad server (Google Ad Manager, FreeWheel, SpringServe, or AdsWizz) is connected and its inventory has synced, you turn that inventory into products buyers can discover and buy. Open Inventory Components to do the whole job directly, or describe an exact product to your storefront agent and let it use the same typed product tools for you.

​

Three things called “product”

Worth separating before you start, because they behave differently and only one of them is yours to author: A component is none of these — it is the raw ad-server material (ad units, placements, targeting) you select from when authoring. You never author a component. If your source is a third-party sales agent rather than a managed one, its products live in that agent and you author them there; Interchange reads them.

​

How a product gets created

Both paths follow the same server contract, so you see the exact request before anything is saved:

1. Pick inventory. Choose the ad-server objects to package, such as ad units or placements from your synced inventory. If the package uses GAM key-values for targeting, create signals from that ad-server targeting rather than putting raw key-values in the inventory selector bundle.
2. Draft. In Inventory Components, select reviewed components, enter a product name and optional description, and choose the delivery options buyers can use. Each option shows practical details such as media type, dimensions, and video length. The Inventory Selector task offers the same form after you pick exact ad-server rows, plus the coverage this product declares. The options come from the coverage your ad server lists: everything sold under one publisher, specific properties, or specific tags. For a representation network, the publisher shown is the network while its represented sites are the individual properties. One option is prefilled; with several you choose. When you start from Create product in Property Roster, the publisher requirement is already attached and only compatible delivery options are shown. Neither widget sends the selection back into chat.
3. Validate. Choose Review product. This checks that the selected inventory can deliver every option before anything is saved and surfaces field-level issues (see What validation surfaces).
4. Confirm and create. Choose Create draft product only after validation succeeds. That explicit click saves the exact reviewed request as draft; it is not visible to buyers until you activate it.

After creation, the task confirms the draft and points you to Inventory Components, where you can manage or activate it. If you created it inside Inventory Components, the Products tab refreshes automatically. In chat, the agent confirms the product landed by listing your products back to you.

​

If GAM shows only the network

A connected Google Ad Manager source should expose the selector types and inventory rows that its sync can read, such as ad units, placements, and custom targeting. Seeing only the GAM network, with no selectable inventory below it, is not a completed product-setup state. It does not mean you must first invent title or geography keys.

1. Confirm the source sync has completed and open its Health or diagnostics view.
2. Check that the Scope3 service account still has GAM inventory read access.
3. Inspect the source’s advertised selector capabilities. A selector type can be absent because GAM does not expose it for that network or because the integration does not support it; an advertised type with no rows is a sync or product defect.
4. If the source is healthy but still exposes no inventory rows, contact Scope3 with the source ID, last sync time, missing selector type, and a screenshot. Do not work around it by creating unsupported targeting keys.

Titles, sections, geography, and similar commercial groupings are not all native GAM inventory levels. Once inventory is visible, package native selectors directly and use existing GAM custom targeting or product metadata for the additional dimensions your network actually maintains.

​

What validation surfaces

Validation (and preview) returns two kinds of findings:

• Blocking problems that stop the product from being valid — for example a creative format your ad server doesn’t recognize. Fix these before creating.
• Advisory warnings that never block creating the product, but flag a gap worth closing:
  • No publisher properties declared. The product doesn’t say which publisher properties (the publisher inventory it covers) it sells, so buyers cannot see what they’re buying. On an ad-server-backed source this also appears as a blocking problem, because the ad server requires a product to declare its coverage before it will accept it.
  • A declared property wasn’t found. You named a specific property (by id or tag) that isn’t in the registry or on the publisher’s adagents.json — usually a typo. The check skips a publisher that exposes no property list yet (not-yet-crawled), so valid-but-unindexed inventory isn’t flagged.
  • Publisher hasn’t authorized your agent. A declared publisher’s adagents.json doesn’t list your storefront’s sales agent. The product still authors fine; treat the warning as a publisher-owned authorization gap to fix before depending on that inventory. The check reads the publisher’s live adagents.json, so a publisher that simply hasn’t been crawled yet is not flagged.
  • Publisher format needs attention. The selected format may be missing or changed in the latest catalog, the catalog may be unavailable or stale, or its property scope may not cover the selected publisher properties. The product task adds the selected publisher format and property scope automatically so validation can flag these gaps.

Advisory warnings are informational and help you catch gaps early. A publisher does not have to have authorized you for a product to author, and the storefront’s own coverage check never blocks you. Declaring coverage is the exception. An ad-server-backed source rejects a product that names no publisher property, so a warning about undeclared coverage arrives alongside a blocking problem from the ad server. The product task asks you to pick from the coverage options listed by your ad server so the draft carries one. Authoring depends on what the option contains, not how the coverage was discovered or whether the publisher was verified. Findings are grouped by whether they stop you, so an advisory never reads as a blocker. Every publisher listed by your ad server produces an all coverage option, even when no individual properties are listed yet. Specific property ids and tags appear only when your ad server supplies them. If the task offers no coverage options, the source has not supplied any publishers; refresh the source and check its publisher setup. A publisher’s adagents.json status does not limit which listed coverage options you can use to author a product.

​

Creating several products at once

When you have a set of products to add, for example a spreadsheet of ad units, you do not have to approve them one by one. The agent validates and previews each draft, then creates the whole set after a single approval.

• Drop a spreadsheet into the chat. Attach a CSV or spreadsheet of products and the agent maps the rows into drafts, validates them, and proposes the batch.
• One approval for the batch. You approve the full set once rather than per product.
• It keeps going if one fails. Bulk creation continues on error: if one product can’t be created, the rest still are. At the end you get a clear per-product result showing which products were created and which failed, with the reason, so you can re-run just the ones that need attention.

You can also ask the agent to make the first pass for you. For example:

• “Set up my initial products for me.”
• “Take a crack at my first cut.”
• “Here is a list of sections and ad units; bulk create products from it.”

The agent should inspect inventory selector capabilities, browse representative ad-server rows, map publisher/property/placement evidence into product drafts, validate the full set, and ask you to approve the batch before it creates anything.

​

Updating several products at once

When you need to change a set of products, for example fixing the ones that failed during a batch create or adjusting pricing across a slate, you do not have to approve each edit one at a time. The agent applies all patches after a single approval.

• Describe the changes in chat. Tell the agent which products to update and what to change. You can paste a list or describe the edits; the agent maps them to the matching products and shows you what will change before asking for approval.
• One approval for the batch. You approve the full set of updates once rather than per product.
• It keeps going if one fails. Bulk updates continue on error: if one product can’t be updated, the rest still are. At the end you get a clear per-product result showing which products were updated and which failed, with the reason, so you can re-run just the ones that need attention.

​

Product status

Every product has a status: Inventory Components and Inventory Selector create new products as draft so you can review them before activation. In chat, state whether you want a draft or an active product; the confirmation shows the exact status before the write.

​

Retiring a product

Two endings, and only one of them can be walked back: Archive first. Archiving is the normal way to stop offering something and is enough for almost every case: a seasonal package, a product you are reworking, inventory you are not selling this quarter. Delete only when you want the product gone for good, and archive it first — deleting an active product takes it out from under buyers who can discover and buy it right now, and there is no undo. A draft was never offered to anyone, so it can go directly. Because the step cannot be reversed, confirm the exact product before you ask for it: name, not just id. Deleting the wrong product is not something a retry fixes. Deleting a product does not touch your ad-server inventory. The ad units, placements, and targeting you packaged stay in your ad server exactly as they were: you are removing the product you authored, not the material it was built from. To sell that inventory again, author a new product from the same components — it comes back with a new id, not the one you deleted.

​

GAM key-value signal targeting

GAM key-value targeting is supported through signals, not as raw product selector fields. For simple one-key mappings, browse the custom_targeting_key and custom_targeting_value ad-server targeting types and create a custom_key_value signal. For composite logic, create a gam_targeting_groups signal: groups are OR’d together, criteria inside a group are AND’d together, and multiple values in one criterion are OR’d by GAM for that key. Before answering whether a source supports key-value targeting, read the source’s signal capabilities. A GAM-backed ad server source can advertise mappingKinds[].mappingKind: "gam_targeting_groups" and API targeting types such as custom_targeting_key and custom_targeting_value. If those capabilities are present, tell the operator that key-value targeting is supported through signals, then validate and create the signal.

​

Property and tag mappings

Some large networks map each publisher property or site in GAM with key-values instead of breaking out placements or ad units per property. Sellers can now author and preview those source-scoped mappings, including tag-based mappings, through the property and tag mapping task. This authoring slice records the seller’s execution address. It does not replace publisher_properties, grant publisher authorization, or claim that downstream media-buy execution consumes the mapping yet. Do not use GAM key-values as a substitute for publisher_properties, and do not describe a mapping as proof of which properties a product sells. Use key-values for source targeting where the source capabilities support it; use ad units, placements, or declared publisher properties for the product’s inventory and property definition. See Ad-server signals for the gam_targeting_groups request shape and validation flow.

​

Related