Lookalike audiences

Lookalike audiences allow advertisers to find more people similar to their existing customers. A lookalike audience uses an existing custom audience segment as a “seed” and expands that seed using Verizon Media data.

Important

Lookalikes can only be built against website custom audiences. Other audience types are not currently supported.

Fields

Lookalike audiences have the following fields:

Name

Description

Type

Add

Update

id

The unique identifier of the audience.

long

N/A

Required

advertiserId

The id of the advertiser that owns the audience.

long

Required

N/A

name

The name of the audience segment. Maximum is 255 characters.

string

Required

Optional

description

A description for the segment. Maximum is 255 characters.

string

Optional

Optional

type

Must be set to LOOKALIKE.

enum

Required

Read-Only

seedAudienceId

The ID of the seed audience segment owned by the advertiser. An origin audience size of at least 1000 is required, and at least 10000 is recommended.

long

Required

Read-Only

cnt24h

Unique user count for the last 24 hours.

long

Read-Only

Read-Only

cnt30d

Unique user count for the last 30 days.

long

Read-Only

Read-Only

status

The status of the segment. Can be ACTIVE or DELETED, and is set to ACTIVE by default.

enum

Optional

Optional

Create a New Audience

To create a new audience, make a POST call to the audience endpoint with the required fields. Batch create is supported. The response will be the newly created audience, or a list of multiple new audiences if an array is passed.

For example:

POST https://api.gemini.yahoo.com/v3/rest/audience

Data passed
             {
                 "advertiserId": 947366,
                 "name": "subscribers expanded",
                 "description": "subscribers expanded”,
                 "type": "LOOKALIKE",
                 "seedAudienceId": 20064660
             }


Example response

     {
         "errors": null,
         "timestamp": "2015-07-01 22:03:06",
         "response": {
             “id”: 20136783
             "advertiserId": 947366,
             "name": "subscribers expanded",
             "description": "subscribers expanded",
             "type": "LOOKALIKE",
             "seedAudienceId": 20064660,
             "status": "ACTIVE"
         }
     }

Note that your lookalike audience will be available for targeting immediately, but it may take up to 6 hours for the audience to finish populating with all the relevant users. You should expect limited delivery if you target this segment during this time window.

Important

The size of your lookablike audience is capped at 10M users, regardless of your seed audience size.

Target a Campaign to a My Audience Segment

Once you have created custom audience segments, you can target Native campaigns and ad groups to serve to these audiences using the TargetingAttribute service, passing in the audience id in the value field.

For example:

POST https://api.gemini.yahoo.com/v3/rest/targetingattribute

  Data passed

             {
                 "value": "2222",
                 "type": "MY_AUDIENCE",
                 "status": "ACTIVE",
                 "advertiserId": 123,
                 "parentType": "CAMPAIGN",
                 "parentId": 789,
                 "exclude": "FALSE",
                 "bidModifier": null
             }


     Example response

     {
         "errors": null,
         "response": {
             "id": 3273448769,
             "value": "2222",
             "type": "MY_AUDIENCE",
             "status": "ACTIVE",
             "advertiserId": 123,
             "parentType": "CAMPAIGN",
             "parentId": 789,
             "exclude": "FALSE",
             "bidModifier": null
         }
     }