ultracart_api 4.1.222 → 4.1.224

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (69) hide show
  1. checksums.yaml +4 -4
  2. data/README.md +55 -2
  3. data/docs/OauthTokenResponse.md +2 -0
  4. data/docs/SfvbAffiliateNetwork.md +60 -0
  5. data/docs/SfvbAffiliateNetworkRequest.md +50 -0
  6. data/docs/SfvbAffiliateNetworksResponse.md +20 -0
  7. data/docs/SfvbApi.md +1456 -120
  8. data/docs/SfvbApprovalCreateRequest.md +8 -2
  9. data/docs/SfvbApprovalParams.md +7 -3
  10. data/docs/SfvbContainerResponse.md +3 -1
  11. data/docs/SfvbSmartAttribution.md +38 -0
  12. data/docs/SfvbSmartAttributionPlatform.md +34 -0
  13. data/docs/SfvbSmartAttributionRequest.md +30 -0
  14. data/docs/SfvbTrackingAdvanced.md +34 -0
  15. data/docs/SfvbTrackingAdvancedRequest.md +34 -0
  16. data/docs/SfvbTrackingChange.md +24 -0
  17. data/docs/SfvbTrackingHtml.md +36 -0
  18. data/docs/SfvbTrackingHtmlRequest.md +20 -0
  19. data/docs/SfvbTrackingHtmlResponse.md +22 -0
  20. data/docs/SfvbTrackingPrivacy.md +28 -0
  21. data/docs/SfvbTrackingPrivacyRequest.md +28 -0
  22. data/docs/SfvbTrackingProvider.md +48 -0
  23. data/docs/SfvbTrackingProviderConsent.md +22 -0
  24. data/docs/SfvbTrackingProviderEvent.md +20 -0
  25. data/docs/SfvbTrackingProviderField.md +42 -0
  26. data/docs/SfvbTrackingProviderOauth.md +28 -0
  27. data/docs/SfvbTrackingProviderRequest.md +32 -0
  28. data/docs/SfvbTrackingProviderSecrets.md +46 -0
  29. data/docs/SfvbTrackingProvidersResponse.md +22 -0
  30. data/docs/SfvbTrackingSettingsResponse.md +28 -0
  31. data/docs/SfvbTrackingWholesaleTier.md +22 -0
  32. data/docs/SfvbUtmShortcode.md +56 -0
  33. data/docs/SfvbUtmShortcodeRequest.md +44 -0
  34. data/docs/SfvbUtmShortcodesResponse.md +24 -0
  35. data/lib/ultracart_api/api/sfvb_api.rb +4602 -2793
  36. data/lib/ultracart_api/models/oauth_token_response.rb +11 -1
  37. data/lib/ultracart_api/models/sfvb_affiliate_network.rb +478 -0
  38. data/lib/ultracart_api/models/sfvb_affiliate_network_request.rb +428 -0
  39. data/lib/ultracart_api/models/sfvb_affiliate_networks_response.rb +232 -0
  40. data/lib/ultracart_api/models/sfvb_approval_create_request.rb +34 -7
  41. data/lib/ultracart_api/models/sfvb_approval_params.rb +24 -4
  42. data/lib/ultracart_api/models/sfvb_container_response.rb +16 -4
  43. data/lib/ultracart_api/models/sfvb_smart_attribution.rb +324 -0
  44. data/lib/ultracart_api/models/sfvb_smart_attribution_platform.rb +300 -0
  45. data/lib/ultracart_api/models/sfvb_smart_attribution_request.rb +282 -0
  46. data/lib/ultracart_api/models/sfvb_tracking_advanced.rb +300 -0
  47. data/lib/ultracart_api/models/sfvb_tracking_advanced_request.rb +302 -0
  48. data/lib/ultracart_api/models/sfvb_tracking_change.rb +250 -0
  49. data/lib/ultracart_api/models/sfvb_tracking_html.rb +344 -0
  50. data/lib/ultracart_api/models/sfvb_tracking_html_request.rb +230 -0
  51. data/lib/ultracart_api/models/sfvb_tracking_html_response.rb +242 -0
  52. data/lib/ultracart_api/models/sfvb_tracking_privacy.rb +352 -0
  53. data/lib/ultracart_api/models/sfvb_tracking_privacy_request.rb +352 -0
  54. data/lib/ultracart_api/models/sfvb_tracking_provider.rb +378 -0
  55. data/lib/ultracart_api/models/sfvb_tracking_provider_consent.rb +240 -0
  56. data/lib/ultracart_api/models/sfvb_tracking_provider_event.rb +230 -0
  57. data/lib/ultracart_api/models/sfvb_tracking_provider_field.rb +342 -0
  58. data/lib/ultracart_api/models/sfvb_tracking_provider_oauth.rb +270 -0
  59. data/lib/ultracart_api/models/sfvb_tracking_provider_request.rb +292 -0
  60. data/lib/ultracart_api/models/sfvb_tracking_provider_secrets.rb +360 -0
  61. data/lib/ultracart_api/models/sfvb_tracking_providers_response.rb +242 -0
  62. data/lib/ultracart_api/models/sfvb_tracking_settings_response.rb +272 -0
  63. data/lib/ultracart_api/models/sfvb_tracking_wholesale_tier.rb +240 -0
  64. data/lib/ultracart_api/models/sfvb_utm_shortcode.rb +410 -0
  65. data/lib/ultracart_api/models/sfvb_utm_shortcode_request.rb +350 -0
  66. data/lib/ultracart_api/models/sfvb_utm_shortcodes_response.rb +252 -0
  67. data/lib/ultracart_api/version.rb +1 -1
  68. data/lib/ultracart_api.rb +27 -0
  69. metadata +55 -1
