Quick start

Adall is fed from two sources: the ad platforms' official APIs (connected in the panel) and your own orders. Sending orders lets decisions follow real profit instead of what the platforms claim.

Add your site in the panel and connect your Google Ads account in Settings › Connections. You choose separately how much adall does by itself; the default is to only suggest.
In Settings › Connections › Send orders straight to adall › Setup details for your developer, Create key gives you a key and a secret. The secret is shown once.
Add the script that captures click ids to your site:

<script src="https://live.adall.io/adall.js" defer></script>

When an order is created, send an event from your server. The raw request is below; ready code for Node.js and PHP is on [Code examples](/docs/examples).

BODY='{"schema_version":1,"events":[{"event_id":"order-1001","type":"order","occurred_at":"2026-09-18T10:00:00Z","reference":"1001","value":{"amount_minor":45000,"currency":"TRY"},"customer":{"email_sha256":"<SHA-256 of the e-mail>"},"consent":{"ad_user_data":"granted","source":"veribenim"}}]}'
TS=$(date +%s)
SIG=$(printf '%s.%s' "$TS" "$BODY" | openssl dgst -sha256 -hmac "$SECRET" -hex | cut -d' ' -f2)
curl -X POST https://live.adall.io/api/v1/events \
  -H "Content-Type: application/json" -H "X-Adall-Key: $KEY" \
  -H "X-Adall-Timestamp: $TS" -H "X-Adall-Signature: sha256=$SIG" \
  -d "$BODY"

Amounts are sent in minor units (cents); never as decimals.
E-mails and phone numbers are sent only as SHA-256 digests; plain text is refused.
The same event_id sent twice counts once.