LinkedInAd
An advertisement displayed on LinkedIn platform, targeting professionals and B2B audiences through sponsored content, messaging, and display formats.
LinkedInAd
An advertisement displayed on LinkedIn platform, targeting professionals and B2B audiences through sponsored content, messaging, and display formats.
Properties
id(string): Unique identifier for the LinkedIn ad.name(string): The name or title of the LinkedIn ad.business([[Business]]): The business running this LinkedIn ad.campaign([[Campaign]]): The campaign this LinkedIn ad belongs to.campaignGroup([[AdSet]]): The campaign group this LinkedIn ad is part of.status(string): Current status (active, paused, archived, canceled).objective(string): Campaign objective (brand-awareness, website-visits, engagement, video-views, lead-generation, website-conversions, job-applicants).format(string): Ad format (single-image, video, carousel, document, event, message, text, spotlight, follower).adType(string): Ad type (sponsored-content, sponsored-messaging, text-ad, dynamic-ad).placement(string[]): Ad placements (feed, messaging, right-rail).creative([[AdCreative]]): The creative assets used.introductoryText(string): Introductory text (primary copy).headline(string): Headline text.description(string): Description text.callToAction(string): Call-to-action button (learn-more, apply-now, download, register, sign-up, request-demo, contact-us).imageUrl(string): Primary image URL.videoUrl(string): Video URL (for video ads).documentUrl(string): Document URL (for document ads).carouselCards(object[]): Carousel cards (for carousel ads).destinationUrl(string): Destination URL.leadGenForm(object): Lead generation form configuration.companyLogo(string): Company logo URL.companyName(string): Company name displayed.targeting(object): Targeting criteria.location(object): Geographic targeting.companySize(string[]): Company size targeting.companyIndustry(string[]): Company industry targeting.companyName(string[]): Specific company targeting.jobFunction(string[]): Job function targeting.jobTitle(string[]): Job title targeting.jobSeniority(string[]): Job seniority targeting.yearsOfExperience(string[]): Years of experience targeting.skills(string[]): Skills targeting.education(object): Education targeting (degrees, schools, fields).interests(string[]): Interest targeting.groups(string[]): LinkedIn group targeting.matchedAudience([[CustomAudience]]): Matched audience (retargeting).lookalike([[LookalikeAudience]]): Lookalike audience.excludedAudiences([[Audience]][]): Audiences to exclude.budgetCents(number): Budget allocated in cents.spentCents(number): Amount spent in cents.bidStrategy(string): Bidding strategy (maximum-delivery, target-cost, manual).bidType(string): Bid type (cpc, cpm, cpv).bidAmountCents(number): Bid amount in cents.impressions(number): Total impressions delivered.clicks(number): Total clicks received.linkClicks(number): Outbound link clicks.engagement(number): Total engagement actions.likes(number): Number of likes.comments(number): Number of comments.shares(number): Number of shares.follows(number): New followers gained.videoViews(number): Number of video views.videoCompletions(number): Number of video completions.leadFormOpens(number): Lead form opens.leadFormSubmissions(number): Lead form submissions.conversions(number): Total conversions tracked.conversionValueCents(number): Conversion value in cents.jobApplications(number): Job applications submitted.ctr(number): Click-through rate as a decimal.engagementRate(number): Engagement rate as a decimal.socialActionsRate(number): Social actions rate as a decimal.cpcCents(number): Cost per click in cents.cpmCents(number): Cost per thousand impressions in cents.cpvCents(number): Cost per video view in cents.cplCents(number): Cost per lead in cents.cpaCents(number): Cost per acquisition in cents.roas(number): Return on ad spend as a decimal.revenueCents(number): Revenue attributed in cents.tags(string[]): Tags for categorizing.createdAt(string): Creation timestamp (ISO 8601 format).updatedAt(string): Last update timestamp (ISO 8601 format).metadata(object): Additional information.
Actions
create
Create a new LinkedIn ad.
Input: [[LinkedInAd]]
Output: [[LinkedInAd]]
update
Modify LinkedIn ad details.
Input: [[LinkedInAd]]
Output: [[LinkedInAd]]
delete
Permanently remove the LinkedIn ad.
Input: [[LinkedInAd]]
Output: [[LinkedInAd]]
launch
Activate and launch the LinkedIn ad.
Input: [[LinkedInAd]]
Output: [[LinkedInAd]]
pause
Pause LinkedIn ad delivery.
Input: [[LinkedInAd]]
Output: [[LinkedInAd]]
resume
Resume a paused LinkedIn ad.
Input: [[LinkedInAd]]
Output: [[LinkedInAd]]
duplicate
Create a copy of the LinkedIn ad.
Input: [[LinkedInAd]]
Output: [[LinkedInAd]]
optimize
Optimize based on performance.
Input: [[OptimizationRequest]]
Output: [[LinkedInAd]]
updateCreative
Update creative assets.
Input: [[AdCreative]]
Output: [[LinkedInAd]]
analyze
Analyze performance.
Input: [[AnalysisRequest]]
Output: [[LinkedInAdAnalysis]]
report
Generate performance report.
Input: [[ReportRequest]]
Output: [[LinkedInAdReport]]
Events
created: Triggered when created.updated: Triggered when modified.deleted: Triggered when removed.launched: Triggered when activated.paused: Triggered when paused.resumed: Triggered when resumed.delivered: Triggered when delivered to user.clicked: Triggered when clicked.engaged: Triggered when user engages.liked: Triggered when user likes.commented: Triggered when user comments.shared: Triggered when user shares.followed: Triggered when user follows.leadFormOpened: Triggered when lead form opened.leadSubmitted: Triggered when lead form submitted.converted: Triggered when drives conversion.budgetExceeded: Triggered when exceeds budget.