@@ -5,7 +5,8 @@
5
5
  | Name | Type | Description | Notes |
6
6
  | ---- | ---- | ----------- | ----- |
7
7
  | **action** | **String** | The gated action to approve. | [optional] |
8
- | **content** | **String** | For a file.put_script write, the exact script to be written, at most 256 KB. UltraCart reviews it and keeps only its hash, so send the same bytes again on the write. Leave it out for a revert, which names params.version. | [optional] |
8
+ | **affiliate_network** | [**SfvbAffiliateNetworkRequest**](SfvbAffiliateNetworkRequest.md) | | [optional] |
9
+ | **content** | **String** | For a file.put_script write, the exact script to be written, at most 256 KB. For tracking_html.put, the exact HTML the write will send, at most 256 KB. UltraCart reviews it and keeps only its hash, so send the same bytes again on the write. Leave it out for a revert, which names params.version. | [optional] |
9
10
  | **experiment_start** | [**SfvbExperimentStartRequest**](SfvbExperimentStartRequest.md) | | [optional] |
10
11
  | **item_attribute_rows** | [**Array<SfvbItemAttributeBatchRow>**](SfvbItemAttributeBatchRow.md) | For item.attribute_batch, exactly the rows the batch will send - the dry run's change rows, each with merchant_item_oid and current_sha256. UltraCart keeps only their hash. | [optional] |
11
12
  | **item_pricing** | [**SfvbItemPricingRequest**](SfvbItemPricingRequest.md) | | [optional] |
@@ -13,6 +14,8 @@
13
14
  | **reason** | **String** | Why the agent wants to do this, in a sentence. Shown to the person as unverified text, capped at 500 characters. | [optional] |
14
15
  | **redirect_rows** | [**Array<SfvbRedirectDeleteRow>**](SfvbRedirectDeleteRow.md) | For redirect.delete_batch, exactly the rows the batch delete will send, up to 5,000, each with its hash_sha256. UltraCart keeps only their hash. | [optional] |
15
16
  | **segment_update** | [**SfvbCommsSegmentWriteRequest**](SfvbCommsSegmentWriteRequest.md) | | [optional] |
17
+ | **smart_attribution** | [**SfvbSmartAttributionRequest**](SfvbSmartAttributionRequest.md) | | [optional] |
18
+ | **tracking_provider** | [**SfvbTrackingProviderRequest**](SfvbTrackingProviderRequest.md) | | [optional] |
16
19
 
17
20
  ## Example
18
21
 
@@ -21,6 +24,7 @@ require 'ultracart_api'
21
24
 
