Change journal

3 LinkedIn Ads tools, each with its inputs, hosted support and CLI command.

On this page

Adwarp journals every change it makes on its own. See Change journal and lift.

On the hosted endpoint: Needs the local change journal, ~/.adwarp/changelog.jsonl. Journaling is off on hosted deploys, which have a read-only filesystem.

log_ad_change

LinkedIn AdsLocal only

Record a change made elsewhere, or attach a hypothesis.

Record a change to an ad entity in the local change journal, so a later lift report can compare performance before vs. after it. Adwarp logs its own changes automatically. Use this for changes made elsewhere (e.g. in Campaign Manager) or to attach a hypothesis/label. Provide field+after for a field change, or note for a freeform annotation.

CLI

$ adwarp changelog add -t <type> -i <id> -f <field> --after <value> [-l <label>]# log a change made elsewhere

Inputs 10, 2 required

Inputs
Input	Type	What it is
`entityType`required	`campaignGroup \| campaign \| creative`	campaignGroup (the 'campaign'), campaign (the 'ad group'), or creative (the 'ad')
`entityId`required	`string`	Numeric id of the campaign group / campaign / creative
`name`	`string`	Human name of the entity (for nicer listings)
`field`	`string`	Field that changed, e.g. dailyBudget, headline, status
`before`	`string`	Prior value, if known
`after`	`string`	New value
`note`	`string`	Freeform note (used when there is no specific field)
`label`	`string`	Hypothesis/label, e.g. 'outcome-led headline test'
`tags`	`string[]`
`at`	`string`	ISO 8601 time the change took effect; defaults to now

list_ad_changes

LinkedIn AdsLocal only

Recorded changes, newest first.

List recorded ad changes (newest first) from the local change journal. Filter by entity type/id or tag. Use this to see what's been changed before computing lift.

CLI

$ adwarp changelog list [-t <type>] [-i <id>] [--tag <tag>]# recorded ad changes, newest first

Inputs 4

Inputs
Input	Type	What it is
`entityType`	`campaignGroup \| campaign \| creative`	campaignGroup (the 'campaign'), campaign (the 'ad group'), or creative (the 'ad')
`entityId`	`string`
`tag`	`string`
`limit`	`integer`	Max rows (default 50)

compute_lift

LinkedIn AdsLocal only

Before and after performance for each recorded change.

For each recorded change to an entity, compare performance in the window before the change against the window after it (default 14 days each side). Returns before/after KPI windows and per-metric relative deltas (CTR, CPC, conversion rate, cost-per-conversion, etc.). This is a directional pre/post comparison, NOT a controlled experiment. It is confounded by seasonality, the LinkedIn learning phase after edits, and concurrent budget changes; present it as a signal and call out partial after-windows on recent changes.

CLI

$ adwarp lift <level> <id> [-w <days>]# before and after performance for each recorded change

Inputs 3, 2 required

Inputs
Input	Type	What it is
`entityType`required	`campaignGroup \| campaign \| creative`	campaignGroup (the 'campaign'), campaign (the 'ad group'), or creative (the 'ad')
`entityId`required	`string`
`windowDays`	`integer`	Days on each side of a change (default 14)

Change journal

3 LinkedIn Ads tools, each with its inputs, hosted support and CLI command.

On this page

Adwarp journals every change it makes on its own. See Change journal and lift.

On the hosted endpoint: Needs the local change journal, ~/.adwarp/changelog.jsonl. Journaling is off on hosted deploys, which have a read-only filesystem.

log_ad_change

LinkedIn AdsLocal only

Record a change made elsewhere, or attach a hypothesis.

CLI

$ adwarp changelog add -t <type> -i <id> -f <field> --after <value> [-l <label>]# log a change made elsewhere

Inputs 10, 2 required

Inputs
Input	Type	What it is
`entityType`required	`campaignGroup \| campaign \| creative`	campaignGroup (the 'campaign'), campaign (the 'ad group'), or creative (the 'ad')
`entityId`required	`string`	Numeric id of the campaign group / campaign / creative
`name`	`string`	Human name of the entity (for nicer listings)
`field`	`string`	Field that changed, e.g. dailyBudget, headline, status
`before`	`string`	Prior value, if known
`after`	`string`	New value
`note`	`string`	Freeform note (used when there is no specific field)
`label`	`string`	Hypothesis/label, e.g. 'outcome-led headline test'
`tags`	`string[]`
`at`	`string`	ISO 8601 time the change took effect; defaults to now

list_ad_changes

LinkedIn AdsLocal only

Recorded changes, newest first.

List recorded ad changes (newest first) from the local change journal. Filter by entity type/id or tag. Use this to see what's been changed before computing lift.

CLI

$ adwarp changelog list [-t <type>] [-i <id>] [--tag <tag>]# recorded ad changes, newest first

Inputs 4

Inputs
Input	Type	What it is
`entityType`	`campaignGroup \| campaign \| creative`	campaignGroup (the 'campaign'), campaign (the 'ad group'), or creative (the 'ad')
`entityId`	`string`
`tag`	`string`
`limit`	`integer`	Max rows (default 50)

compute_lift

LinkedIn AdsLocal only

Before and after performance for each recorded change.

CLI

$ adwarp lift <level> <id> [-w <days>]# before and after performance for each recorded change

Inputs 3, 2 required

Inputs
Input	Type	What it is
`entityType`required	`campaignGroup \| campaign \| creative`	campaignGroup (the 'campaign'), campaign (the 'ad group'), or creative (the 'ad')
`entityId`required	`string`
`windowDays`	`integer`	Days on each side of a change (default 14)

Start with 1 prompt.

Start with 1 prompt.

Change journal

log_ad_change

list_ad_changes

compute_lift

Change journal

log_ad_change

list_ad_changes

compute_lift