Class: OursprivacyIngest::Models::VisitorUpsertParams

Inherits:

Internal::Type::BaseModel

• Object
• Internal::Type::BaseModel
• OursprivacyIngest::Models::VisitorUpsertParams

Extended by:

Internal::Type::RequestParameters::Converter

Includes:

Internal::Type::RequestParameters

Defined in:

lib/oursprivacy_ingest/models/visitor_upsert_params.rb,
sig/oursprivacy_ingest/models/visitor_upsert_params.rbs

Overview

See Also:

• OursprivacyIngest::Resources::Visitor#upsert

Defined Under Namespace

Classes: DefaultProperties, IdentityContext, UserProperties

Constant Summary

Constants included from Internal::Type::RequestParameters

Internal::Type::RequestParameters::OursprivacyIngest

Instance Attribute Summary

• #default_properties ⇒ OursprivacyIngest::Models::VisitorUpsertParams::DefaultProperties^?

  These properties are used throughout the Ours app to pass known values onto destinations.

• #email ⇒ String^?

  The email address of a user.

• #external_id ⇒ String^?

  Your system's unique identifier for this user.

• #identity_context ⇒ OursprivacyIngest::Models::VisitorUpsertParams::IdentityContext^?

  End-user network context for server-side calls.

• #token ⇒ String

  The token for your Source.

• #user_id ⇒ String^?

  The Ours Visitor ID stored in local storage and cookies on your web properties.

• #user_properties ⇒ OursprivacyIngest::Models::VisitorUpsertParams::UserProperties

  User properties to associate with this user.

Attributes included from Internal::Type::RequestParameters

#request_options

Instance Method Summary

• #initialize(_ef_transaction_id: nil, active_duration: nil, ad_id: nil, admitad_uid: nil, adset_id: nil, alart: nil, aleid: nil, axwrt: nil, basis_cid: nil, beeswax_auction_id: nil, browser_language: nil, browser_name: nil, browser_version: nil, campaign_id: nil, clickid: nil, clid: nil, cpu_architecture: nil, current_url: nil, dclid: nil, device_model: nil, device_type: nil, device_vendor: nil, duration: nil, encoding: nil, engine_name: nil, engine_version: nil, epik: nil, fbc: nil, fbclid: nil, fbp: nil, fv: nil, gad_source: nil, gbraid: nil, gclid: nil, host: nil, iframe: nil, im_ref: nil, ip: nil, irclickid: nil, is_bot: nil, li_fat_id: nil, msclkid: nil, ndclid: nil, new_s: nil, ob_click_id: nil, oppref: nil, os_name: nil, os_version: nil, page_hash: nil, pathname: nil, qclid: nil, rdt_cid: nil, received_at: nil, referrer: nil, referring_domain: nil, sacid: nil, sccid: nil, screen_height: nil, screen_width: nil, session_count: nil, sid: nil, sr: nil, title: nil, ttclid: nil, twclid: nil, uafvl: nil, user_agent: nil, utm_campaign: nil, utm_content: nil, utm_medium: nil, utm_name: nil, utm_source: nil, utm_term: nil, version: nil, viant_click_id: nil, viant_impression_id: nil, wbraid: nil, webview: nil) ⇒ Object constructor

  Some parameter documentations has been truncated, see DefaultProperties for more details.

• #to_hash ⇒ {

Methods included from Internal::Type::RequestParameters::Converter

dump_request

Methods included from Internal::Type::RequestParameters

included

Methods inherited from Internal::Type::BaseModel

==, #==, #[], coerce, #deconstruct_keys, #deep_to_h, dump, fields, hash, #hash, inherited, inspect, #inspect, known_fields, optional, recursively_to_h, required, #to_h, #to_json, #to_s, to_sorbet_type, #to_yaml

Methods included from Internal::Type::Converter

#coerce, coerce, #dump, dump, inspect, #inspect, meta_info, new_coerce_state, type_info

Methods included from Internal::Util::SorbetRuntimeSupport

#const_missing, #define_sorbet_constant!, #sorbet_constant_defined?, #to_sorbet_type, to_sorbet_type

Constructor Details