22
25
  instance = UltracartClient::SfvbApprovalCreateRequest.new(
23
26
  action: null,
27
+ affiliate_network: null,
24
28
  content: null,
25
29
  experiment_start: null,
26
30
  item_attribute_rows: null,
@@ -28,7 +32,9 @@ instance = UltracartClient::SfvbApprovalCreateRequest.new(
28
32
  params: null,
29
33
  reason: null,
30
34
  redirect_rows: null,
31
- segment_update: null
35
+ segment_update: null,
36
+ smart_attribution: null,
37
+ tracking_provider: null
32
38
  )
33
39
  ```
34
40
 
@@ -4,25 +4,27 @@
4
4
 
5
5
  | Name | Type | Description | Notes |
6
6
  | ---- | ---- | ----------- | ----- |
7
+ | **affiliate_network_oid** | **Integer** | The affiliate network, for affiliate_network.change and affiliate_network.delete. 0 or left out for affiliate_network.change of a network the create call will add. | [optional] |
7
8
  | **after_step_uuid** | **String** | For sequence_step.move, the step it moves after. Or branch_step_uuid with side. | [optional] |
8
9
  | **attribute_names** | **Array<String>** | For item.attribute_batch, the attributes the batch would change. Set by the server. | [optional] |
9
10
  | **blog_post_oid** | **Integer** | The blog post, for blog_post.delete. | [optional] |
10
11
  | **branch_step_uuid** | **String** | For sequence_step.move, the condition, split or inboxgeek step it moves to the start of a side of. | [optional] |
11
- | **content_sha256** | **String** | For file.put_script, the SHA-256 of the exact bytes approved. Set by the server, never by the caller. The write must send bytes with this hash. | [optional] |
12
+ | **content_sha256** | **String** | For file.put_script and tracking_html.put, the SHA-256 of the exact bytes approved, and for affiliate_network.change the SHA-256 of the conversion pixel. Set by the server, never by the caller. The write must send bytes with this hash. | [optional] |
12
13
  | **domain** | **String** | For sending_domain.delete, the sending domain. | [optional] |
13
14
  | **esp_twilio_uuid** | **String** | For twilio_account.delete, the Twilio account's esp_twilio_uuid, as GET comms/twilio_account returns it. | [optional] |
14
15
  | **experiment_oid** | **Integer** | For experiment.end, the experiment to end. | [optional] |
15
16
  | **item_count** | **Integer** | For item.attribute_batch, how many items the batch would change when it was requested. Set by the server. | [optional] |
16
17
  | **merchant_item_oid** | **Integer** | For item.pricing, the item whose pricing changes. | [optional] |
17
18
  | **path** | **String** | The file path, for file.delete and file.put_script, or the page path for experiment.start of a page experiment. Exactly as the gated call will send it. | [optional] |
18
- | **request_sha256** | **String** | For experiment.start of a url experiment, the hash of the checked experiment approved, and for item.pricing the hash of the change. Set by the server. The gated call must send the same. | [optional] |
19
+ | **request_sha256** | **String** | For experiment.start of a url experiment, the hash of the checked experiment approved, for item.pricing, tracking_provider.change and affiliate_network.change the hash of the change, and for smart_attribution.change the hash of the configuration the change would store. Set by the server. The gated call must send the same. | [optional] |
19
20
  | **rows_sha256** | **String** | For redirect.delete_batch and item.attribute_batch, the plan_hash of the exact rows approved. Set by the server. The batch must send rows with this hash. | [optional] |
20
21
  | **rule_count** | **Integer** | For redirect.delete_batch, how many rules the batch would delete when it was requested. Set by the server. | [optional] |
21
22
  | **segment_uuid** | **String** | The segment whose rule changes, for segment.update. | [optional] |
22
23
  | **sequence_uuid** | **String** | The communication sequence, for sequence_step.delete, sequence_step.move and sequence_step.enable_postcard. | [optional] |
23
24
  | **side** | **String** | For sequence_step.move with branch_step_uuid, the side's label from the sequence read. | [optional] |
24
- | **slot** | **String** | For experiment.start of a page experiment, the page body name. Defaults to body. | [optional] |
25
+ | **slot** | **String** | For experiment.start of a page experiment, the page body name, which defaults to body. For tracking_html.put, tracking or conversion. | [optional] |
25
26
  | **step_uuid** | **String** | The step to remove, for sequence_step.delete, to move, for sequence_step.move, or to turn on, for sequence_step.enable_postcard. | [optional] |
27
+ | **tracking_provider** | **String** | The tracking provider key, for tracking_provider.change. | [optional] |
26
28
  | **upsell_kind** | **String** | For upsell.enable, what to switch on. | [optional] |
27
29
  | **upsell_oid** | **Integer** | For upsell.enable, the oid of the offer or path to switch on. | [optional] |
28
30
  | **version** | **Integer** | For file.put_script, the history version a revert restores. Leave it out, and send content instead, for a write. | [optional] |
@@ -35,6 +37,7 @@
35
37
  require 'ultracart_api'
36
38
 
37
39
  instance = UltracartClient::SfvbApprovalParams.new(
40
+ affiliate_network_oid: null,
38
41
  after_step_uuid: null,
39
42
  attribute_names: null,
40
43
  blog_post_oid: null,
@@ -54,6 +57,7 @@ instance = UltracartClient::SfvbApprovalParams.new(
54
57
  side: null,
55
58
  slot: null,
56
59
  step_uuid: null,
60
+ tracking_provider: null,
57
61
  upsell_kind: null,
58
62
  upsell_oid: null,
59
63
  version: null,
@@ -11,6 +11,7 @@
11
11
  | **merchant_item_id** | **String** | The merchant item id of the owning item, for item containers only and absent for every other owner type. owner_object_id is the item oid, which appears nowhere on a rendered storefront, so this is how a caller confirms which item an oid actually reached. It is read fresh on every call and so reflects a renamed item. A container's own id embeds this value, which is what a preview session keys an item container on. | [optional] |
12
12
  | **owner_object_id** | **String** | Identifier of the owning object within its store. | [optional] |
13
13
  | **owner_type** | **String** | Where this container lives. | [optional] |
14
+ | **warnings** | [**Array<SfvbErrorDetail>**](SfvbErrorDetail.md) | Quality warnings from validating this write. The write succeeded; each one says what to look at, such as a postcard QR code URL with a fragment. Absent when there are none. | [optional] |
14
15
 
15
16
  ## Example
16
17
 
@@ -24,7 +25,8 @@ instance = UltracartClient::SfvbContainerResponse.new(
24
25
  last_modified: null,
25
26
  merchant_item_id: null,
26
27
  owner_object_id: null,
27
- owner_type: null
28
+ owner_type: null,
29
+ warnings: null
28
30
  )
29
31
  ```
30
32
 
@@ -0,0 +1,38 @@
1
+ # UltracartClient::SfvbSmartAttribution
2
+
3
+ ## Properties
4
+
5
+ | Name | Type | Description | Notes |
6
+ | ---- | ---- | ----------- | ----- |
7
+ | **assist_percent** | **Float** | The global assist credit, 0 to 1. | [optional] |
8
+ | **attribution_model** | **String** | position_based, linear, time_decay or custom. | [optional] |
9
+ | **available_platforms** | [**Array<SfvbSmartAttributionPlatform>**](SfvbSmartAttributionPlatform.md) | Platforms detected from the storefront's tracking integrations that are not configured yet, with suggested settings. | [optional] |
10
+ | **closer_percent** | **Float** | The global closer credit, 0 to 1. | [optional] |
11
+ | **configured** | **Boolean** | True when the storefront has a saved configuration. When false, the other fields are the defaults an enable would save. | [optional] |
12
+ | **hash_sha256** | **String** | The hash of the configuration. Send it as If-Match when changing or deleting it. | [optional] |
13
+ | **lookback_days** | **Integer** | How many days of a shopper's visits count toward an order, 7 to 365. | [optional] |
14
+ | **mode** | **String** | disabled, report_only (decisions are recorded but every platform reports as before) or active (Smart Attribution decides whether each platform's conversion fires and what value it reports). | [optional] |
15
+ | **originator_percent** | **Float** | The global originator credit, 0 to 1. The three global percentages total exactly 1. | [optional] |
16
+ | **platforms** | [**Array<SfvbSmartAttributionPlatform>**](SfvbSmartAttributionPlatform.md) | The configured platforms. | [optional] |
17
+ | **storefront_oid** | **Integer** | The storefront this configuration belongs to. | [optional] |
18
+
19
+ ## Example
20
+
21
+ ```ruby
22
+ require 'ultracart_api'
23
+
24
+ instance = UltracartClient::SfvbSmartAttribution.new(
25
+ assist_percent: null,
26
+ attribution_model: null,
27
+ available_platforms: null,
28
+ closer_percent: null,
29
+ configured: null,
30
+ hash_sha256: null,
31
+ lookback_days: null,
32
+ mode: null,
33
+ originator_percent: null,
34
+ platforms: null,
35
+ storefront_oid: null
36
+ )
37
+ ```
38
+
@@ -0,0 +1,34 @@
1
+ # UltracartClient::SfvbSmartAttributionPlatform
2
+
3
+ ## Properties
4
+
5
+ | Name | Type | Description | Notes |
6
+ | ---- | ---- | ----------- | ----- |
7
+ | **assist_percent** | **Float** | This platform's assist credit, 0 to 1. Used only when platform_type_override is true. | [optional] |
8
+ | **closer_percent** | **Float** | This platform's closer credit, 0 to 1. Used only when platform_type_override is true. | [optional] |
9
+ | **fire_on_rebill** | **Boolean** | True when the platform also reports auto order rebills. On a write, when left out, true for paid and owned and false for the affiliate types. | [optional] |
10
+ | **integration_id** | **Integer** | The integration's id, such as an affiliate network pixel's oid. Null for a platform matched by name. On a write it must be an id from platforms or available_platforms. | [optional] |
11
+ | **integration_name** | **String** | The platform, as Smart Attribution names it, up to 50 characters. | [optional] |
12
+ | **non_participant_percent** | **Float** | The credit this platform reports for an order it took no part in, 0 to 1. 0 when left out. | [optional] |
13
+ | **originator_percent** | **Float** | This platform's originator credit, 0 to 1. Used only when platform_type_override is true. | [optional] |
14
+ | **platform_type** | **String** | paid, owned, external affiliate, affiliate network pixel, or excluded. | [optional] |
15
+ | **platform_type_override** | **Boolean** | True when this platform uses its own originator, assist and closer split instead of the global one. On a write, when left out, true if all three of its percentages are sent. | [optional] |
16
+
17
+ ## Example
18
+
19
+ ```ruby
20
+ require 'ultracart_api'
21
+
22
+ instance = UltracartClient::SfvbSmartAttributionPlatform.new(
23
+ assist_percent: null,
24
+ closer_percent: null,
25
+ fire_on_rebill: null,
26
+ integration_id: null,
27
+ integration_name: null,
28
+ non_participant_percent: null,
29
+ originator_percent: null,
30
+ platform_type: null,
31
+ platform_type_override: null
32
+ )
33
+ ```
34
+
@@ -0,0 +1,30 @@
1
+ # UltracartClient::SfvbSmartAttributionRequest
2
+
3
+ ## Properties
4
+
5
+ | Name | Type | Description | Notes |
6
+ | ---- | ---- | ----------- | ----- |
7
+ | **assist_percent** | **Float** | 0 to 1, at most 4 decimals. | [optional] |
8
+ | **attribution_model** | **String** | position_based, linear, time_decay or custom. | [optional] |
9
+ | **closer_percent** | **Float** | 0 to 1, at most 4 decimals. | [optional] |
10
+ | **lookback_days** | **Integer** | 7 to 365. | [optional] |
11
+ | **mode** | **String** | disabled, report_only or active. Making it active, or any change while it is active, needs an approval. | [optional] |
12
+ | **originator_percent** | **Float** | 0 to 1, at most 4 decimals. The three global percentages must total exactly 1, so send all three to change the split. | [optional] |
13
+ | **platforms** | [**Array<SfvbSmartAttributionPlatform>**](SfvbSmartAttributionPlatform.md) | When sent, replaces the whole platform list. Up to 100, each name and id once. Left out, the list is unchanged. | [optional] |
14
+
15
+ ## Example
16
+
17
+ ```ruby
18
+ require 'ultracart_api'
19
+
20
+ instance = UltracartClient::SfvbSmartAttributionRequest.new(
21
+ assist_percent: null,
22
+ attribution_model: null,
23
+ closer_percent: null,
24
+ lookback_days: null,
25
+ mode: null,
26
+ originator_percent: null,
27
+ platforms: null
28
+ )
29
+ ```
30
+
@@ -0,0 +1,34 @@
1
+ # UltracartClient::SfvbTrackingAdvanced
2
+
3
+ ## Properties
4
+
5
+ | Name | Type | Description | Notes |
6
+ | ---- | ---- | ----------- | ----- |
7
+ | **catalog_url** | **String** | The override for the storefront's catalog URL (the admin's Override Catalog URL). A path starting with / or an absolute http or https URL, up to 250 characters. Null when not overridden. | [optional] |
8
+ | **continue_shopping_url** | **String** | Where the continue shopping button goes instead of the default. A path starting with / or an absolute http or https URL, up to 250 characters. Null when not overridden. | [optional] |
9
+ | **conversion_pixel_only_if_paid** | **Boolean** | True when the receipt's conversion HTML runs only for orders whose payment succeeded. | [optional] |
10
+ | **default_currency** | **String** | The storefront's default currency code, one of the response's currencies. Null when not set. | [optional] |
11
+ | **hash_sha256** | **String** | The hash of the seven writable settings. Send it as If-Match when changing them. | [optional] |
12
+ | **omit_order_data** | **Boolean** | True when the order data is left off the custom thank you URL. | [optional] |
13
+ | **order_hash_secret_key_set** | **Boolean** | True when the account has an order hash secret key. The key is shared by every storefront on the account, is never returned, and is changed only in the admin. Null when it could not be checked. | [optional] |
14
+ | **payment_pending_url** | **String** | Where the shopper goes when the order's payment is still pending. A path starting with / or an absolute http or https URL, up to 500 characters. Null when not set. | [optional] |
15
+ | **thank_you_url** | **String** | Where the shopper goes after placing an order, instead of the built-in receipt. A path starting with / or an absolute http or https URL, up to 500 characters. Null for the built-in receipt. | [optional] |
16
+
17
+ ## Example
18
+
19
+ ```ruby
20
+ require 'ultracart_api'
21
+
22
+ instance = UltracartClient::SfvbTrackingAdvanced.new(
23
+ catalog_url: null,
24
+ continue_shopping_url: null,
25
+ conversion_pixel_only_if_paid: null,
26
+ default_currency: null,
27
+ hash_sha256: null,
28
+ omit_order_data: null,
29
+ order_hash_secret_key_set: null,
30
+ payment_pending_url: null,
31
+ thank_you_url: null
32
+ )
33
+ ```
34
+
@@ -0,0 +1,34 @@
1
+ # UltracartClient::SfvbTrackingAdvancedRequest
2
+
3
+ ## Properties
4
+
5
+ | Name | Type | Description | Notes |
6
+ | ---- | ---- | ----------- | ----- |
7
+ | **catalog_url** | **String** | A path starting with / or an absolute http or https URL, up to 250 characters. | [optional] |
8
+ | **continue_shopping_url** | **String** | A path starting with / or an absolute http or https URL, up to 250 characters. | [optional] |
9
+ | **conversion_pixel_only_if_paid** | **Boolean** | True to run the receipt's conversion HTML only for orders whose payment succeeded. | [optional] |
10
+ | **default_currency** | **String** | A currency code from the read's currencies. | [optional] |
11
+ | **dry_run** | **Boolean** | True to check the change and report it without saving. | [optional] |
12
+ | **omit_order_data** | **Boolean** | True to leave the order data off the custom thank you URL. | [optional] |
13
+ | **payment_pending_url** | **String** | A path starting with / or an absolute http or https URL, up to 500 characters. | [optional] |
14
+ | **thank_you_url** | **String** | A path starting with / or an absolute http or https URL, up to 500 characters. | [optional] |
15
+ | **unset** | **Array<String>** | Text settings to clear, by key. continue_shopping_url, catalog_url, thank_you_url, payment_pending_url or default_currency. Not with a value for the same key. | [optional] |
16
+
17
+ ## Example
18
+
19
+ ```ruby
20
+ require 'ultracart_api'
21
+
22
+ instance = UltracartClient::SfvbTrackingAdvancedRequest.new(
23
+ catalog_url: null,
24
+ continue_shopping_url: null,
25
+ conversion_pixel_only_if_paid: null,
26
+ default_currency: null,
27
+ dry_run: null,
28
+ omit_order_data: null,
29
+ payment_pending_url: null,
30
+ thank_you_url: null,
31
+ unset: null
32
+ )
33
+ ```
34
+
@@ -0,0 +1,24 @@
1
+ # UltracartClient::SfvbTrackingChange
2
+
3
+ ## Properties
4
+
5
+ | Name | Type | Description | Notes |
6
+ | ---- | ---- | ----------- | ----- |
7
+ | **from** | **String** | The value before. Null when it was not set. Booleans are true or false. | [optional] |
8
+ | **key** | **String** | The setting's key, as the read names it. | [optional] |
9
+ | **section** | **String** | What the setting belongs to. privacy or advanced for the tracking settings, the provider's key for a tracking provider, or affiliate_network. | [optional] |
10
+ | **to** | **String** | The value after. Null when it is cleared. Booleans are true or false. | [optional] |
11
+
12
+ ## Example
13
+
14
+ ```ruby
15
+ require 'ultracart_api'
16
+
17
+ instance = UltracartClient::SfvbTrackingChange.new(
18
+ from: null,
19
+ key: null,
20
+ section: null,
21
+ to: null
22
+ )
23
+ ```
24
+
@@ -0,0 +1,36 @@
1
+ # UltracartClient::SfvbTrackingHtml
2
+
3
+ ## Properties
4
+
5
+ | Name | Type | Description | Notes |
6
+ | ---- | ---- | ----------- | ----- |
7
+ | **approval_needed** | **Boolean** | On a dry run, whether the real write needs an approved tracking_html.put request. | [optional] |
8
+ | **changed** | **Boolean** | On a write, whether the slot changed. False when the content was already the same. | [optional] |
9
+ | **content** | **String** | The HTML, with its Velocity tokens as stored. Only on a read of one slot and on a write. Null when empty. | [optional] |
10
+ | **dry_run** | **Boolean** | On a write, true when nothing was saved. | [optional] |
11
+ | **hash_sha256** | **String** | The SHA-256 of the HTML as UTF-8, the hash of an empty string when empty. Send it as If-Match on the write. | [optional] |
12
+ | **label** | **String** | The slot's name in the admin. | [optional] |
13
+ | **runs_on** | **String** | Where the storefront injects it, in words. | [optional] |
14
+ | **set** | **Boolean** | True when the slot holds any HTML. | [optional] |
15
+ | **size_bytes** | **Integer** | The size of the HTML in UTF-8 bytes. 0 when empty. | [optional] |
16
+ | **slot** | **String** | tracking is injected into every page except the receipt. conversion is injected into the receipt only. | [optional] |
17
+
18
+ ## Example
19
+
20
+ ```ruby
21
+ require 'ultracart_api'
22
+
23
+ instance = UltracartClient::SfvbTrackingHtml.new(
24
+ approval_needed: null,
25
+ changed: null,
26
+ content: null,
27
+ dry_run: null,
28
+ hash_sha256: null,
29
+ label: null,
30
+ runs_on: null,
31
+ set: null,
32
+ size_bytes: null,
33
+ slot: null
34
+ )
35
+ ```
36
+
@@ -0,0 +1,20 @@
1
+ # UltracartClient::SfvbTrackingHtmlRequest
2
+
3
+ ## Properties
4
+
5
+ | Name | Type | Description | Notes |
6
+ | ---- | ---- | ----------- | ----- |
7
+ | **content** | **String** | The whole HTML the slot will hold, at most 256 KB as UTF-8. An empty string empties the slot, which needs no approval. Anything else needs an approved tracking_html.put request for exactly these bytes. | [optional] |
8
+ | **dry_run** | **Boolean** | True to check the write and say whether it needs an approval, without saving. | [optional] |
9
+
10
+ ## Example
11
+
12
+ ```ruby
13
+ require 'ultracart_api'
14
+
15
+ instance = UltracartClient::SfvbTrackingHtmlRequest.new(
16
+ content: null,
17
+ dry_run: null
18
+ )
19
+ ```
20
+
@@ -0,0 +1,22 @@
1
+ # UltracartClient::SfvbTrackingHtmlResponse
2
+
3
+ ## Properties
4
+
5
+ | Name | Type | Description | Notes |
6
+ | ---- | ---- | ----------- | ----- |
7
+ | **max_bytes** | **Integer** | The largest HTML the API writes to a slot, in UTF-8 bytes. The admin allows larger, but UltraCart's review must read the whole of it. | [optional] |
8
+ | **slots** | [**Array<SfvbTrackingHtml>**](SfvbTrackingHtml.md) | tracking and conversion, each with its size and hash_sha256. Read one slot for its content. | [optional] |
9
+ | **storefront_oid** | **Integer** | The storefront. | [optional] |
10
+
11
+ ## Example
12
+
13
+ ```ruby
14
+ require 'ultracart_api'
15
+
16
+ instance = UltracartClient::SfvbTrackingHtmlResponse.new(
17
+ max_bytes: null,
18
+ slots: null,
19
+ storefront_oid: null
20
+ )
21
+ ```
22
+
@@ -0,0 +1,28 @@
1
+ # UltracartClient::SfvbTrackingPrivacy
2
+
3
+ ## Properties
4
+
5
+ | Name | Type | Description | Notes |
6
+ | ---- | ---- | ----------- | ----- |
7
+ | **anonymize_ip** | **String** | Which shoppers have their IP address anonymized on the cart and order. all, eea, non_us, or null for nobody. | [optional] |
8
+ | **default_mailing_list_off** | **String** | Which shoppers start checkout with the mailing list sign-up unchecked. all, eea, non_us, or null for nobody. | [optional] |
9
+ | **disable_return_email** | **String** | Which shoppers are left out of the return email (the admin's Disable Return Email rule). all, eea, non_us, or null for nobody. | [optional] |
10
+ | **exclude_purchase_bubble_history** | **String** | Which shoppers' purchases are left out of the purchase bubble history. all, eea, non_us, or null for nobody. | [optional] |
11
+ | **hash_sha256** | **String** | The hash of these five rules. Send it as If-Match when changing them. | [optional] |
12
+ | **show_cookie_notice** | **String** | Which shoppers see the privacy and cookie notice. all, eea (shoppers in the European Economic Area), non_us, or null for nobody. | [optional] |
13
+
14
+ ## Example
15
+
16
+ ```ruby
17
+ require 'ultracart_api'
18
+
19
+ instance = UltracartClient::SfvbTrackingPrivacy.new(
20
+ anonymize_ip: null,
21
+ default_mailing_list_off: null,
22
+ disable_return_email: null,
23
+ exclude_purchase_bubble_history: null,
24
+ hash_sha256: null,
25
+ show_cookie_notice: null
26
+ )
27
+ ```
28
+
@@ -0,0 +1,28 @@
1
+ # UltracartClient::SfvbTrackingPrivacyRequest
2
+
3
+ ## Properties
4
+
5
+ | Name | Type | Description | Notes |
6
+ | ---- | ---- | ----------- | ----- |
7
+ | **anonymize_ip** | **String** | all, eea, non_us, or off. | [optional] |
8
+ | **default_mailing_list_off** | **String** | all, eea, non_us, or off. | [optional] |
9
+ | **disable_return_email** | **String** | all, eea, non_us, or off. | [optional] |
10
+ | **dry_run** | **Boolean** | True to check the change and report it without saving. | [optional] |
11
+ | **exclude_purchase_bubble_history** | **String** | all, eea, non_us, or off. | [optional] |
12
+ | **show_cookie_notice** | **String** | all, eea, non_us, or off. | [optional] |
13
+
14
+ ## Example
15
+
16
+ ```ruby
17
+ require 'ultracart_api'
18
+
19
+ instance = UltracartClient::SfvbTrackingPrivacyRequest.new(
20
+ anonymize_ip: null,
21
+ default_mailing_list_off: null,
22
+ disable_return_email: null,
23
+ dry_run: null,
24
+ exclude_purchase_bubble_history: null,
25
+ show_cookie_notice: null
26
+ )
27
+ ```
28
+
@@ -0,0 +1,48 @@
1
+ # UltracartClient::SfvbTrackingProvider
2
+
3
+ ## Properties
4
+
5
+ | Name | Type | Description | Notes |
6
+ | ---- | ---- | ----------- | ----- |
7
+ | **admin_path** | **String** | Where the provider is in the admin. | [optional] |
8
+ | **changes** | [**Array<SfvbTrackingChange>**](SfvbTrackingChange.md) | On a write, each setting it changed, or would change on a dry run. Secrets read only set or cleared. | [optional] |
9
+ | **configured** | **Boolean** | True when the provider is on, which means one of its identifying fields is set. | [optional] |
10
+ | **consent** | [**SfvbTrackingProviderConsent**](SfvbTrackingProviderConsent.md) | | [optional] |
11
+ | **consent_supported** | **Boolean** | True when the provider can be held back until the shopper consents. | [optional] |
12
+ | **cost** | **String** | For google_tag_manager, what turning on Google Tag Gateway costs. | [optional] |
13
+ | **dry_run** | **Boolean** | On a write, true when nothing was saved. | [optional] |
14
+ | **events** | [**Array<SfvbTrackingProviderEvent>**](SfvbTrackingProviderEvent.md) | For a provider with standard events, each one and whether it is sent. | [optional] |
15
+ | **fields** | [**Array<SfvbTrackingProviderField>**](SfvbTrackingProviderField.md) | Every field, in the order the admin shows them. | [optional] |
16
+ | **group** | **String** | google or other, the admin tab it is on. | [optional] |
17
+ | **hash_sha256** | **String** | The hash of the stored settings. A secret counts by its mask and length only. Send it as If-Match when changing or clearing the provider. | [optional] |
18
+ | **key** | **String** | The provider key, such as facebook or google_analytics. | [optional] |
19
+ | **name** | **String** | The name the admin shows. | [optional] |
20
+ | **notes** | **Array<String>** | Anything the write left for a person to do, such as disconnecting an OAuth connection in the admin. | [optional] |
21
+ | **oauth** | [**SfvbTrackingProviderOauth**](SfvbTrackingProviderOauth.md) | | [optional] |
22
+ | **wholesale_tiers** | [**Array<SfvbTrackingWholesaleTier>**](SfvbTrackingWholesaleTier.md) | For google_analytics, the account number per wholesale pricing tier. | [optional] |
23
+
24
+ ## Example
25
+
26
+ ```ruby
27
+ require 'ultracart_api'
28
+
29
+ instance = UltracartClient::SfvbTrackingProvider.new(
30
+ admin_path: null,
31
+ changes: null,
32
+ configured: null,
33
+ consent: null,
34
+ consent_supported: null,
35
+ cost: null,
36
+ dry_run: null,
37
+ events: null,
38
+ fields: null,
39
+ group: null,
40
+ hash_sha256: null,
41
+ key: null,
42
+ name: null,
43
+ notes: null,
44
+ oauth: null,
45
+ wholesale_tiers: null
46
+ )
47
+ ```
48
+
@@ -0,0 +1,22 @@
1
+ # UltracartClient::SfvbTrackingProviderConsent
2
+
3
+ ## Properties
4
+
5
+ | Name | Type | Description | Notes |
6
+ | ---- | ---- | ----------- | ----- |
7
+ | **_false** | **Boolean** | On a write, true to remove the gate. Not with type or region. | [optional] |
8
+ | **region** | **String** | Which shoppers the gate applies to. all, eea or non_us. | [optional] |
9
+ | **type** | **String** | Statistics, Preferences or Marketing. | [optional] |
10
+
11
+ ## Example
12
+
13
+ ```ruby
14
+ require 'ultracart_api'
15
+
16
+ instance = UltracartClient::SfvbTrackingProviderConsent.new(
17
+ _false: null,
18
+ region: null,
19
+ type: null
20
+ )
21
+ ```
22
+
@@ -0,0 +1,20 @@
1
+ # UltracartClient::SfvbTrackingProviderEvent
2
+
3
+ ## Properties
4
+
5
+ | Name | Type | Description | Notes |
6
+ | ---- | ---- | ----------- | ----- |
7
+ | **name** | **String** | AddPaymentInfo, AddToCart, AddToWishlist, CompleteRegistration, InitiateCheckout, Lead, Search or ViewContent. | [optional] |
8
+ | **_true** | **Boolean** | True when the event is sent to the provider. | [optional] |
9
+
10
+ ## Example
11
+
12
+ ```ruby
13
+ require 'ultracart_api'
14
+
15
+ instance = UltracartClient::SfvbTrackingProviderEvent.new(
16
+ name: null,
17
+ _true: null
18
+ )
19
+ ```
20
+
@@ -0,0 +1,42 @@
1
+ # UltracartClient::SfvbTrackingProviderField
2
+
3
+ ## Properties
4
+
5
+ | Name | Type | Description | Notes |
6
+ | ---- | ---- | ----------- | ----- |
7
+ | **allowed** | **Array<String>** | For a select, the values accepted. | [optional] |
8
+ | **key** | **String** | The field key a write names. | [optional] |
9
+ | **label** | **String** | The label the admin shows. | [optional] |
10
+ | **mask** | **String** | For a stored secret, its mask. Send it back, or leave the secret out, to keep it. | [optional] |
11
+ | **max** | **Integer** | The longest value accepted, or for an id_list the longest line. | [optional] |
12
+ | **max_value** | **Integer** | For a number, the largest value accepted. | [optional] |
13
+ | **min_value** | **Integer** | For a number, the smallest value accepted. | [optional] |
14
+ | **secret** | **Boolean** | True for a secret. Its value is never returned; set and mask say whether one is stored. | [optional] |
15
+ | **set** | **Boolean** | For a secret, true when one is stored. | [optional] |
16
+ | **sink** | **String** | For a writable secret, the sink a secret request names, with this storefront_oid as its target. | [optional] |
17
+ | **type** | **String** | id, id_list, token, url, server_url, host, host_list, bool, select, number, numeric_id or secret. It decides what a write accepts. | [optional] |
18
+ | **value** | **String** | The stored value. Booleans are true or false. Null when blank. Never present for a secret. | [optional] |
19
+ | **writable** | **Boolean** | False for a field the API reports but does not change. | [optional] |
20
+
21
+ ## Example
22
+
23
+ ```ruby
24
+ require 'ultracart_api'
25
+
26
+ instance = UltracartClient::SfvbTrackingProviderField.new(
27
+ allowed: null,
28
+ key: null,
29
+ label: null,
30
+ mask: null,
31
+ max: null,
32
+ max_value: null,
33
+ min_value: null,
34
+ secret: null,
35
+ set: null,
36
+ sink: null,
37
+ type: null,
38
+ value: null,
39
+ writable: null
40
+ )
41
+ ```
42
+
@@ -0,0 +1,28 @@
1
+ # UltracartClient::SfvbTrackingProviderOauth
2
+
3
+ ## Properties
4
+
5
+ | Name | Type | Description | Notes |
6
+ | ---- | ---- | ----------- | ----- |
7
+ | **admin_path** | **String** | Where in the admin a person connects or disconnects it. | [optional] |
8
+ | **ads_connected** | **Boolean** | For twitter, true when the Ads connection is made. | [optional] |
9
+ | **connected** | **Boolean** | True when the connection is made. | [optional] |
10
+ | **expires_at** | **String** | For facebook, when the connection expires, ISO 8601. | [optional] |
11
+ | **feeds_connected** | **Boolean** | For twitter, true when the Feeds connection is made. | [optional] |
12
+ | **kind** | **String** | google_ads, facebook, hubspot, snapchat, tiktok or twitter. | [optional] |
13
+
14
+ ## Example
15
+
16
+ ```ruby
17
+ require 'ultracart_api'
18
+
19
+ instance = UltracartClient::SfvbTrackingProviderOauth.new(
20
+ admin_path: null,
21
+ ads_connected: null,
22
+ connected: null,
23
+ expires_at: null,
24
+ feeds_connected: null,
25
+ kind: null
26
+ )
27
+ ```
28
+
@@ -0,0 +1,32 @@
1
+ # UltracartClient::SfvbTrackingProviderRequest
2
+
3
+ ## Properties
4
+
5
+ | Name | Type | Description | Notes |
6
+ | ---- | ---- | ----------- | ----- |
7
+ | **accept_cost** | **Boolean** | True to accept the cost of turning on Google Tag Gateway. Required to turn it on. | [optional] |
8
+ | **consent** | [**SfvbTrackingProviderConsent**](SfvbTrackingProviderConsent.md) | | [optional] |
9
+ | **dry_run** | **Boolean** | True to check the change and report it without saving. | [optional] |
10
+ | **events** | **Object** | Standard events by name, true to send. | [optional] |
11
+ | **fields** | **Object** | Plain field values by key. An empty string clears one. Booleans are true or false. Secrets go in secrets instead. | [optional] |
12
+ | **secrets** | [**SfvbTrackingProviderSecrets**](SfvbTrackingProviderSecrets.md) | | [optional] |
13
+ | **unset** | **Array<String>** | Plain field keys to clear. | [optional] |
14
+ | **wholesale_tiers** | [**Array<SfvbTrackingWholesaleTier>**](SfvbTrackingWholesaleTier.md) | For google_analytics, account numbers by pricing_tier_oid. | [optional] |
15
+
16
+ ## Example
17
+
18
+ ```ruby
19
+ require 'ultracart_api'
20
+
21
+ instance = UltracartClient::SfvbTrackingProviderRequest.new(
22
+ accept_cost: null,
23
+ consent: null,
24
+ dry_run: null,
25
+ events: null,
26
+ fields: null,
27
+ secrets: null,
28
+ unset: null,
29
+ wholesale_tiers: null
30
+ )
31
+ ```
32
+