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 theadagents.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
Everyseller read, from get and from search with kind: "seller",
carries propertyClaims:
byStatuscounts the claims asauthorized,unverifiedandnot_authorized.authorizedByDelegationTypecounts the authorized claims asdirect,delegatedandad_network. A listing that states nodelegation_typecounts as authorized and under none of the three.
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’sadagents.json authorizes the media partner directly
(direct) and authorizes the network as delegated or ad_network. An
unverified claim never makes a member.
memberCountis how many members a media partner has.memberOflists the seller Account ids of the networks a media partner belongs to.searchwithkind: "seller"andfilter: { "memberOf": <seller Account id> }lists a network’s members, page by page.
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:
- Authorized and exclusive for that country across the property, such as its sales house in that market.
- Authorized, not exclusive, for the whole property: other direct sellers, sales houses and reps.
- Authorized for some placements only, labelled with those placements.
- Authorized resellers:
ad_network, not exclusive, no placement limit. - Unverified claims, labelled unverified.
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 readauthorized 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.