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_SPUNITSPROD("TOY STORE", "2023")
=GORILLA_SPUNITSPROD("TOY STORE", "2023", "US", $A$1:$A$100)
=GORILLA_SPUNITSPROD("TOY STORE", "2023", "US", $A$1:$A$1000, "BOTTLESMALL")
Syntax Description
Description:
Get total units of advertised products between any period.
⚠️ 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 SP SALES or the SP CONVERSIONS. Not the total sales over the last 7 days. Only the converted SP 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. SPPRODSALES() will display the combined data over the period you enter such as “last month”.
- HIST functions such as SPSALESPRODHIST() displays the daily value.
- All values are PPC attributed data.
Syntax:
GORILLA_SPUNITSPROD(sellerId, [period], [marketplace], [prod], [campaign], [adgroup], [datapoint], [output], [start_date], [end_date], [header])
Seller ID – REQUIRED
Enter the seller ID or nickname you entered in your Gorilla account.
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, 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, ‘EU’ for all Europe markets EXCEPT UK, ‘EURO’ to combine countries using EURO currency.
PROD – OPTIONAL
SKU or ASIN to filter the results. Can be a range of values like A1:A100 where A1 to A100 consists of values like SKU111, SKU222, SKU333 or ASIN123…
CAMPAIGN – OPTIONAL
Include campaign to filter data by campaign. Use ADCAMPAIGNLIST to list the IDs. Can be a range of values like A1:A100 where A1 to A100 consists of values like Campaign1, Campaign2, Campaign3…
ADGROUP – OPTIONAL
Include adgroup to filter data by adgroup. Use ADGROUPLIST to list the IDs. Can be a range of values like A1:A100 where A1 to A100 consists of values like AdGroup1, AdGroup2, AdGroup3…
DATAPOINT – OPTIONAL
Return data for specific data point. Default is empty value for all data points. Other Valid values are: unitsSoldClicks1d, unitsSoldClicks7d, unitsSoldClicks14d, unitsSoldClicks30d unitsSoldSameSku1d, unitsSoldSameSku7d, unitsSoldSameSku14d and unitsSoldSameSku30d.
OUTPUT– OPTIONAL
Use to select the type of data output required. Use ‘SINGLE’ to get a single value output of the single advertising. Use ‘TOTAL’ to generate a table of the datapoint corresponding. Valid values: ‘TOTAL’ or ‘SINGLE (default is ‘SINGLE’).
START_DATE – OPTIONAL
Starting date to get ads data from when period is custom.
END_DATE – OPTIONAL
Ending date to get ads data till when period is custom.
HEADER – OPTIONAL
Include the header line in the results. Possible values: TRUE/FALSE. Default: TRUE.
GORILLA_SPUNITSPROD 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 |
Datapoint Attributes:
| unitsSoldClicks1d – PPC attributed units sold within 1 day of click | unitsSoldClicks7d – PPC attributed units sold within 7 days of click | unitsSoldClicks14d – PPC attributed units sold within 7 days of click |
| unitsSoldClicks30d – PPC attributed units sold within 30 days of click | unitsSoldSameSku1d – PPC same SKU sold within 1 day of click | unitsSoldSameSku7d – PPC same SKU sold within 7 day of click |
| unitsSoldSameSku14d – PPC same SKU sold within 14 day of click | unitsSoldSameSku30d – PPC same SKU sold within 30 day of click |
Screenshots
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_SPUNITSPROD("TOY STORE", "2023")
This will provide a DUMP of Ads Units Sold based on products in a table-like manner for all the SKUs/ASINs under this seller. The data dump contains ASIN, SKU, unitsSoldClicks1d, unitsSoldClicks7d, unitsSoldClicks14d, unitsSoldClicks30d, unitsSoldSameSku1d, unitsSoldSameSku7d, unitsSoldSameSku14d, unitsSoldSameSku30d, for year 2023.
=GORILLA_SPUNITSPROD("TOY STORE", "2023", "US", $A$1:$A$100)
This will provide a DUMP of Ads Units Sold based on products in a table-like manner for SKUs/ASINs from A1 till A100 in the US Marketplace, consisting of unitsSoldClicks1d, unitsSoldClicks7d, unitsSoldClicks14d, unitsSoldClicks30d, unitsSoldSameSku1d, unitsSoldSameSku7d, unitsSoldSameSku14d, unitsSoldSameSku30d, for the year 2023.
=GORILLA_SPUNITSPROD("TOY STORE", "2023", "US", $A$1:$A$1000, "BOTTLESMALL")
This will provide a DUMP of Ads Units Sold based on products in a table-like manner for the campaign name BottleSmall, and SKUs/ASINs from A1 till A1000 in the US Marketplace, consisting of unitsSoldClicks1d, unitsSoldClicks7d, unitsSoldClicks14d, unitsSoldClicks30d, unitsSoldSameSku1d, unitsSoldSameSku7d, unitsSoldSameSku14d, unitsSoldSameSku30d, for the year 2023.