Class: Google::Apis::ContentV2_1::CompetitiveVisibility

Inherits:
Object
  • Object
show all
Includes:
Google::Apis::Core::Hashable, Google::Apis::Core::JsonObjectSupport
Defined in:
lib/google/apis/content_v2_1/classes.rb,
lib/google/apis/content_v2_1/representations.rb,
lib/google/apis/content_v2_1/representations.rb

Overview

Fields related to competitive visibility reports.

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(**args) ⇒ CompetitiveVisibility

Returns a new instance of CompetitiveVisibility.



3460
3461
3462
 
# File 'lib/google/apis/content_v2_1/classes.rb', line 3460

def initialize(**args)
   update!(**args)
end

Instance Attribute Details

#ads_organic_ratio ⇒ Float

Ads / organic ratio shows how often a merchant receives impressions from Shopping ads compared to organic traffic. The number is rounded and bucketed. Available only in CompetitiveVisibilityTopMerchantView and CompetitiveVisibilityCompetitorView. Cannot be filtered on in the 'WHERE' clause. Corresponds to the JSON property adsOrganicRatio

Returns:

  • (Float) 


3356
3357
3358
 
# File 'lib/google/apis/content_v2_1/classes.rb', line 3356

def ads_organic_ratio
  @ads_organic_ratio
end

#category_benchmark_visibility_trend ⇒ Float

Change in visibility based on impressions with respect to the start of the selected time range (or first day with non-zero impressions) for a combined set of merchants with highest visibility approximating the market. Available only in CompetitiveVisibilityBenchmarkView. Cannot be filtered on in the ' WHERE' clause. Corresponds to the JSON property categoryBenchmarkVisibilityTrend

Returns:

  • (Float) 


3365
3366
3367
 
# File 'lib/google/apis/content_v2_1/classes.rb', line 3365

def category_benchmark_visibility_trend
  @category_benchmark_visibility_trend
end

#category_id ⇒ Fixnum

Google product category ID to calculate the report for, represented in Google' s product taxonomy. Required in the SELECT clause. A WHERE condition on competitive_visibility.category_id is required in the query. Corresponds to the JSON property categoryId

Returns:

  • (Fixnum) 


3373
3374
3375
 
# File 'lib/google/apis/content_v2_1/classes.rb', line 3373

def category_id
  @category_id
end

#country_code ⇒ String

The country where impression appeared. Required in the SELECT clause. A WHERE condition on competitive_visibility.country_code is required in the query. Corresponds to the JSON property countryCode

Returns:

  • (String) 


3380
3381
3382
 
# File 'lib/google/apis/content_v2_1/classes.rb', line 3380

def country_code
  @country_code
end

#date ⇒ Google::Apis::ContentV2_1::Date

Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type. TimeOfDay * google.type.DateTime * google.protobuf.Timestamp Corresponds to the JSON property date

Returns:



3392
3393
3394
 
# File 'lib/google/apis/content_v2_1/classes.rb', line 3392

def date
  @date
end

#domain ⇒ String

Domain of your competitor or your domain, if 'is_your_domain' is true. Available only in CompetitiveVisibilityTopMerchantView and CompetitiveVisibilityCompetitorView. Required in the SELECT clause for CompetitiveVisibilityTopMerchantView and CompetitiveVisibilityCompetitorView . Cannot be filtered on in the 'WHERE' clause. Corresponds to the JSON property domain

Returns:

  • (String) 


3401
3402
3403
 
# File 'lib/google/apis/content_v2_1/classes.rb', line 3401

def domain
  @domain
end

#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. Available only in CompetitiveVisibilityTopMerchantView and CompetitiveVisibilityCompetitorView . Cannot be filtered on in the 'WHERE' clause. Corresponds to the JSON property higherPositionRate

Returns:

  • (Float) 


3409
3410
3411
 
# File 'lib/google/apis/content_v2_1/classes.rb', line 3409

def higher_position_rate
  @higher_position_rate
end

#is_your_domain ⇒ Boolean Also known as: is_your_domain?

True if this row contains data for your domain. Available only in CompetitiveVisibilityTopMerchantView and CompetitiveVisibilityCompetitorView . Cannot be filtered on in the 'WHERE' clause. Corresponds to the JSON property isYourDomain

