get_campaign_activities

Pinpoint.Client.get_campaign_activities(**kwargs)

Retrieves information about all the activities for a campaign.

See also: AWS API Documentation

Request Syntax

response = client.get_campaign_activities(
    ApplicationId='string',
    CampaignId='string',
    PageSize='string',
    Token='string'
)

Parameters

• ApplicationId (string) --

  [REQUIRED]

  The unique identifier for the application. This identifier is displayed as the Project ID on the Amazon Pinpoint console.

• CampaignId (string) --

  [REQUIRED]

  The unique identifier for the campaign.

• PageSize (string) -- The maximum number of items to include in each page of a paginated response. This parameter is not supported for application, campaign, and journey metrics.
• Token (string) -- The NextToken string that specifies which page of results to return in a paginated response.

Return type

dict

Returns

Response Syntax

{
    'ActivitiesResponse': {
        'Item': [
            {
                'ApplicationId': 'string',
                'CampaignId': 'string',
                'End': 'string',
                'Id': 'string',
                'Result': 'string',
                'ScheduledStart': 'string',
                'Start': 'string',
                'State': 'string',
                'SuccessfulEndpointCount': 123,
                'TimezonesCompletedCount': 123,
                'TimezonesTotalCount': 123,
                'TotalEndpointCount': 123,
                'TreatmentId': 'string'
            },
        ],
        'NextToken': 'string'
    }
}

Response Structure

• (dict) --

  The request succeeded.

  • ActivitiesResponse (dict) --

    Provides information about the activities that were performed by a campaign.

    • Item (list) --

      An array of responses, one for each activity that was performed by the campaign.

      • (dict) --

        Provides information about an activity that was performed by a campaign.

        • ApplicationId (string) --

          The unique identifier for the application that the campaign applies to.

        • CampaignId (string) --

          The unique identifier for the campaign that the activity applies to.

        • End (string) --

          The actual time, in ISO 8601 format, when the activity was marked CANCELLED or COMPLETED.

        • Id (string) --

          The unique identifier for the activity.

        • Result (string) --

          Specifies whether the activity succeeded. Possible values are SUCCESS and FAIL.

        • ScheduledStart (string) --

          The scheduled start time, in ISO 8601 format, for the activity.

        • Start (string) --

          The actual start time, in ISO 8601 format, of the activity.

        • State (string) --

          The current status of the activity. Possible values are: PENDING, INITIALIZING, RUNNING, PAUSED, CANCELLED, and COMPLETED.

        • SuccessfulEndpointCount (integer) --

          The total number of endpoints that the campaign successfully delivered messages to.

        • TimezonesCompletedCount (integer) --

          The total number of time zones that were completed.

        • TimezonesTotalCount (integer) --

          The total number of unique time zones that are in the segment for the campaign.

        • TotalEndpointCount (integer) --

          The total number of endpoints that the campaign attempted to deliver messages to.

        • TreatmentId (string) --

          The unique identifier for the campaign treatment that the activity applies to. A treatment is a variation of a campaign that's used for A/B testing of a campaign.

    • NextToken (string) --

      The string to use in a subsequent request to get the next page of results in a paginated response. This value is null if there are no additional pages.

Exceptions

• Pinpoint.Client.exceptions.BadRequestException
• Pinpoint.Client.exceptions.InternalServerErrorException
• Pinpoint.Client.exceptions.PayloadTooLargeException
• Pinpoint.Client.exceptions.ForbiddenException
• Pinpoint.Client.exceptions.NotFoundException
• Pinpoint.Client.exceptions.MethodNotAllowedException
• Pinpoint.Client.exceptions.TooManyRequestsException