图谱 API 版

    Offline Conversion Data Set Stats

    读取

    Graph API endpoint to get granular stats for a data set aggregated by event time or upload time

    例子

    Graph API Explorer
    GET /v20.0/{offline-conversion-data-set-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(
        '/{offline-conversion-data-set-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(
        "/{offline-conversion-data-set-id}/stats",
        function (response) {
          if (response && !response.error) {
            /* handle the result */
          }
        }
    );
    /* make the API call */
    new GraphRequest(
        AccessToken.getCurrentAccessToken(),
        "/{offline-conversion-data-set-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:@"/{offline-conversion-data-set-id}/stats"
                                          parameters:params
                                          HTTPMethod:@"GET"];
    [request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,
                                          id result,
                                          NSError *error) {
        // Handle the result
    }];
    如果你希望详细了解如何使用图谱 API,请阅读我们的图谱 API 指南

    参数

    参数描述
    aggr_time
    enum{upload_time, event_time}
    默认值:event_time

    Metrics aggregated on event time or upload time

    end
    integer

    Timestamp for range end

    granularity
    enum{daily, hourly, six_hourly}
    默认值:daily

    Granularity of stats returned, either daily or hourly. Hourly granularity not supported for date ranges older than 30 days

    skip_empty_values
    boolean
    默认值:false

    Skip records if all numbers are empty

    start
    integer

    Timestamp for range start

    user_timezone_id
    int64

    Timezone ID to convert data into, does not support date ranges older than 30 days. Supported timezones - https://developers.facebook.com/docs/marketing-api/reference/ad-account/timezone-ids/

    字段

    从这条连线读取将返回一个 JSON 格式的结果:

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

    data

    OfflineConversionDataSetStats 节点列表。

    paging

    详细了解分页功能,请见图谱 API 指南

    summary

    关于连线的汇总信息(例如次数总计)。请指定字段来调取概要中的参数(例如:概要=attribution_status)。

    字段说明
    attribution_status
    enum

    Status of attribution over the specified time period. Possible values are no_attribution, low_attribution and fine_attribution

    count
    integer

    Number of events in the specified time period

    match_rate_approx
    int32

    Approximate match rate percentage for all events in the specified time period

    usd_amount
    integer

    Sum of USD(in cents) of all events in the specified time period

    错误代码

    错误描述
    100Invalid parameter

    创建

    你无法在此端点执行该操作。

    更新

    你无法在此端点执行该操作。

    删除

    你无法在此端点执行该操作。