engaging_networks

A ruby binding for the Engaging Networks API

This fork is no longer maintained. Please see controlshift/ruby_engaging_networks for an updated version.

Usage

create a client object

require 'engaging_networks'
en = EngagingNetworks.new({public_token: 'PUBLIC_TOKEN',private_token: 'PRIVATE_TOKEN'})

Get a campaign by id

campaign = en.campaign.get 456
campaign.obj
=> #<EngagingNetworks::Response::Object:0x00000101685f68
 @fields=
  {"clientId"=>"123",
   "campaignId"=>"456",
   "campaignStatus"=>"Live",
   "campaignName"=>"Test Campaign",
   "campaignExportName"=>"Test Campaign",
   "description"=>nil}>

Duplicate a campaign

action = en.campaign.duplicate reference_name: 'foo',
                      format_name: 'API New Supporter Template',
                      csv_string: 'Email,First Name,Last Name,City,Country Code,Country Name,Postal Code,Mobile Phone,Language,Originating Action',
                      csv_file_name: 'upload.csv',
                      segment_id: 'Test Segment Id',
                      segment_name: 'Test Segment',
                      template_campaign_id: 26967,
                      new_campaign_reference_name: 'New Test Campaign4'
action.job_id
=> '1234'

Search for a campaign by name (exact match only)

action = en.campaign.search "Foo"
action.campaignName
=> 'Foo'

check if supporter exists

en.supporter.exists? 'email@example.com'
=> false

create an action

action = en.action.create(client_id: 123, campaign_id: 123, form_id: 123, first_name: 'George',
                                        last_name: 'Washington', city: 'Detroit', country: country_code, country_name: 'United States',
                                        email: 'george@washington.com', language_code: 'EN', address_line_1: 'address1', address_line_2: 'address2',
                                        post_code: '02052', state: 'MI', mobile_phone: '518-207-6768', originating_action: 'xxx')

action.valid?
=> true
action.result
=> true

And then check again, and now supporter exists!

en.supporter.exists? 'email@example.com'
=> true

Supporters by date

en.supporter.export Date.new(2014,6,5)
=> [{...}]

jlev/ruby_engaging_networks

engaging_networks

Usage

Copyright