/ Platform API
Platform API
    Chat Platform API v3
    Chat Platform API
    Chat Platform API
    Version 3

    Get detailed open rate of an announcement group

    Copy link

    Retrieves detailed open rate information on an announcement group.


    HTTP request

    Copy link
    GET https://api-{application_id}.sendbird.com/v3/announcement_open_rate_by_group/{announcement_group}
    

    Parameters

    Copy link

    The following table lists the parameters that this action supports.

    Parameters
    RequiredTypeDescription

    announcement_group

    string

    Specifies the name of an announcement group.

    OptionalTypeDescription

    days

    integer

    Specifies the number of days to retrieve detailed open rate information per hour. The specified period is calculated from the time the announcement was sent. The data is cumulated on an hourly basis, so each value separated by a comma in the response represents an hourly open count and open rate. (Default: 7)


    Response

    Copy link

    If successful, this action returns the open rate information on a specific announcement group in the response body.

    {
        "unique_id": "marketing_announcement_20200211",
        "announcement_group": "insurance",
        "open_counts": [1, 2, 3, ... ],
        "open_rates": [0.0, 0.001, 0.02, ... ],
        "cumulative_open_counts": [1, 3, 6, ... ],
        "cumulative_open_rates": [0.0, 0.001, 0.021, ... ]
    }
    

    In the case of an error, an error object is returned. A detailed list of error codes is available here.