Partager via


Engagement Retargeting

Warning

Deprecation Notice
The Marketing Version 202310 (Marketing October 2023) and earlier versions (excluding 202306 and 202307) have been sunset. Additionally, the unversioned APIs will be sunset soon. We recommend that you migrate to the versioned APIs as well as migrate to the new Content and Community Management APIs to avoid disruptions. See the Migration page for more details. If you haven’t yet migrated and have questions, submit a request on the LinkedIn Developer Support Portal.

The LinkedIn Ads platform offers advertisers the ability to retarget audiences based on content engagement and interactions such as visiting a company page or watching a video. To enable engagement retargeting functionality, engagement rule(s) must be created.

For more information on campaign targeting options, see Ads Targeting, and for information on using retargeting in Campaign Manager, see Retargeting Overview.

The use of this API is restricted to those developers approved by LinkedIn for the LinkedIn Marketing API Program and subject to applicable data restrictions in their agreements.

Note

All API requests are represented in protocol 2.0.0 and require the header X-Restli-Protocol-Version: 2.0.0

Permissions

Scope Permission

Permission Description
rw_ads Manage and read an authenticated member's ad accounts data
r_ads Read an authenticated member's ad accounts data

Account Roles

Engagement Source Type Required Account Roles
Company Pages
  • PAGE_ADMIN
  • DARK_CONTENT_POSTER

Rate Limits

We have introduced granular rate limits for this API to prevent abuse, ensure service stability, and consistent API availability. These limits will be enforced in addition to your current daily limits, which can be found through Developer Portal > My Apps > App > Analytics > Quotas and usage.

You may get a HTTP 429 response if calling the endpoints too frequently, indicating that you are exceeding the rate limits. If your application makes a large amount of automated, bulk data pushes that exceed tens of millions of calls, you can expect to see frequent throttling.

The limits we intend to enforce will not be customizable at an application level. However the limits will be enforced such that there is minimal interruption to existing applications.

Prerequisites

You will need a DMP Segment with source_platform inline with type of engagement source in order to create or get an Engagement Rule. Refer to the following table:

Engagement source type Source Platform Enum
Video Ads VIDEO_ADS
Leadgen Forms LEAD_GEN_FORMS
Company pages ORGANIZATION_PAGES
Website retargeting LINKEDIN_WEBSITE_RETARGETING
Single image ads SINGLE_IMAGE_ADS
Document ads DOCUMENT_ADS
Conversation ads CONVERSATION_ADS
Event Pages EVENT_PAGES

Note

If you have created a dmpSegment, please do add an engagement rule on it, or delete it if you don't plan to use it.

Sample Request To Create a DMP Segment

POST https://api.linkedin.com/rest/dmpSegments
{
   "name":"DMP Segment 1",
   "sourcePlatform":"VIDEO_ADS",
   "account":"urn:li:sponsoredAccount:1000",
   "type":"USER",
   "destinations":[
      {
         "destination":"LINKEDIN"
      }
   ]
}

A successful response returns a 201 Created HTTP status code and the segment ID in the X-LinkedIn-Id response header.

Note

After you create a DMP segment, you must wait 5 seconds for the segment to be available to add any engagement rule. If you try to create an engagement rule when a DMP segment is not ready, you might receive validation error(s) including: "Entity with dmp segment id {your dmp segment id} was not found." or "Unable to load dmp segment id {your dmp segment id}. Please try again." You can retry creating engagement rule(s).

Supported Engagement Source Types

Engagement Source Type Engagement Trigger Look Back
Video Ads (VIDEO_ADS)
  • Viewed at least 25% (FIRST_QUARTILE)
  • Viewed at least 50% (MIDPOINT)
  • Viewed at least 75% (THIRD_QUARTILE)
  • Viewed at least 97% (FULL_COMPLETE)
  • 30 Days
  • 60 Days
  • 90 Days
  • 180 Days
  • 365 Days
Leadgen Forms (LEAD_GEN_FORMS)
  • Anyone who opened your lead gen form, including submits (VIEW_FORM)
  • Only people who submitted your lead gen form (LEAD_FORM_SUBMIT)
  • 30 Days
  • 60 Days
  • 90 Days
  • 180 Days
  • 365 Days
Company Pages (ORGANIZATION_PAGES)
  • People who visited your organization page (VIEW)
  • Call-to-action Button Clicks (CTA_CLICK)
  • 30 Days
  • 60 Days
  • 90 Days
  • 180 Days
  • 365 Days
Single Image Ads
  • People who performed chargeable clicks on your ad (CLICK)
  • Any interactions with your ad (ENGAGEMENT)
  • 30 Days
  • 60 Days
  • 90 Days
  • 180 Days
  • 365 Days
Website
  • People who visited your website (VISIT)
  • 30 Days
  • 60 Days
  • 90 Days
  • 180 Days
Document Ads
  • People who performed chargeable clicks on your ad (CLICK)
  • Any interactions with your ad (ENGAGEMENT)
  • Those who downloaded the document (DOWNLOAD_CLICK)
  • 30 Days
  • 60 Days
  • 90 Days
  • 180 Days
  • 365 Days
Conversation Ads
  • People who opened a conversation (OPEN)
  • People who clicked on any call-to-action (ANY_CTA_CLICK)
  • 30 Days
  • 60 Days
  • 90 Days
  • 180 Days
  • 365 Days
Event Pages
  • People who viewed the stream/video for 2 continuous seconds (VIDEO_VIEWED)
  • Viewed at least 25% of your event (FIRST_QUARTILE)
  • Viewed at least 50% of your event (MIDPOINT)
  • Viewed at least 75% of your event (THIRD_QUARTILE)
  • Viewed at least 97% of your event (FULL_COMPLETE)
  • Any interactions on your event (ENGAGEMENT)
  • People who performed chargeable clicks on your event (CLICK)
  • 30 Days
  • 60 Days
  • 90 Days
  • 180 Days
  • 365 Days
Engagement Source Type Engagement Trigger Look Back
Video Ads (VIDEO_ADS)
  • Viewed at least 25% (FIRST_QUARTILE)
  • Viewed at least 50% (MIDPOINT)
  • Viewed at least 75% (THIRD_QUARTILE)
  • Viewed at least 97% (FULL_COMPLETE)
  • 30 Days
  • 60 Days
  • 90 Days
  • 180 Days
  • 365 Days
Leadgen Forms (LEAD_GEN_FORMS)
  • Anyone who opened your lead gen form, including submits (VIEW_FORM)
  • Only people who submitted your lead gen form (LEAD_FORM_SUBMIT)
  • 30 Days
  • 60 Days
  • 90 Days
  • 180 Days
  • 365 Days
Company Pages (ORGANIZATION_PAGES)
  • People who visited your organization page (VIEW)
  • Call-to-action Button Clicks (CTA_CLICK)
  • 30 Days
  • 60 Days
  • 90 Days
  • 180 Days
  • 365 Days
Single Image Ads
  • People who performed chargeable clicks on your ad (CLICK)
  • Any interactions with your ad (ENGAGEMENT)
  • 30 Days
  • 60 Days
  • 90 Days
  • 180 Days
  • 365 Days
Website
  • People who visited your website (VISIT)
  • 30 Days
  • 60 Days
  • 90 Days
  • 180 Days
Document Ads
  • People who performed chargeable clicks on your ad (CLICK)
  • Any interactions with your ad (ENGAGEMENT)
  • Those who downloaded the document (DOWNLOAD_CLICK)
  • 30 Days
  • 60 Days
  • 90 Days
  • 180 Days
  • 365 Days
Conversation Ads
  • People who opened a conversation (OPEN)
  • People who clicked on any call-to-action (ANY_CTA_CLICK)
  • 30 Days
  • 60 Days
  • 90 Days
  • 180 Days
  • 365 Days
Engagement Source Type Engagement Trigger Look Back
Video Ads (VIDEO_ADS)
  • Viewed at least 25% (FIRST_QUARTILE)
  • Viewed at least 50% (MIDPOINT)
  • Viewed at least 75% (THIRD_QUARTILE)
  • Viewed at least 97% (FULL_COMPLETE)
  • 30 Days
  • 60 Days
  • 90 Days
  • 180 Days
  • 365 Days
Leadgen Forms (LEAD_GEN_FORMS)
  • Anyone who opened your lead gen form, including submits (VIEW_FORM)
  • Only people who submitted your lead gen form (LEAD_FORM_SUBMIT)
  • 30 Days
  • 60 Days
  • 90 Days
  • 180 Days
  • 365 Days
Company Pages (ORGANIZATION_PAGES)
  • People who visited your organization page (VIEW)
  • Call-to-action Button Clicks (CTA_CLICK)
  • 30 Days
  • 60 Days
  • 90 Days
  • 180 Days
  • 365 Days
