Update Lookalike Audience Targeting

Update Lookalike Audience Targeting for the specified campaign.

Rate limit: Tier 2
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

VALID request examples:

{
   "collection": []
}
{
    "collection": [
        {
            "collection": [
                {
                    "rule_id": 5253453,
                    "similarity_level": 15
                },
                {
                    "rule_id": 444487,
                    "similarity_level": 25
                }
            ],
            "type": "INCLUDE"
        }
    ]
}
🚧

To obtain a list of Lookalike Audience IDs, use the Dictionary endpoint: dictionary/lookalike_audiences.

To create Lookalike Audiences, use Backstage UI.

📘

Pixel Lookalike Audiences support a single similarity level of 5.
CRM Lookalike Audiences support a wider range of similarity levels - see: Lookalike Audience Object.

🚧

Audience Targeting does not support a PATCH operation - the submitted values overwrite the old ones.

📘

For a successful request, the same object is returned in the response.

INVALID request example:

{
    "collection": [
        {
            "collection": [
                {
                    "rule_id": 190356,
                    "similarity_level": 15
                },
                {
                    "rule_id": 232287,
                    "similarity_level": 25
                }
            ],
            "type": "EXCLUDE"
        }
    ]
}
{
    "http_status": 400,
    "message": "Invalid input - Exclude for lookalike audiences is not supported.",
    "offending_field": "lookalike_audience_targeting.collection[0].type"
}
🚧

Lookalike Audience Targeting does not support EXCLUDE.

Rate limit

🚧

Rate limit

Tier 2. Updating lookalike audience targeting has its own budget, stricter than the one for reading it and separate from every other targeting type.

See Rate limits for the request allowance each tier carries.

Path Params
string
required

An alphabetic ID. See Get Account Details.

string
required

A numeric ID.

Body Params
json
Defaults to { "collection": [ { "collection": [ { "rule_id": 5253453, "similarity_level": 15 }, { "rule_id": 444487, "similarity_level": 25 } ], "type": "INCLUDE" } ] }
Response

Language
Credentials
OAuth2
LoadingLoading…
Response
Choose an example:
application/json