#initialize(_ef_transaction_id: nil, active_duration: nil, ad_id: nil, admitad_uid: nil, adset_id: nil, alart: nil, aleid: nil, axwrt: nil, basis_cid: nil, beeswax_auction_id: nil, browser_language: nil, browser_name: nil, browser_version: nil, campaign_id: nil, clickid: nil, clid: nil, cpu_architecture: nil, current_url: nil, dclid: nil, device_model: nil, device_type: nil, device_vendor: nil, duration: nil, encoding: nil, engine_name: nil, engine_version: nil, epik: nil, fbc: nil, fbclid: nil, fbp: nil, fv: nil, gad_source: nil, gbraid: nil, gclid: nil, host: nil, iframe: nil, im_ref: nil, ip: nil, irclickid: nil, is_bot: nil, li_fat_id: nil, msclkid: nil, ndclid: nil, new_s: nil, ob_click_id: nil, oppref: nil, os_name: nil, os_version: nil, page_hash: nil, pathname: nil, qclid: nil, rdt_cid: nil, received_at: nil, referrer: nil, referring_domain: nil, sacid: nil, sccid: nil, screen_height: nil, screen_width: nil, session_count: nil, sid: nil, sr: nil, title: nil, ttclid: nil, twclid: nil, uafvl: nil, user_agent: nil, utm_campaign: nil, utm_content: nil, utm_medium: nil, utm_name: nil, utm_source: nil, utm_term: nil, version: nil, viant_click_id: nil, viant_impression_id: nil, wbraid: nil, webview: nil) ⇒ Object

Some parameter documentations has been truncated, see DefaultProperties for more details.

These properties are used throughout the Ours app to pass known values onto destinations

