Create audience
POST {{baseUrl}}/ad_accounts/:ad_account_id/audiences
Create an audience you can use in targeting for specific ad groups. Targeting combines customer information with the ways users interact with Pinterest to help you reach specific groups of users; you can include or exclude specific audienceids when you create an ad group.
For more, see <a class=reference external
href=https://help.pinterest.com/en/business/article/audience-targeting
target="blank">Audience targeting.
Request Body
{"audience_type"=>"VISITOR", "name"=>"<string>", "rule"=>{"country"=>"<string>", "customer_list_id"=>"927", "engagement_domain"=>["<string>", "<string>"], "engagement_type"=>"<string>", "event"=>"<string>", "event_data"=>{"currency"=>"NZD", "lead_type"=>"<string>", "line_items"=>{"product_brand"=>"<string>", "product_category"=>"<string>", "product_id"=>"<integer>", "product_name"=>"<string>", "product_price"=>"<string>", "product_quantity"=>"<integer>", "product_variant"=>"<string>", "product_variant_id"=>"<string>"}, "order_id"=>"<string>", "order_quantity"=>"<integer>", "page_name"=>"<string>", "promo_code"=>"<string>", "property"=>"<string>", "search_query"=>"<string>", "value"=>"<string>", "video_title"=>"<string>"}, "percentage"=>"<integer>", "pin_id"=>["1", "09198020781"], "prefill"=>"<boolean>", "retention_days"=>"<integer>", "seed_id"=>["4174", "967855370"], "url"=>["<string>", "<string>"], "visitor_source_id"=>"2243719", "engager_type"=>"<integer>", "campaign_id"=>["55417787", "825756075"], "ad_id"=>["3", "530432"], "objective_type"=>["VIDEO_VIEW", "WEB_CONVERSION"], "ad_account_id"=>"8"}, "ad_account_id"=>"34999028468", "description"=>"<string>"}
HEADERS
| Key | Datatype | Required | Description |
|---|---|---|---|
Content-Type | string | ||
Accept | string |
RESPONSES
status: OK
{"ad_account_id":"34","id":"540616","name":"\u003cstring\u003e","audience_type":"\u003cstring\u003e","description":"\u003cstring\u003e","rule":{"country":"\u003cstring\u003e","customer_list_id":"017151893","engagement_domain":["\u003cstring\u003e","\u003cstring\u003e"],"engagement_type":"\u003cstring\u003e","event":"\u003cstring\u003e","event_data":{"currency":"SEK","lead_type":"\u003cstring\u003e","line_items":{"product_brand":"\u003cstring\u003e","product_category":"\u003cstring\u003e","product_id":"\u003cinteger\u003e","product_name":"\u003cstring\u003e","product_price":"\u003cstring\u003e","product_quantity":"\u003cinteger\u003e","product_variant":"\u003cstring\u003e","product_variant_id":"\u003cstring\u003e"},"order_id":"\u003cstring\u003e","order_quantity":"\u003cinteger\u003e","page_name":"\u003cstring\u003e","promo_code":"\u003cstring\u003e","property":"\u003cstring\u003e","search_query":"\u003cstring\u003e","value":"\u003cstring\u003e","video_title":"\u003cstring\u003e"},"percentage":"\u003cinteger\u003e","pin_id":["36","57223"],"prefill":"\u003cboolean\u003e","retention_days":"\u003cinteger\u003e","seed_id":["475712","42311749575"],"url":["\u003cstring\u003e","\u003cstring\u003e"],"visitor_source_id":"921465","event_source":{},"ingestion_source":{},"engager_type":"\u003cinteger\u003e","campaign_id":["3073443738","0626762932"],"ad_id":["732","5108076091"],"objective_type":["CATALOG_SALES","WEB_SESSIONS"],"ad_account_id":"403239"},"size":"\u003cinteger\u003e","status":"\u003cstring\u003e","type":"\u003cstring\u003e","created_timestamp":"\u003cinteger\u003e","updated_timestamp":"\u003cinteger\u003e"}