Marketing API Version

Clickthroughs

Provides operations to create, read, update and delete Clickthroughs.

Read Clickthroughs

Permissions

A user access token with Atlas API capability is required to request click through details.

Fields

Reading this endpoint returns a single Clickthrough object with the same fields as the node.

Read Clickthrough

You can get details of clickthroughs by making an HTTP GET request.

An example of the request and response:

Request:

https://graph.facebook.com/<API_VERSION>/<CLICK_THROUGH_ID>

Response:

{
  "campaign_id": "11002200631200", 
  "created_date": "2013-12-19T20:07:58+0000", 
  "id": "11002200632200", 
  "last_modified_date": "2014-04-24T00:36:20+0000", 
  "name": "Test ClickThrough", 
  "standard_url": "http://www.testwebsite.com/1", 
  "version": "3"
}

Curl Example

A curl example to get clickthrough details:

curl -G \
  -d 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/<API_VERSION>/<CLICK_THROUGH_ID>

Read Campaign Clickthrough

You can get details of clickthroughs for a campaign by making an HTTP GET request.

An example of the request and response:

Request:

https://graph.facebook.com/<API_VERSION>/<CAMPAIGN_ID>/click_throughs

Response:

{
  "data": [
    {
      "campaign_id": "11002200631200",
      "created_date": "2014-09-04T10:09:22-07:00",
      "id": "11002200632200",
      "last_modified_date": "2014-09-04T10:09:22-07:00",
      "name": "TestCampaign", 
      "standard_url": "http://www.test.com",
      "version": "1"
    }
  ]
}

Curl Example

A curl example to get clickthrough details for a campaign:

curl -G \
  -d 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/<API_VERSION>/<CAMPAIGN_ID>/click_throughs

Create Campaign Clickthroughs

Permissions

A user access token with Atlas API capability is required to create clickthrough details.

Fields

Publishing this endpoint returns a single or an array of Clickthrough objects.

Create Campaign Clickthrough

You can create clickthroughs for a campaign by making an HTTP POST request. It will update the clickthrough if it already exists.

An example of the request and response:

Request:

https://graph.facebook.com/<API_VERSION>/<CAMPAIGN_ID>/click_throughs?click_throughs=[{"name":"TestClickthrough", "standard_url":"http://www.facebook.com", "mobile_url":"http://m.facebook.com"}]

Response:

{
  "data": [
    {
      "id": "11002200632200", 
      "success": true
    }
  ]
}

Curl Example

A curl example to create clickthrough for a campaign:


curl \ -F 'click_throughs=[{"name":"TestClickthrough", "standard_url":"http://www.facebook.com", "mobile_url":"http://m.facebook.com"}]' \ -F 'access_token=<ACCESS_TOKEN>' \ https://graph.facebook.com/<API_VERSION>/<CAMPAIGN_ID>/click_throughs

Delete Atlas Clickthroughs

You cannot delete atlas clickthroughs.