Google Sheets Functions

⌘K
  1. Home
  2. /
  3. Docs
  4. /
  5. Google Sheets Functions
  6. /
  7. 2.Advertising Data/Functi...
  8. /
  9. GORILLA_SPSALESKEYWORDHIS...

GORILLA_SPSALESKEYWORDHIST() – Advertising Sales Keyword History.

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_SPSALESKEYWORDHIST("TOY STORE", "2023")
=GORILLA_SPSALESKEYWORDHIST("TOY STORE", "2023", "US")
=GORILLA_SPSALESKEYWORDHIST("TOY STORE", "2023", "US", , , "BOTTLESMALL")

Syntax Description

SPSALESKEYWORDHIST Gorilla ROI

Description:

Advertising Sales Keyword History.

⚠️ 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_SPSALESKEYWORDHIST(sellerId, [period], [marketplace], [keyword], [campaign], [adgroup], [datapoint], [days], [Sort], [start_date], [end_date], [transpose], [header])

Seller ID – REQUIRED
Enter the seller ID or nickname you entered in your Gorilla account.

PERIOD – REQUIRED
Predefined period to get ads spend or use custom to specify a start and end date.

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.

KEYWORD – OPTIONAL
Keyword to filter the results. Can be a range of values like A1:A100 where A1 to A100 consists of values like Keyword1, Keyword2, Keyword3…

CAMPAIGN – OPTIONAL
Keyword to filter the results. Can be a range of values like A1:A100 where A1 to A100 consists of values like Keyword1, Keyword2, Keyword3…

ADGROUP – OPTIONAL
AdGroup to filter the results. Can be a number (adgroup id) or string (adgroup name).

DATAPOINT – OPTIONAL
Return data for specific data point. Default is empty value for all data points. Other Valid values are: sales1d, sales7d, sales14d, sales30d, salesSameSku1d, salesSameSku7d, salesSameSku14d, salesSameSku30d.

DAYS – OPTIONAL
Number of days to return data corresponding from current date.

SORT – OPTIONAL
Date sorting criteria. Valid values: Desc (DEFAULT), Asc.

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.

TRANSPOSE – OPTIONAL
If empty, “no” or “false”, returns datapoints as column headers,

HEADER – OPTIONAL
Include the header line in the results. Possible values: TRUE/FALSE. Default: TRUE.

GORILLA_SPSALESKEYWORDHIST Attributes

Period Attributes:

TodayThis monthLast 3 Months
YesterdayThis quarterLast 12 Months
Same day last weekThis yearLast 7 Days Week Ago
Same day last monthThis Year-to-Last-MonthLast 7 Days Year Ago
Same day last yearLast WeekLast 30 Days Month Ago
Last 7 DaysLast MonthLast 30 Days Year Ago
Last 14 DaysLast QuarterLast Week Year Ago
Last 30 DaysLast YearLast Month Year Ago
Last 90 DaysLast 60 DaysYYYY-MM (change format to text)
 This weekYYYY YYYYQ1… YYYYQ4
Custom

Datapoints Attributes:

sales1d – PPC attributed units sold within 1 day of clicksales7d – PPC attributed units sold within 7 days of clicksales14d – PPC attributed units sold within 14 days of click
sales30d – PPC attributed units sold within 30 day of clicksalesSameSku1d – PPC same SKU sold within 1 day of clicksalesSameSku7d – PPC same SKU sold within 7 days of click
salesSameSku14d – PPC same SKU sold within 14 days of clicksalesSameSku30d – PPC same SKU sold within 30 days of click

Screenshots:

SPSALESKEYWORDHIST 1 Gorilla ROI

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_SPSALESKEYWORDHIST("TOY STORE", "2023")

This will provide a DUMP of Ads Sales based on Keyword in a table-like manner. The data dump contains Keyword Name, sales1d, sales7d, sales14d, sales30d, salesSameSku1d, salesSameSku7d, salesSameSku14d, salesSameSku30d, for year 2023.

=GORILLA_SPSALESKEYWORDHIST("TOY STORE", "2023", "US")

This will provide a DUMP of Ads Sales based on Keyword in a table-like manner in the US Marketplace, consisting of Keyword Name, sales1d, sales7d, sales14d, sales30d, salesSameSku1d, salesSameSku7d, salesSameSku14d, salesSameSku30d, for the year 2023.

=GORILLA_SPSALESKEYWORDHIST("TOY STORE", "2023", "US", , , "BOTTLESMALL")

This will provide a DUMP of Ads Sales based on Keyword in a table-like manner for the campaign name BottleSmall, in the US Marketplace, consisting of Keyword Name, sales1d, sales7d, sales14d, sales30d, salesSameSku1d, salesSameSku7d, salesSameSku14d, salesSameSku30d, for the year 2023.

Tags , , ,

EBOOKS tO HELP unleash your amazon success

Enter your name and email for the full download package now.

Want SPREADSHEETS CREATED BY 7-Figure AMAZON Sellers?

Enter your name & email for the full download package now.

GET THE EBOOK PACKAGE

Enter your email for the full download package now.

GET YOUR SPREADSHEETS

Enter your email for the full download package now.