Skip to main content
Many media partners can say they sell the same property. A publisher’s sales house, a rep firm, a network and a reseller can all claim it. Apostra does not take their word for it. It reads what the property’s own domain says, and reports that.

What a claim is

A claim is a property, shown as the domain a media partner registered, that the media partner says it sells. Apostra decides the status of each claim from the adagents.json file on the property’s own domain, as Apostra last read it. What a media partner says about itself never changes a status. A listing is in effect when today is on or after its effective_from and before its effective_until. A listing with neither date is always in effect. A listing that has expired, or has not started yet, stops counting on its own: the domain’s other listings, and their statuses, are unaffected. A date Apostra cannot parse counts as outside the window. An unread file is never a not_authorized. A file that was never read, failed to read, or is waiting to be read again leaves the claim unverified until Apostra reads it. An authorized claim carries what the file states, exactly as AdCP names it: delegation_type, exclusive, countries and placement_ids. A field the file leaves out is left out of the claim too.

Read a media partner’s claims

Every seller read, from get and from search with kind: "seller", carries propertyClaims:
  • byStatus counts the claims as authorized, unverified and not_authorized.
  • authorizedByDelegationType counts the authorized claims as direct, delegated and ad_network. A listing that states no delegation_type counts as authorized and under none of the three.
To list the claims, call get with kind: "seller", the media partner’s id and include: ["propertyClaims"]. It returns at most 100, authorized first, then unverified, then not authorized, each group in order of property domain. propertyClaimsOmitted counts the claims the list leaves out. Each claim has the property ({ "type": "domain", "value": "nu.nl" }), its status, and for an authorized claim the file’s own fields.

Networks and their members

A media partner can be a member of a network. Apostra finds membership in the properties’ own files, and nobody types it in. A media partner is a member of a network when a property’s adagents.json authorizes the media partner directly (direct) and authorizes the network as delegated or ad_network. An unverified claim never makes a member.
  • memberCount is how many members a media partner has.
  • memberOf lists the seller Account ids of the networks a media partner belongs to.
  • search with kind: "seller" and filter: { "memberOf": <seller Account id> } lists a network’s members, page by page.
Only media partners a buyer can list count as members.

How media partners are ranked for a property

Search by property and country, filter.property and filter.country, is not available yet. When it is, it will list every media partner that claims the property in that country, with propertyAccess holding its claim, and rank them by what the property’s own file says:
  1. Authorized and exclusive for that country across the property, such as its sales house in that market.
  2. Authorized, not exclusive, for the whole property: other direct sellers, sales houses and reps.
  3. Authorized for some placements only, labelled with those placements.
  4. Authorized resellers: ad_network, not exclusive, no placement limit.
  5. Unverified claims, labelled unverified.
A not_authorized claim is never offered as a way to buy the property. It shows on the media partner’s own read. An authorization limited to other countries does not match the country asked. Many media partners can hold claims to one property, so the answer is a list and never a single owner.

If a status or a membership is wrong

The property’s own file is the authority, so the fix starts there. A publisher who wants a media partner to read authorized adds it to the authorized_agents list in its adagents.json and keeps the file reachable. Apostra reads the new file the next time it reads that domain, and the status follows. If you think Apostra read a file wrongly, or a status does not match what the file says today, tell Apostra through your usual contact. Staff review the dispute in their supply review. A media partner that disagrees with its own status disputes it the same way.