Graph API-Version

Custom Conversion Stats

Wird gelesen

Access insights aggregated from Custom Conversion

Beispiel

GET /v19.0/{custom-conversion-id}/stats HTTP/1.1
Host: graph.facebook.com

/* PHP SDK v5.0.0 */
/* make the API call */
try {
  // Returns a `Facebook\FacebookResponse` object
  $response = $fb->get(
    '/{custom-conversion-id}/stats',
    '{access-token}'
  );
} catch(Facebook\Exceptions\FacebookResponseException $e) {
  echo 'Graph returned an error: ' . $e->getMessage();
  exit;
} catch(Facebook\Exceptions\FacebookSDKException $e) {
  echo 'Facebook SDK returned an error: ' . $e->getMessage();
  exit;
}
$graphNode = $response->getGraphNode();
/* handle the result */

/* make the API call */
FB.api(
    "/{custom-conversion-id}/stats",
    function (response) {
      if (response && !response.error) {
        /* handle the result */
      }
    }
);

/* make the API call */
new GraphRequest(
    AccessToken.getCurrentAccessToken(),
    "/{custom-conversion-id}/stats",
    null,
    HttpMethod.GET,
    new GraphRequest.Callback() {
        public void onCompleted(GraphResponse response) {
            /* handle the result */
        }
    }
).executeAsync();

/* make the API call */
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
                               initWithGraphPath:@"/{custom-conversion-id}/stats"
                                      parameters:params
                                      HTTPMethod:@"GET"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,
                                      id result,
                                      NSError *error) {
    // Handle the result
}];

Weitere Informationen zur Verwendung der Graph API findest du in unserem Graph API-Leitfaden.

Parameter

Parameter Beschreibung

Parameter	Beschreibung
`aggregation` enum{count, device_type, host, pixel_fire, unmatched_count, unmatched_usd_amount, url, usd_amount}	The aggregation to use for the stats. `device_type`: Get the number of pixel fires per mobile device type, grouped by hour. You can use this aggregation type with custom conversions from the event source `pixel`. `host`: Get the number of pixel fires for the top 10,000 hosts grouped by hour. You can use this aggregation type with custom conversions from the event source `pixel`. `url`: Get the number of pixel fires for the top 10,000 URLs grouped by hour. Facebook pulls query parameters from the URLs. You can use this aggregation type with custom conversions from the event source `pixel`. `pixel_fire`: Get the number of pixel fires by hour (deprecated, please use `count` instead). `count`: Get the number of event fires. For `pixel` based custom conversion, the number is grouped by hour. For `offline_conversion_data_set` based custom conversion, the number is grouped by day. You can use this aggregation type with custom conversions from the event source `pixel` and `offline_conversion_data_set` . `unmatched_count`: Number of event fires Facebook cannot match to user. Grouped by day. You can use this aggregation type with custom conversions from the event source `offline_conversion_data_set` . `usd_amount`: USD amount, in cents, for custom conversion grouped by day. You can use this aggregation type with custom conversions from the event source `offline_conversion_data_set` . `unmatched_usd_amount`: USD amount, in cents, for custom conversion that Facebook cannot match with users. Grouped by day. You can use this aggregation type with custom conversions from the event source `offline_conversion_data_set`
`end_time` datetime	End time of the requested stat
`start_time` datetime	Start time of the requested stat

aggregation

enum{count, device_type, host, pixel_fire, unmatched_count, unmatched_usd_amount, url, usd_amount}

The aggregation to use for the stats.

device_type: Get the number of pixel fires per mobile device type, grouped by hour.
You can use this aggregation type with custom conversions from the event source pixel.

host: Get the number of pixel fires for the top 10,000 hosts grouped by hour.
You can use this aggregation type with custom conversions from the event source pixel.

url: Get the number of pixel fires for the top 10,000 URLs grouped by hour. Facebook pulls query parameters from the URLs.
You can use this aggregation type with custom conversions from the event source pixel.

pixel_fire: Get the number of pixel fires by hour (deprecated, please use count instead).

count: Get the number of event fires.
For pixel based custom conversion, the number is grouped by hour.
For offline_conversion_data_set based custom conversion, the number is grouped by day.
You can use this aggregation type with custom conversions from the event source pixel and offline_conversion_data_set .

unmatched_count: Number of event fires Facebook cannot match to user. Grouped by day.
You can use this aggregation type with custom conversions from the event source offline_conversion_data_set .

usd_amount: USD amount, in cents, for custom conversion grouped by day.
You can use this aggregation type with custom conversions from the event source offline_conversion_data_set .

unmatched_usd_amount: USD amount, in cents, for custom conversion that Facebook cannot match with users. Grouped by day.
You can use this aggregation type with custom conversions from the event source offline_conversion_data_set

end_time

datetime

End time of the requested stat

start_time

datetime

Start time of the requested stat

Felder

Beim Lesen dieses Edge wird ein Ergebnis im JSON-Format ausgegeben:

{
    "data": [],
    "paging": {}
}

`data`

Eine Liste von CustomConversionStatsResult-Nodes.

`paging`

Weitere Informationen zur Paginierung findest du im Graph API-Leitfaden.

Error Codes

Fehler	Beschreibung
368	The action attempted has been deemed abusive or is otherwise disallowed
100	Invalid parameter
190	Invalid OAuth 2.0 Access Token

Wird erstellt

Diese Handlung kann auf diesem Endpunkt nicht durchgeführt werden.

Wird aktualisiert

Diese Handlung kann auf diesem Endpunkt nicht durchgeführt werden.

Wird gelöscht

Diese Handlung kann auf diesem Endpunkt nicht durchgeführt werden.