landing_page_url on save_creative) and to
click-URL parameter values (macroAdditions on a creative,
tracking.macroAdditions on an advertiser or campaign). For how click-URL
parameters work in general, see
Click-URL parameters.
Tokens Apostra fills
Whether a seller fills a given token is up to that seller. A token the seller
does not fill is removed from the landing page URL rather than left as written.
A creative on a media buy that went to the seller in the last hour is not sent
to the seller until the buy’s package exists, so
{PACKAGE_ID} already has its value in the
copy the seller receives. A seller whose ad server cannot change a creative
that is already serving does not receive a second, changed copy.
Vendor tokens Apostra rewrites for you
A token in another platform’s syntax is rewritten to the AdCP token when you save. The URL you wrote is kept as written; the click tracker carries the rewritten form.
For example, a Campaign Manager 360 click tracker landing such as
https://ad.doubleclick.net/ddm/trackclk/N123.456/B789;gdpr=${GDPR};gdpr_consent=${GDPR_CONSENT_755};ltd=
reaches the seller with gdpr={GDPR} and gdpr_c={GDPR_CONSENT} on Apostra’s
click tracker, so the seller’s ad server fills both.
The AdCP token {GDPR_CONSENT} names no vendor, and Google Ad Manager’s consent
macro needs one. So for a seller that writes to Google Ad Manager, Apostra’s
click tracker declares the vendor your landing page names: its
macro_declarations ask the seller to write Google Ad Manager’s own token,
${GDPR_CONSENT_755}, in place of {GDPR_CONSENT}. The seller sends
gdpr=${GDPR}&gdpr_c=${GDPR_CONSENT_755} to Google Ad Manager, which fills both
on each click. When your landing page names no vendor, a seller that writes to
Google Ad Manager receives no consent parameter, because Google Ad Manager could
not fill it.
Any other seller receives {GDPR_CONSENT} to fill itself, unless the seller’s
format option lists the macros it fills and consent is not among them. Apostra
then removes the consent parameter from its click tracker, because that seller
would not fill it, and the landing page receives no consent string. The same rule
applies to every serve-time token on Apostra’s trackers.
Apostra’s click tracker has one consent parameter, so a landing page can name
one consent vendor. Name the vendor in the landing page URL, not in a click-URL
parameter: a parameter is saved with its consent token rewritten to
{GDPR_CONSENT}, so its vendor would be lost (see the table below).
Braces around any other name, such as {sku} or {PRODUCT_ID}, are left exactly
as you wrote them.
Tokens Apostra refuses at save
A save with any of these is refused with aVALIDATION_ERROR. The error names each
token, the reason, and what to do. Nothing is saved.
Meta’s own dynamic URL parameters
A creative Apostra imports from your Meta ad account keeps the dynamic URL parameters Meta fills when it serves the ad, such as{{campaign.name}},
{{adset.id}}, {{ad.id}} or {{placement}}. Apostra stores the landing page URL exactly as you wrote it in
Meta, and records on the creative that these parameters are Meta’s and that Meta
fills them. Only the eight parameters Meta documents are kept:
{{campaign.id}}, {{campaign.name}}, {{adset.id}}, {{adset.name}},
{{ad.id}}, {{ad.name}}, {{placement}} and {{site_source_name}}. Any other
{{...}} is refused as in the table above, on an imported creative too.
Nothing but Meta fills these parameters, so a creative that carries them can go
to Meta only. When you send it to a seller other than Meta, Apostra leaves that
creative out of the send, delivers the other creatives in the same send, and
reports each creative it left out. The report has one error per creative with the
code META_LINK_PARAMETERS_NOT_SENDABLE, naming the creative and the
parameters, and the creative shows as rejected for that seller. If every creative
in the send carries Meta’s parameters, nothing is sent to that seller. Edit the
landing page URL to remove the parameters, or send the creative to Meta only.
Sending it to Meta passes the URL through unchanged.
You can keep editing an imported creative. A save that sends the landing page URL
again with the parameters recorded at import succeeds. A save that adds another
of Meta’s parameters, and any save of a creative that is not imported from Meta,
is checked as before.