getaero-io/gtm-eng-skills / skills/deepline-ads-audiences
deepline-ads-audiences
VerifiedUse this skill when building, enriching, auditing, or uploading B2B paid ads audiences to Google Customer Match, Meta/Facebook Custom Audiences, or LinkedIn Matched Audiences. Triggers on phrases like '/deepline-ads-audience', '/deepline-ads-audiences', 'upload this audience', 'create custom audiences', 'personal email hashes', 'increase Facebook match rate', 'Google ads audience', 'Meta audience', 'FB audience', or any workflow that turns CRM/customer/contact data into paid ads upload lists. Skip for outbound prospecting sequences, cold email, or pure campaign copywriting.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 37.6 KB |
| plays/audit-no-double-hash.play.ts | script | 3.1 KB |
| plays/build-contactout-hash-pool.play.ts | script | 9.7 KB |
| plays/build-hash-only-audience.play.ts | script | 7.0 KB |
| plays/enrich-audience-waterfall.play.ts | script | 16.7 KB |
| plays/evaluate-leadmagic-personal-email.play.ts | script | 3.7 KB |
| plays/evaluate-personal-email-provider.play.ts | script | 13.8 KB |
| plays/report-google-coverage-lift.play.ts | script | 8.6 KB |
| plays/shared/audience-hash.ts | script | 10.8 KB |
| plays/upload-facebook-google-hash-only-audience.play.ts | script | 5.4 KB |
| plays/upload-google-hash-only-audience.play.ts | script | 3.3 KB |
| recipes/enrich-and-upload-facebook-google.md | markdown | 6.9 KB |
| recipes/max-coverage-audience.md | markdown | 11.3 KB |
| recipes/sample-abm-segment-example.md | markdown | 4.9 KB |
| shared/audience-basics.md | markdown | 4.5 KB |
| shared/contactout-hash-pool.md | markdown | 7.9 KB |
| shared/meta-connection.md | markdown | 3.7 KB |
| shared/upload-failure-modes.md | markdown | 9.3 KB |
| skill-metadata.json | config | 3.3 KB |
shared/meta-connection.md
View on GitHub# Meta connection
Meta Audiences connects with a system user token from the customer's own
Business Manager. The dashboard does not offer Meta Login for Business for new
connections: until Meta approves Deepline's App Review, that login only grants
the ads permissions to people with a role on Deepline's own Meta app. Existing
Login for Business connections keep working.
The customer does the Meta steps; nothing on Meta's side can be done for them.
Send them the [setup guide](https://deepline.com/docs/features/bring-your-own-keys#meta-audiences)
and walk them through it:
1. [Create a Business app](https://developers.facebook.com/apps/creation/) with
the use case "Create & manage ads with Marketing API", connected to the
Business portfolio that owns the ad account.
2. In [System users](https://business.facebook.com/settings/system-users),
add a system user (the default Employee role is enough). Meta enables Add only after an app
belongs to the portfolio.
3. Assign the ad account with Manage campaigns (ads) and the app with Develop
app. Full control is not needed.
4. Generate a token for that app with only `ads_management` and `ads_read`,
expiration Never. Meta preselects 60 days; a 60-day token stops working
without warning.
5. Accept the Custom Audience terms once per ad account at
`https://business.facebook.com/ads/manage/customaudiences/tos/?act=<ad account ID>`.
6. Paste the token in Dashboard -> Integrations -> Meta Audiences -> Connect.
`business_management` is not needed.
## Custom Audience terms
Audience creation fails until a person in the business accepts Meta's Custom
Audience terms for that ad account. Deepline records the state per account at
setup: `GET /api/v2/integrations/meta_audiences/accounts` (org admin session
or admin-owned API key) returns `customAudienceTermsAccepted` on each account
(`false` means not accepted, `null` means unknown). It reflects the last
discovery; `POST` to the same endpoint (the page's Refresh) discovers again,
so refresh after the customer accepts. Check it before the first `meta_audiences_create_audience`
on an account. When it is `false`, or create fails with "Custom audience terms
not accepted", send the customer
`https://business.facebook.com/ads/manage/customaudiences/tos/?act=<ad account ID>`
and wait for them to accept; do not retry the create in a loop. Never ask the customer to paste a token
into chat; the dashboard field is the only place it goes.
## Errors
| Error | Cause | Fix |
| --------------------------------------------------------------------------- | ------------------------------------------------------- | -------------------------------------------------------------------- |
| `(#100) Unsupported get request`, `Requires business_management permission` | A Login for Business token without the ads permissions. | Reconnect with a system user token. |
| "This token can reach no ad accounts" | No ad account assigned to the system user. | Assign it, then select Connect with token again with the same token. |
| `(#190)` / "Error validating access token" | Revoked or truncated token. | Generate and paste a new token. |
| "Custom audience terms not accepted" on create | Custom Audience terms not accepted for that account. | Send the terms link from the error; the customer accepts once. |
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |