@koda-sl/baker-cli 0.22.0-dev.ecc541fb → 0.24.0-dev.55a07065
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +65 -9
- package/dist/cli.js +1 -1
- package/dist/commands/actions/create.d.ts +0 -5
- package/dist/commands/actions/create.d.ts.map +1 -1
- package/dist/commands/actions/create.js +0 -15
- package/dist/commands/actions/create.js.map +1 -1
- package/dist/commands/actions/update.d.ts +0 -5
- package/dist/commands/actions/update.d.ts.map +1 -1
- package/dist/commands/actions/update.js +3 -14
- package/dist/commands/actions/update.js.map +1 -1
- package/dist/commands/ads/index.d.ts.map +1 -1
- package/dist/commands/ads/index.js +8 -2
- package/dist/commands/ads/index.js.map +1 -1
- package/dist/commands/ads/meta/account.d.ts +11 -0
- package/dist/commands/ads/meta/account.d.ts.map +1 -0
- package/dist/commands/ads/meta/account.js +32 -0
- package/dist/commands/ads/meta/account.js.map +1 -0
- package/dist/commands/ads/meta/accounts.d.ts +20 -0
- package/dist/commands/ads/meta/accounts.d.ts.map +1 -0
- package/dist/commands/ads/meta/accounts.js +55 -0
- package/dist/commands/ads/meta/accounts.js.map +1 -0
- package/dist/commands/ads/meta/activities.d.ts +24 -0
- package/dist/commands/ads/meta/activities.d.ts.map +1 -0
- package/dist/commands/ads/meta/activities.js +44 -0
- package/dist/commands/ads/meta/activities.js.map +1 -0
- package/dist/commands/ads/meta/ads.d.ts +32 -0
- package/dist/commands/ads/meta/ads.d.ts.map +1 -0
- package/dist/commands/ads/meta/ads.js +54 -0
- package/dist/commands/ads/meta/ads.js.map +1 -0
- package/dist/commands/ads/meta/adsets.d.ts +28 -0
- package/dist/commands/ads/meta/adsets.d.ts.map +1 -0
- package/dist/commands/ads/meta/adsets.js +47 -0
- package/dist/commands/ads/meta/adsets.js.map +1 -0
- package/dist/commands/ads/meta/audiences.d.ts +20 -0
- package/dist/commands/ads/meta/audiences.d.ts.map +1 -0
- package/dist/commands/ads/meta/audiences.js +41 -0
- package/dist/commands/ads/meta/audiences.js.map +1 -0
- package/dist/commands/ads/meta/businesses.d.ts +12 -0
- package/dist/commands/ads/meta/businesses.d.ts.map +1 -0
- package/dist/commands/ads/meta/businesses.js +35 -0
- package/dist/commands/ads/meta/businesses.js.map +1 -0
- package/dist/commands/ads/meta/campaigns.d.ts +24 -0
- package/dist/commands/ads/meta/campaigns.d.ts.map +1 -0
- package/dist/commands/ads/meta/campaigns.js +48 -0
- package/dist/commands/ads/meta/campaigns.js.map +1 -0
- package/dist/commands/ads/meta/catalogs.d.ts +17 -0
- package/dist/commands/ads/meta/catalogs.d.ts.map +1 -0
- package/dist/commands/ads/meta/catalogs.js +37 -0
- package/dist/commands/ads/meta/catalogs.js.map +1 -0
- package/dist/commands/ads/meta/creatives.d.ts +24 -0
- package/dist/commands/ads/meta/creatives.d.ts.map +1 -0
- package/dist/commands/ads/meta/creatives.js +51 -0
- package/dist/commands/ads/meta/creatives.js.map +1 -0
- package/dist/commands/ads/meta/currency.d.ts +11 -0
- package/dist/commands/ads/meta/currency.d.ts.map +1 -0
- package/dist/commands/ads/meta/currency.js +31 -0
- package/dist/commands/ads/meta/currency.js.map +1 -0
- package/dist/commands/ads/meta/high-demand-periods.d.ts +17 -0
- package/dist/commands/ads/meta/high-demand-periods.d.ts.map +1 -0
- package/dist/commands/ads/meta/high-demand-periods.js +33 -0
- package/dist/commands/ads/meta/high-demand-periods.js.map +1 -0
- package/dist/commands/ads/meta/images.d.ts +24 -0
- package/dist/commands/ads/meta/images.d.ts.map +1 -0
- package/dist/commands/ads/meta/images.js +45 -0
- package/dist/commands/ads/meta/images.js.map +1 -0
- package/dist/commands/ads/meta/index.d.ts +2 -0
- package/dist/commands/ads/meta/index.d.ts.map +1 -0
- package/dist/commands/ads/meta/index.js +76 -0
- package/dist/commands/ads/meta/index.js.map +1 -0
- package/dist/commands/ads/meta/insights.d.ts +81 -0
- package/dist/commands/ads/meta/insights.d.ts.map +1 -0
- package/dist/commands/ads/meta/insights.js +178 -0
- package/dist/commands/ads/meta/insights.js.map +1 -0
- package/dist/commands/ads/meta/labels.d.ts +16 -0
- package/dist/commands/ads/meta/labels.d.ts.map +1 -0
- package/dist/commands/ads/meta/labels.js +34 -0
- package/dist/commands/ads/meta/labels.js.map +1 -0
- package/dist/commands/ads/meta/pixels.d.ts +33 -0
- package/dist/commands/ads/meta/pixels.d.ts.map +1 -0
- package/dist/commands/ads/meta/pixels.js +69 -0
- package/dist/commands/ads/meta/pixels.js.map +1 -0
- package/dist/commands/ads/meta/presets.d.ts +18 -0
- package/dist/commands/ads/meta/presets.d.ts.map +1 -0
- package/dist/commands/ads/meta/presets.js +110 -0
- package/dist/commands/ads/meta/presets.js.map +1 -0
- package/dist/commands/ads/meta/preview.d.ts +32 -0
- package/dist/commands/ads/meta/preview.d.ts.map +1 -0
- package/dist/commands/ads/meta/preview.js +90 -0
- package/dist/commands/ads/meta/preview.js.map +1 -0
- package/dist/commands/ads/meta/shared.d.ts +12 -0
- package/dist/commands/ads/meta/shared.d.ts.map +1 -0
- package/dist/commands/ads/meta/shared.js +59 -0
- package/dist/commands/ads/meta/shared.js.map +1 -0
- package/dist/commands/ads/meta/studies.d.ts +24 -0
- package/dist/commands/ads/meta/studies.d.ts.map +1 -0
- package/dist/commands/ads/meta/studies.js +56 -0
- package/dist/commands/ads/meta/studies.js.map +1 -0
- package/dist/env.d.ts +1 -0
- package/dist/env.d.ts.map +1 -1
- package/dist/env.js +1 -0
- package/dist/env.js.map +1 -1
- package/dist/error-handler.d.ts +1 -1
- package/dist/error-handler.d.ts.map +1 -1
- package/dist/error-handler.js +3 -0
- package/dist/error-handler.js.map +1 -1
- package/package.json +1 -1
|
@@ -0,0 +1,45 @@
|
|
|
1
|
+
import { defineCommand } from "citty";
|
|
2
|
+
import { apiGet } from "../../../client.js";
|
|
3
|
+
import { writeAdsJson, writeAdsOutput } from "../output.js";
|
|
4
|
+
import { csvOrJson, handleMetaError, resolveAccountIdArg } from "./shared.js";
|
|
5
|
+
export const imagesCommand = defineCommand({
|
|
6
|
+
meta: {
|
|
7
|
+
name: "images",
|
|
8
|
+
description: `List ad images in a Meta ad account. AdImages are keyed by per-account hash — references in
|
|
9
|
+
creatives use image_hash, not URL.
|
|
10
|
+
|
|
11
|
+
Examples:
|
|
12
|
+
baker ads meta images --account-id act_123
|
|
13
|
+
baker ads meta images --account-id act_123 --hash a1b2c3...`,
|
|
14
|
+
},
|
|
15
|
+
args: {
|
|
16
|
+
"account-id": { type: "string", description: "Meta ad account ID" },
|
|
17
|
+
hash: { type: "string", description: "Filter to one image hash" },
|
|
18
|
+
limit: { type: "string", description: "Max rows (default 500)" },
|
|
19
|
+
"skip-cache": { type: "boolean", description: "Bypass server-side cache" },
|
|
20
|
+
output: { type: "string", description: "Output format", default: "json" },
|
|
21
|
+
},
|
|
22
|
+
run: async ({ args }) => {
|
|
23
|
+
const accountId = resolveAccountIdArg(args);
|
|
24
|
+
try {
|
|
25
|
+
const params = { "account-id": accountId };
|
|
26
|
+
if (args.hash)
|
|
27
|
+
params.hash = args.hash;
|
|
28
|
+
if (args.limit)
|
|
29
|
+
params.limit = args.limit;
|
|
30
|
+
if (args["skip-cache"])
|
|
31
|
+
params["skip-cache"] = "true";
|
|
32
|
+
const data = await apiGet("/api/ads/meta/images", params);
|
|
33
|
+
const fmt = csvOrJson(args);
|
|
34
|
+
if (fmt !== "json") {
|
|
35
|
+
writeAdsOutput(data, fmt);
|
|
36
|
+
return;
|
|
37
|
+
}
|
|
38
|
+
writeAdsJson({ ok: true, data });
|
|
39
|
+
}
|
|
40
|
+
catch (err) {
|
|
41
|
+
handleMetaError(err);
|
|
42
|
+
}
|
|
43
|
+
},
|
|
44
|
+
});
|
|
45
|
+
//# sourceMappingURL=images.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"images.js","sourceRoot":"","sources":["../../../../src/commands/ads/meta/images.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AACtC,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC5D,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAE9E,MAAM,CAAC,MAAM,aAAa,GAAG,aAAa,CAAC;IACzC,IAAI,EAAE;QACJ,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE;;;;;8DAK6C;KAC3D;IACD,IAAI,EAAE;QACJ,YAAY,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,oBAAoB,EAAE;QACnE,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,0BAA0B,EAAE;QACjE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,wBAAwB,EAAE;QAChE,YAAY,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,0BAA0B,EAAE;QAC1E,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,EAAE;KAC1E;IACD,GAAG,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE;QACtB,MAAM,SAAS,GAAG,mBAAmB,CAAC,IAAI,CAAC,CAAC;QAC5C,IAAI,CAAC;YACH,MAAM,MAAM,GAA2B,EAAE,YAAY,EAAE,SAAS,EAAE,CAAC;YACnE,IAAI,IAAI,CAAC,IAAI;gBAAE,MAAM,CAAC,IAAI,GAAG,IAAI,CAAC,IAAc,CAAC;YACjD,IAAI,IAAI,CAAC,KAAK;gBAAE,MAAM,CAAC,KAAK,GAAG,IAAI,CAAC,KAAe,CAAC;YACpD,IAAI,IAAI,CAAC,YAAY,CAAC;gBAAE,MAAM,CAAC,YAAY,CAAC,GAAG,MAAM,CAAC;YACtD,MAAM,IAAI,GAAG,MAAM,MAAM,CAAiC,sBAAsB,EAAE,MAAM,CAAC,CAAC;YAC1F,MAAM,GAAG,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;YAC5B,IAAI,GAAG,KAAK,MAAM,EAAE,CAAC;gBACnB,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;gBAC1B,OAAO;YACT,CAAC;YACD,YAAY,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QACnC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,eAAe,CAAC,GAAG,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;CACF,CAAC,CAAC"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/commands/ads/meta/index.ts"],"names":[],"mappings":"AAoBA,eAAO,MAAM,WAAW,qDAuDtB,CAAC"}
|
|
@@ -0,0 +1,76 @@
|
|
|
1
|
+
import { defineCommand } from "citty";
|
|
2
|
+
import { accountCommand } from "./account.js";
|
|
3
|
+
import { accountsCommand } from "./accounts.js";
|
|
4
|
+
import { activitiesCommand } from "./activities.js";
|
|
5
|
+
import { adsListCommand } from "./ads.js";
|
|
6
|
+
import { adsetsCommand } from "./adsets.js";
|
|
7
|
+
import { audiencesCommand } from "./audiences.js";
|
|
8
|
+
import { businessesCommand } from "./businesses.js";
|
|
9
|
+
import { campaignsCommand } from "./campaigns.js";
|
|
10
|
+
import { catalogsCommand } from "./catalogs.js";
|
|
11
|
+
import { creativesCommand } from "./creatives.js";
|
|
12
|
+
import { currencyCommand } from "./currency.js";
|
|
13
|
+
import { highDemandPeriodsCommand } from "./high-demand-periods.js";
|
|
14
|
+
import { imagesCommand } from "./images.js";
|
|
15
|
+
import { insightsCommand } from "./insights.js";
|
|
16
|
+
import { labelsCommand } from "./labels.js";
|
|
17
|
+
import { pixelsCommand } from "./pixels.js";
|
|
18
|
+
import { previewCommand } from "./preview.js";
|
|
19
|
+
import { studiesCommand } from "./studies.js";
|
|
20
|
+
export const metaCommand = defineCommand({
|
|
21
|
+
meta: {
|
|
22
|
+
name: "meta",
|
|
23
|
+
description: `Meta Marketing API (Facebook + Instagram ads).
|
|
24
|
+
|
|
25
|
+
Discovery:
|
|
26
|
+
baker ads meta accounts — accounts in this company's connected scope
|
|
27
|
+
baker ads meta accounts --include-all — every account the token can see
|
|
28
|
+
baker ads meta businesses — Business Manager IDs
|
|
29
|
+
|
|
30
|
+
Account-scoped:
|
|
31
|
+
baker ads meta account --account-id act_123
|
|
32
|
+
baker ads meta currency --account-id act_123
|
|
33
|
+
baker ads meta campaigns --account-id act_123 --effective-status ACTIVE
|
|
34
|
+
baker ads meta adsets --campaign-id 6123
|
|
35
|
+
baker ads meta ads --account-id act_123 --effective-status ACTIVE
|
|
36
|
+
baker ads meta creatives --account-id act_123
|
|
37
|
+
baker ads meta images --account-id act_123
|
|
38
|
+
baker ads meta labels --account-id act_123
|
|
39
|
+
baker ads meta audiences --account-id act_123
|
|
40
|
+
baker ads meta pixels --account-id act_123
|
|
41
|
+
baker ads meta activities --account-id act_123 --days 14
|
|
42
|
+
|
|
43
|
+
Insights + previews:
|
|
44
|
+
baker ads meta insights --object act_123 --preset campaign-performance
|
|
45
|
+
baker ads meta insights --object act_123 --preset placement-breakdown --async
|
|
46
|
+
baker ads meta preview --creative-id 6123 --ad-format MOBILE_FEED_STANDARD --out-file /tmp/p.html
|
|
47
|
+
|
|
48
|
+
Business-scoped:
|
|
49
|
+
baker ads meta studies --business-id 12345
|
|
50
|
+
baker ads meta catalogs --business-id 12345
|
|
51
|
+
|
|
52
|
+
Other:
|
|
53
|
+
baker ads meta high-demand-periods --campaign-id 6123`,
|
|
54
|
+
},
|
|
55
|
+
subCommands: {
|
|
56
|
+
accounts: accountsCommand,
|
|
57
|
+
account: accountCommand,
|
|
58
|
+
currency: currencyCommand,
|
|
59
|
+
businesses: businessesCommand,
|
|
60
|
+
campaigns: campaignsCommand,
|
|
61
|
+
adsets: adsetsCommand,
|
|
62
|
+
ads: adsListCommand,
|
|
63
|
+
creatives: creativesCommand,
|
|
64
|
+
images: imagesCommand,
|
|
65
|
+
labels: labelsCommand,
|
|
66
|
+
audiences: audiencesCommand,
|
|
67
|
+
pixels: pixelsCommand,
|
|
68
|
+
studies: studiesCommand,
|
|
69
|
+
catalogs: catalogsCommand,
|
|
70
|
+
"high-demand-periods": highDemandPeriodsCommand,
|
|
71
|
+
activities: activitiesCommand,
|
|
72
|
+
insights: insightsCommand,
|
|
73
|
+
preview: previewCommand,
|
|
74
|
+
},
|
|
75
|
+
});
|
|
76
|
+
//# sourceMappingURL=index.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/commands/ads/meta/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AACtC,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9C,MAAM,CAAC,MAAM,WAAW,GAAG,aAAa,CAAC;IACvC,IAAI,EAAE;QACJ,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wDA8BuC;KACrD;IACD,WAAW,EAAE;QACX,QAAQ,EAAE,eAAe;QACzB,OAAO,EAAE,cAAc;QACvB,QAAQ,EAAE,eAAe;QACzB,UAAU,EAAE,iBAAiB;QAC7B,SAAS,EAAE,gBAAgB;QAC3B,MAAM,EAAE,aAAa;QACrB,GAAG,EAAE,cAAc;QACnB,SAAS,EAAE,gBAAgB;QAC3B,MAAM,EAAE,aAAa;QACrB,MAAM,EAAE,aAAa;QACrB,SAAS,EAAE,gBAAgB;QAC3B,MAAM,EAAE,aAAa;QACrB,OAAO,EAAE,cAAc;QACvB,QAAQ,EAAE,eAAe;QACzB,qBAAqB,EAAE,wBAAwB;QAC/C,UAAU,EAAE,iBAAiB;QAC7B,QAAQ,EAAE,eAAe;QACzB,OAAO,EAAE,cAAc;KACxB;CACF,CAAC,CAAC"}
|
|
@@ -0,0 +1,81 @@
|
|
|
1
|
+
export declare const insightsCommand: import("citty").CommandDef<{
|
|
2
|
+
readonly object: {
|
|
3
|
+
readonly type: "string";
|
|
4
|
+
readonly description: "Object ID — act_<id> for account, or campaign/adset/ad ID";
|
|
5
|
+
readonly required: true;
|
|
6
|
+
};
|
|
7
|
+
readonly level: {
|
|
8
|
+
readonly type: "string";
|
|
9
|
+
readonly description: "account|campaign|adset|ad";
|
|
10
|
+
};
|
|
11
|
+
readonly fields: {
|
|
12
|
+
readonly type: "string";
|
|
13
|
+
readonly description: "Comma-separated fields list";
|
|
14
|
+
};
|
|
15
|
+
readonly preset: {
|
|
16
|
+
readonly type: "string";
|
|
17
|
+
readonly description: "Insights preset name";
|
|
18
|
+
};
|
|
19
|
+
readonly "list-presets": {
|
|
20
|
+
readonly type: "boolean";
|
|
21
|
+
readonly description: "List available presets and exit";
|
|
22
|
+
};
|
|
23
|
+
readonly "date-preset": {
|
|
24
|
+
readonly type: "string";
|
|
25
|
+
readonly description: "Meta date preset (last_7d, last_28d, today, ...)";
|
|
26
|
+
};
|
|
27
|
+
readonly since: {
|
|
28
|
+
readonly type: "string";
|
|
29
|
+
readonly description: "Custom start date YYYY-MM-DD";
|
|
30
|
+
};
|
|
31
|
+
readonly until: {
|
|
32
|
+
readonly type: "string";
|
|
33
|
+
readonly description: "Custom end date YYYY-MM-DD";
|
|
34
|
+
};
|
|
35
|
+
readonly "time-increment": {
|
|
36
|
+
readonly type: "string";
|
|
37
|
+
readonly description: "1 (day) | monthly | all_days";
|
|
38
|
+
};
|
|
39
|
+
readonly breakdowns: {
|
|
40
|
+
readonly type: "string";
|
|
41
|
+
readonly description: "Comma-separated breakdowns";
|
|
42
|
+
};
|
|
43
|
+
readonly "action-breakdowns": {
|
|
44
|
+
readonly type: "string";
|
|
45
|
+
readonly description: "Comma-separated action_breakdowns";
|
|
46
|
+
};
|
|
47
|
+
readonly filtering: {
|
|
48
|
+
readonly type: "string";
|
|
49
|
+
readonly description: "JSON array of {field,operator,value}";
|
|
50
|
+
};
|
|
51
|
+
readonly "attribution-windows": {
|
|
52
|
+
readonly type: "string";
|
|
53
|
+
readonly description: "Comma-separated. Only 1d_view, 1d_click, 7d_click, 28d_click work as of Jan 2026";
|
|
54
|
+
};
|
|
55
|
+
readonly "use-account-attribution": {
|
|
56
|
+
readonly type: "boolean";
|
|
57
|
+
readonly description: "Use account-saved attribution setting";
|
|
58
|
+
};
|
|
59
|
+
readonly "use-unified-attribution": {
|
|
60
|
+
readonly type: "boolean";
|
|
61
|
+
readonly description: "Use ad-set unified attribution setting";
|
|
62
|
+
};
|
|
63
|
+
readonly limit: {
|
|
64
|
+
readonly type: "string";
|
|
65
|
+
readonly description: "Max rows (default per preset)";
|
|
66
|
+
};
|
|
67
|
+
readonly async: {
|
|
68
|
+
readonly type: "boolean";
|
|
69
|
+
readonly description: "Submit as async job, poll, then dump results";
|
|
70
|
+
};
|
|
71
|
+
readonly "skip-cache": {
|
|
72
|
+
readonly type: "boolean";
|
|
73
|
+
readonly description: "Bypass server-side cache";
|
|
74
|
+
};
|
|
75
|
+
readonly output: {
|
|
76
|
+
readonly type: "string";
|
|
77
|
+
readonly description: "Output format";
|
|
78
|
+
readonly default: "json";
|
|
79
|
+
};
|
|
80
|
+
}>;
|
|
81
|
+
//# sourceMappingURL=insights.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"insights.d.ts","sourceRoot":"","sources":["../../../../src/commands/ads/meta/insights.ts"],"names":[],"mappings":"AAqHA,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA2F1B,CAAC"}
|
|
@@ -0,0 +1,178 @@
|
|
|
1
|
+
import { defineCommand } from "citty";
|
|
2
|
+
import { apiPost } from "../../../client.js";
|
|
3
|
+
import { writeAdsJson, writeAdsOutput } from "../output.js";
|
|
4
|
+
import { getPreset, listPresets } from "./presets.js";
|
|
5
|
+
import { csvOrJson, getDateRange, handleMetaError } from "./shared.js";
|
|
6
|
+
const POLL_INTERVAL_MS = 5_000;
|
|
7
|
+
const POLL_MAX_MS = 10 * 60_000;
|
|
8
|
+
function commaSplit(input) {
|
|
9
|
+
if (!input)
|
|
10
|
+
return undefined;
|
|
11
|
+
return input
|
|
12
|
+
.split(",")
|
|
13
|
+
.map((s) => s.trim())
|
|
14
|
+
.filter(Boolean);
|
|
15
|
+
}
|
|
16
|
+
function parseFiltering(raw) {
|
|
17
|
+
if (!raw)
|
|
18
|
+
return undefined;
|
|
19
|
+
try {
|
|
20
|
+
return JSON.parse(raw);
|
|
21
|
+
}
|
|
22
|
+
catch {
|
|
23
|
+
handleMetaError(new Error("Invalid --filtering JSON"));
|
|
24
|
+
}
|
|
25
|
+
}
|
|
26
|
+
function pickLevel(args, preset) {
|
|
27
|
+
const level = args.level ?? preset?.level;
|
|
28
|
+
if (!level) {
|
|
29
|
+
handleMetaError(new Error("--level is required (account|campaign|adset|ad)"));
|
|
30
|
+
}
|
|
31
|
+
return level;
|
|
32
|
+
}
|
|
33
|
+
function pickFields(fieldsArg, preset) {
|
|
34
|
+
const fields = fieldsArg ?? preset?.fields;
|
|
35
|
+
if (!fields || fields.length === 0) {
|
|
36
|
+
handleMetaError(new Error("--fields is required (comma-separated, e.g. impressions,spend,ctr)"));
|
|
37
|
+
}
|
|
38
|
+
return fields;
|
|
39
|
+
}
|
|
40
|
+
function applyDateRange(body, args, preset) {
|
|
41
|
+
const range = getDateRange(args);
|
|
42
|
+
if (range.datePreset)
|
|
43
|
+
body.datePreset = range.datePreset;
|
|
44
|
+
if (range.since)
|
|
45
|
+
body.since = range.since;
|
|
46
|
+
if (range.until)
|
|
47
|
+
body.until = range.until;
|
|
48
|
+
if (!body.datePreset && !(body.since && body.until)) {
|
|
49
|
+
body.datePreset = preset?.defaultDatePreset ?? "last_7d";
|
|
50
|
+
}
|
|
51
|
+
}
|
|
52
|
+
function buildBodyFromArgs(args, preset) {
|
|
53
|
+
const fieldsArg = commaSplit(args.fields);
|
|
54
|
+
const breakdowns = commaSplit(args.breakdowns);
|
|
55
|
+
const actionBreakdowns = commaSplit(args["action-breakdowns"]);
|
|
56
|
+
const attributionWindows = commaSplit(args["attribution-windows"]);
|
|
57
|
+
const body = {
|
|
58
|
+
object: args.object,
|
|
59
|
+
level: pickLevel(args, preset),
|
|
60
|
+
fields: pickFields(fieldsArg, preset),
|
|
61
|
+
timeIncrement: args["time-increment"],
|
|
62
|
+
breakdowns: breakdowns ?? preset?.breakdowns,
|
|
63
|
+
actionBreakdowns: actionBreakdowns ?? preset?.actionBreakdowns,
|
|
64
|
+
filtering: parseFiltering(args.filtering),
|
|
65
|
+
attributionWindows: attributionWindows ?? preset?.attributionWindows,
|
|
66
|
+
useAccountAttributionSetting: Boolean(args["use-account-attribution"]),
|
|
67
|
+
useUnifiedAttributionSetting: Boolean(args["use-unified-attribution"]),
|
|
68
|
+
limit: args.limit ? Number(args.limit) : preset?.defaultLimit,
|
|
69
|
+
skipCache: Boolean(args["skip-cache"]),
|
|
70
|
+
};
|
|
71
|
+
applyDateRange(body, args, preset);
|
|
72
|
+
return body;
|
|
73
|
+
}
|
|
74
|
+
async function pollAsync(reportRunId) {
|
|
75
|
+
const start = Date.now();
|
|
76
|
+
while (Date.now() - start < POLL_MAX_MS) {
|
|
77
|
+
const status = await apiPost(`/api/ads/meta/insights/async/status?report-run-id=${encodeURIComponent(reportRunId)}`, {});
|
|
78
|
+
if (status.async_status === "Job Completed")
|
|
79
|
+
return;
|
|
80
|
+
if (status.async_status === "Job Failed" || status.async_status === "Job Skipped") {
|
|
81
|
+
handleMetaError(new Error(`Async insights job ${status.async_status}`));
|
|
82
|
+
}
|
|
83
|
+
process.stderr.write(`Async insights ${status.async_status ?? "queued"} (${Math.round(status.async_percent_completion ?? 0)}%)…\n`);
|
|
84
|
+
await new Promise((resolve) => setTimeout(resolve, POLL_INTERVAL_MS));
|
|
85
|
+
}
|
|
86
|
+
handleMetaError(new Error("Async insights polling timed out after 10 minutes"));
|
|
87
|
+
}
|
|
88
|
+
export const insightsCommand = defineCommand({
|
|
89
|
+
meta: {
|
|
90
|
+
name: "insights",
|
|
91
|
+
description: `Run Meta Marketing API insights queries.
|
|
92
|
+
|
|
93
|
+
Synchronous unless --async is set, or auto-fallback if Meta returns a "too large" error.
|
|
94
|
+
Use presets for the marketing team's standard reports.
|
|
95
|
+
|
|
96
|
+
Presets (run with --preset <name>):
|
|
97
|
+
${listPresets()
|
|
98
|
+
.map((p) => ` ${p.name} — ${p.description}`)
|
|
99
|
+
.join("\n")}
|
|
100
|
+
|
|
101
|
+
Examples:
|
|
102
|
+
baker ads meta insights --object act_123 --level ad --fields impressions,spend --date-preset last_7d
|
|
103
|
+
baker ads meta insights --object 6123456 --preset campaign-performance
|
|
104
|
+
baker ads meta insights --object act_123 --preset placement-breakdown --since 2026-01-01 --until 2026-03-31 --async
|
|
105
|
+
baker ads meta insights --object act_123 --level ad --fields ad_id,impressions \\
|
|
106
|
+
--filtering '[{"field":"spend","operator":"GREATER_THAN","value":0}]'`,
|
|
107
|
+
},
|
|
108
|
+
args: {
|
|
109
|
+
object: {
|
|
110
|
+
type: "string",
|
|
111
|
+
description: "Object ID — act_<id> for account, or campaign/adset/ad ID",
|
|
112
|
+
required: true,
|
|
113
|
+
},
|
|
114
|
+
level: { type: "string", description: "account|campaign|adset|ad" },
|
|
115
|
+
fields: { type: "string", description: "Comma-separated fields list" },
|
|
116
|
+
preset: { type: "string", description: "Insights preset name" },
|
|
117
|
+
"list-presets": { type: "boolean", description: "List available presets and exit" },
|
|
118
|
+
"date-preset": { type: "string", description: "Meta date preset (last_7d, last_28d, today, ...)" },
|
|
119
|
+
since: { type: "string", description: "Custom start date YYYY-MM-DD" },
|
|
120
|
+
until: { type: "string", description: "Custom end date YYYY-MM-DD" },
|
|
121
|
+
"time-increment": { type: "string", description: "1 (day) | monthly | all_days" },
|
|
122
|
+
breakdowns: { type: "string", description: "Comma-separated breakdowns" },
|
|
123
|
+
"action-breakdowns": { type: "string", description: "Comma-separated action_breakdowns" },
|
|
124
|
+
filtering: { type: "string", description: "JSON array of {field,operator,value}" },
|
|
125
|
+
"attribution-windows": {
|
|
126
|
+
type: "string",
|
|
127
|
+
description: "Comma-separated. Only 1d_view, 1d_click, 7d_click, 28d_click work as of Jan 2026",
|
|
128
|
+
},
|
|
129
|
+
"use-account-attribution": { type: "boolean", description: "Use account-saved attribution setting" },
|
|
130
|
+
"use-unified-attribution": { type: "boolean", description: "Use ad-set unified attribution setting" },
|
|
131
|
+
limit: { type: "string", description: "Max rows (default per preset)" },
|
|
132
|
+
async: { type: "boolean", description: "Submit as async job, poll, then dump results" },
|
|
133
|
+
"skip-cache": { type: "boolean", description: "Bypass server-side cache" },
|
|
134
|
+
output: { type: "string", description: "Output format", default: "json" },
|
|
135
|
+
},
|
|
136
|
+
run: async ({ args }) => {
|
|
137
|
+
if (args["list-presets"]) {
|
|
138
|
+
writeAdsJson({ ok: true, data: listPresets() });
|
|
139
|
+
return;
|
|
140
|
+
}
|
|
141
|
+
const presetName = args.preset;
|
|
142
|
+
const preset = presetName ? getPreset(presetName) : undefined;
|
|
143
|
+
if (presetName && !preset) {
|
|
144
|
+
handleMetaError(new Error(`Unknown preset: ${presetName}. Use --list-presets.`));
|
|
145
|
+
}
|
|
146
|
+
const body = buildBodyFromArgs(args, preset);
|
|
147
|
+
try {
|
|
148
|
+
if (args.async) {
|
|
149
|
+
const submit = await apiPost("/api/ads/meta/insights/async", body);
|
|
150
|
+
process.stderr.write(`Submitted async insights job: ${submit.reportRunId}\n`);
|
|
151
|
+
await pollAsync(submit.reportRunId);
|
|
152
|
+
const result = await apiPost("/api/ads/meta/insights/async/result", {
|
|
153
|
+
reportRunId: submit.reportRunId,
|
|
154
|
+
fields: body.fields,
|
|
155
|
+
limit: body.limit,
|
|
156
|
+
});
|
|
157
|
+
const fmt = csvOrJson(args);
|
|
158
|
+
if (fmt !== "json") {
|
|
159
|
+
writeAdsOutput(result, fmt, body.fields);
|
|
160
|
+
return;
|
|
161
|
+
}
|
|
162
|
+
writeAdsJson({ ok: true, data: result });
|
|
163
|
+
return;
|
|
164
|
+
}
|
|
165
|
+
const data = await apiPost("/api/ads/meta/insights", body);
|
|
166
|
+
const fmt = csvOrJson(args);
|
|
167
|
+
if (fmt !== "json") {
|
|
168
|
+
writeAdsOutput(data, fmt, body.fields);
|
|
169
|
+
return;
|
|
170
|
+
}
|
|
171
|
+
writeAdsJson({ ok: true, data });
|
|
172
|
+
}
|
|
173
|
+
catch (err) {
|
|
174
|
+
handleMetaError(err);
|
|
175
|
+
}
|
|
176
|
+
},
|
|
177
|
+
});
|
|
178
|
+
//# sourceMappingURL=insights.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"insights.js","sourceRoot":"","sources":["../../../../src/commands/ads/meta/insights.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
export declare const labelsCommand: import("citty").CommandDef<{
|
|
2
|
+
readonly "account-id": {
|
|
3
|
+
readonly type: "string";
|
|
4
|
+
readonly description: "Meta ad account ID";
|
|
5
|
+
};
|
|
6
|
+
readonly "skip-cache": {
|
|
7
|
+
readonly type: "boolean";
|
|
8
|
+
readonly description: "Bypass server-side cache";
|
|
9
|
+
};
|
|
10
|
+
readonly output: {
|
|
11
|
+
readonly type: "string";
|
|
12
|
+
readonly description: "Output format";
|
|
13
|
+
readonly default: "json";
|
|
14
|
+
};
|
|
15
|
+
}>;
|
|
16
|
+
//# sourceMappingURL=labels.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"labels.d.ts","sourceRoot":"","sources":["../../../../src/commands/ads/meta/labels.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,aAAa;;;;;;;;;;;;;;EA0BxB,CAAC"}
|
|
@@ -0,0 +1,34 @@
|
|
|
1
|
+
import { defineCommand } from "citty";
|
|
2
|
+
import { apiGet } from "../../../client.js";
|
|
3
|
+
import { writeAdsJson, writeAdsOutput } from "../output.js";
|
|
4
|
+
import { csvOrJson, handleMetaError, resolveAccountIdArg } from "./shared.js";
|
|
5
|
+
export const labelsCommand = defineCommand({
|
|
6
|
+
meta: {
|
|
7
|
+
name: "labels",
|
|
8
|
+
description: `List ad labels for a Meta ad account.`,
|
|
9
|
+
},
|
|
10
|
+
args: {
|
|
11
|
+
"account-id": { type: "string", description: "Meta ad account ID" },
|
|
12
|
+
"skip-cache": { type: "boolean", description: "Bypass server-side cache" },
|
|
13
|
+
output: { type: "string", description: "Output format", default: "json" },
|
|
14
|
+
},
|
|
15
|
+
run: async ({ args }) => {
|
|
16
|
+
const accountId = resolveAccountIdArg(args);
|
|
17
|
+
try {
|
|
18
|
+
const params = { "account-id": accountId };
|
|
19
|
+
if (args["skip-cache"])
|
|
20
|
+
params["skip-cache"] = "true";
|
|
21
|
+
const data = await apiGet("/api/ads/meta/labels", params);
|
|
22
|
+
const fmt = csvOrJson(args);
|
|
23
|
+
if (fmt !== "json") {
|
|
24
|
+
writeAdsOutput(data, fmt);
|
|
25
|
+
return;
|
|
26
|
+
}
|
|
27
|
+
writeAdsJson({ ok: true, data });
|
|
28
|
+
}
|
|
29
|
+
catch (err) {
|
|
30
|
+
handleMetaError(err);
|
|
31
|
+
}
|
|
32
|
+
},
|
|
33
|
+
});
|
|
34
|
+
//# sourceMappingURL=labels.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"labels.js","sourceRoot":"","sources":["../../../../src/commands/ads/meta/labels.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AACtC,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC5D,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAE9E,MAAM,CAAC,MAAM,aAAa,GAAG,aAAa,CAAC;IACzC,IAAI,EAAE;QACJ,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,uCAAuC;KACrD;IACD,IAAI,EAAE;QACJ,YAAY,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,oBAAoB,EAAE;QACnE,YAAY,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,0BAA0B,EAAE;QAC1E,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,EAAE;KAC1E;IACD,GAAG,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE;QACtB,MAAM,SAAS,GAAG,mBAAmB,CAAC,IAAI,CAAC,CAAC;QAC5C,IAAI,CAAC;YACH,MAAM,MAAM,GAA2B,EAAE,YAAY,EAAE,SAAS,EAAE,CAAC;YACnE,IAAI,IAAI,CAAC,YAAY,CAAC;gBAAE,MAAM,CAAC,YAAY,CAAC,GAAG,MAAM,CAAC;YACtD,MAAM,IAAI,GAAG,MAAM,MAAM,CAAiC,sBAAsB,EAAE,MAAM,CAAC,CAAC;YAC1F,MAAM,GAAG,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;YAC5B,IAAI,GAAG,KAAK,MAAM,EAAE,CAAC;gBACnB,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;gBAC1B,OAAO;YACT,CAAC;YACD,YAAY,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QACnC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,eAAe,CAAC,GAAG,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;CACF,CAAC,CAAC"}
|
|
@@ -0,0 +1,33 @@
|
|
|
1
|
+
export declare const pixelsCommand: import("citty").CommandDef<{
|
|
2
|
+
readonly "account-id": {
|
|
3
|
+
readonly type: "string";
|
|
4
|
+
readonly description: "Meta ad account ID";
|
|
5
|
+
};
|
|
6
|
+
readonly "pixel-id": {
|
|
7
|
+
readonly type: "string";
|
|
8
|
+
readonly description: "Pixel ID for --stats";
|
|
9
|
+
};
|
|
10
|
+
readonly stats: {
|
|
11
|
+
readonly type: "boolean";
|
|
12
|
+
readonly description: "Fetch firing stats for the pixel";
|
|
13
|
+
};
|
|
14
|
+
readonly aggregation: {
|
|
15
|
+
readonly type: "string";
|
|
16
|
+
readonly description: "stats aggregation: event|browser_type|host|pixel_fire";
|
|
17
|
+
readonly default: "event";
|
|
18
|
+
};
|
|
19
|
+
readonly days: {
|
|
20
|
+
readonly type: "string";
|
|
21
|
+
readonly description: "Lookback days for --stats (default 7)";
|
|
22
|
+
};
|
|
23
|
+
readonly "skip-cache": {
|
|
24
|
+
readonly type: "boolean";
|
|
25
|
+
readonly description: "Bypass server-side cache";
|
|
26
|
+
};
|
|
27
|
+
readonly output: {
|
|
28
|
+
readonly type: "string";
|
|
29
|
+
readonly description: "Output format";
|
|
30
|
+
readonly default: "json";
|
|
31
|
+
};
|
|
32
|
+
}>;
|
|
33
|
+
//# sourceMappingURL=pixels.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"pixels.d.ts","sourceRoot":"","sources":["../../../../src/commands/ads/meta/pixels.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA4DxB,CAAC"}
|
|
@@ -0,0 +1,69 @@
|
|
|
1
|
+
import { defineCommand } from "citty";
|
|
2
|
+
import { apiGet } from "../../../client.js";
|
|
3
|
+
import { writeAdsJson, writeAdsOutput } from "../output.js";
|
|
4
|
+
import { csvOrJson, daysAgoIso, handleMetaError, resolveAccountIdArg, todayIso } from "./shared.js";
|
|
5
|
+
export const pixelsCommand = defineCommand({
|
|
6
|
+
meta: {
|
|
7
|
+
name: "pixels",
|
|
8
|
+
description: `List Meta Pixels for an ad account, or fetch firing stats for one pixel.
|
|
9
|
+
|
|
10
|
+
Examples:
|
|
11
|
+
baker ads meta pixels --account-id act_123
|
|
12
|
+
baker ads meta pixels --account-id act_123 --pixel-id 9876 --stats --days 7`,
|
|
13
|
+
},
|
|
14
|
+
args: {
|
|
15
|
+
"account-id": { type: "string", description: "Meta ad account ID" },
|
|
16
|
+
"pixel-id": { type: "string", description: "Pixel ID for --stats" },
|
|
17
|
+
stats: { type: "boolean", description: "Fetch firing stats for the pixel" },
|
|
18
|
+
aggregation: {
|
|
19
|
+
type: "string",
|
|
20
|
+
description: "stats aggregation: event|browser_type|host|pixel_fire",
|
|
21
|
+
default: "event",
|
|
22
|
+
},
|
|
23
|
+
days: { type: "string", description: "Lookback days for --stats (default 7)" },
|
|
24
|
+
"skip-cache": { type: "boolean", description: "Bypass server-side cache" },
|
|
25
|
+
output: { type: "string", description: "Output format", default: "json" },
|
|
26
|
+
},
|
|
27
|
+
run: async ({ args }) => {
|
|
28
|
+
try {
|
|
29
|
+
if (args.stats) {
|
|
30
|
+
const pixelId = args["pixel-id"];
|
|
31
|
+
if (!pixelId) {
|
|
32
|
+
handleMetaError(new Error("--pixel-id is required when --stats is set"));
|
|
33
|
+
}
|
|
34
|
+
const days = args.days ? Number(args.days) : 7;
|
|
35
|
+
const params = {
|
|
36
|
+
"pixel-id": pixelId,
|
|
37
|
+
aggregation: args.aggregation ?? "event",
|
|
38
|
+
"start-time": daysAgoIso(days),
|
|
39
|
+
"end-time": todayIso(),
|
|
40
|
+
};
|
|
41
|
+
if (args["skip-cache"])
|
|
42
|
+
params["skip-cache"] = "true";
|
|
43
|
+
const data = await apiGet("/api/ads/meta/pixel-stats", params);
|
|
44
|
+
const fmt = csvOrJson(args);
|
|
45
|
+
if (fmt !== "json") {
|
|
46
|
+
writeAdsOutput(data, fmt);
|
|
47
|
+
return;
|
|
48
|
+
}
|
|
49
|
+
writeAdsJson({ ok: true, data });
|
|
50
|
+
return;
|
|
51
|
+
}
|
|
52
|
+
const accountId = resolveAccountIdArg(args);
|
|
53
|
+
const params = { "account-id": accountId };
|
|
54
|
+
if (args["skip-cache"])
|
|
55
|
+
params["skip-cache"] = "true";
|
|
56
|
+
const data = await apiGet("/api/ads/meta/pixels", params);
|
|
57
|
+
const fmt = csvOrJson(args);
|
|
58
|
+
if (fmt !== "json") {
|
|
59
|
+
writeAdsOutput(data, fmt);
|
|
60
|
+
return;
|
|
61
|
+
}
|
|
62
|
+
writeAdsJson({ ok: true, data });
|
|
63
|
+
}
|
|
64
|
+
catch (err) {
|
|
65
|
+
handleMetaError(err);
|
|
66
|
+
}
|
|
67
|
+
},
|
|
68
|
+
});
|
|
69
|
+
//# sourceMappingURL=pixels.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"pixels.js","sourceRoot":"","sources":["../../../../src/commands/ads/meta/pixels.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Meta-native insights presets. Names + fields chosen for our marketing team's
|
|
3
|
+
* review workflows — not parity-aligned with the Google Ads presets.
|
|
4
|
+
*/
|
|
5
|
+
export interface MetaInsightsPreset {
|
|
6
|
+
name: string;
|
|
7
|
+
description: string;
|
|
8
|
+
level: "account" | "campaign" | "adset" | "ad";
|
|
9
|
+
fields: string[];
|
|
10
|
+
breakdowns?: string[];
|
|
11
|
+
actionBreakdowns?: string[];
|
|
12
|
+
attributionWindows?: string[];
|
|
13
|
+
defaultDatePreset: string;
|
|
14
|
+
defaultLimit: number;
|
|
15
|
+
}
|
|
16
|
+
export declare function getPreset(name: string): MetaInsightsPreset | undefined;
|
|
17
|
+
export declare function listPresets(): MetaInsightsPreset[];
|
|
18
|
+
//# sourceMappingURL=presets.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"presets.d.ts","sourceRoot":"","sources":["../../../../src/commands/ads/meta/presets.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,SAAS,GAAG,UAAU,GAAG,OAAO,GAAG,IAAI,CAAC;IAC/C,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC9B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC;CACtB;AAsGD,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS,CAEtE;AAED,wBAAgB,WAAW,IAAI,kBAAkB,EAAE,CAElD"}
|