Single Image Ads
  • People who performed chargeable clicks on your ad (CLICK)
  • Any interactions with your ad (ENGAGEMENT)
  • 30 Days
  • 60 Days
  • 90 Days
  • 180 Days
  • 365 Days
Website
  • People who visited your website (VISIT)
  • 30 Days
  • 60 Days
  • 90 Days
  • 180 Days
Document Ads
  • People who performed chargeable clicks on your ad (CLICK)
  • Any interactions with your ad (ENGAGEMENT)
  • Those who downloaded the document (DOWNLOAD_CLICK)
  • 30 Days
  • 60 Days
  • 90 Days
  • 180 Days
  • 365 Days
Conversation Ads
  • People who opened a conversation (OPEN)
  • People who clicked on any call-to-action (ANY_CTA_CLICK)
  • 30 Days
  • 60 Days
  • 90 Days
  • 180 Days
  • 365 Days

Note

For website retargeting, the advertiser you are working with must have deployed a working and live Insight Tag on their website. For more information, see Conversion Tracking.

Retargeting Audiences

After you create an engagement rule on a dmp segment, it can take up to 48 hours (on a rare occasion, longer) for your retargeting audience to process and up to an additional 24 hours to start delivery. Include this audience to a campaign at any time and it will automatically start serving once ready. To check audience count and segment status, see DMP Segments.

Retargeting Audiences Example Workflow

Each engagement retargeting audience has a dmp segment id associated with engagement rules, each rule containing the following:
Engagement Source: content that the member engaged with
Engagement Trigger: action performed by the member
Lookback: when was the action performed

Example: if an advertiser wants to retarget all members who watched more than 25% of video ad campaign 123456 in the past 90 days, then the engagement source will be campaign id 123456, engagement trigger will be watched more than 25% of video ad and lookback will be 90 days. Engagement source is not to be confused with engagement source type.

Steps to Create An Engagement Retargeting Audience

There are many different ways this flow could be implemented, below is an example flow:

  1. At this point, the user should be narrowed down to a single sponsored account.
  2. Get all Supported Engagement Source Types
    • Only engagement source types with the engagementSourceTypeStatus ACTIVE can be used for creating engagement rules.
  3. Allow the user to choose one of the available engagement source types from step 2 then get all Supported Engagement Triggers for the chosen engagement source type.
    • Only engagement triggers with the engagementTriggerStatus ACTIVE can be used for creating engagement rules.
  4. Have engagement source(s) ready to be used for engagement rule creation. For example, sponsoredCampaign urns for Video Ads and Leadgen Forms or an Organization urn for Company Pages.
  5. Fetch and display the engagement source's Statistics and Analytics based on the chosen lookback window and engagement trigger.
    • Allow the the user to choose which engagement sources they want to use to create their engagement retargeting audience, along with the engagement trigger and lookback window.
  6. Create a dmp segment with appropriate source platform. Refer to this table for the appropriate source platform to use in the request.
  7. Create an Engagement Rule (or create multiple engagement rules if multiple engagement sources were chosen) for the dmpSegment created in the step 6
    • Tip: the trigger urn will be defined using the engagement source and trigger chosen from step 2 and 3.
      e.g. urn:li:dmpEngagementTrigger:(urn:li:dmpEngagementSourceType:VIDEO_ADS,FIRST_QUARTILE_VIEWERS)

Statistics and Analytics

The LinkedIn Ads platform offers advertisers the ability to retrieve statistics and analytics for the source to help determine if engagement retargeting is beneficial.

For Video Ads, Leadgen Forms, and Single Image Ads, statistics will be available via /adAnalytics, see Ad Analytics. For Company Pages, statistics will be available via /organizationPageStatistics, see Organization Page Statistics.

Examples of Analytics

  • Example 1: engagement retargeting can be beneficial A Video Ads campaign has 10,000+ videoStarts or 500+ videoCompletions from /adAnalytics, meaning the video ads has been watched by a decent number of audiences, and can be used for retargeting, to get a better ads experience with targeting audiences.
  • Example 2: engagement retargeting may not be beneficial A Video Ads campaign has 10 videoStarts or 0 videoCompletionsfrom /adAnalytics, meaning the video ads has not been watched by many people yet, so it is not suggested to be used for an engagement retargeting rule for now. It may be valuable later after more people watch it.
Engagement Source Type Engagement Trigger Reference Field From Analytics or Statistics API API Request Example
VIDEO_ADS FIRST_QUARTILE videoFirstQuartileCompletions GET /rest/adAnalytics?q=analytics&pivot=CAMPAIGN&timeGranularity=ALL&dateRange=(start:(day:24,month:9,year:2020),end:(day:23,month:9,year:2021))&campaigns=List(urn%3Ali%3AsponsoredCampaign%3A123456)&fields=videoFirstQuartileCompletions,pivotValues
VIDEO_ADS MIDPOINT videoMidpointCompletions
VIDEO_ADS THIRD_QUARTILE videoThirdQuartileCompletions
VIDEO_ADS FULL_COMPLETE videoCompletions
LEAD_GEN_FORMS VIEW_FORM oneClickLeads
LEAD_GEN_FORMS LEAD_FORM_SUBMIT oneClickLeadFormOpens GET /rest/adAnalytics?q=analytics&pivot=CAMPAIGN&timeGranularity=ALL&dateRange=(start:(day:24,month:9,year:2020),end:(day:23,month:9,year:2021))&campaigns=List(urn%3Ali%3AsponsoredCampaign%3A123456)&fields=oneClickLeadFormOpens,pivotValues
ORGANIZATION_PAGES VIEW totalPageStatistics.views GET /rest/organizationPageStatistics?q=organization&organization=urn%3Ali%3Aorganization%3A73841066&timeIntervals=(timeRange:(start:1629926990000,end:1632518990000),timeGranularityType:MONTH)&fields=totalPageStatistics
ORGANIZATION_PAGES CTA_CLICK totalPageStatistics.clicks GET /rest/organizationPageStatistics?q=organization&organization=urn%3Ali%3Aorganization%3A73841066&timeIntervals=(timeRange:(start:1629926990000,end:1632518990000),timeGranularityType:MONTH)&fields=totalPageStatistics
SINGLE_IMAGE_ADS CLICK clicks GET /rest/adAnalytics?q=analytics&pivot=CAMPAIGN&timeGranularity=ALL&dateRange=(start:(day:24,month:9,year:2021),end:(day:23,month:2,year:2021))&campaigns=List(urn%3Ali%3AsponsoredCampaign%3A123456)&fields=clicks,pivotValues
SINGLE_IMAGE_ADS ENGAGEMENT totalEngagements GET /rest/adAnalytics?q=analytics&pivot=CAMPAIGN&timeGranularity=ALL&dateRange=(start:(day:24,month:9,year:2021),end:(day:23,month:2,year:2021))&campaigns=List(urn%3Ali%3AsponsoredCampaign%3A123456)&fields=totalEngagements,pivotValues
EVENT_PAGES VIDEO_VIEWED videoViews GET /rest/adAnalytics?q=analytics&pivot=CAMPAIGN&timeGranularity=ALL&dateRange=(start:(year:2023,month:10,day:1),end:(year:2024,month:10,day:1))&campaigns=List(urn%3Ali%3AsponsoredCampaign%3A123456)&fields=videoViews,pivotValues
EVENT_PAGES FIRST_QUARTILE videoFirstQuartileCompletions GET /rest/adAnalytics?q=analytics&pivot=CAMPAIGN&timeGranularity=ALL&dateRange=(start:(year:2023,month:10,day:1),end:(year:2024,month:10,day:1))&campaigns=List(urn%3Ali%3AsponsoredCampaign%3A123456)&fields=videoFirstQuartileCompletions,pivotValues
EVENT_PAGES MIDPOINT videoMidpointCompletions GET /rest/adAnalytics?q=analytics&pivot=CAMPAIGN&timeGranularity=ALL&dateRange=(start:(year:2023,month:10,day:1),end:(year:2024,month:10,day:1))&campaigns=List(urn%3Ali%3AsponsoredCampaign%3A123456)&fields=videoMidpointCompletions,pivotValues
EVENT_PAGES THIRD_QUARTILE videoThirdQuartileCompletions GET /rest/adAnalytics?q=analytics&pivot=CAMPAIGN&timeGranularity=ALL&dateRange=(start:(year:2023,month:10,day:1),end:(year:2024,month:10,day:1))&campaigns=List(urn%3Ali%3AsponsoredCampaign%3A123456)&fields=videoThirdQuartileCompletions,pivotValues
EVENT_PAGES FULL_COMPLETE videoCompletions GET /rest/adAnalytics?q=analytics&pivot=CAMPAIGN&timeGranularity=ALL&dateRange=(start:(year:2023,month:10,day:1),end:(year:2024,month:10,day:1))&campaigns=List(urn%3Ali%3AsponsoredCampaign%3A123456)&fields=videoCompletions,pivotValues
EVENT_PAGES ENGAGEMENT totalEngagements GET /rest/adAnalytics?q=analytics&pivot=CAMPAIGN&timeGranularity=ALL&dateRange=(start:(year:2023,month:10,day:1),end:(year:2024,month:10,day:1))&campaigns=List(urn%3Ali%3AsponsoredCampaign%3A123456)&fields=totalEngagements,pivotValues
EVENT_PAGES CLICK clicks GET /rest/adAnalytics?q=analytics&pivot=CAMPAIGN&timeGranularity=ALL&dateRange=(start:(year:2023,month:10,day:1),end:(year:2024,month:10,day:1))&campaigns=List(urn%3Ali%3AsponsoredCampaign%3A123456)&fields=clicks,pivotValues
Engagement Source Type Engagement Trigger Reference Field From Analytics or Statistics API API Request Example
VIDEO_ADS FIRST_QUARTILE videoFirstQuartileCompletions GET /rest/adAnalytics?q=analytics&pivot=CAMPAIGN&timeGranularity=ALL&dateRange=(start:(day:24,month:9,year:2020),end:(day:23,month:9,year:2021))&campaigns=List(urn%3Ali%3AsponsoredCampaign%3A123456)&fields=videoFirstQuartileCompletions,pivotValues
VIDEO_ADS MIDPOINT videoMidpointCompletions
VIDEO_ADS THIRD_QUARTILE videoThirdQuartileCompletions
VIDEO_ADS FULL_COMPLETE videoCompletions
LEAD_GEN_FORMS VIEW_FORM oneClickLeads
LEAD_GEN_FORMS LEAD_FORM_SUBMIT oneClickLeadFormOpens GET /rest/adAnalytics?q=analytics&pivot=CAMPAIGN&timeGranularity=ALL&dateRange=(start:(day:24,month:9,year:2020),end:(day:23,month:9,year:2021))&campaigns=List(urn%3Ali%3AsponsoredCampaign%3A123456)&fields=oneClickLeadFormOpens,pivotValues
ORGANIZATION_PAGES VIEW totalPageStatistics.views GET /rest/organizationPageStatistics?q=organization&organization=urn%3Ali%3Aorganization%3A73841066&timeIntervals=(timeRange:(start:1629926990000,end:1632518990000),timeGranularityType:MONTH)&fields=totalPageStatistics
ORGANIZATION_PAGES CTA_CLICK totalPageStatistics.clicks GET /rest/organizationPageStatistics?q=organization&organization=urn%3Ali%3Aorganization%3A73841066&timeIntervals=(timeRange:(start:1629926990000,end:1632518990000),timeGranularityType:MONTH)&fields=totalPageStatistics
SINGLE_IMAGE_ADS CLICK clicks GET /rest/adAnalytics?q=analytics&pivot=CAMPAIGN&timeGranularity=ALL&dateRange=(start:(day:24,month:9,year:2021),end:(day:23,month:2,year:2021))&campaigns=List(urn%3Ali%3AsponsoredCampaign%3A123456)&fields=clicks,pivotValues
SINGLE_IMAGE_ADS ENGAGEMENT totalEngagements GET /rest/adAnalytics?q=analytics&pivot=CAMPAIGN&timeGranularity=ALL&dateRange=(start:(day:24,month:9,year:2021),end:(day:23,month:2,year:2021))&campaigns=List(urn%3Ali%3AsponsoredCampaign%3A123456)&fields=totalEngagements,pivotValues

