Overview
General Set Email Subscribe Email Info Send Brand Send Category Add To Cart Add To Wishlist Checkout Ids Click Image Comment On Product Remove From Cart Save Order Send Product Set Cart Url Visit Help Page
CSV Feed
Product Feed
PHP SDK
PHP SDK
API Integration
Add Subscriber Remove subscriber Subscriber status Send Email Feedback Discounts Generate Discounts Unsubscribed Emails
API For Partners
Shopping Carts AOV Transactions Facebook CPA Google CPA Traffic Source

Facebook CPA

Returns the cost per action from Facebook, along with a percentage value and an indicator if it's a positive or negative change (compared to the previous interval).

Method: GET

URL: https://api.retargeting.app/v1/partners-api/facebook-cpa

Function parameters

Field Type Required Description
rest_key number or text True The REST API Key of the client.
date_from number Optional (Required only if date_to parameter is given) Unix Timestamp (Example: 1729590548). If not provided, default fallback is 30 days in the past from now.
date_to number Optional Unix Timestamp (Example: 1732182548). If not provided, default fallback is the current time.

The interval between date_from and date_to parameters (if provided) must not exceed 30 days.

Your account status must be in one of the states: PAID, PAYMENT ERROR or ACCOUNT SUSPENDED.

If your account is Inactive or Closed the API call will not work.

The API call will respond with JSON format.

Example 

    <?php

    require_once "vendor/autoload.php";

    $apiURL = "https://api.retargeting.app/v1/partners-api/facebook-cpa";
    $apiKey = "REST_KEY";

    $client = new GuzzleHttp\Client();

    $registerData = [
        "rest_key" => $apiKey,
    ];

    $request = $client->request("GET", $apiURL, ["query" => $registerData]);

If the API call succeeds, then the response will be as seen below: 

// currency dynamic based on the client's currency (Lei, EUR, BGN, etc.)

{
    status: "success",
    data: {
        value: "48.00 EUR",
        percentage: "75.50"
        increase: true
    }
}

If the API call fails, then the responses will be similar to the ones below:

When the rest_key parameter is invalid: 

{
    status: "error",
    message: "Incorrect rest key!"
}

When the account is not active: 

{
    status: "error",
    message: "Your account is not active!"
}

When the interval between date_from and date_to parameters is greater than 30 days: 

{
    status: "error",
    message: "Interval is greater than 30 days"
}

When date_from parameter is not provided together with date_to parameter: 

{
    status: "fail",
    data: {
        validator: {
            date_from: [
                "The date from field is required when date to is present."
            ]
        }
    }
}

When something went wrong: 

{
    status: "error",
    message: "Something went wrong"
}