Custom Audience

Custom Audience enables you to better target your ads by creating audiences from your website, from your mobile app or from your customer lists.

Custom Audience lets you create, read and update tag endpoints using standard POST, GET and PUT calls. Audiences can be defined using Apple’s Advertising Identifier (IDFA), or Android’s advertising ID.

The features and capabilities of Custom Audience are described in the table below:

Feature Objective Task
Audiences from websites Define and manage audience segments of people who have visited or have taken certain actions on your website. Use audiences from a website to accomplish this task.
Audiences from customer lists Target your ads to a specific set of people with whom you’ve already established a relationship. Use audiences from a customer list to target your ads.
Audiences from your app Target people who have taken specific actions in your mobile app, like achieving a level in a game or placing an item in a shopping cart. Use audiences from your app to accomplish this task.
Audiences from email lists Define and target audience segments of people who are on your email lists. Use audiences-from-email-lists to accomplish this task.
Lookalike audiences Find more people who are similar to your existing customers. Use lookalike audiences to accomplish this task.

Target a Campaign to a Custom Audience Segment

Once you’ve created Custom Audience segments, you can target Yahoo Gemini 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.admanager.yahoo.com/v1/rest/audience

Data passed

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


Example response

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