Create An Engagement Rule

Add or Remove an engagement rule from a dmp segment.

Schema

Field Name Type Description
engagementSource Urn The content urn that members are engaging with. For now, this could be a campaign or a organization urn.
engagementTrigger DMPEngagementTriggerUrn The action that users can take on the source. This could be viewed (2s, 25%, etc), visited, clicked, etc. E.g. urn:li:dmpEngagementTrigger:(urn:li:dmpEngagementSourceType:VIDEO_ADS,FIRST_QUARTILE). See more details at Get Engagement Trigger
timeFrame TimeSpan The time frame members engaged with the specified source urn with the specified engagement trigger. This should be a rolling time window like past 90 days.

TimeSpan

Object Name Field Name Type Description
TimeSpan duration long Represents the length of time
--- unit TimeUnit Represents the unit of the duration of time. Allowed Unit(s): DAY

Input Data Requirements and Validations

An input request will be validated and it will fail if the following validation rules are not met:

  • The DMP segment used must be valid, and must be created under the appropriate source platform as per this table and segment type USER.
  • The DMP segment must be accessible for the user.
  • Engagement rules under the same segment must have the same engagement trigger, time frame, and engagement source urn type (e.g. sponsoredCampaign, organization, etc)
  • Input engagement sources must be existing and accessible by the user making the request.
  • Input engagement sources must be supported by LinkedIn Ads platform for API requests.
  • Input engagement sources cannot be duplicates of an engagement source that already exists in the engagement rule.

Sample Request

POST https://api.linkedin.com/rest/dmpSegments/10000/engagementRules
{
    "engagementSource": "urn:li:sponsoredCampaign:358004465",
    "timeFrame": {
        "timeSpan": {
            "duration": 60,
            "unit": "DAY"
        }
    },
    "engagementTrigger": "urn:li:dmpEngagementTrigger:(urn:li:dmpEngagementSourceType:VIDEO_ADS,FIRST_QUARTILE)"
}

A successful response returns a 201 Created HTTP status code and the engagement rule ID in the X-LinkedIn-Id response header.

Create Multiple Engagement Rules

Sample Request (will fail)

The below example would fail multiple validation rules because the engagement triggers, time frame, and engagement source urn types are different.

{
    "elements": [
        {
            "engagementSource": "urn:li:sponsoredCampaign:10000",
            "timeFrame": {
                "timeSpan": {
                    "duration": 60,
                    "unit": "DAY"
                }
            },
            "engagementTrigger": "urn:li:dmpEngagementTrigger:(urn:li:dmpEngagementSourceType:VIDEO_ADS,FIRST_QUARTILE)"
        },
        {
            "engagementSource": "urn:li:campaignGroup:10001",
            "timeFrame": {
                "timeSpan": {
                    "duration": 30,
                    "unit": "DAY"
                }
            },
            "engagementTrigger": "urn:li:dmpEngagementTrigger:(urn:li:dmpEngagementSourceType:VIDEO_ADS,MIDPOINT)"
        }
    ]
}

Sample Request

POST https://api.linkedin.com/rest/dmpSegments/10000/engagementRules
{
    "elements": [
        {
            "engagementSource": "urn:li:sponsoredCampaign:10000",
            "timeFrame": {
                "timeSpan": {
                    "duration": 60,
                    "unit": "DAY"
                }
            },
            "engagementTrigger": "urn:li:dmpEngagementTrigger:(urn:li:dmpEngagementSourceType:VIDEO_ADS,FIRST_QUARTILE)"
        },
        {
            "engagementSource": "urn:li:sponsoredCampaign:10001",
            "timeFrame": {
                "timeSpan": {
                    "duration": 60,
                    "unit": "DAY"
                }
            },
            "engagementTrigger": "urn:li:dmpEngagementTrigger:(urn:li:dmpEngagementSourceType:VIDEO_ADS,FIRST_QUARTILE)"
        }
    ]
}

The response content will contain an id for each engagement rule created, along with the status code. A 201 will be returned if one engagement rule is created successfully.

{
    "elements": [
        {
            "location": "/dmpSegments/119436/engagementRules/28265",
            "id": "28265",
            "status": 201
        },
        {
            "location": "/dmpSegments/119436/engagementRules/28275",
            "id": "28275",
            "status": 201
        }
    ]
}

Delete An Engagement Rule

Delete an engagement rule using the dmp segment ID and engagement rule ID.

Note

If you have deleted all engagement rules under a segment, please do consider deleting the segment too.

Sample Request

DELETE https://api.linkedin.com/rest/dmpSegments/10000/engagementRules/10000

The response returns a 204 No Content HTTP status code if the deletion succeeds.

Delete Multiple Engagement Rules

Delete a batch of engagement rules using dmp segment IDs and engagement rule IDs. Note that all the engagement rules must be under the same dmp segment.

Note

If you have deleted all engagement rules under a segment, please do consider deleting the segment too.

Sample Request

DELETE https://api.linkedin.com/rest/dmpSegments/10000/engagementRules?ids=List(10001,10002)

The response returns a 204 code for each segment that has been deleted successfully. Or an error with error message for each segment that has failed to be deleted.

{
    "results": {
        "10001": {
            "status": 204
        },
        "10002": {
            "status": 204
        }
    },
    "errors": {}
}

Update An Engagement Rule

