Creatives
The Ad Creatives search finder allows you to search for creatives by id, campaign URN, status, or reference URN.
Table Specific Information
NOTE: The Account column is deprecated and will be removed in the next major version of the server.Select
The Creatives view returns a list of the creatives that belong to the authenticated user so they can be used as dimensions in analytic requests.
The server uses the LinkedIn Marketing Solutions API to process search criteria that refer to the Id, Account, Campaign, and IntendedStatus columns. The server processes other filters client-side within the server. For example, the following queries are processed server side.
SELECT * FROM Creatives WHERE Id = '179345687'
SELECT * FROM Creatives WHERE AdAccountId = '510013292'
SELECT * FROM Creatives WHERE AdAccountId IN ('510013292', '510013293')
SELECT * FROM Creatives WHERE Campaign = '198952936'
SELECT * FROM Creatives WHERE IntendedStatus = 'ACTIVE'
CUD Operations
Insert
To create a new advertising creative there are some fields that are required in initial creation which are: Campaign, Content, IntendedStatus, AdAccountId.
While the following parameters are optional: CallToActionLabel, CallToActionFormId, Name.
INSERT INTO Creatives ( Campaign, Content, IntendedStatus, Name, AdAccountId ) VALUES ( 'urn:li:sponsoredCampaign:403027733', ' { \"reference\": \"urn:li:share:7346473724906237952\" }', 'DRAFT', 'Summer Campaign Main Creative', '515218099' );
Update
To modify an existing creative, use an UPDATE statement. Note that the Id and AdAccountId columns are required in the WHERE clause.
The following columns are the ones that are mutable after creation: Content, IntendedStatus, CallToActionLabel, CallToActionFormId, Name.
UPDATE Creatives SET Campaign = 'urn:li:sponsoredCampaign:403027733', Name = 'Updated Summer Campaign Creative' WHERE Id = 'urn:li:sponsoredCreative:722532663' and AdAccountId = '515218099';
Delete
To remove a creative, use a DELETE statement. Note that the Id and AdAccountId columns are required in the WHERE clause.
DELETE FROM Creatives WHERE Id = 'urn:li:sponsoredCreative:722492693' and AdAccountId = '515218099';
Columns
| Name | Type | ReadOnly | References | Description |
| Id [KEY] | String | True |
Numerical identifier for the creative. | |
| Account | String | True |
URN identifying the advertising account associated with the creative. | |
| Campaign | String | False |
URN identifying the campaign associated with the creative. | |
| Content | String | False |
Content sponsored in the creative. | |
| CreatedAt | Datetime | True |
Datetime when the creative was first created | |
| CreatedBy | String | True |
Entity that developed the creative. | |
| IntendedStatus | String | False |
Creative user intended status. The allowed values are ACTIVE, REMOVED, PENDING_DELETION, CANCELED, ARCHIVED, DRAFT, PAUSED. | |
| IsServing | Boolean | True |
This indicates whether the creative is currently being served or not. | |
| ServingHoldReasons | String | True |
Array that contains all the reasons why the creative is not serving. | |
| LastModifiedAt | Datetime | True |
Datetime when the creative was last modified. | |
| LastModifiedBy | String | True |
Entity that modified the creative. | |
| ReviewStatus | String | True |
The current review status of the creative. | |
| IsTest | Boolean | True |
Flag showing whether this creative is a test creative, i.e., belongs to a test campaign. | |
| AdAccountId | String | False |
Id of the account. | |
| CallToActionLabel | String | False |
Label for the CallToAction button. Present only if the campaign objective is LEAD_GENERATION. The allowed values are APPLY, DOWNLOAD, VIEW_QUOTE, LEARN_MORE, SIGN_UP, SUBSCRIBE, REGISTER, REQUEST_DEMO, JOIN, ATTEND, UNLOCK_FULL_DOCUMENT. | |
| CallToActionFormId | String | False |
Forms.Id |
The Id of the corresponding form which the call to action redirects to. Present only if the campaign objective is LEAD_GENERATION. |
| RejectionReasons | String | True |
A comma-seperated list of values with reasons explaining why the creative has been rejected. | |
| Name | String | False |
The name of the creative that can be set by advertiser; primarily used to make it easier to reference a Creative and to recall its purpose. |