Sample Usage
🚨 Use ranges (e.g.A2:A1000) in your formula wherever possible for quicker results and to prevent Google from blocking your account for 24 hrs due to overloading their resources.
=GORILLA_ADCAMPAIGNLIST("TOY STORE", "2023")
=GORILLA_ADCAMPAIGNLIST("TOY STORE", "2023", "US")
=GORILLA_ADCAMPAIGNLIST("TOY STORE", "2023", "US", "ENABLED")
Syntax Description
Description:
Get advertising campaign list.
⚠️ Important Note:
Data from all advertising related functions are based on your advertising attributed sales. Not regular organic sales.
When you see datapoints such as sales7d or conversions7d, it means the AD SALES or the AD CONVERSIONS. Not the total sales over the last 7 days. Only the converted AD or PPC SALES. This is the same for spend, units sold, and performance numbers. It is all based on the PPC spend, PPC units sold, PPC performance.
- Regular advertising functions (non HIST functions) aggregate the values of the period you enter. E.g. ADPRODSALES() will display the combined data over the period you enter such as “last month”.
- HIST functions such as ADSALESPRODHIST() displays the daily value.
- All values are PPC attributed data.
Syntax:
GORILLA_ADCAMPAIGNLIST(sellerId, period, [marketplace], [status], [start_date], [end_date], [header])
Seller ID – REQUIRED
Seller account or Nickname to work with.
PERIOD – OPTIONAL
Predefined period to get ads data or use ‘custom’ to specify a start and end date. Default will be last 30 days.
MARKETPLACE – OPTIONAL
Marketplace country filter. Country codes are US, CA, MX, BR, BE, UK, DE, ES, IT, FR, NL, PL, TR, IN, SE, AE, AU, SG, JP, EG, SA. Use ALL to combine values from a single account, EURO to combine countries using EURO currency, EU for all Europe markets EXCEPT UK.
STATUS – OPTIONAL
Filter by status. Status are: enabled, paused, archived, all but archived and all. If the status is empty, it will filter by ‘enabled’
START_DATE – OPTIONAL
Starting date to get ads sales from when period is custom.
END_DATE – OPTIONAL
Ending date to get ads sales till when period is custom.
HEADER – OPTIONAL
Include the header line in the results. Possible values: TRUE/FALSE. Default: TRUE.
GORILLA_ADCAMPAIGNLIST Attributes
Period Attributes:
| Today | This month | Last 3 Months |
| Yesterday | This quarter | Last 12 Months |
| Same day last week | This year | Last 7 Days Week Ago |
| Same day last month | This Year-to-Last-Month | Last 7 Days Year Ago |
| Same day last year | Last Week | Last 30 Days Month Ago |
| Last 7 Days | Last Month | Last 30 Days Year Ago |
| Last 14 Days | Last Quarter | Last Week Year Ago |
| Last 30 Days | Last Year | Last Month Year Ago |
| Last 90 Days | Last 60 Days | YYYY-MM (change format to text) |
| This week | YYYY | YYYYQ1… YYYYQ4 |
| Custom |
Screenshot:
Examples:
🚨 Use ranges (e.g.A2:A1000) in your formula wherever possible for quicker results and to prevent Google from blocking your account for 24 hrs due to overloading their resources.
=GORILLA_ADCAMPAIGNLIST("TOY STORE1", "2023")
Returns a list of All CampaignID, Campaign Name advertised for the year 2023.
=GORILLA_ADCAMPAIGNLIST("TOY STORE", "2023", "US")
Returns a list of All CampaignID, Campaign Name in the US Marketplace for the year 2023.
=GORILLA_ADCAMPAIGNLIST("TOY STORE", "2023", "US", "ENABLED")
Returns a list of Active CampaignID, Campaign Name in the US Marketplace for the year 2023.