v3.3.0: Multiple personal coupons creation endpoint, Loyalty and Referrals counters and Export Endpoints
Summary
Management API
Introduce createCouponsForMultipleRecipients Endpoint
An endpoint to allow creation of multiple coupons of the same configuration for up to 1,000 recipients at once.
Expose export endpoints as integral part of the SDK
All of our CSV export endpoints are accessible via the Web Application from the corresponding entity pages (refer to our Help Center for an example regarding Coupons).
Now these are also available endpoints as part of the SDK (links to our developer docs):
- Coupons Export
- Customer Sessions Export
- Effects Export
- Customer Loyalty Balance Export
- Customer Loyalty Ledgers Log Export
Example code snippet demonstrating consuming and printing the lines of a Customer Loyalty Balance Export:
# ...preparing api client...
# An example could be seen at the repository's README file: https://github.com/talon-one/talon_one.py#management-api
loyalty_program_id = '1'
export_contents = management_api.export_loyalty_balance(loyalty_program_id)
csv_reader = csv.reader(export_contents.splitlines())
for line in csv_reader:
# do something with line...
pprint(line)
Expose destroySession Endpoint
Expose an existing endpoint to allow destroying a bearer token used in the context of the management-api.
This endpoint imitates a "logout" function and will make the attached token invalid for consequent requests.
Introduce loyalty effects related and referrals creation counters on Campaign entities
As part of the newly added budgets to campaigns (see relevant Help Center Section), we have added new counters on campaigns with regard to loyalty and referrals:
created_loyalty_points_count: Total number of loyalty points created by rules in this campaigncreated_loyalty_points_effect_count: Total number of loyalty point creation effects triggered by rules in this campaignredeemed_loyalty_points_count: Total number of loyalty points redeemed by rules in this campaignredeemed_loyalty_points_effect_count: Total number of loyalty point redemption effects triggered by rules in this campaignreferral_creation_count: Total number of referrals created by rules in this campaign
⚠️ ⚠️ Breaking Change: Fix Campaign's discount_count type from int to float
Campaign's discount_count counter property was all along calculated as a floating decimal number by our system.
From this release on the returned values will be floating decimals and not cut-off integers:
- **discount_count** | **int** | Total amount of discounts redeemed in the campaign. | [optional]
+ **discount_count** | **float** | Total amount of discounts redeemed in the campaign. | [optional]
Integration API
Improve Responses Transparency
We are constantly extending and improving our integration API to provide our consumers with the best transparency regarding what exactly has happened within their requests.
We have added new data points to our v2 endpoints effects in order to improve the transparency we aspire for:
- If an effect was triggered because of a specific coupon the effect will now include this coupon ID, see
Effect.md - When a coupon is rejected we attach more details regarding the origin of the failure in
RejectCouponEffectProps:condition_index- The index of the condition that caused the rejection of the couponeffect_index- The index of the effect that caused the rejection of the coupondetails- More details about the failure (if available)
- The same applies for referrals, when a referral is rejected we attach more details regarding the origin of the failure in
RejectReferralEffectProps:condition_index- The index of the condition that caused the rejection of the referraleffect_index- The index of the effect that caused the rejection of the referraldetails- More details about the failure (if available)
Moreover, we have introduced a new response content, ruleFailureReasons, which when requested will attach to the response a collection containing all failed rules, with details (see the ruleFailureReason model to help narrowing down failures and further debugging efforts to a specific single condition or effect that caused the failure.
One "gotcha" to keep in mind: in order to maximize transparency, and due to the fact that we do not know in advance which campaign in the application the request targets, the list contains a collection of all failure reasons.
Meaning that, it might have "white noise" with data about failures that could be considered as "obvious" to the consumer. Therefore, we suggest always filtering the list by the campaign id that was expected to trigger and did not.
Attach Loyalty Program ID in responses
When the consumer requires that the response will contain the details of loyalty programs involved in processing the requests, we now attach the identifier of the loyalty program to the returned loyaltyProgramLedgers models.
The idea behind attaching the identifier is to help streamline further potential requests to our Management API with regard to details about a Loyalty Program, for example getLoyaltyStatistics or getLoyaltyPoints, that require the program identifier as part of the URI of the endpoint.
⚠️ A reminder of The Deprecation Notice: Integration API@v1 endpoints
The deprecation was introduced already in the last release of the SDK, here is a kind reminder of the deprecation notices for Integration API@v1 endpoints:
These endpoints will be flagged deprecated on 15.07.2021, meaning support for requests to these endpoints will end on that date. We will not remove the endpoints, and they will still be accessible for you to use.
We highly encourage migrating to the correspondent v2 endpoints for easier and more granular integration, as well as new features support (See our developer docs section about API V2.0).