offerRetraction Webhook
When an offer becomes invalid, we use the offerRetraction Webhook to retract the offer from users who have qualified for the offer. An offer can become invalid for any of the following reasons:
An advertiser might be unable to continue to sell policies after a time, in a specific state. For example, in Florida, publishers remove offer advertisements that fail to sell to targeted users.
An advertiser's Ad copy might contain spurious claims which could get reported to insurance regulators.
A copyright issue with the advertiser's logo or trademark, which could result in a legal injunction to remove all ad copy.
About the Offer Retraction System
The offer retraction system performs the following three key operations:
Make the necessary changes in the IQL backend system for offer retraction.
Send a webhook to the publisher informing them about the offer retraction.
Update the internal reporting system with the offer retraction status.
Once an offer has been retracted, the offerRetraction Webhook is sent to the publisher. The publisher then needs to ensure that the retracted offers are not displayed to the users who qualified for those offers.
They also need to ensure that retracted offers do not get cached, and invalidate them from the cache.
offerRetraction Webhook Method
POST The publisher needs to provide the URL
Headers
Authorization*
JSON Application
APIKEY <api_key>
Sample Request Payload
{
"driver_id": <user_id>,
"publisher_app_id": <publisher_app_id>,
"ad_id": <ad_id>,
"advertiser_id": <advertiser_id>,
"offer_retraction_reason": <offer_retraction_reason>,
"timestamp": <timestamp>
}