Download the PHP package eyefi/marketo without Composer
On this page you can find all versions of the php package eyefi/marketo. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download eyefi/marketo
More information about eyefi/marketo
Files in eyefi/marketo
Informations about the package marketo
Marketo
A PHP client for the Marketo SOAP API.
Installation
Add following line to your composer.json require:
And the following to you composer.json repositories:
Usage
- get_lead_by
- sync_lead
- add_to_campaign
- get_campaigns
Authentication
The first thing you'll want to do is include the marketo class and create a new instance of the client.
You will need your SOAP user id and SOAP encryption key as well as the hostname for your Marketo API endpoint. These can be found in the Admin -> SOAP section when logged into app.marketo.com.
If you store configuration in the environment you would create a new instance like:
The credentials are passed directly to the class rather than looking for constants or keys stored in superglobals so you can connect to multiple Marketo instances.
Getting a lead
You can get a lead using the get_lead_by($type, $value)
method.
Arguments
$type
- The type of ID you would like to look up the lead by. This can be one of the following:
idnum
- The Marketo lead IDcookie
- The entire _mkto_trk cookieemail
- The email address of the leadsdfccontantid
- The Salesforce Contact IDsfdcleadid
- The Salesforce Lead ID
$value
- The value for the key. For example if the $type is email the $value should be and email address
Examples
This will return an array of lead objects or FALSE
if not found. The result will always be an array whether there are one or more leads found.
Creating or updating a lead
You can create or update a lead using the sync_lead($lead, $lead_key = NULL, $cookie = NULL)
method.
Arguments
$lead
- Associative array of lead attributes
$lead_key
- Optional, The key being used to identify the lead, this can be either an email or Marketo ID
$cookie
- Optional, The entire _mkto_trk cookie the lead will be associated with
Examples
When no $lead_key or $cookie is given a new lead will be created
When a $lead_key or $cookie is specified, Marketo will attempt to identify the lead and update it. Sending the _mkto_trk
cookie is important for associating the lead you're syncing with any information Marketo collected when the lead was anonymous.
This will return the updated or created lead object.
Adding leads to campaigns
You can add leads to a campaign using the add_to_campaign($campaign_key, $leads)
method.
Arguments
$campaign_key
- Either the campaign id or the campaign name. You can get these from get_campaigns()
.
$leads
- An associative array with a key of lead id type and the corresponding value. This can also be an array of associative arrays. The available id types are:
idnum
- The Marketo lead IDsdfccontantid
- The Salesforce Contact IDsfdcleadid
- The Salesforce Lead ID
Examples
Add one lead to a campaign
Add multiple leads to a campaign with mixed id types
Returns TRUE
if successful FALSE
if not
Getting campaigns
You can get available campaigns using the get_campaigns($campaign = NULL)
method.
Arguments
$name
- Optional, the exact name of the campaign to get
You would usually use this to figure out what campaigns are available when calling add_to_campaign()
.
Returns an object containing all the campaigns that are available to the API. Campaigns are only available to the API if they have a Campaign is Requested trigger where the Source is Web Service API.
Examples