- Spotify: the advertiser’s Spotify show, for podcast promotion.
- Meta: the Facebook Page the advertiser advertises as.
save_connection and its ownedLink input. Answering is optional. The connection works whether you answer, skip the
question or confirm there is nothing to link. This is available to accounts
with Creative Engines access.
The connection does not list the Facebook Pages an ad account can promote. Any
buyer can list the Pages one product can run as with search, using
kind: "wholesale_product", a filter with the advertiserId, the
productId and resourceKind: "platform_identity", and
include: ["executionResources"]. Each result’s providerId is a Page id,
with its name when Meta returns one. To use a Page on a buy, pass that id as
products[].pageId on save_media_buy.
What the connection shows
Read the connection withget(kind: "connection"). For each mapped advertiser,
ownedLinks says whether a show or Page is available to link, already linked,
or confirmed absent.
candidateCount is how many Facebook Pages Meta lets
the advertiser’s mapped ad account promote. linked lists the Pages the
advertiser’s brand profile names that are among them.
candidateCount and linked, and the rest of the connection still
reads.
Link a Spotify show
Pass the mapped advertiser, the existing Spotify connection, and the show URL. Apostra checks the link with Spotify and saves the show as anoffering
catalog item for that advertiser.
promotion_target_id.
Link a Facebook Page
Pass the mapped advertiser, the existing Meta connection, and the Page as either its facebook.com link (url) or its username (handle). Give one, not
both.
https://www.facebook.com/<username>https://www.facebook.com/<Page id>https://www.facebook.com/profile.php?id=<Page id>- a handle such as
chalklinesor@chalklines
brandProfile.stated.pages on save_advertiser), with its link and
name. Apostra
does not store Meta’s Page id. It matches the stated page against Meta’s list
again every time the connection is read, so a Page the ad account loses access
to stops showing as linked.
A creative session for a Meta image post uses the linked Page when the request
names no page_id. The Page is checked against the same live list first. A
page_id in the request always wins, and must also be one of the Pages the ad
account can promote. If the profile names no Page the ad account can still
promote, or names more than one, the session leaves the Page unset and you
choose it as before.
The save is refused, and nothing changes, when:
- the link or handle names no Page the ad account can promote. Give the ad account access to the Page in Meta, or link a Page it already lists;
- the link or handle names more than one of those Pages. Link the Page by its
facebook.com/<Page id>link instead; or - the brand profile already names a different Page the ad account can promote.
Confirm the advertiser has no Page, or remove that page with
save_advertiser, then link the new one.
Confirm there is nothing to link
If the advertiser has no Spotify show or no Facebook Page, save that fact instead. The connection stops offering the question until one is linked later."platform": "meta" and "kind": "page". Confirming that a
Spotify show is absent archives the advertiser’s linked Spotify shows.
Confirming that a Facebook Page is absent removes the Facebook pages from the
advertiser’s stated pages.