Skip to main content
All CollectionsGoogle Sheets FunctionsAds Data Plan Functions
GORILLA_SBUNITSGROUP() – Get total units of advertised Brand group between any period

GORILLA_SBUNITSGROUP() – Get total units of advertised Brand group between any period

Updated over 2 months ago

GORILLA_SBUNITSGROUP() – Get total units of advertised Brand group between any period

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_SBUNITSGROUP("TOY STORE", "2023", "US")
=GORILLA_SBUNITSGROUP("TOY STORE", "2023", "US",  "BOTTLESMALL")
=GORILLA_SBUNITSGROUP("TOY STORE", "2023", "US",  "BOTTLESMALL", , ,"DUMP")

Syntax Description

UNITSGROUP S Gorilla ROI

Description:

Get total units of advertised group 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_SBUNITSGROUP(sellerId, [period], [marketplace], [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 – REQUIRED
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.

CAMPAIGN – OPTIONAL
Include campaign to filter data by campaign. Use BRANDCAMPAIGNLIST 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 BRANDGROUPLIST to list the Names. 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: unitssold14d, unitsorderednewtobrand14d, unitsorderednewtobrandpercentage14d

OUTPUT – OPTIONAL
Use to select the type of data output required. Use ‘SINGLE’ to get a single value output of the Total advertising. Use ‘DUMP’ to generate a table of the datapoint corresponding. Valid values: ‘DUMP’ 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_SBUNITSGROUP 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:

All

unitssold14d

unitsorderednewtobrand14d

unitsorderednewtobrandpercentage14d

Screenshot:

UNITSGROUP E 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_SBUNITSGROUP("TOY STORE", "2023", "US")

This displays the number of units sold through advertising for all AdGroups under this seller in the US marketplace for the year 2023.

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

This displays the number of units sold through advertising for all AdGroups under this seller based on the campaign ‘BOTTLESMALL’ in the US marketplace for the year 2023.

=GORILLA_SBUNITSGROUP("TOY STORE", "2023", "US",  "BOTTLESMALL", , ,"DUMP")

This offers a comprehensive report detailing the number of units sold through advertising for the ‘BOTTLESMALL’ campaign, based on all AdGroups in the US marketplace throughout the year 2023.

Did this answer your question?