Manage ads

By the end of this page, you can stop and restart a LinkedIn ad, change what it spends and looks like, copy it and remove it.

Before you start

You need a linkedinads account and an ad. Zernio's levels map onto LinkedIn's like this:

Pause or resume

PUT /v1/ads/campaigns/{campaignId}/status writes the Campaign Group's own switch and nothing else. Its Campaigns and Creatives keep their own switches.

import Zernio from '@zernio/node';

const zernio = new Zernio();

const { data: paused } = await zernio.adcampaigns.updateAdCampaignStatus({
  path: { campaignId: '645412093' },
  body: { status: 'paused', platform: 'linkedin' }
});

Response (200):

{ "status": "paused", "platformCampaignStatus": null, "statusReadAt": null, "updated": 1, "skipped": 0 }

LinkedIn has no single Campaign Group read, so platformCampaignStatus and statusReadAt are always null and the write always goes out.

Resuming a group lets each Campaign and Creative deliver again only if its own switch is on. Narrower scopes take the same status:

A Creative still in DRAFT is already held off, and LinkedIn refuses to pause it before its review is approved. Pausing one writes nothing.

Change the budget

Send budget on PUT /v1/ads/{adId}. Zernio writes it to the ad's LinkedIn Campaign, so it covers every Creative in that Campaign.

{ "budget": { "amount": 40, "type": "daily" } }

LinkedIn's minimums still apply (Budget minimums).

Swap the creative

Send creative on PUT /v1/ads/{adId} with new media in imageUrl or videoUrl, plus headline, body, description, callToAction and linkUrl as needed.

Zernio uploads the media, creates a new Creative on the same Campaign and pauses the old one. The old Creative is kept for reporting.

A text-only update returns 400, because LinkedIn needs new media. videoId and existingCreativeId are Meta-only and return 400.

Rename

name on PUT /v1/ads/ad-sets/{adSetId} renames the LinkedIn Campaign.

LinkedIn Creatives cannot be renamed: name on PUT /v1/ads/{adId} returns 501.

Duplicate a campaign

Call POST /v1/ads/campaigns/{campaignId}/duplicate with platform: "linkedin" and the source Campaign Group id.

LinkedIn has no native copy endpoint. Zernio walks the source Campaign Group, its Campaigns and their Creatives and recreates the tree.

const { data: copy } = await zernio.adcampaigns.duplicateAdCampaign({
  path: { campaignId: '645412093' },
  body: {
    platform: 'linkedin',
    statusOption: 'PAUSED',
    renameStrategy: 'DEEP_RENAME',
    renameSuffix: ' (Copy)'
  }
});

Response (200):

{
  "copiedCampaignId": "645498211",
  "discovery": "triggered"
}

discovery reports whether Zernio ran an ads sync straight after the copy. The sync makes the copy show up in GET /v1/ads/tree within seconds instead of at the next scheduled pass.

• triggered: the sync ran
• skipped: the request sent syncAfter: false
• failed: the sync itself errored

The copy exists on LinkedIn in all 3 cases. failed and skipped only delay when Zernio sees it, so poll the tree.

The copy carries the campaign fields verbatim (type, costType, creativeSelection, unitCost, optimizationTargetType, targetingCriteria, dailyBudget, totalBudget, ...).

It also carries every Creative's content object, for DSC-authored, reference, document and thought-leader creatives alike.

statusOption takes one of:

• PAUSED (default): the whole clone stays DRAFT
• ACTIVE: the clone launches the moment LinkedIn approves it
• INHERITED_FROM_SOURCE: evaluated per entity. Any Group, Campaign or Creative whose source is ACTIVE gets its clone activated too.

If any step fails, only the entities the duplicate authored are cleaned up. The source tree is never touched.

Delete

If the Creative itself cannot be removed, the request fails and no parent is touched.

A Campaign Group with no ads in Zernio is deleted only after LinkedIn confirms it holds no Campaigns. To delete one, send accountId in the body or the query string.

If it fails

Related

• Create a campaign: the hierarchy these calls manage.
• Targeting: change a running Campaign's audience.
• Pause or resume a campaign and Update ad: every field.
• Duplicate a campaign and Delete a campaign: the full bodies.