NAME WWW::Deduce::Ingest - an interface to Deduce Ingestion SYNOPSIS use WWW:Deduce::Ingest; my $d = WWW::Deduce::Ingest->new( 'my site id', 'my secret api key' ); # output html widget print $d->html('email@example.com'); # send an event my $err = $d->event( 'email@example.com', '192.0.2.3', 'eventname', { ... }, $opts ); print STDERR "uh oh! $err\n" if $err; INTERFACE new( site, apikey ) Create a new object. You need to pass in the site id and api key that were assigned to you by Deduce. html( email, opts ) Generate HTML to place on your web page. "email" The user's email address. It will be processed and hashed, not used directly. event(email, client_ip, eventtype, additional, opts) When something interesting happens on your site, tell Deduce. "email" The user's email address. It will be processed and hashed, not used directly. "client_ip" the user's IP address in dotted quad format (IPv4), or coloned octopus (IPv6). can often be found in $ENV{REMOTE_ADDR}. "eventtype" the event type. Consult with Deduce support to determine the event types. "additional" a hashref of event data to send. Consult with Deduce support to determine data to send. if you pass in 'email_prev' or 'cc' fields, they will be automatically processed and hashed, not send directly. "returns" if there is an error, the error message will be returned. on success, nothing. events(evts, opts) You can send several related events, by sending an array of event data. "evts" an array of event data (hashrefs). the events must contain valid email, ip, and event fields. any email, email_prev, and cc fields will automatically be processed and hashed. "returns" if there is an error, the error message will be returned. on success, nothing. BUGS There are no known bugs in the module. SEE ALSO http://www.deduce.com/ LICENSE This software may be copied and distributed under the terms found in the Perl "Artistic License". A copy of the "Artistic License" may be found in the standard Perl distribution.