agentleFS
itsryanarmaniitsryanarmani/skills/ads-stackadapt/SKILL.md

ads-stackadapt

Skill1 starsChanged 4 days agoMITView on GitHub

Set up StackAdapt conversion tracking for a web app — client tag or pixel, server-side conversion path, OAuth or partner access, audience and retargeting rules, deduplication, and reporting checks. Use when integrating StackAdapt, debugging 0 conversions, or running a small paid test.

1 other project uses a version of this.

Adopted by

Most recently taken up by

The file

Show its rules and text

We split this skill into the rules it gives an agent

15 rules. About 0 are common, 14 are distinctive, and 1 is very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈14

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 1

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Very specific:

    Use STACKADAPT_PIXEL_ID or STACKADAPT_TAG_ID for the public identifier, as the vendor names it.

    line 30
  2. Distinctive:

    Do not invent a CAPI body from an SDK or old help article.

    line 40
  3. Distinctive:

    Create the advertiser, pixel, data source, or API connection.

    line 45
  4. Distinctive:

    Keep the credential in a server-side secret store.

    line 47
  5. Distinctive:

    Use the platform's official site-audience, customer-list, CRM, or conversion audience workflow.

    line 61
  6. Distinctive:

    Verify the audience status in the console or with the official read endpoint.

    line 70
  7. Distinctive:

    Use the payment transaction ID as the shared event ID.

    line 75
  8. Distinctive:

    Do not require a click ID before sending a server event.

    line 76
  9. Distinctive:

    Read the vendor's current timestamp unit.

    line 79
  10. Distinctive:

    Run one audience, geo, creative, and conversion goal per test.

    line 83
  11. Distinctive:

    Start with traffic or click optimization when no conversion history exists.

    line 85
  12. Distinctive:

    Check the campaign's review, billing, and delivery status before increasing spend.

    line 87
  13. Distinctive:

    Use the official test-event view, status endpoint, or reporting API.

    line 93
  14. Distinctive:

    Keep this adapter thin. A vendor error must not fail checkout or a payment webhook.

    line 104
  15. Distinctive:

    Do not infer attribution from the presence of an event in a debug view.

    line 112

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

StackAdapt

This skill is a product-agnostic adapter for the shared conversion hub. It maps one canonical event to the vendor event, sends it after payment confirmation, and makes an absent STACKADAPT_TOKEN a logged no-op.

The three-layer conversion model

  1. Client tag. Load the vendor pixel or approved data source on the browser.
  2. Server conversion path. Send the canonical event from the server when the payment provider confirms the charge. Use one stable event ID across both paths.
  3. Attribution layer. Configure the vendor conversion action and reporting surface. A 2xx response does not prove that an ad received credit.

Official tracking reference: StackAdapt pixel or measurement docs.

Client tag

Install the exact tag generated by the vendor console. Do not copy an old blog snippet or mirror a vendor script through your own CDN.

⚠ UNVERIFIED — confirm the current init call, script origin, pixel ID field, and purchase event shape at StackAdapt tracking reference.

Use STACKADAPT_PIXEL_ID or STACKADAPT_TAG_ID for the public identifier, as the vendor names it. Send event_id when the platform supports client/server deduplication.

Server-side conversion API

Server endpoint: GET https://www.stackadapt.com/ is an official API or console root, not a claimed conversion endpoint.

⚠ UNVERIFIED — confirm the current conversion POST path, authorization header, timestamp unit, deduplication field, and JSON payload at StackAdapt API documentation.

Do not invent a CAPI body from an SDK or old help article.

Get a token and validate it

  1. Open the official StackAdapt console or request access from the account team.
  2. Create the advertiser, pixel, data source, or API connection.
  3. Generate the credential required by the official API. Store it as STACKADAPT_TOKEN.
  4. Keep the credential in a server-side secret store.

StackAdapt integration details are account and partner gated. This entry remains a stub until StackAdapt publishes a stable public API reference for pixel, CAPI, token, and audience contracts.

Token validation:

curl -sS 'https://www.stackadapt.com/' -H "Authorization: Bearer $STACKADAPT_TOKEN"

⚠ UNVERIFIED — confirm the endpoint, token type, and required headers at StackAdapt authentication reference before using this command.

Audience, retargeting, and lookalike expansion

Use the platform's official site-audience, customer-list, CRM, or conversion audience workflow. Normalize email by trimming and lowercasing before SHA-256 hashing when the official product requires hashed contacts.

StackAdapt integration details are account and partner gated. This entry remains a stub until StackAdapt publishes a stable public API reference for pixel, CAPI, token, and audience contracts.

⚠ UNVERIFIED — confirm the current customer-list fields, minimum usable size, match-rate rules, lookalike product, and audience eligibility at StackAdapt audience documentation.

Verify the audience status in the console or with the official read endpoint. A successful upload response is not proof that the audience can serve.

Deduplication and event rules

  • Use the payment transaction ID as the shared event ID.
  • Do not require a click ID before sending a server event.
  • Persist the click ID in first-party storage when the platform requires it later.
  • Hash first-party identifiers only after consent. Never send raw email or phone data.
  • Read the vendor's current timestamp unit. Do not assume seconds or milliseconds.

Small-budget campaign launch

  • Run one audience, geo, creative, and conversion goal per test.
  • Disable broad expansion, network, placement, and automatic targeting defaults until they fit the hypothesis.
  • Start with traffic or click optimization when no conversion history exists.
  • Set a hard spend cap where the product supports one.
  • Check the campaign's review, billing, and delivery status before increasing spend.
  • ⚠ UNVERIFIED — confirm current bid floors, learning thresholds, budget minimums, and default placements at StackAdapt API documentation.

Verification

Use the official test-event view, status endpoint, or reporting API. Reconcile the result with payment-provider succeeded charges. A zero count before deploy is expected. A real charge with zero platform events is a tracking failure.

⚠ UNVERIFIED — confirm the current event-test or reporting query at StackAdapt API documentation.

Hub conventions

Pair this skill with ad-conversion-hub for canonical taxonomy, consent, hashing, secret names, and multi-platform dispatch. Pair it with ad-experiments for seed sizing, narrow tests, PII-export authorization, and ground truth. Keep this adapter thin. A vendor error must not fail checkout or a payment webhook.

Common pitfalls

  • A browser tag can fire while server events remain absent.
  • A successful upload can return partial warnings or a non-servable audience.
  • Partner-gated APIs often need account approval before a token works.
  • Build-time secrets need a redeploy after they change.
  • Do not infer attribution from the presence of an event in a debug view.

Security

Load client code only from the vendor's official HTTPS origin. Keep STACKADAPT_TOKEN server-side. Never log or commit it. Send only consented and hashed identifiers.

Official sources checked (2026-08-11)

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.