Code Examples

PHP Code Examples

Here are some code examples for connecting to the Trillion Direct API via PHP.

Note: The below code examples have been tested in PHP 5 only. For compatibility with other PHP versions, some modifications may be required.

Add Keyword Example

This code example will a create a new Keyword Campaign, using the API function add_keyword.

<?php
#
# Create a new Keyword Campaign, using API function add_keyword
#

// define new campaign settings
$keyword = "credit cards"; // keyword to add
$folder = "Credit Cards"; // Name of Folder in which Keyword is to be added. The Folder has to be present in the account before adding keywords in it
$my_bid = "5.00"; // Your bid for the keyword ($5)
$target_url = "https://www.trillion.com"; // target URL, including http://
$daily_limit = "200.00"; // daily spend limit ($200)
$negative = "interest free"; // negative keywords


// create query URL, correctly URL encoded -- It is best to urlencode all values, just in case
$query_url = "https://www.trillion.com/api.html?mode=add_keyword&keyword=" . urlencode($keyword) .
        "&folder=". urlencode($folder) . "&my_bid=". urlencode($my_bid) . "&daily_limit=" . urlencode($daily_limit) . "&negative=" .urlencode($negative) .
        "&target_url=" . urlencode($target_url);

// attempt connection and to put response into variable $res
$res = file_get_contents($query_url);

// if connection was successful
if($res) {

   // parse XML results

   // put response in XML object $results
   $results = simplexml_load_string($res); // you could also use a regex to get data, but this way is neater

   // check for error
   if($results->error) {

      // if there was an error, get reason reason and display
      $error_attributes = $results->error->attributes();

      // display error
      echo "Error: " . $error_attributes->error;

   } elseif($results->result) { // if there was NOT an error

      // check that status is Success

      $result_attributes = $results->result->attributes();

      if($result_attributes->Status == "Added"){

        // Success!
        echo "Successfully created Keyword Campaign:" . $keyword;

      } else {

        // there was an error, show it

        // display error
        echo "Error status: " . $error_attributes->Status;

      }

   }


} else { // if there was a connection error

   // print error
   echo "Connection error!";

}

?>