Google Shopping Merchant Reports V1beta Client - Class CompetitiveVisibilityTopMerchantView (0.4.0)

Reference documentation and code samples for the Google Shopping Merchant Reports V1beta Client class CompetitiveVisibilityTopMerchantView.

Fields available for query in competitive_visibility_top_merchant_view table.

Competitive visibility report with business with highest visibility. Values are only set for fields requested explicitly in the request's search query.

Generated from protobuf message google.shopping.merchant.reports.v1beta.CompetitiveVisibilityTopMerchantView

Namespace

Google \ Shopping \ Merchant \ Reports \ V1beta

Methods

__construct

Constructor.

Parameters
NameDescription
data array

Optional. Data for populating the Message object.

↳ date Google\Type\Date

Date of this row. Cannot be selected in the SELECT clause. A condition on date is required in the WHERE clause.

↳ domain string

Domain of your competitor or your domain, if 'is_your_domain' is true. Required in the SELECT clause. Cannot be filtered on in the 'WHERE' clause.

↳ is_your_domain bool

True if this row contains data for your domain. Cannot be filtered on in the 'WHERE' clause.

↳ report_country_code string

Country where impressions appeared. Required in the SELECT clause. A condition on report_country_code is required in the WHERE clause.

↳ report_category_id int|string

Google product category ID to calculate the report for, represented in Google's product taxonomy. Required in the SELECT clause. A condition on report_category_id is required in the WHERE clause.

↳ traffic_source int

Traffic source of impressions. Required in the SELECT clause.

↳ rank int|string

Position of the domain in the top merchants ranking for the selected keys (date, report_category_id, report_country_code, traffic_source) based on impressions. 1 is the highest. Cannot be filtered on in the 'WHERE' clause.

↳ ads_organic_ratio float

Ads / organic ratio shows how often the domain receives impressions from Shopping ads compared to organic traffic. The number is rounded and bucketed. Cannot be filtered on in the 'WHERE' clause.

↳ page_overlap_rate float

Page overlap rate shows how frequently competing retailers’ offers are shown together with your offers on the same page. Cannot be filtered on in the 'WHERE' clause.

↳ higher_position_rate float

Higher position rate shows how often a competitor’s offer got placed in a higher position on the page than your offer. Cannot be filtered on in the 'WHERE' clause.

getDate

Date of this row.

Cannot be selected in the SELECT clause. A condition on date is required in the WHERE clause.

Returns
TypeDescription
Google\Type\Date|null

hasDate

clearDate

setDate

Date of this row.

Cannot be selected in the SELECT clause. A condition on date is required in the WHERE clause.

Parameter
NameDescription
var Google\Type\Date
Returns
TypeDescription
$this

getDomain

Domain of your competitor or your domain, if 'is_your_domain' is true.

Required in the SELECT clause. Cannot be filtered on in the 'WHERE' clause.

Returns
TypeDescription
string

hasDomain

clearDomain

setDomain

Domain of your competitor or your domain, if 'is_your_domain' is true.

Required in the SELECT clause. Cannot be filtered on in the 'WHERE' clause.

Parameter
NameDescription
var string
Returns
TypeDescription
$this

getIsYourDomain

True if this row contains data for your domain.

Cannot be filtered on in the 'WHERE' clause.

Returns
TypeDescription
bool

hasIsYourDomain

clearIsYourDomain

setIsYourDomain

True if this row contains data for your domain.

Cannot be filtered on in the 'WHERE' clause.

Parameter
NameDescription
var bool
Returns
TypeDescription
$this

getReportCountryCode

Country where impressions appeared.

Required in the SELECT clause. A condition on report_country_code is required in the WHERE clause.

Returns
TypeDescription
string

hasReportCountryCode

clearReportCountryCode

setReportCountryCode

Country where impressions appeared.

Required in the SELECT clause. A condition on report_country_code is required in the WHERE clause.

Parameter
NameDescription
var string
Returns
TypeDescription
$this

getReportCategoryId

Google product category ID to calculate the report for, represented in Google's product taxonomy.

Required in the SELECT clause. A condition on report_category_id is required in the WHERE clause.

Returns
TypeDescription
int|string

hasReportCategoryId

clearReportCategoryId

setReportCategoryId

Google product category ID to calculate the report for, represented in Google's product taxonomy.

Required in the SELECT clause. A condition on report_category_id is required in the WHERE clause.

Parameter
NameDescription
var int|string
Returns
TypeDescription
$this

getTrafficSource

Traffic source of impressions.

Required in the SELECT clause.

Returns
TypeDescription
int

hasTrafficSource

clearTrafficSource

setTrafficSource

Traffic source of impressions.

Required in the SELECT clause.

Parameter
NameDescription
var int
Returns
TypeDescription
$this

getRank

Position of the domain in the top merchants ranking for the selected keys (date, report_category_id, report_country_code, traffic_source) based on impressions. 1 is the highest.

Cannot be filtered on in the 'WHERE' clause.

Returns
TypeDescription
int|string

hasRank

clearRank

setRank

Position of the domain in the top merchants ranking for the selected keys (date, report_category_id, report_country_code, traffic_source) based on impressions. 1 is the highest.

Cannot be filtered on in the 'WHERE' clause.

Parameter
NameDescription
var int|string
Returns
TypeDescription
$this

getAdsOrganicRatio

Ads / organic ratio shows how often the domain receives impressions from Shopping ads compared to organic traffic. The number is rounded and bucketed.

Cannot be filtered on in the 'WHERE' clause.

Returns
TypeDescription
float

hasAdsOrganicRatio

clearAdsOrganicRatio

setAdsOrganicRatio

Ads / organic ratio shows how often the domain receives impressions from Shopping ads compared to organic traffic. The number is rounded and bucketed.

Cannot be filtered on in the 'WHERE' clause.

Parameter
NameDescription
var float
Returns
TypeDescription
$this

getPageOverlapRate

Page overlap rate shows how frequently competing retailers’ offers are shown together with your offers on the same page.

Cannot be filtered on in the 'WHERE' clause.

Returns
TypeDescription
float

hasPageOverlapRate

clearPageOverlapRate

setPageOverlapRate

Page overlap rate shows how frequently competing retailers’ offers are shown together with your offers on the same page.

Cannot be filtered on in the 'WHERE' clause.

Parameter
NameDescription
var float
Returns
TypeDescription
$this

getHigherPositionRate

Higher position rate shows how often a competitor’s offer got placed in a higher position on the page than your offer.

Cannot be filtered on in the 'WHERE' clause.

Returns
TypeDescription
float

hasHigherPositionRate

clearHigherPositionRate

setHigherPositionRate

Higher position rate shows how often a competitor’s offer got placed in a higher position on the page than your offer.

Cannot be filtered on in the 'WHERE' clause.

Parameter
NameDescription
var float
Returns
TypeDescription
$this