EvaDav
EvaDav is a traffic source (push). Its own documentation: https://evadavapi.com/docs/api.
What it connects
Section titled “What it connects”- Sends your conversions back to EvaDav.
- Pulls your spend from its API.
- Blocks placements in a source campaign.
- Pauses and resumes its campaigns.
- Sets bids on its placements.
- Checks the connection with a harmless request when you test it.
How to connect it
Section titled “How to connect it”API key. Sent in the X-Api-Key header.
Conversions go without it: the postback carries no credentials, so a connection that lacks the API’s goes on sending conversions.
Set these on the connection:
| Field | Name | Kind | What to enter |
|---|---|---|---|
| Statistics time zone | time_zone | string | For spend, the time zone of EvaDav’s statistics days, UTC when unset; it can’t change once spend is reported |
| Blacklist audience per campaign | blacklists | a list of name and value pairs | For blocking sources, each EvaDav campaign’s id mapped to the id of the blacklist audience it filters by (Audiences in EvaDav, set as the campaign’s black list), one of its own, as a block applies to every campaign an audience filters; a campaign without one can’t block |
| API key | api_key | string, secret | The API key your EvaDav manager gives, for spend, sources and pauses; postbacks go without it |
A secret is set by the workspace’s owner alone and never shown again. A required secret that is missing holds the connection’s deliveries until it is set; one that is optional holds only what reads it.
Tracking macros
Section titled “Tracking macros”Each token is a query parameter on the campaign URL; the source replaces its macro with the value when it sends the visitor. The columns say which part of the visit it fills and which report column (v1 to v20) it lands in.
| Parameter | Macro | Fills | Report column |
|---|---|---|---|
click_id | {CLICKID} | The source’s click id | |
source | {SOURCE_ID} | Placement | v1 (Source) |
cmp | {CAMPAIGN_ID} | Source campaign | v2 (Campaign) |
creative | {CREATIVE_ID} | Creative | v3 (Creative) |
zone | {ZONE_ID} | Custom value | v4 (Zone) |
format | {FORMAT} | Custom value | v5 (Format) |
sub_period | {SUB_PERIOD} | Custom value | v6 (Subscription period) |
cost | {COST} | Cost |
The campaign URL you paste into the source is the tracking domain, the campaign’s key and the tokens the source fills, in this order (the domain below is an example, and {url_key} stands for the campaign’s own key):
https://trk.example.com/{url_key}?click_id={CLICKID}&source={SOURCE_ID}&cmp={CAMPAIGN_ID}&creative={CREATIVE_ID}&zone={ZONE_ID}&format={FORMAT}&sub_period={SUB_PERIOD}&cost={COST}Cost models, the first the default: from_token (the source’s own cost, passed in a token), cpc (cost per click), cpm (cost per thousand visits), api (the spend pulled from the source’s API).
With from_token, the cost is the value of cost, per visit in USD.
Preview the campaign URL
Section titled “Preview the campaign URL”Campaign URL
Paste the campaign URL into the source's ad. {url_key} stands for the campaign's own key, which the portal fills in; the macros are the source's, which it replaces with each visit's values.
How conversions get back to it
Section titled “How conversions get back to it”Tallyray sends a conversion to EvaDav when it enters one of these statuses: approved. A conversion is sent once per status it enters; an adjustment, with revenue moving and its status not, isn’t sent. A conversion older than 30d isn’t sent.
Tallyray’s event kinds, and the name each is sent as. A conversion of a kind not listed isn’t sent:
| Tallyray event | Sent to EvaDav as |
|---|---|
sale | sale |
The request: GET https://evadav.com/phpb.
A conversion is sent only when this holds:
=visit.external_click_id != ''Conversions are retried when the source can’t be reached or answers with an error that can pass; see the limits below.
Tallyray pulls spend from the source’s API every 1h, covering the last 2d again, as sources restate spend, 1d at most per request, by day, in the zone =conn.time_zone != '' ? conn.time_zone : 'UTC'. With api among the cost models, a campaign is priced by it.
The request: POST https://evadavapi.com/api/v2.2/advertiser/stats/campaign.
Pulling spend needs the API’s credential. A connection without it goes on sending conversions and pulls no spend.
Placements
Section titled “Placements”Placements are the visit’s placement value, as the tokens above fill it.
Blocking: POST https://evadavapi.com/api/v2.2/advertiser/sources/add. Mode append: Tallyray sends the placements to add. Lifting a block is sent too.
Pausing and resuming
Section titled “Pausing and resuming”Rules and reports can pause and resume the source’s own objects at these levels. Tallyray reads an object before it writes, and writes only what isn’t so already, so a repeated pause never toggles anything.
| Level | Named by |
|---|---|
| campaigns | cmp |
Rules and reports can set the source’s bids at these levels. Each value is read before it’s written, in the account’s currency, never converted; a value the source sets itself isn’t written.
| Level | Named by | Prices | Bounds | Notes |
|---|---|---|---|---|
| placements | cmp + source | cpc | min 0.001, step 0.001 | a value per country |
Limits
Section titled “Limits”- Rate: at most
2/sper connection, 2 at once. - Retries: up to 15 attempts, waiting from
30sand doubling up to6h, longer when the source’sRetry-Afterasks, and never past the conversion’s age limit. - Hosts it reaches:
evadav.com,evadavapi.com. No other. - What a connection may override:
/tokens,/conversions/events,/conversions/send_on,/cost. Hosts, authentication and requests never are, and an override may only lower the limits.
This page describes version 2 of the EvaDav template, the latest published. The version your connection runs is the one your administrators approved, and the portal shows it.