Class: SoapyCake::AdminAddedit

Inherits:
Client
  • Object
show all
Includes:
Helper
Defined in:
lib/soapy_cake/admin_addedit.rb

Overview

rubocop:disable Metrics/ClassLength

Constant Summary collapse

OFFER_DEFAULT_OPTIONS = 
{
  offer_name: '',
  third_party_name: '',
  hidden: 'no_change',
  offer_status_id: 0,
  ssl: 'no_change',
  click_cookie_days: -1,
  impression_cookie_days: -1,
  redirect_offer_contract_id: 0,
  redirect_404: 'no_change',
  enable_view_thru_conversions: 'no_change',
  click_trumps_impression: 'no_change',
  disable_click_deduplication: 'no_change',
  last_touch: 'no_change',
  enable_transaction_id_deduplication: 'no_change',
  postbacks_only: 'no_change',
  pixel_html: '',
  postback_url: '',
  fire_global_pixel: 'no_change',
  fire_pixel_on_nonpaid_conversions: 'no_change',
  expiration_date_modification_type: 'do_not_change',
  offer_contract_name: '',
  offer_link: '',
  thankyou_link: '',
  preview_link: '',
  thumbnail_file_import_url: '',
  offer_description: '',
  restrictions: '',
  advertiser_extended_terms: '',
  testing_instructions: '',
  allow_affiliates_to_create_creatives: 'no_change',
  unsubscribe_link: '',
  from_lines: '',
  subject_lines: '',
  conversions_from_whitelist_only: 'off',
  allowed_media_type_modification_type: 'do_not_change',
  track_search_terms_from_non_supported_search_engines: 'off',
  auto_disposition_type: 'none',
  auto_disposition_delay_hours: '0',
  session_regeneration_seconds: -1,
  session_regeneration_type_id: 0,
  payout_modification_type: 'change',
  received_modification_type: 'change',
  tags_modification_type: 'do_not_change'
}
REQUIRED_NEW_OFFER_PARAMS = 
%i(
  hidden offer_status_id offer_type_id currency_id ssl click_cookie_days
  impression_cookie_days redirect_404 enable_view_thru_conversions
  click_trumps_impression disable_click_deduplication last_touch
  enable_transaction_id_deduplication postbacks_only fire_global_pixel
  fire_pixel_on_nonpaid_conversions offer_link thankyou_link from_lines
  subject_lines
)
REQUIRED_OFFER_PARAMS = 
%i(
  advertiser_id vertical_id postback_url_ms_delay offer_contract_hidden
  price_format_id received received_percentage payout tags
)
REQUIRED_OFFER_CONTRACT_PARAMS = 
%i(
  offer_id offer_contract_id offer_contract_name price_format_id payout received
  received_percentage offer_link thankyou_link offer_contract_hidden
  offer_contract_is_default use_fallback_targeting
)

Instance Attribute Summary

Attributes inherited from Client

#api_key, #domain, #time_offset

Instance Method Summary collapse

Methods included from Helper

#const_lookup, #require_params, #translate_booleans!, #translate_values!, #validate_id, #walk_tree

Methods inherited from Client

#initialize

Constructor Details

This class inherits a constructor from SoapyCake::Client

Instance Method Details

#add_geo_targets(opts = {}) ⇒ Object 



90
91
92
93
94
95
96
97
98
99
100
101
102
 
# File 'lib/soapy_cake/admin_addedit.rb', line 90

def add_geo_targets(opts = {})
  require_params(opts, %i(offer_contract_id allow_countries))

  if opts[:allow_countries]
    geo_targets_allow_options!(opts)
  else
    geo_targets_redirect_options!(opts)
  end

  opts.merge!(add_edit_option: 'add', set_targeting_to_geo: true)

  run Request.new(:admin, :addedit, :geo_targets, opts)
end

#add_offer(opts = {}) ⇒ Object 



72
73
74
75
76
 
# File 'lib/soapy_cake/admin_addedit.rb', line 72

def add_offer(opts = {})
  require_params(opts, REQUIRED_NEW_OFFER_PARAMS)

  addedit_offer(opts.merge(offer_id: 0))
end

#add_offer_contract(opts = {}) ⇒ Object 



121
122
123
 
# File 'lib/soapy_cake/admin_addedit.rb', line 121

def add_offer_contract(opts = {})
  addedit_offer_contract(opts.merge(offer_contract_id: 0))
end

#add_offer_tier(opts = {}) ⇒ Object 



140
141
142
143
144
145
146
147
 
# File 'lib/soapy_cake/admin_addedit.rb', line 140

def add_offer_tier(opts = {})
  require_params(opts, %i(offer_id tier_id price_format_id offer_contract_id status_id))

  opts.merge!(redirect_offer_contract_id: -1, add_edit_option: 'add')
  translate_values!(opts, %i(status_id price_format_id))

  run Request.new(:admin, :addedit, :offer_tiers, opts)
end

#edit_affiliate(opts) ⇒ Object 



149
150
151
152
153
 
# File 'lib/soapy_cake/admin_addedit.rb', line 149

def edit_affiliate(opts)
  require_params(opts, %i(affiliate_id vat_tax_required))

  run Request.new(:admin, :addedit, :affiliate, opts)
end

#edit_contact(opts) ⇒ Object 



84
85
86
87
88
 
# File 'lib/soapy_cake/admin_addedit.rb', line 84

def edit_contact(opts)
  require_params(opts, %i(entity_id contact_id contact_email_address))

  run Request.new(:admin, :addedit, :contact, opts)
end

#edit_offer(opts = {}) ⇒ Object 



78
79
80
81
82
 
# File 'lib/soapy_cake/admin_addedit.rb', line 78

def edit_offer(opts = {})
  validate_id(opts, :offer_id)

  addedit_offer(opts)
end

#edit_offer_contract(opts = {}) ⇒ Object 



125
126
127
128
129
 
# File 'lib/soapy_cake/admin_addedit.rb', line 125

def edit_offer_contract(opts = {})
  validate_id(opts, :offer_contract_id)

  addedit_offer_contract(opts)
end

#geo_targets_allow_options!(opts) ⇒ Object 



104
105
106
107
108
109
 
# File 'lib/soapy_cake/admin_addedit.rb', line 104

def geo_targets_allow_options!(opts)
  require_params(opts, %i(countries))
  countries = Array(opts[:countries])
  opts[:countries] = countries.join(',')
  opts[:redirect_offer_contract_ids] = ([0] * countries.count).join(',')
end

#geo_targets_redirect_options!(opts) ⇒ Object 



111
112
113
114
115
116
117
118
119
 
# File 'lib/soapy_cake/admin_addedit.rb', line 111

def geo_targets_redirect_options!(opts)
  redirects = opts.delete(:redirects)
  unless redirects.is_a?(Hash) && redirects.keys.count > 0
    fail Error, "Parameter 'redirects' must be a COUNTRY=>REDIRECT_OFFER_CONTRACT_ID hash!"
  end

  opts[:countries] = redirects.keys.join(',')
  opts[:redirect_offer_contract_ids] = redirects.values.join(',')
end

#update_caps(opts = {}) ⇒ Object 



131
132
133
134
135
136
137
138
 
# File 'lib/soapy_cake/admin_addedit.rb', line 131

def update_caps(opts = {})
  require_params(opts, %i(cap_type_id cap_interval_id cap_amount send_alert_only))

  translate_values!(opts, %i(cap_type_id cap_interval_id))
  opts[:cap_amount] = -1 if opts[:cap_interval_id] == const_lookup(:cap_interval_id, :disabled)

  run Request.new(:admin, :addedit, :caps, opts)
end