Overview

Advertising partners integrate directly with Charity Engine through a combination of installation flow callbacks and API requests to track campaign activity and performance. Callbacks allow us to notify you when events take place or milestones are reached for a given install, while our API allows review of campaign and affiliate performance in real time.

Access and Setup

The first step is to obtain campaign identifiers and optional API credentials:

  • Campaign ID: Uniquely identifies each advertising campaign.
  • API Key (optional): Used for authentication on all API calls.

Please contact us to define your campaign IDs and exchange any callback requirements for integration, and also to receive your API key for reporting.

If callbacks are required, please provide the URL format and any instructions for proper usage. For example:

https://yourdomain.com/callback?campaign={campaignID}&click={clickID}&event={eventID}&status=complete

Define any mapping required of data to the URL parameters so it is clear what values to return via the callback. Also describe the circumstance by which the callback should be made (e.g. installation is complete, still active after 30 days, etc.). While we can assume that clickID here would correspond to the same identifier used to launch the install initially, it is best to define it all explicitly.

Integration

Once campaigns and callback details are established, initiate tracking links in the format below:

https://www.charityengine.com/join/{campaignID}/{clickID}:{affiliateID}
  • clickID: Unique identifier for each user click.
  • affiliateID (optional): Identifies specific traffic sources.

Tracking and Reporting

Review the Charity Engine Distribution Partner API documentation.

Charity Engine now supports detailed reporting of click and affiliate activity via the /installs/ids endpoint. This reporting can be used as an alternative to callback integration, or as a supplement to ensure accuracy.

To retrieve all click IDs for a campaign:

https://www.charityengine.com/api/v1/installs/ids?campaign={campaignID}&auth={APIkey}

To further filter those click IDs by affiliate:

https://www.charityengine.com/api/v1/installs/ids?campaign={campaignID}&source_id={affiliateID}&auth={APIkey}

This allows for granular performance reporting by source, campaign, or creative.

Additional Information

For detailed endpoint specifications, parameters, and data formats, refer to the official API documentation linked above. Charity Engine can assist with any integration or reporting questions – just contact us.

  • No labels