AskAdStage uses simple sentence structures that are intuitive and should flow like a normal ask, depending on what you want. 

Basic structure: Tell us the format you want (list, chart, etc) on what level/entities (account, campaign, etc) the metric you care about and the date range. 

  

Basic Structure: (example)

List of examples:

Commands, Parsers & Modifiers:

Here are the lists of commands, parsers and modifiers that you can use to structure your sentences to AskAdStage:


Commands:

  • Chart/List (Default): /askadstage chart [sentence]
  • Pause/Enable: /askadstage pause [sentence] 

(ie. campaigns, ad groups/ad sets, ads)

Example: /askadstage show me FB campaigns with the most conversion last 7 days?

You will be able to pause/enable campaigns right in Slack.


Chart types:

  • bar: barchart, bar
  • pie: total, pie
  • line: linechart, line

Networks: (/askadstage chart all active facebook campaigns where spend is greater than 50 and campaign name contains "cool kids")

facebook / adwords/ as words/ bing / bing ads / linkedin/ twitter

Entity Level:
(/askadstage spend on top 10 campaigns over last 60 days)

  • account_groups: account group , accountgroup +s?
  • accounts: account +s?
  • folders: folder +s?
  • campaigns: campaign + s?
  • ad_groups: ad group, adgroup, ad set, adset+s?
  • ads: ad + s?

Status: (/askadstage chart all active facebook campaigns where spend is greater than 50 and campaign name contains "cool kids")

  • all_with_deleted:  all_with_deleted / all with deleted
  • all_active: all_active / active
  • all_inactive: all inactive / inactive


Metrics:
(ex. /askadstage spend on top 10 campaigns over last 60 days)

  • cpc: cost per click/cpc
  • results: results
  • cpm: cpm
  • cpr: cpr
  • ctr: ctr
  • cpa: cpa/cost per conversion
  • clicks: clicks
  • impressions impressions
  • spend: spend/spending
  • conversions: conversions/converting
  • conversion-rate: conversion rate`


Timeframe:
(/askadstage spend on top 10 campaigns over last 60 days)

*Common Timeframes:

  • for/over the? this/last NUM? day/week/month/year +s?
  • Will map to last_1_week, this_year... etc

*Custom Timeframes:
between/from/since CUSTOMDATE and/to? CUSTOMDATE?

*Other Timeframe Choices:

  • ISO8601: 2017-05-12
  • Month: January,dec ...
  • Year: 2012...
  • Month + Year: April 2016, feb 2017

Modifiers/Filters: (/askadstage spend on top 10 campaigns over last 60 days)

Order:

  • asc (ascending): bottom, worst, lowest performing
  • dsc (descending): top, best, highest performing
  • Limit: We look for digits that don’t match anything else.

Aggregate By:

  • by + day/week/month

Sort:

  • by + METRIC

By Network:

  • by + network/channel

Operators: (/askadstage chart all active facebook campaigns where spend is greater than 50 and campaign name contains "cool kids")

  • > / greater / bigger / higher / larger +than?
  • >= / greater / bigger / higher / larger +than? or equal +s? +to?
  • < / less / lesser / smaller / lower +than?
  • <= / less / lesser / smaller / lower +than? or equal +s? +to?

Example: (/askadstage chart all active facebook campaigns where spend is greater than 50 and campaign name contains "cool kids")

  • ~/ match / matching / matches / contain / contains / containing
  • !~ or not match / matching / matches / contain / contains / containing

Best Practices & Other Notes

  • AskAdStage can only comprehend Slack messages with the prefix /AskAdstage
  • Unlike Report, AskAdStage can only chart one KPI at a time, but you can list multiple
  • AskAdStage charts and lists can only be viewed in the Slack channel in which they were generated
  • You can change the format of an AskAdStage by clicking one of the other chart options just below (bar, line, pie)
  • Default date range - Last 30 days (if not specified)

Have more questions about AskAdStage? Check out our other FAQ!

Did this answer your question?