`_ef_transactio

Parameters:

• _ef_transaction_id (String, nil) (defaults to: nil) —

  The Everflow affiliate Click (Transaction) ID, captured from the

• active_duration (Float, nil) (defaults to: nil) —

  The active time in milliseconds that the user had this tab active

• ad_id (String, nil) (defaults to: nil) —

  The ad id for detected in the session. This is set by the web sdk automatically.

• admitad_uid (String, nil) (defaults to: nil) —

  The Admitad (Mitgo) affiliate Click ID. Ex: admitad_uid_abc123

• adset_id (String, nil) (defaults to: nil) —

  The adset id for detected in the session. This is set by the web sdk automatical

• alart (String, nil) (defaults to: nil) —

  The AppLovin alart query parameter. Ex: alart123

• aleid (String, nil) (defaults to: nil) —

  The AppLovin aleid query parameter. Ex: aleid123

• axwrt (String, nil) (defaults to: nil) —

  The AppLovin pixel cookie value (_axwrt). Web-only.

• basis_cid (String, nil) (defaults to: nil) —

  The Basis DSP Click ID. Ex: basis_cid123

• beeswax_auction_id (String, nil) (defaults to: nil) —

  The Beeswax (FreeWheel Buyer Cloud) auction ID, captured from the `{AUCTION_ID

• browser_language (String, nil) (defaults to: nil) —

  The language of the browser. Ex: en-US

• browser_name (String, nil) (defaults to: nil) —

  The name of the browser. Ex: Chrome

• browser_version (String, nil) (defaults to: nil) —

  The version of the browser. Ex: 114.0

• campaign_id (String, nil) (defaults to: nil) —

  The campaign id for detected in the session. This is set by the web sdk automati

• clickid (String, nil) (defaults to: nil) —

  The Click ID. Ex: clickid123

• clid (String, nil) (defaults to: nil) —

  The Generic Click ID. Ex: clid123

• cpu_architecture (String, nil) (defaults to: nil) —

  The architecture of the CPU. Ex: x64

• current_url (String, nil) (defaults to: nil) —

  The full url (including query params) of the current page

• dclid (String, nil) (defaults to: nil) —

  The DoubleClick Click ID. Ex: dclid123

• device_model (String, nil) (defaults to: nil) —

  The model of the device. Ex: iPhone 13

• device_type (String, nil) (defaults to: nil) —

  The type of device the user is using. Ex: mobile

• device_vendor (String, nil) (defaults to: nil) —

  The vendor of the device. Ex: Apple

• duration (Float, nil) (defaults to: nil) —

  The time in milliseconds since the page was loaded // script was loaded

• encoding (String, nil) (defaults to: nil) —

  The browsers encoding. Ex: UTF-8

• engine_name (String, nil) (defaults to: nil) —

  The name of the browser engine. Ex: Blink

• engine_version (String, nil) (defaults to: nil) —

  The version of the browser engine. Ex: 114.0

• epik (String, nil) (defaults to: nil) —

  The Pinterest Click ID. Ex: epik456

• fbc (String, nil) (defaults to: nil) —

  Facebook Click ID with prefix format for Conversions API tracking. Ex: fb.1.1554

• fbclid (String, nil) (defaults to: nil) —

  Raw Facebook Click ID query parameter without prefix from ad clicks. Ex: AbCdEfG

• fbp (String, nil) (defaults to: nil) —

  Facebook Browser ID parameter for identifying browsers and attributing events. E

• fv (Boolean, nil) (defaults to: nil) —

  Deprecated

• gad_source (String, nil) (defaults to: nil) —

  The Google Ad Source. Ex: google

• gbraid (String, nil) (defaults to: nil) —

  The Google Braid ID. Ex: gbraid123

• gclid (String, nil) (defaults to: nil) —

  The Google Click ID. Ex: gclid123

• host (String, nil) (defaults to: nil) —

  The host of the current page. Ex: example.com

• iframe (Boolean, nil) (defaults to: nil) —

  Whether the user is in an iframe. Ex: true

• im_ref (String, nil) (defaults to: nil) —

  The Impact Click ID reference. Ex: im_ref123

• ip (String, nil) (defaults to: nil) —

  The IP address of the user. Ex: 127.0.0.1

• irclickid (String, nil) (defaults to: nil) —

  The Impact Click ID. Ex: irclickid123

• is_bot (String, nil) (defaults to: nil) —

  Whether we have detected that the user is a bot. This is set automatically by th

• li_fat_id (String, nil) (defaults to: nil) —

  The LinkedIn Click ID. Ex: li_fat_id123

• msclkid (String, nil) (defaults to: nil) —

  The Microsoft Click ID. Ex: msclkid123

• ndclid (String, nil) (defaults to: nil) —

  The NextDoor Click ID. Ex: ndclid123

• new_s (Boolean, nil) (defaults to: nil) —

  Deprecated

• ob_click_id (String, nil) (defaults to: nil) —

  The Outbrain click ID, captured from the ob_click_id URL parameter (Outbrain `

• oppref (String, nil) (defaults to: nil) —

  The OpenAI Ads privacy-preserving reference, captured from the oppref URL para

• os_name (String, nil) (defaults to: nil) —

  The name of the operating system. Ex: Windows

• os_version (String, nil) (defaults to: nil) —

  The version of the operating system. Ex: 10.0

• page_hash (Float, nil) (defaults to: nil) —

  A random set of numbers for the page load

• pathname (String, nil) (defaults to: nil) —

  The pathname of the current page. Ex: /home

• qclid (String, nil) (defaults to: nil) —

  The Quora Click ID. Ex: qclid123

• rdt_cid (String, nil) (defaults to: nil) —

  The Reddit Click ID. Ex: rdt_cid123

• received_at (String, nil) (defaults to: nil) —

  The time the event was received by an Ours server in ISO format

• referrer (String, nil) (defaults to: nil) —

  The referrer URL of the current page

• referring_domain (String, nil) (defaults to: nil) —

  The referring domain of the current page

• sacid (String, nil) (defaults to: nil) —

  The StackAdapt Tracking ID. Ex: sacid123

• sccid (String, nil) (defaults to: nil) —

  The SnapChat Click ID. Ex: sccid123

• screen_height (Float, nil) (defaults to: nil) —

  The height of the screen. Ex: 1080

• screen_width (Float, nil) (defaults to: nil) —

  The width of the screen. Ex: 1920

• session_count (Float, nil) (defaults to: nil) —

  The number of sessions the user has had. Ex: 3

• sid (String, nil) (defaults to: nil) —

  The session ID as assigned automatically by the web SDK. This is required for se

• sr (String, nil) (defaults to: nil)
• title (String, nil) (defaults to: nil) —

  The title of the current page

• ttclid (String, nil) (defaults to: nil) —

  The TikTok Click ID. Ex: ttclid123

• twclid (String, nil) (defaults to: nil) —

  The Twitter Click ID. Ex: twclid123

• uafvl (String, nil) (defaults to: nil) —

  User agent as a full list of strings.

• user_agent (String, nil) (defaults to: nil) —

  The user agent of the browser

• utm_campaign (String, nil) (defaults to: nil) —

  The UTM Campaign. The web SDK automatically captures this from the query params.

• utm_content (String, nil) (defaults to: nil) —

  The UTM Content. The web SDK automatically captures this from the query params.

• utm_medium (String, nil) (defaults to: nil) —

  The UTM Medium. The web SDK automatically captures this from the query params.

• utm_name (String, nil) (defaults to: nil) —

  The UTM Name. The web SDK automatically captures this from the query params.

• utm_source (String, nil) (defaults to: nil) —

  The UTM Source. The web SDK automatically captures this from the query params.

• utm_term (String, nil) (defaults to: nil) —

  The UTM Term. The web SDK automatically captures this from the query params.

• version (String, nil) (defaults to: nil) —

  The SDK version (e.g., web SDK or ingest-sdk-* via Stainless headers)

• viant_click_id (String, nil) (defaults to: nil) —

  The Viant (Adelphic) Click ID, captured from the viant_click_id URL parameter

• viant_impression_id (String, nil) (defaults to: nil) —

  The Viant (Adelphic) Impression ID, captured from the viant_impression_id URL

• wbraid (String, nil) (defaults to: nil) —

  The WBRAID Identifier. The web SDK automatically captures this from the query pa

• webview (Boolean, nil) (defaults to: nil) —

  Whether the user is in a webview. Ex: true

# File 'lib/oursprivacy_ingest/models/visitor_upsert_params.rb', line 417

Instance Attribute Details

#default_properties ⇒ OursprivacyIngest::Models::VisitorUpsertParams::DefaultProperties^?

These properties are used throughout the Ours app to pass known values onto destinations

Parameters:

• value (OursprivacyIngest::VisitorUpsertParams::DefaultProperties, nil)

Returns:

• (OursprivacyIngest::Models::VisitorUpsertParams::DefaultProperties, nil)

# File 'lib/oursprivacy_ingest/models/visitor_upsert_params.rb', line 31

optional :default_properties,
-> { OursprivacyIngest::VisitorUpsertParams::DefaultProperties },
api_name: :defaultProperties,
nil?: true

#email ⇒ String^?

The email address of a user. When userId is absent and externalId does not resolve a visitor, we search your account for a visitor with this email. If no match is found, we try userProperties.phone_number before creating a new visitor.

Parameters:

• value (String, nil)

Returns:

• (String, nil)

# File 'lib/oursprivacy_ingest/models/visitor_upsert_params.rb', line 43

optional :email, String, nil?: true

#external_id ⇒ String^?

Your system's unique identifier for this user. When userId is absent, we search your account for an existing visitor with this externalId. If no match is found, we try email and then userProperties.phone_number before creating a new visitor. If you also have the userId from cookies or local storage, send both — it removes the lookup round-trip.

Parameters:

• value (String, nil)

Returns:

• (String, nil)

# File 'lib/oursprivacy_ingest/models/visitor_upsert_params.rb', line 53

optional :external_id, String, api_name: :externalId, nil?: true

#identity_context ⇒ OursprivacyIngest::Models::VisitorUpsertParams::IdentityContext^?

End-user network context for server-side calls. Required for probabilistic identity resolution when the caller is a backend server rather than an end-user browser.

Parameters:

• value (OursprivacyIngest::VisitorUpsertParams::IdentityContext, nil)

Returns:

• (OursprivacyIngest::Models::VisitorUpsertParams::IdentityContext, nil)

# File 'lib/oursprivacy_ingest/models/visitor_upsert_params.rb', line 61

optional :identity_context,
-> { OursprivacyIngest::VisitorUpsertParams::IdentityContext },
api_name: :identityContext,
nil?: true

#token ⇒ String

The token for your Source. You can find this in the dashboard.

Parameters:

• value (String)

Returns:

• (String)

# File 'lib/oursprivacy_ingest/models/visitor_upsert_params.rb', line 14

required :token, String

#user_id ⇒ String^?

The Ours Visitor ID stored in local storage and cookies on your web properties. When present, this is used directly — no lookup by externalId, email, or phone is performed. If you have both a userId and an externalId, send both so the event is attached to the right visitor without any lookup overhead.

Parameters:

• value (String, nil)

Returns:

• (String, nil)

# File 'lib/oursprivacy_ingest/models/visitor_upsert_params.rb', line 73

optional :user_id, String, api_name: :userId, nil?: true

#user_properties ⇒ OursprivacyIngest::Models::VisitorUpsertParams::UserProperties

User properties to associate with this user. The existing user properties will be updated. And all future events will have these properties associated with them.

Parameters:

• value (OursprivacyIngest::VisitorUpsertParams::UserProperties)

Returns:

• (OursprivacyIngest::Models::VisitorUpsertParams::UserProperties)

# File 'lib/oursprivacy_ingest/models/visitor_upsert_params.rb', line 22

required :user_properties,
-> { OursprivacyIngest::VisitorUpsertParams::UserProperties },
api_name: :userProperties

Instance Method Details

#to_hash ⇒ {

Returns:

• ({)

# File 'sig/oursprivacy_ingest/models/visitor_upsert_params.rbs', line 44

def to_hash: -> {