Re-usable Python scripts doing useful things with the various APIs of the CrossEngage CDP. The code provided is neither provided nor endorsed or supported by CrossEngage.
These scripts consume APIs of the CrossEngage CDP. You need to have an active account with this service and be in possesion of a valid master API key for this account.
The code was written and tested using Python 3.7.4. It utilises the excellent Requests HTTP library as well as python-dotenv to make managing environment variables easy.
- Clone the repository from GitHub using
git clone https://github.com/MutedJam/crossengage-python-snippets.gitand enter the newly created directory usingcd crossengage-python-snippets - Install the requirements with
pip3 install -r requirements.txt - Set the environment variables XNG_MASTER_API_KEY, XNG_APP_USER, XNG_APP_PASSWORD manually or configure them permantently in the
.envfile (see next section for an example)
To avoid having keys and password available in your shell history, you can create a .env file in the script directory. It will be read when you run a script loading the respective values as environment variables:
XNG_MASTER_API_KEY="123abcdef456"
XNG_APP_USER="someone@crossengage.io"
XNG_APP_PASSWORD="topsecretpassword"
XNG_WEB_TRACKING_KEY="123abcdef456"
SENDGRID_API_KEY="SG.some.secretKeyForTheSendgridApi"
Not all variables are required for all scripts. Please see the below descriptions for a list of the variables used by each script.
Generates a CSV file with yesterday's message statistics for campaigns in your account.
Requires environment variables XNG_MASTER_API_KEY, XNG_APP_USER and XNG_APP_PASSWORD.
Usage Example: python3 fetchMessageStatistcs.py output.csv where output.csv is the target file. Use the -r or --reduced option (e.g. python3 fetchMessageStatistcs.py -r ~/test.csv) to have each KPI in a separate column and thus only one row per message (instead of one row per KPI per message).
Fetches the Global Unsubscribes from Sendgrid through the respective API, then creates a segment in your CrossEngage account to identify CrossEngage users with matching email addresses and marks them as opted out of all CrossEngage communication. This avoids having CrossEngage send messages for these users to Sendgrid only for Sendgrid to drop them (which would not be reflected in the CrossEngage statistics).
The script only takes Sendgrid's Global Unsubscribes but not Unsubscribe Groups into account as there is no group-based opt-out management available in CrossEngage.
Requires environment variables XNG_MASTER_API_KEY, XNG_APP_USER, XNG_APP_PASSWORD, XNG_WEB_TRACKING_KEY and SENDGRID_API_KEY. The Sendgrid API key needs at least read access to Suppressions.
Usage Example: python3 optOutSendgridGlobalSuppressions.py