Notifications
AD80 can tell you when it has classified a creative, when a creative breaks your rules, and when a key is about to expire. You choose the channel, the events, the filters, the language and how often.
Channels
Section titled “Channels”| Channel | What you get |
|---|---|
| A message in English or Arabic (HTML and plain text) with the app, the rules and scores, the network, the placement and a link to the creative image. Every message has an unsubscribe link, and mail programs can unsubscribe in one click. | |
| Webhook | An HTTPS POST with a JSON body, signed with your secret. See Webhook events. |
Notification channels are included in the Starter and Enterprise plans. You set them up on the Notifications page or with the Notifications API.
Events
Section titled “Events”| Event | When |
|---|---|
creative.violation | A creative’s new verdict breaks at least one rule. |
creative.classified | A creative was classified (whether or not it breaks a rule). |
key.expiring | An upload key or API key with an expiry date is about to expire. |
Each subscription chooses its events and can be narrowed by filters: apps, rules and a minimum score.
Verify a destination
Section titled “Verify a destination”A new subscription receives nothing until you prove the destination is yours:
- E-mail: AD80 sends a confirmation e-mail. Open the link and press Confirm. The link is valid for 48 hours.
- Webhook: AD80 posts a
notify.verifyevent to your URL. Itsdata.code(starting withvc_) is a one-time code; send it back toPOST /v1/notifications/subscriptions/{id}/confirm. See Verify a destination.
Changing the destination requires a new verification.
How often: immediate or digest
Section titled “How often: immediate or digest”| Mode | Behaviour |
|---|---|
immediate | One message per event. |
digest_hourly | One message per hour with the events of that hour. |
digest_daily | One message per day. |
Expedited notifications
Section titled “Expedited notifications”Classification and violation alerts sent to an immediate subscription are expedited notifications; your plan
includes a monthly number of them, and under normal operation they arrive within minutes. When the monthly allowance
is used up, later alerts are not lost: they arrive in the subscription’s hourly digest, and the message says the
allowance was reached (webhooks carry "expedited": false). The allowance renews at the start of the next calendar
month (UTC).
Delivery
Section titled “Delivery”- A delivery is tried until your endpoint accepts it or for 24 hours, with growing waits. See Delivery, retries and idempotency.
- Delivery is at least once: a message can occasionally arrive twice. Webhook receivers de-duplicate with the delivery id; e-mail has no such guarantee.
- The delivery log (dashboard or API) shows every delivery and attempt, and lets you redeliver.
After a plan change
Section titled “After a plan change”If your plan loses a channel, your subscriptions stay but nothing is sent on that channel, and they cannot be turned on again until the plan includes the channel.