To ensure the data gets processed correctly, before updating an existing engagement rule, first delete the engagement rule and then create an engagement rule.

Note

After you delete an engagement rule, you must wait 5 seconds for the segment to be available to add any engagement rule.

Get An Engagement Rule

Schema

Field Name Type Description
created, lastModified long creation timestamp and last updated timestamp.
dmpSegmentId long The DMP segment id that this engagement retargeting rule belongs.
engagementSource Urn The content urn that members are engaging with.
engagementTrigger DMPEngagementTriggerUrn The action that users can take on the source.
id long The engagement rule id.
timeFrame TimeSpan The time frame members engaged with the specified source urn with the specified engagement trigger. This should be a rolling time window like past 90 days.

Sample Request

GET https://api.linkedin.com/rest/dmpSegments/10000/engagementRules/10001

Sample Response

{
    "engagementSource": "urn:li:sponsoredCampaign:10000",
    "created": 1631251849000,
    "dmpSegmentId": 10000,
    "lastModified": 1631251849000,
    "id": 10001,
    "timeFrame": {
        "timeSpan": {
            "duration": 60,
            "unit": "DAY"
        }
    },
    "engagementTrigger": "urn:li:dmpEngagementTrigger:(urn:li:dmpEngagementSourceType:VIDEO_ADS,FIRST_QUARTILE)"
}

Get All Engagement Rules

Get all engagement rules under one dmp segment.

Sample Request

GET https://api.linkedin.com/rest/dmpSegments/10000/engagementRules

Sample Response

{
    "elements": [
        {
            "engagementSource": "urn:li:sponsoredCampaign:358004465",
            "dmpSegmentId": 10000,
            "created": 1631308284000,
            "lastModified": 1631308284000,
            "id": 10001,
            "timeFrame": {
                "timeSpan": {
                    "duration": 60,
                    "unit": "DAY"
                }
            },
            "engagementTrigger": "urn:li:dmpEngagementTrigger:(urn:li:dmpEngagementSourceType:VIDEO_ADS,FIRST_QUARTILE)"
        },
        {
            "engagementSource": "urn:li:sponsoredCampaign:358072465",
            "dmpSegmentId": 10000,
            "created": 1631308284000,
            "lastModified": 1631308284000,
            "id": 10002,
            "timeFrame": {
                "timeSpan": {
                    "duration": 60,
                    "unit": "DAY"
                }
            },
            "engagementTrigger": "urn:li:dmpEngagementTrigger:(urn:li:dmpEngagementSourceType:VIDEO_ADS,FIRST_QUARTILE)"
        }
    ],
    "paging": {
        "count": 10,
        "start": 0,
        "links": []
    }
}

Get Engagement Source Type

Schema

Field Name Type Description
defaultLookBack TimeSpan The default look back window for this particular source. This value will be used if advertiser does not specify the look back window when creating engagement rules.
engagementSourceType string The engagement source type - e.g. VIDEO_ADS, LEAD_GEN_FORMS, etc.
engagementSourceTypeDescription MultiLocaleString The i18n human-readable string description for the engagement source type - e.g. 'Video Ads'.
engagementSourceTypeStatus DMPEngagementSourceTypeStatus The current status of this engagement source type - whether it's ACTIVE, DEPRECATED, or SOON_AVAILABLE.
maxLookBack TimeSpan The maximum look-back window for this particular source.
minLookBack TimeSpan The minimum look-back window for this particular source.
statusMessage MultiLocaleString An i18n string providing more information on the engagement source type status.

Sample Request

GET https://api.linkedin.com/rest/dmpEngagementSourceTypes/VIDEO_ADS

Sample Response

{
    "maxLookBack": {
        "duration": 365,
        "unit": "DAY"
    },
    "minLookBack": {
        "duration": 30,
        "unit": "DAY"
    },
    "engagementSourceTypeDescription": {
        "localized": {
            "ru_RU": "\u0412\u0438\u0434\u0435\u043e\u0440\u0435\u043a\u043b\u0430\u043c\u0430",
            "it_IT": "Annunci video",
            "pl_PL": "Reklamy wideo",
            "sv_SE": "Videoannonser",
            "ro_RO": "Reclame video",
            "da_DK": "Videoannoncer",
            "tr_TR": "Video reklamlar\u0131",
            "tl_PH": "Mga video ad",
            "pt_BR": "An\u00fancios em v\u00eddeo",
            "th_TH": "\u0e42\u0e06\u0e29\u0e13\u0e32\u0e41\u0e1a\u0e1a\u0e27\u0e34\u0e14\u0e35\u0e42\u0e2d",
            "fr_FR": "Video Ads",
            "ja_JP": "\u52d5\u753b\u5e83\u544a",
            "cs_CZ": "Video reklamy",
            "in_ID": "Iklan video",
            "de_DE": "Video Ads",
            "ms_MY": "Iklan video",
            "zh_TW": "\u5f71\u7247\u5ee3\u544a",
            "ko_KR": "\ub3d9\uc601\uc0c1 \uad11\uace0",
            "en_US": "Video ads",
            "es_ES": "Anuncios de v\u00eddeo",
            "zh_CN": "\u89c6\u9891\u5e7f\u544a",
            "ar_AE": "\u0625\u0639\u0644\u0627\u0646\u0627\u062a \u0627\u0644\u0641\u064a\u062f\u064a\u0648",
            "no_NO": "Videoannonser",
            "nl_NL": "Video-advertenties"
        },
        "preferredLocale": {
            "country": "US",
            "language": "en"
        }
    },
    "engagementSourceType": "VIDEO_ADS",
    "statusMessage": {
        "localized": {
            "ru_RU": "\u042d\u0442\u043e\u0442 \u0442\u0438\u043f \u0438\u0441\u0442\u043e\u0447\u043d\u0438\u043a\u0430 \u0432\u043e\u0432\u043b\u0435\u0447\u0435\u043d\u0438\u044f \u0433\u043e\u0442\u043e\u0432 \u0438 \u0434\u043e\u0441\u0442\u0443\u043f\u0435\u043d \u0434\u043b\u044f \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u043d\u0438\u044f",
            "it_IT": "Questo tipo di fonte di interazione \u00e8 pronto e disponibile per l\u2019utilizzo in produzione",
            "pl_PL": "Ten typ \u017ar\u00f3d\u0142a zaanga\u017cowania jest gotowy i dost\u0119pny do wykorzystania w produkcji",
            "sv_SE": "Den h\u00e4r typen av aktivitetsk\u00e4lla \u00e4r f\u00e4rdig och tillg\u00e4nglig f\u00f6r anv\u00e4ndning i produktion",
            "ro_RO": "Acest tip de surs\u0103 de interac\u021biune este gata \u0219i disponibil pentru a fi utilizat \u00een produc\u021bie",
            "da_DK": "Denne engagementskildetype er klar og tilg\u00e6ngelig til brug i produktionen",
            "tr_TR": "Bu etkile\u015fim kayna\u011f\u0131 t\u00fcr\u00fc, prod\u00fcksiyonda kullan\u0131lmak \u00fczere haz\u0131rd\u0131r",
            "tl_PH": "Handa at available nang gamitin sa produksyon ang uring ito ng source ng pakikipag-ugnayan",
            "pt_BR": "Este tipo de fonte de engajamento est\u00e1 pronto e dispon\u00edvel para ser usado na produ\u00e7\u00e3o",
            "th_TH": "\u0e1b\u0e23\u0e30\u0e40\u0e20\u0e17\u0e41\u0e2b\u0e25\u0e48\u0e07\u0e02\u0e49\u0e2d\u0e21\u0e39\u0e25\u0e01\u0e32\u0e23\u0e21\u0e35\u0e2a\u0e48\u0e27\u0e19\u0e23\u0e48\u0e27\u0e21\u0e19\u0e35\u0e49\u0e1e\u0e23\u0e49\u0e2d\u0e21\u0e43\u0e0a\u0e49\u0e07\u0e32\u0e19\u0e41\u0e25\u0e30\u0e21\u0e35\u0e43\u0e2b\u0e49\u0e43\u0e0a\u0e49\u0e07\u0e32\u0e19\u0e41\u0e25\u0e49\u0e27\u0e43\u0e19\u0e01\u0e32\u0e23\u0e1c\u0e25\u0e34\u0e15",
            "fr_FR": "Ce type de source d\u2019engagement est pr\u00eat et disponible pour utilisation dans la production",
            "ja_JP": "\u3053\u306e\u30a8\u30f3\u30b2\u30fc\u30b8\u30e1\u30f3\u30c8\u30bd\u30fc\u30b9\u30bf\u30a4\u30d7\u306f\u3001\u6e96\u5099\u304c\u3067\u304d\u3066\u304a\u308a\u3001\u672c\u756a\u74b0\u5883\u3067\u5229\u7528\u53ef\u80fd\u3067\u3059",
            "cs_CZ": "Tento typ zdroje u\u017eivatelsk\u00e9 aktivity je p\u0159ipraven k pou\u017eit\u00ed",
            "in_ID": "Tipe sumber interaksi ini sudah siap dan tersedia untuk digunakan dalam produksi",
            "de_DE": "Diese Engagement-Quelle ist verf\u00fcgbar und kann verwendet werden.",
            "ms_MY": "Jenis sumber penglibatan sudah sedia dan boleh digunakan dalam pengeluaran",
            "zh_TW": "\u6b64\u4e92\u52d5\u4f86\u6e90\u985e\u578b\u5df2\u6e96\u5099\u5c31\u7dd2\uff0c\u53ef\u5728\u751f\u7522\u74b0\u5883\u4e2d\u4f7f\u7528",
            "ko_KR": "\uc774 \ucc38\uc5ec \uc18c\uc2a4 \uc720\ud615\uc774 \uc900\ube44\ub418\uc5c8\uc73c\uba70 \uc81c\uc791 \ub2e8\uacc4\uc5d0\uc11c \uc0ac\uc6a9\ud560 \uc218 \uc788\uc2b5\ub2c8\ub2e4.",
            "en_US": "This engagement source type is ready and available to be used in production",
            "es_ES": "Este tipo de fuente de interacci\u00f3n est\u00e1 listo y disponible para usarse en producci\u00f3n",
            "zh_CN": "\u6b64\u53c2\u4e0e\u6e90\u7c7b\u578b\u5df2\u51c6\u5907\u5c31\u7eea\uff0c\u53ef\u7528\u4e8e\u5236\u4f5c",
            "ar_AE": "\u0646\u0648\u0639 \u0645\u0635\u062f\u0631 \u0627\u0644\u062a\u0641\u0627\u0639\u0644 \u0647\u0630\u0627 \u062c\u0627\u0647\u0632 \u0648\u0645\u062a\u0627\u062d \u0644\u0644\u0627\u0633\u062a\u062e\u062f\u0627\u0645 \u0641\u064a \u0627\u0644\u0625\u0646\u062a\u0627\u062c",
            "no_NO": "Denne kildetypen for engasjement er klar og tilgjengelig for bruk i produksjon",
            "nl_NL": "Dit type interactiebron is klaar en beschikbaar voor gebruik in productie"
        },
        "preferredLocale": {
            "country": "US",
            "language": "en"
        }
    },
    "engagementSourceTypeStatus": "ACTIVE",
    "defaultLookBack": {
        "duration": 90,
        "unit": "DAY"
    }
}