Returns:

  • (Boolean) 


3416
3417
3418
 
# File 'lib/google/apis/content_v2_1/classes.rb', line 3416

def is_your_domain
  @is_your_domain
end

#page_overlap_rate ⇒ Float

Page overlap rate describes how frequently competing retailers’ offers are shown together with your offers on the same page. Available only in CompetitiveVisibilityTopMerchantView and CompetitiveVisibilityCompetitorView . Cannot be filtered on in the 'WHERE' clause. Corresponds to the JSON property pageOverlapRate

Returns:

  • (Float) 


3425
3426
3427
 
# File 'lib/google/apis/content_v2_1/classes.rb', line 3425

def page_overlap_rate
  @page_overlap_rate
end

#rank ⇒ Fixnum

Position of the domain in the top merchants ranking for the selected keys ( date, category_id, country_code, listing_type) based on impressions. 1 is the highest. Available only in CompetitiveVisibilityTopMerchantView and CompetitiveVisibilityCompetitorView. Cannot be filtered on in the 'WHERE' clause. Corresponds to the JSON property rank

Returns:

  • (Fixnum) 


3434
3435
3436
 
# File 'lib/google/apis/content_v2_1/classes.rb', line 3434

def rank
  @rank
end

#relative_visibility ⇒ Float

Relative visibility shows how often your competitors’ offers are shown compared to your offers. In other words, this is the number of displayed impressions of a competitor retailer divided by the number of your displayed impressions during a selected time range for a selected product category and country. Available only in CompetitiveVisibilityCompetitorView. Cannot be filtered on in the 'WHERE' clause. Corresponds to the JSON property relativeVisibility

Returns:

  • (Float) 


3444
3445
3446
 
# File 'lib/google/apis/content_v2_1/classes.rb', line 3444

def relative_visibility
  @relative_visibility
end

#traffic_source ⇒ String

Type of impression listing. Required in the SELECT clause. Cannot be filtered on in the 'WHERE' clause. Corresponds to the JSON property trafficSource

Returns:

  • (String) 


3450
3451
3452
 
# File 'lib/google/apis/content_v2_1/classes.rb', line 3450

def traffic_source
  @traffic_source
end

#your_domain_visibility_trend ⇒ Float

Change in visibility based on impressions for your domain with respect to the start of the selected time range (or first day with non-zero impressions). Available only in CompetitiveVisibilityBenchmarkView. Cannot be filtered on in the 'WHERE' clause. Corresponds to the JSON property yourDomainVisibilityTrend

Returns:

  • (Float) 


3458
3459
3460
 
# File 'lib/google/apis/content_v2_1/classes.rb', line 3458

def your_domain_visibility_trend
  @your_domain_visibility_trend
end

Instance Method Details

#update!(**args) ⇒ Object

Update properties of this object



3465
3466
3467
3468
3469
3470
3471
3472
3473
3474
3475
3476
3477
3478
3479
 
# File 'lib/google/apis/content_v2_1/classes.rb', line 3465

def update!(**args)
  @ads_organic_ratio = args[:ads_organic_ratio] if args.key?(:ads_organic_ratio)
  @category_benchmark_visibility_trend = args[:category_benchmark_visibility_trend] if args.key?(:category_benchmark_visibility_trend)
  @category_id = args[:category_id] if args.key?(:category_id)
  @country_code = args[:country_code] if args.key?(:country_code)
  @date = args[:date] if args.key?(:date)
  @domain = args[:domain] if args.key?(:domain)
  @higher_position_rate = args[:higher_position_rate] if args.key?(:higher_position_rate)
  @is_your_domain = args[:is_your_domain] if args.key?(:is_your_domain)
  @page_overlap_rate = args[:page_overlap_rate] if args.key?(:page_overlap_rate)
  @rank = args[:rank] if args.key?(:rank)
  @relative_visibility = args[:relative_visibility] if args.key?(:relative_visibility)
  @traffic_source = args[:traffic_source] if args.key?(:traffic_source)
  @your_domain_visibility_trend = args[:your_domain_visibility_trend] if args.key?(:your_domain_visibility_trend)
end