Markets
Open Markets and audiences in your brand’s settings. Add a market adds a country, Global or Europe to the choices for new topics. Adding a market uses no topics. The Home market prefills new topics. Open another market’s menu and choose Make home market to change it. Existing topics keep their market. Global measures without a country. Its Google search volume comes from the United States. Europe measures ten countries as one topic market, even with a single question. The Europe schedule describes its countries and languages.Language policy
Global and English-speaking markets use English. Other countries use their local languages and English. English accounts for a third of questions in the Netherlands, Denmark, Norway, Sweden, Finland, Romania, Belgium and Switzerland, and a quarter in other non-English markets. Europe applies each country’s default. Belgium splits local questions between Dutch and French. Switzerland splits them between German and French. An English question for a country names that country; a Global question names none. When a question moves to another market, a place that says where the asker is moves with it, while a destination the question is about, or a place whose products or rules it asks about, stays as written. Language markers beside measured questions identify the wordings you read. The app API acceptsasked_in as local, english or both when drafting or copying a topic. With both, english_share accepts quarter, third or half. Omitting these fields uses the market’s defaults. English-speaking markets and Global use English only.
Audiences
All buyers is the default audience for new topics. Choose Add an audience to save a name and Who they are, such as agencies running campaigns for several clients. Questions for that audience use the buyer’s perspective. Open an audience’s menu and choose Edit to change its name or description. Renaming changes its label. Changing who they are affects questions drafted afterwards and leaves existing questions unchanged. Adding an audience uses no topics. Only tracking a topic for that audience counts against your workspace allowance.Remove a choice
Remove hides a market or audience from new topics. Existing topics, questions and history stay. A restored topic keeps its original market and audience, even if either was removed from these lists.Copy a topic
Open a topic’s menu and choose Copy to another market or audience. Choose entries from your brand’s lists, then select Preview questions. Check the questions and choose Copy topic. Each copy uses one topic from your workspace allowance. A topic’s market and audience stay fixed. Copy it to measure another combination. If Heralded cannot write every question for the destination audience, it tracks nothing and asks you to try again.Filter your results
Insight pages offer Market and Audience in Filters when there is more than one choice. Market selects topics for that market. Selecting Romania excludes Europe topics, including their Romanian answers. The language markers beside questions stay visible.Read the lists through the API
GET /v1/brands/{brand_id}/markets and MCP get_markets return home_market, the brand’s markets, their vocabulary of names and focus_options for starring a market with its audience. GET /v1/brands/{brand_id}/audiences and MCP get_audiences return each audience’s id, name and description. All buyers comes first, with a null ID.
Use market and audience in insight reads. In keyword and Search comparison reads, country selects the country of a Google check within those topics. Use all_buyers to select topics for All buyers; omit the audience to include every audience. API keys and assistant access follow your access to the brand.
Topic references identify the topic in its market and audience. Question, question-fit and keyword writes use tracked_topic_id from that reference.