adobe-marketing-cloud / marketing-cloud-php-sdk
An Object Oriented wrapper for the Adobe Marketing Cloud APIs
Installs: 210 180
Dependents: 1
Suggesters: 0
Security: 0
Stars: 35
Watchers: 30
Forks: 32
Open Issues: 5
Requires
- php: >=5.3
Requires (Dev)
- phpunit/phpunit: 3.7.*
This package is auto-updated.
Last update: 2024-10-29 04:19:54 UTC
README
A simple, Object Oriented wrapper for the Adobe Marketing Cloud APIs written in PHP5. This library is modeled after the php-github-api library built by ornicar
Uses the Adobe Marketing Cloud APIs. Default version is 1.4, but 1.3 and 1.2 are compatible.
Requires
- PHP 5.3 or higher
- php curl but it is possible to write another transport layer..
If the method you need does not exist yet, don't hesitate to request it with an issue!
Autoload
The first step to use include the library via composer:
require_once '/vendor/autoload.php';
Instantiate a new AdobeMarketingCloud Client
$adm = new AdobeMarketingCloud\Client();
From this object you can now access all of the different AdobeMarketingCloud APIs (listed below)
Authenticate a user
Authenticate using your Adobe Digital Marketing Web Services username and secret. You can obtain one by logging into the Marketing Cloud and browsing to Admin > Company > Web Services
$adm->authenticate($username, $secret);
Note: If authentication fails, it's probably because your company endpoint is different from the default. To verify, this, call the getEndpoint()
method:
echo $adm->getCompanyApi()->getEndpoint('My Company Name');
// "https://api2.omniture.com"
If the return value of this function is different from https:api.omniture.com, you will need to set the endpoint in your client
$adm->setEndpoint('https://api2.omniture.com');
Deauthenticate a user
Cancels authentication.
$adm->deAuthenticate();
Next requests will not be authenticated
Reports
For queueing SiteCatalyst reports Wraps SiteCatalyst Report API.
$reportApi = $adm->getReportApi();
Run a Ranked Report
$response = $reportApi->queueReport(array(
'reportSuiteID' => 'your-id',
'date' => date('Y-m-d'),
'metrics' => array(
array('id' => 'pageviews'),
),
'elements' => array(
array('id' => 'eVar1'),
),
));
print_r($response);
The above code will render the status of your queued report, which will look something like this:
Array
(
[status] => ready
[statusMsg] => Your report has been queued
[reportID] => 123456789
)
Retrieve a Queued Report
Once the report ID is retrieved for the trended, ranked, or overtime report, use the Report.GetReport API call to retrieve the report
$response = $reportApi->queueReport(array(
//... (see above)
));
$reportId = $response['reportID'];
do {
$report = $reportApi->getReport($reportId);
sleep(2);
} while ($report['status'] == 'not ready');
print_r($report['report']);
The above code will render the Report array, which will look something like this:
Array
(
[reportSuite] => Array (
[id] => your-id
[name] => Your Report Suite
)
[period] => "Mon. 16 July 2012",
[elements] => Array (
[id] => eVar2,
[name] => eVar 2
)
[metrics] => Array (
[id] => event2
[name] => Page View Event
[type] => number
)
[type] => trended
[data] => Array (
...
)
[totals] => Array (
...
)
)
Returns an array of results as described in the documentation
Calling Additional Methods
All the methods visible in the API Explorer can be called
using the SuiteApi
class. This is a generic class that accepts the method name and parameters, and will return the json
encoded response of the result.
$adm->getSuiteApi()->post('Saint.ExportCreateJob', $parameters);
Curl Debugging
If a request returns null, call the getLastResponse
method on the client in order to see the curl information and raw response:
if (!$response = $adm->getReportApi()->getReport($reportId)) {
print_r($adm->getLastResponse());
}
Passing in the debug flag to the HttpClient will output the response automatically when the response does not exist, or is not in json format
$adm = new AdobeMarketingCloud\Client(
new AdobeMarketingCloud\HttpClient\Curl(array('debug' => true))
);
Command Line Utility
OAuth is not yet available for production use. This functionality is still under development.
The easiest way to begin with OAuth is by using the command line utility tool (bin/adm
).
To get started, copy over the configuration file:
$ cp config/profile.json.dist config/profile.json
Once this is done, run the adm
command to get started
$ ./bin/amc
Calls the Adobe Marketing Cloud APIs
To get started, call
$ amc authorize
to retrieve a token. Some other options available are
-h, --help Display a help message and exit
-v, --version Display the current api version
-e, --endpoint Specify the api endpoint
See developer.omniture.com for more information
The first step will be to get an oauth token. This can be accomplished by providing the authorize
command with a client id, client secret, username and password. Client IDs can be created in the Developer Connection. Once you've done this, run the authorize
command to receive a token:
$ adm authorize CLIENT_ID CLIENT_SECRET USERNAME PASSWORD
Token: {
"access_token":"f9f071ca2c25d23eff01a1ea238d6f85666be0f6",
"expires_in":2592000,
"token_type":"bearer",
"scope":null,
"success":true
}
You've now received your first access token. This has been saved to config/profile.json
, so you don't need to worry about it. You can go ahead and start making requests!
$ adm request Company.GetReportSuites
Array
(
[report_suites] => Array
(
[0] => Array
(
[rsid] => your.rsid
[site_title] => Your Site
)
...
)
)
Endpoints
The default endpoint is api.omniture.com. If you are experiencing issues, call the Company.GetEndpoint
method to find out which endpoint you should be using:
$ ./bin/adm Company.GetEndpoint 'company=My Company'
https://api2.omniture.com/admin/1.3/rest/
In this case, the endpoint is api2.omniture.com. To use this endpoint instead, set the endpoint in your profile:
$ ./bin/amc profile endpoint api2.omniture.com
default value for "endpoint" set to api2.omniture.com
Now all subsequent requests will use this endpoint. If you need to use an endpoint other than the default, you can pass this in with the -e
or --endpoint
options
$ ./bin/amc authorize CLIENT_ID CLIENT_SECRET USERNAME PASSWORD --endpoint 'api3.omniture.com'
To Do
Better documentation and test coverage will be coming soon