Get All Supported Engagement Source Types

Sample Request

GET https://api.linkedin.com/rest/dmpEngagementSourceTypes

The response will return all supported engagement source types.

Get Engagement Trigger

Schema

Field Name Type Description
default boolean Whether this engagement trigger will be selected by default.
engagementSourceType string The engagement source type - e.g. VIDEO_ADS, LEAD_GEN_FORMS, etc.
engagementTrigger string The engagement trigger - e.g. FIRST_QUARTILE (video ads), SUBMITTED (lead-gen forms), etc.
engagementTriggerDescription MultiLocaleString The i18n human-readable string description for the engagement source type - e.g. '25% Video Viewers'.
engagementTriggerStatus DMPEngagementTriggerStatus The current status of this engagement trigger - whether it's ACTIVE, DEPRECATED, or SOON_AVAILABLE.
statusMessage MultiLocaleString An i18n string providing more information on the engagement source type status.

Sample Request

GET https://api.linkedin.com/rest/dmpEngagementSourceTypes/VIDEO_ADS/dmpEngagementTriggers/FIRST_QUARTILE

Sample Response

{
    "default": true,
    "engagementTriggerStatus": "ACTIVE",
    "engagementTriggerDescription": {
        "localized": {
            "it_IT": "Persone che hanno visualizzato almeno il 25%\u00a0del tuo annuncio video",
            "ru_RU": "\u041b\u044e\u0434\u0438, \u043f\u0440\u043e\u0441\u043c\u043e\u0442\u0440\u0435\u0432\u0448\u0438\u0435 \u043d\u0435 \u043c\u0435\u043d\u0435\u0435 25%\u00a0\u0432\u0430\u0448\u0435\u0439 \u0432\u0438\u0434\u0435\u043e\u0440\u0435\u043a\u043b\u0430\u043c\u044b",
            "pl_PL": "Osoby, kt\u00f3re obejrza\u0142y co najmniej 25%\u00a0Twojej reklamy wideo",
            "ro_RO": "Persoane care au vizionat cel pu\u021bin 25%\u00a0din reclama dvs. video",
            "tr_TR": "Video reklam\u0131n\u0131z\u0131n en az\u00a0%25\u2018ini izleyen ki\u015filer",
            "tl_PH": "Mga tao na tumingin nang hindi bababa sa 25%\u00a0ng iyong video ad",
            "pt_BR": "Pessoas que visualizaram pelo menos 25%\u00a0do seu an\u00fancio em v\u00eddeo",
            "th_TH": "\u0e1c\u0e39\u0e49\u0e04\u0e19\u0e17\u0e35\u0e48\u0e40\u0e04\u0e22\u0e23\u0e31\u0e1a\u0e0a\u0e21\u0e42\u0e06\u0e29\u0e13\u0e32\u0e41\u0e1a\u0e1a\u0e27\u0e34\u0e14\u0e35\u0e42\u0e2d\u0e02\u0e2d\u0e07\u0e04\u0e38\u0e13\u0e2d\u0e22\u0e48\u0e32\u0e07\u0e19\u0e49\u0e2d\u0e22 25%",
            "fr_FR": "Personnes ayant visionn\u00e9 au moins 25%\u00a0de votre publicit\u00e9 vid\u00e9o",
            "ja_JP": "\u3042\u306a\u305f\u306e\u52d5\u753b\u5e83\u544a\u306e25%\u4ee5\u4e0a\u3092\u95b2\u89a7\u3057\u305f\u30e6\u30fc\u30b6\u30fc",
            "cs_CZ": "Lid\u00e9, kte\u0159\u00ed si zobrazili alespo\u0148 25\u00a0%\u00a0va\u0161\u00ed video reklamy",
            "in_ID": "Orang yang melihat setidaknya 25%\u00a0iklan video Anda",
            "de_DE": "Personen, die Ihre Video Ad zu mindestens 25\u00a0%\u00a0angesehen haben",
            "ms_MY": "Orang yang menonton sekurang-kurangnya 25%\u00a0iklan video anda",
            "zh_TW": "\u89c0\u770b\u4e86\u81f3\u5c11 25%\u00a0\u5f71\u7247\u5ee3\u544a\u7684\u6703\u54e1",
            "es_ES": "Personas que han visto al menos el 25\u00a0%\u00a0de tu anuncio de v\u00eddeo",
            "nl_NL": "Personen die minstens 25%\u00a0van uw videoadvertentie hebben bekeken",
            "sv_SE": "Personer som tittade p\u00e5 minst 25\u00a0%\u00a0av din filmannons",
            "da_DK": "Personer, der har set mindst 25\u00a0%\u00a0af din videoannonce",
            "ko_KR": "\ub3d9\uc601\uc0c1 \uad11\uace0\ub97c 25%\u00a0\uc774\uc0c1 \ubcf8 \uc0ac\ub78c",
            "en_US": "People who viewed at least 25% of your video ad",
            "zh_CN": "\u81f3\u5c11\u89c2\u770b\u4e86 25%\u00a0\u7684\u89c6\u9891\u5e7f\u544a\u7684\u4f1a\u5458",
            "ar_AE": "\u0627\u0644\u0623\u0634\u062e\u0627\u0635 \u0627\u0644\u0630\u064a\u0646 \u0634\u0627\u0647\u062f\u0648\u0627 \u0645\u0627 \u0644\u0627 \u064a\u0642\u0644 \u0639\u0646 25\u066a \u0645\u0646 \u0625\u0639\u0644\u0627\u0646\u0627\u062a \u0627\u0644\u0641\u064a\u062f\u064a\u0648 \u0627\u0644\u062e\u0627\u0635\u0629 \u0628\u0643",
            "no_NO": "Personer som s\u00e5 minst 25\u00a0%\u00a0av videoannonsen din"
        },
        "preferredLocale": {
            "country": "US",
            "language": "en"
        }
    },
    "engagementSourceType": "VIDEO_ADS",
    "statusMessage": {
        "localized": {
            "it_IT": "Questo trigger di interazione \u00e8 pronto e disponibile per l\u2019utilizzo in produzione",
            "ru_RU": "\u042d\u0442\u043e\u0442 \u0442\u0440\u0438\u0433\u0433\u0435\u0440 \u0432\u043e\u0432\u043b\u0435\u0447\u0435\u043d\u0438\u044f \u0433\u043e\u0442\u043e\u0432 \u0438 \u0434\u043e\u0441\u0442\u0443\u043f\u0435\u043d \u0434\u043b\u044f \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u043d\u0438\u044f",
            "pl_PL": "Ten wyzwalacz zaanga\u017cowania jest gotowy i dost\u0119pny do wykorzystania w produkcji",
            "ro_RO": "Acest declan\u0219ator de interac\u021biune este preg\u0103tit \u0219i disponibil pentru a fi utilizat \u00een produc\u021bie",
            "tr_TR": "Bu etkile\u015fim ba\u015flatma arac\u0131, prod\u00fcksiyonda kullan\u0131lmak \u00fczere haz\u0131rd\u0131r",
            "tl_PH": "Ang engagement trigger na ito ay handa at available na para gamitin sa produksyon",
            "pt_BR": "Este gatilho de engajamento est\u00e1 pronto e dispon\u00edvel para ser usado na produ\u00e7\u00e3o",
            "th_TH": "\u0e17\u0e23\u0e34\u0e01\u0e40\u0e01\u0e2d\u0e23\u0e4c\u0e01\u0e32\u0e23\u0e21\u0e35\u0e2a\u0e48\u0e27\u0e19\u0e23\u0e48\u0e27\u0e21\u0e19\u0e35\u0e49\u0e1e\u0e23\u0e49\u0e2d\u0e21\u0e43\u0e0a\u0e49\u0e07\u0e32\u0e19\u0e41\u0e25\u0e30\u0e21\u0e35\u0e43\u0e2b\u0e49\u0e43\u0e0a\u0e49\u0e07\u0e32\u0e19\u0e41\u0e25\u0e49\u0e27\u0e43\u0e19\u0e01\u0e32\u0e23\u0e1c\u0e25\u0e34\u0e15",
            "fr_FR": "Ce facteur d\u2019engagement est pr\u00eat et disponible pour utilisation dans la production",
            "ja_JP": "\u3053\u306e\u30a8\u30f3\u30b2\u30fc\u30b8\u30e1\u30f3\u30c8\u30c8\u30ea\u30ac\u30fc\u306f\u3001\u6e96\u5099\u304c\u3067\u304d\u3066\u304a\u308a\u3001\u672c\u756a\u74b0\u5883\u3067\u5229\u7528\u53ef\u80fd\u3067\u3059",
            "cs_CZ": "Tento spou\u0161t\u011b\u010d u\u017eivatelsk\u00e9 aktivity je p\u0159ipraven k pou\u017eit\u00ed",
            "in_ID": "Pemicu interaksi ini sudah siap dan tersedia untuk digunakan dalam produksi",
            "de_DE": "Dieser Engagement-Trigger ist verf\u00fcgbar und kann verwendet werden.",
            "ms_MY": "Pencetus penglibatan ini sudah sedia dan boleh digunakan dalam pengeluaran",
            "zh_TW": "\u6b64\u4e92\u52d5\u89f8\u767c\u689d\u4ef6\u5df2\u6e96\u5099\u5c31\u7dd2\uff0c\u53ef\u5728\u751f\u7522\u74b0\u5883\u4e2d\u4f7f\u7528",
            "es_ES": "Este factor de interacci\u00f3n est\u00e1 listo y disponible para usarse en producci\u00f3n",
            "nl_NL": "Deze trigger voor interactie is klaar en beschikbaar voor gebruik in productie",
            "sv_SE": "Den h\u00e4r aktivitetsutl\u00f6saren \u00e4r klar och tillg\u00e4nglig f\u00f6r att anv\u00e4ndas",
            "da_DK": "Denne engagementsudl\u00f8ser er klar og tilg\u00e6ngelig til brug i produktionen",
            "ko_KR": "\uc774 \ucc38\uc5ec \ud2b8\ub9ac\uac70\uac00 \uc900\ube44\ub418\uc5c8\uc73c\uba70 \ud604\uc7ac \uc6f9\uc0ac\uc774\ud2b8\uc5d0\uc11c \uc774\uc6a9 \uac00\ub2a5\ud569\ub2c8\ub2e4.",
            "en_US": "This engagement trigger is ready and available to be used in production",
            "zh_CN": "\u6b64\u53c2\u4e0e\u89e6\u53d1\u5668\u5df2\u51c6\u5907\u5c31\u7eea\uff0c\u53ef\u7528\u4e8e\u5236\u4f5c",
            "ar_AE": "\u0645\u064f\u0641\u0639\u0644 \u0627\u0644\u0645\u0634\u0627\u0631\u0643\u0629 \u0647\u0630\u0627 \u062c\u0627\u0647\u0632 \u0648\u0645\u062a\u0627\u062d \u0644\u0644\u0627\u0633\u062a\u062e\u062f\u0627\u0645 \u0641\u064a \u0627\u0644\u0625\u0646\u062a\u0627\u062c",
            "no_NO": "Denne engasjementsutl\u00f8seren er klar og tilgjengelig for bruk i produksjon"
        },
        "preferredLocale": {
            "country": "US",
            "language": "en"
        }
    },
    "engagementTrigger": "FIRST_QUARTILE"
}

