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_SDSTATS("TOY STORE", "2023")
=GORILLA_SDSTATS("TOY STORE", "Last Month", "US", "spend")
=GORILLA_SDSTATS("TOY STORE", "2023", "US", "Spend", B4:B215,,, "TOTAL")
Syntax Description
Description:
Sponsored Display Stats
⚠️ 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_SDSTATS (sellerId, [period], [marketplace], [datapoint], [prod], [campaign], [adgroup], [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, 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.
DATAPOINT- OPTIONAL
Return data for specific data point. Default is empty value for all data points. Other Valid values are: purchases, purchasesClicks, cpc, ctr, acosClicks, roasClicks, clicks, unitsSold, unitsSoldClicks, newToBrandUnitsSold, newToBrandUnitsSoldClicks, salesClicks, viewClickThroughRate
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 SDCAMPAIGNLIST to list the Names. 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 SDGROUPLIST to list the Names. Can be a range of values like A1:A100 where A1 to A100 consists of values like AdGroup1, AdGroup2, AdGroup3…
OUTPUT – OPTIONAL
Use to select the type of data output required. Use ‘SINGLE’ to get a single value output of the Total Sponsored Display. Use ‘TOTAL’ to generate a table of the datapoint corresponding. Valid values: ‘TOTAL’ or ‘SINGLE'(default is ‘TOTAL’).
START DATE – OPTIONAL
Starting date for the data when period is custom.
END DATE – OPTIONAL
Ending date for the data when period is custom.
HEADER – OPTIONAL
Include the header line in the results. Possible values: TRUE/FALSE. Default: TRUE.
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_SDSTATS("TOY STORE", "2023")
This will provide the data of all datapoints with “2023” as the pre-defined period. The data will show the lists of all datapoints as shown in the screenshot.
=GORILLA_SDSTATS("TOY STORE", "Last Month", "US", "spend")
This will provide a total of the datapoint “spend” with the pre defined period as “Last Month” and the Marketplace as “US”.
=GORILLA_SDSTATS("TOY STORE", "2023", "US", "Spend", B4:B215,,, "TOTAL")
This will provide a list of SKUs and the “spend” for each one with pre-defined period as “2023”, Marketplace as “US”, Output as “TOTAL”, datapoint as “Spend” and B4:B215 will be the list of the CAMPAIGNS.