Skip to main content
A landing page URL, and the click-URL parameters you add to it, can carry tokens that stand for a value only known when someone clicks: the cache-buster, the page’s domain, whether GDPR applies. Apostra wraps the landing page in its click tracker. The seller’s ad server fills each token on that tracker, and Apostra’s click redirect copies the filled value into your landing page URL. That only works for a token the tracker has a parameter for. A token it has none for would reach your landing page empty or as written, and your analytics would record a blank where you expected a value. So Apostra checks every token when you save, and either carries it or refuses the save and tells you which token and why. It never accepts a token and drops it later. This applies to the landing page URL (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 a VALIDATION_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.

Creatives saved before this check

A creative saved before this check keeps working as it was saved. Apostra does not rewrite its landing page URL or parameters. A save that sends a landing page URL or click-URL parameters again, even unchanged, is checked like a new one. If that refuses a creative that was already live, apply the fix in the table and save again.