Get All Supported Engagement Triggers

Get all supported engagement triggers under one engagement source type

Sample Request

GET https://api.linkedin.com/rest/dmpEngagementSourceTypes/VIDEO_ADS/dmpEngagementTriggers

The response will return all supported engagement triggers for the engagement source type, along with the status. Please note that the below example shows a partial response.

{
    "elements": [
        {
            "default": true,
            "engagementTriggerStatus": "ACTIVE",
            "engagementTriggerDescription": {
                "localized": {
                    "it_IT": "Persone che hanno visualizzato almeno il 25%\u00a0del tuo annuncio video",
                    "ru_RU": "\u041b\u044e\u0434\u0438, \u043f\u0440\u043e\u0441\u043c\u043e\u0442\u0440\u0435\u0432\u0448\u0438\u0435 \u043d\u0435 \u043c\u0435\u043d\u0435\u0435 25%\u00a0\u0432\u0430\u0448\u0435\u0439 \u0432\u0438\u0434\u0435\u043e\u0440\u0435\u043a\u043b\u0430\u043c\u044b",
                    "pl_PL": "Osoby, kt\u00f3re obejrza\u0142y co najmniej 25%\u00a0Twojej reklamy wideo",
                    "ro_RO": "Persoane care au vizionat cel pu\u021bin 25%\u00a0din reclama dvs. video",
                    "tr_TR": "Video reklam\u0131n\u0131z\u0131n en az\u00a0%25\u2018ini izleyen ki\u015filer",
                    "tl_PH": "Mga tao na tumingin nang hindi bababa sa 25%\u00a0ng iyong video ad",
                    "pt_BR": "Pessoas que visualizaram pelo menos 25%\u00a0do seu an\u00fancio em v\u00eddeo",
                    "th_TH": "\u0e1c\u0e39\u0e49\u0e04\u0e19\u0e17\u0e35\u0e48\u0e40\u0e04\u0e22\u0e23\u0e31\u0e1a\u0e0a\u0e21\u0e42\u0e06\u0e29\u0e13\u0e32\u0e41\u0e1a\u0e1a\u0e27\u0e34\u0e14\u0e35\u0e42\u0e2d\u0e02\u0e2d\u0e07\u0e04\u0e38\u0e13\u0e2d\u0e22\u0e48\u0e32\u0e07\u0e19\u0e49\u0e2d\u0e22 25%",
                    "fr_FR": "Personnes ayant visionn\u00e9 au moins 25%\u00a0de votre publicit\u00e9 vid\u00e9o",
                    "ja_JP": "\u3042\u306a\u305f\u306e\u52d5\u753b\u5e83\u544a\u306e25%\u4ee5\u4e0a\u3092\u95b2\u89a7\u3057\u305f\u30e6\u30fc\u30b6\u30fc",
                    "cs_CZ": "Lid\u00e9, kte\u0159\u00ed si zobrazili alespo\u0148 25\u00a0%\u00a0va\u0161\u00ed video reklamy",
                    "in_ID": "Orang yang melihat setidaknya 25%\u00a0iklan video Anda",
                    "de_DE": "Personen, die Ihre Video Ad zu mindestens 25\u00a0%\u00a0angesehen haben",
                    "ms_MY": "Orang yang menonton sekurang-kurangnya 25%\u00a0iklan video anda",
                    "zh_TW": "\u89c0\u770b\u4e86\u81f3\u5c11 25%\u00a0\u5f71\u7247\u5ee3\u544a\u7684\u6703\u54e1",
                    "es_ES": "Personas que han visto al menos el 25\u00a0%\u00a0de tu anuncio de v\u00eddeo",
                    "nl_NL": "Personen die minstens 25%\u00a0van uw videoadvertentie hebben bekeken",
                    "sv_SE": "Personer som tittade p\u00e5 minst 25\u00a0%\u00a0av din filmannons",
                    "da_DK": "Personer, der har set mindst 25\u00a0%\u00a0af din videoannonce",
                    "ko_KR": "\ub3d9\uc601\uc0c1 \uad11\uace0\ub97c 25%\u00a0\uc774\uc0c1 \ubcf8 \uc0ac\ub78c",
                    "en_US": "People who viewed at least 25% of your video ad",
                    "zh_CN": "\u81f3\u5c11\u89c2\u770b\u4e86 25%\u00a0\u7684\u89c6\u9891\u5e7f\u544a\u7684\u4f1a\u5458",
                    "ar_AE": "\u0627\u0644\u0623\u0634\u062e\u0627\u0635 \u0627\u0644\u0630\u064a\u0646 \u0634\u0627\u0647\u062f\u0648\u0627 \u0645\u0627 \u0644\u0627 \u064a\u0642\u0644 \u0639\u0646 25\u066a \u0645\u0646 \u0625\u0639\u0644\u0627\u0646\u0627\u062a \u0627\u0644\u0641\u064a\u062f\u064a\u0648 \u0627\u0644\u062e\u0627\u0635\u0629 \u0628\u0643",
                    "no_NO": "Personer som s\u00e5 minst 25\u00a0%\u00a0av videoannonsen din"
                },
                "preferredLocale": {
                    "country": "US",
                    "language": "en"
                }
            },
            "engagementSourceType": "VIDEO_ADS",
            "statusMessage": {
                "localized": {
                    "it_IT": "Questo trigger di interazione \u00e8 pronto e disponibile per l\u2019utilizzo in produzione",
                    "ru_RU": "\u042d\u0442\u043e\u0442 \u0442\u0440\u0438\u0433\u0433\u0435\u0440 \u0432\u043e\u0432\u043b\u0435\u0447\u0435\u043d\u0438\u044f \u0433\u043e\u0442\u043e\u0432 \u0438 \u0434\u043e\u0441\u0442\u0443\u043f\u0435\u043d \u0434\u043b\u044f \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u043d\u0438\u044f",
                    "pl_PL": "Ten wyzwalacz zaanga\u017cowania jest gotowy i dost\u0119pny do wykorzystania w produkcji",
                    "ro_RO": "Acest declan\u0219ator de interac\u021biune este preg\u0103tit \u0219i disponibil pentru a fi utilizat \u00een produc\u021bie",
                    "tr_TR": "Bu etkile\u015fim ba\u015flatma arac\u0131, prod\u00fcksiyonda kullan\u0131lmak \u00fczere haz\u0131rd\u0131r",
                    "tl_PH": "Ang engagement trigger na ito ay handa at available na para gamitin sa produksyon",
                    "pt_BR": "Este gatilho de engajamento est\u00e1 pronto e dispon\u00edvel para ser usado na produ\u00e7\u00e3o",
                    "th_TH": "\u0e17\u0e23\u0e34\u0e01\u0e40\u0e01\u0e2d\u0e23\u0e4c\u0e01\u0e32\u0e23\u0e21\u0e35\u0e2a\u0e48\u0e27\u0e19\u0e23\u0e48\u0e27\u0e21\u0e19\u0e35\u0e49\u0e1e\u0e23\u0e49\u0e2d\u0e21\u0e43\u0e0a\u0e49\u0e07\u0e32\u0e19\u0e41\u0e25\u0e30\u0e21\u0e35\u0e43\u0e2b\u0e49\u0e43\u0e0a\u0e49\u0e07\u0e32\u0e19\u0e41\u0e25\u0e49\u0e27\u0e43\u0e19\u0e01\u0e32\u0e23\u0e1c\u0e25\u0e34\u0e15",
                    "fr_FR": "Ce facteur d\u2019engagement est pr\u00eat et disponible pour utilisation dans la production",
                    "ja_JP": "\u3053\u306e\u30a8\u30f3\u30b2\u30fc\u30b8\u30e1\u30f3\u30c8\u30c8\u30ea\u30ac\u30fc\u306f\u3001\u6e96\u5099\u304c\u3067\u304d\u3066\u304a\u308a\u3001\u672c\u756a\u74b0\u5883\u3067\u5229\u7528\u53ef\u80fd\u3067\u3059",
                    "cs_CZ": "Tento spou\u0161t\u011b\u010d u\u017eivatelsk\u00e9 aktivity je p\u0159ipraven k pou\u017eit\u00ed",
                    "in_ID": "Pemicu interaksi ini sudah siap dan tersedia untuk digunakan dalam produksi",
                    "de_DE": "Dieser Engagement-Trigger ist verf\u00fcgbar und kann verwendet werden.",
                    "ms_MY": "Pencetus penglibatan ini sudah sedia dan boleh digunakan dalam pengeluaran",
                    "zh_TW": "\u6b64\u4e92\u52d5\u89f8\u767c\u689d\u4ef6\u5df2\u6e96\u5099\u5c31\u7dd2\uff0c\u53ef\u5728\u751f\u7522\u74b0\u5883\u4e2d\u4f7f\u7528",
                    "es_ES": "Este factor de interacci\u00f3n est\u00e1 listo y disponible para usarse en producci\u00f3n",
                    "nl_NL": "Deze trigger voor interactie is klaar en beschikbaar voor gebruik in productie",
                    "sv_SE": "Den h\u00e4r aktivitetsutl\u00f6saren \u00e4r klar och tillg\u00e4nglig f\u00f6r att anv\u00e4ndas",
                    "da_DK": "Denne engagementsudl\u00f8ser er klar og tilg\u00e6ngelig til brug i produktionen",
                    "ko_KR": "\uc774 \ucc38\uc5ec \ud2b8\ub9ac\uac70\uac00 \uc900\ube44\ub418\uc5c8\uc73c\uba70 \ud604\uc7ac \uc6f9\uc0ac\uc774\ud2b8\uc5d0\uc11c \uc774\uc6a9 \uac00\ub2a5\ud569\ub2c8\ub2e4.",
                    "en_US": "This engagement trigger is ready and available to be used in production",
                    "zh_CN": "\u6b64\u53c2\u4e0e\u89e6\u53d1\u5668\u5df2\u51c6\u5907\u5c31\u7eea\uff0c\u53ef\u7528\u4e8e\u5236\u4f5c",
                    "ar_AE": "\u0645\u064f\u0641\u0639\u0644 \u0627\u0644\u0645\u0634\u0627\u0631\u0643\u0629 \u0647\u0630\u0627 \u062c\u0627\u0647\u0632 \u0648\u0645\u062a\u0627\u062d \u0644\u0644\u0627\u0633\u062a\u062e\u062f\u0627\u0645 \u0641\u064a \u0627\u0644\u0625\u0646\u062a\u0627\u062c",
                    "no_NO": "Denne engasjementsutl\u00f8seren er klar og tilgjengelig for bruk i produksjon"
                },
                "preferredLocale": {
                    "country": "US",
                    "language": "en"
                }
            },
            "engagementTrigger": "FIRST_QUARTILE"
        },
        {
            "default": false,
            "engagementTriggerStatus": "ACTIVE",
            "engagementTriggerDescription": {
                "localized": {
                    "it_IT": "Persone che hanno visualizzato almeno il 97%\u00a0del tuo annuncio video",
                    "ru_RU": "\u041b\u044e\u0434\u0438, \u043f\u0440\u043e\u0441\u043c\u043e\u0442\u0440\u0435\u0432\u0448\u0438\u0435 \u043d\u0435 \u043c\u0435\u043d\u0435\u0435 97%\u00a0\u0432\u0430\u0448\u0435\u0439 \u0432\u0438\u0434\u0435\u043e\u0440\u0435\u043a\u043b\u0430\u043c\u044b",
                    "pl_PL": "Osoby, kt\u00f3re obejrza\u0142y co najmniej 97%\u00a0Twojej reklamy wideo",
                    "ro_RO": "Persoane care au vizionat cel pu\u021bin 97%\u00a0din reclama dvs. video",
                    "tr_TR": "Video reklam\u0131n\u0131z\u0131n en az\u00a0%97\u2018sini izleyen ki\u015filer",
                    "tl_PH": "Mga tao na tumingin nang hindi bababa sa 97%\u00a0ng iyong video ad",
                    "pt_BR": "Pessoas que visualizaram pelo menos 97%\u00a0do seu an\u00fancio em v\u00eddeo",
                    "th_TH": "\u0e1c\u0e39\u0e49\u0e04\u0e19\u0e17\u0e35\u0e48\u0e40\u0e04\u0e22\u0e23\u0e31\u0e1a\u0e0a\u0e21\u0e42\u0e06\u0e29\u0e13\u0e32\u0e41\u0e1a\u0e1a\u0e27\u0e34\u0e14\u0e35\u0e42\u0e2d\u0e02\u0e2d\u0e07\u0e04\u0e38\u0e13\u0e2d\u0e22\u0e48\u0e32\u0e07\u0e19\u0e49\u0e2d\u0e22 97%",
                    "fr_FR": "Personnes ayant visionn\u00e9 au moins 97%\u00a0de votre publicit\u00e9 vid\u00e9o",
                    "ja_JP": "\u3042\u306a\u305f\u306e\u52d5\u753b\u5e83\u544a\u306e97%\u4ee5\u4e0a\u3092\u95b2\u89a7\u3057\u305f\u30e6\u30fc\u30b6\u30fc",
                    "cs_CZ": "Lid\u00e9, kte\u0159\u00ed si zobrazili alespo\u0148 97%\u00a0va\u0161\u00ed video reklamy",
                    "in_ID": "Orang yang melihat setidaknya 97%\u00a0iklan video Anda",
                    "de_DE": "Personen, die Ihre Video Ad zu mindestens 97\u00a0%\u00a0angesehen haben",
                    "ms_MY": "Orang yang menonton sekurang-kurangnya 97%\u00a0iklan video anda",
                    "zh_TW": "\u89c0\u770b\u4e86\u81f3\u5c11 97%\u00a0\u5f71\u7247\u5ee3\u544a\u7684\u6703\u54e1",
                    "es_ES": "Personas que han visto al menos el 97\u00a0%\u00a0de tu anuncio de v\u00eddeo",
                    "nl_NL": "Personen die minstens 97%\u00a0van uw videoadvertentie hebben bekeken",
                    "sv_SE": "Personer som tittade p\u00e5 minst 97\u00a0%\u00a0av din filmannons",
                    "da_DK": "Personer, der har set mindst 97%\u00a0af din videoannonce",
                    "ko_KR": "\ub3d9\uc601\uc0c1 \uad11\uace0\ub97c 97%\u00a0\uc774\uc0c1 \ubcf8 \uc0ac\ub78c",
                    "en_US": "People who viewed at least 97% of your video ad",
                    "zh_CN": "\u81f3\u5c11\u89c2\u770b\u4e86 97%\u00a0\u7684\u89c6\u9891\u5e7f\u544a\u7684\u4f1a\u5458",
                    "ar_AE": "\u0627\u0644\u0623\u0634\u062e\u0627\u0635 \u0627\u0644\u0630\u064a\u0646 \u0634\u0627\u0647\u062f\u0648\u0627 \u0645\u0627 \u0644\u0627 \u064a\u0642\u0644 \u0639\u0646 \u0669\u0667\u066a \u0645\u0646 \u0625\u0639\u0644\u0627\u0646\u0643 \u0627\u0644\u0645\u0635\u0648\u0631",
                    "no_NO": "Personer som s\u00e5 minst 97\u00a0%\u00a0av videoannonsen din"
                },
                "preferredLocale": {
                    "country": "US",
                    "language": "en"
                }
            },
            "engagementSourceType": "VIDEO_ADS",
            "statusMessage": {
                "localized": {
                    "it_IT": "Questo trigger di interazione \u00e8 pronto e disponibile per l\u2019utilizzo in produzione",
                    "ru_RU": "\u042d\u0442\u043e\u0442 \u0442\u0440\u0438\u0433\u0433\u0435\u0440 \u0432\u043e\u0432\u043b\u0435\u0447\u0435\u043d\u0438\u044f \u0433\u043e\u0442\u043e\u0432 \u0438 \u0434\u043e\u0441\u0442\u0443\u043f\u0435\u043d \u0434\u043b\u044f \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u043d\u0438\u044f",
                    "pl_PL": "Ten wyzwalacz zaanga\u017cowania jest gotowy i dost\u0119pny do wykorzystania w produkcji",
                    "ro_RO": "Acest declan\u0219ator de interac\u021biune este preg\u0103tit \u0219i disponibil pentru a fi utilizat \u00een produc\u021bie",
                    "tr_TR": "Bu etkile\u015fim ba\u015flatma arac\u0131, prod\u00fcksiyonda kullan\u0131lmak \u00fczere haz\u0131rd\u0131r",
                    "tl_PH": "Ang engagement trigger na ito ay handa at available na para gamitin sa produksyon",
                    "pt_BR": "Este gatilho de engajamento est\u00e1 pronto e dispon\u00edvel para ser usado na produ\u00e7\u00e3o",
                    "th_TH": "\u0e17\u0e23\u0e34\u0e01\u0e40\u0e01\u0e2d\u0e23\u0e4c\u0e01\u0e32\u0e23\u0e21\u0e35\u0e2a\u0e48\u0e27\u0e19\u0e23\u0e48\u0e27\u0e21\u0e19\u0e35\u0e49\u0e1e\u0e23\u0e49\u0e2d\u0e21\u0e43\u0e0a\u0e49\u0e07\u0e32\u0e19\u0e41\u0e25\u0e30\u0e21\u0e35\u0e43\u0e2b\u0e49\u0e43\u0e0a\u0e49\u0e07\u0e32\u0e19\u0e41\u0e25\u0e49\u0e27\u0e43\u0e19\u0e01\u0e32\u0e23\u0e1c\u0e25\u0e34\u0e15",
                    "fr_FR": "Ce facteur d\u2019engagement est pr\u00eat et disponible pour utilisation dans la production",
                    "ja_JP": "\u3053\u306e\u30a8\u30f3\u30b2\u30fc\u30b8\u30e1\u30f3\u30c8\u30c8\u30ea\u30ac\u30fc\u306f\u3001\u6e96\u5099\u304c\u3067\u304d\u3066\u304a\u308a\u3001\u672c\u756a\u74b0\u5883\u3067\u5229\u7528\u53ef\u80fd\u3067\u3059",
                    "cs_CZ": "Tento spou\u0161t\u011b\u010d u\u017eivatelsk\u00e9 aktivity je p\u0159ipraven k pou\u017eit\u00ed",
                    "in_ID": "Pemicu interaksi ini sudah siap dan tersedia untuk digunakan dalam produksi",
                    "de_DE": "Dieser Engagement-Trigger ist verf\u00fcgbar und kann verwendet werden.",
                    "ms_MY": "Pencetus penglibatan ini sudah sedia dan boleh digunakan dalam pengeluaran",
                    "zh_TW": "\u6b64\u4e92\u52d5\u89f8\u767c\u689d\u4ef6\u5df2\u6e96\u5099\u5c31\u7dd2\uff0c\u53ef\u5728\u751f\u7522\u74b0\u5883\u4e2d\u4f7f\u7528",
                    "es_ES": "Este factor de interacci\u00f3n est\u00e1 listo y disponible para usarse en producci\u00f3n",
                    "nl_NL": "Deze trigger voor interactie is klaar en beschikbaar voor gebruik in productie",
                    "sv_SE": "Den h\u00e4r aktivitetsutl\u00f6saren \u00e4r klar och tillg\u00e4nglig f\u00f6r att anv\u00e4ndas",
                    "da_DK": "Denne engagementsudl\u00f8ser er klar og tilg\u00e6ngelig til brug i produktionen",
                    "ko_KR": "\uc774 \ucc38\uc5ec \ud2b8\ub9ac\uac70\uac00 \uc900\ube44\ub418\uc5c8\uc73c\uba70 \ud604\uc7ac \uc6f9\uc0ac\uc774\ud2b8\uc5d0\uc11c \uc774\uc6a9 \uac00\ub2a5\ud569\ub2c8\ub2e4.",
                    "en_US": "This engagement trigger is ready and available to be used in production",
                    "zh_CN": "\u6b64\u53c2\u4e0e\u89e6\u53d1\u5668\u5df2\u51c6\u5907\u5c31\u7eea\uff0c\u53ef\u7528\u4e8e\u5236\u4f5c",
                    "ar_AE": "\u0645\u064f\u0641\u0639\u0644 \u0627\u0644\u0645\u0634\u0627\u0631\u0643\u0629 \u0647\u0630\u0627 \u062c\u0627\u0647\u0632 \u0648\u0645\u062a\u0627\u062d \u0644\u0644\u0627\u0633\u062a\u062e\u062f\u0627\u0645 \u0641\u064a \u0627\u0644\u0625\u0646\u062a\u0627\u062c",
                    "no_NO": "Denne engasjementsutl\u00f8seren er klar og tilgjengelig for bruk i produksjon"
                },
                "preferredLocale": {
                    "country": "US",
                    "language": "en"
                }
            },
            "engagementTrigger": "FULL_COMPLETE"
        }
    ],
    "paging": {
        "count": 10,
        "start": 0,
        "links": []
    }
}