| Object | Resources |
|---|---|
| Earnings account: aggregates your spending across multiple sites that all belong to the same publishing group. Allows you to (automatically if wanted) share reports with publishing partners. Example: Schibsted ASA | Documentation Start creating |
| Site: aggregates your spending across multiple ad units. Allows you to (automatically if wanted) share reports with publishing partners, and to target your campaigns and creatives to one or more sites. Example: aftenposten.no | Documentation Start creating |
| Ad unit: counts your impressions, clicks and much more for a single placement on a site. Example: aftenposten.no - top banner | Documentation Start creating |
| Object | Resources |
|---|---|
| Understand the advertising section. The link to the right leads you to a page that teaches you the main parts of the advertising section. | Documentation |
| Create an advertiser. An advertiser is an advertising client that buys your services. If you have no advertisers yet, try creating your own company as an advertiser. | Documentation Start creating |
| Create an order. An advertiser can contain one or more orders. An order is also a folder for line items, and also determines which team that the campaign should belong to. | Documentation Start creating |
| Create a line item. A line item determines start and end dates, delivery objectives, targeting and more. | Documentation Start creating |
| Upload a creative. A line item needs one or more creatives to work. Try also to target the creative. Remember to use a creative size that is supported by the ad units you want to serve to. | Documentation (Creation starts from the line item) |
| Try to generate an ad impression using the Ad Tag Generator. This tool helps you verify that your ads are serving as they should. | Documentation Start testing |
| Object | Resources |
|---|---|
| Layouts let you determine what file types, looks and feels and other information to serve with your advertising. | Documentation Go to layouts |
| Custom events let you measure additional events in addition to what we already measure for you. | Documentation Go to custom events |
| Log data lets you download detailed data about each event (impression, viewable impression, click etc) and get in-depth information about each of these events. | Introduction to log data Go to data exports |
| Tiers let you organize your campaigns into priority levels, so that you can ensure that your VIPs get first look before the second priority campaigns, and so on. | Documentation Go to tiers |
Change between networks if you have access to multiple networks.
If you're a Marketplace Advertiser you will be asked to select one ore more sites.
| Diagnostics example | Explanation |
|---|---|
| Line Item dates indicate it should be currently running. | If the line item's start date had been in the future or the end date had been in the past, this could have been the reason why the line item didn't deliver any impressions. However, this check tells you that the dates are not the problem. |
| Line Item has no validation warnings. | When there is some information missing on a line item (for instance, if there is no creative to serve, or that the line item is paused), then there would be a warning in a yellow box on top of the line item page. This check looks for such a warning, but in this case there is no warning, and there is no information missing from the line item. |
| Located all assets for the Line Item on the CDN. | The asset test checks if Adnuntius has successfully been able to find the line item's creative material on our CDN. If you ever see a warning here, try to re-create your creatives, and if that does not work, contact us at support@adnuntius.com. |
| There are Ad Units with suitable dimensions. | The ad unit test checks if there are ad units with the appropriate width and height that can serve one of the creatives. |
| Line item delivery is NOT currently limited by smoothing. | Smoothing might limit the delivery of a line item if enabled, to ensure that the line item will not meet its objectives before the end date. If your line item is limited by smoothing and you want this to stop, try setting the line item's delivery to "unsmoothed". |
| There is no frequency capping. | Frequency capping might limit the delivery of a line item if enabled. If your line item is limited by frequency capping and you want this to stop, try removing the frequency cap from your line item. |
| The line item has lost about 25% of auctions in the last 24 hours. | If your line item loses auctions you may have to increase its bid price if you want it to win more often. Increasing the win rate may increase your velocity. |
| The line item did not deliver enough events in the past 24 hours. | This means that your line item didn't deliver enough impressions, clicks or whatever your objectives are, in order to deliver on all objectives before the end date of your line item. You can change this with one of the actions described above. |
To create a line item from a template, click "new line item from template" in the upper right corner, then choose your template.
Third party audiences can be added as targeting to your line item.
Semantic targeting.
Daily Delivery of 20k Impressions over 20 Days: Even vs Front Loaded Delivery
Cumulative Delivery of 20k Impressions over 20 Days: Even vs Front Loaded Delivery
Apply a ruleset to Publishers/Earnings Accounts, Sites and/or Ad Units.
| Concept | Description |
|---|---|
| Advertising Queries | Allows you to create a summary report of all advertisers, orders, line items or creatives across the system, or those who match certain labels or other criteria. |
| Publishing Queries | Allows you to create a summary report of all sites, ad units or earnings accounts across the system, or those who match certain labels or other criteria. |
Example invite email sent from Adnuntius
| Role | Details |
|---|---|
| Marketplace Advertiser: an agency or advertiser that should be able to buy inventory from some or all publishers. | https://docs.google.com/spreadsheets/d/1M_YV-UNw9fV9Jk7hcsjc98J4Eh604rfdhtVrCRaQPao/edit#gid=1644839331 |
| Marketplace Publisher: a publisher that should be able to sell its inventory through your marketplace. | https://docs.google.com/spreadsheets/d/1M_YV-UNw9fV9Jk7hcsjc98J4Eh604rfdhtVrCRaQPao/edit#gid=1634715789 |
| Parameter | Required | Restrictions | Description |
|---|---|---|---|
| pageSize | yes | Number | The amount of results to get back. |
| sentence | yes | String | A url encoded string of your search sentence. |
| thresholdScore | yes | Number | A decimal number of the closeness to your sentence you want to be, it ranges from 0 - 1 where 1 is exactly similar, and 0 is not very similar. |
| Parameter | Required | Restrictions | Description |
|---|---|---|---|
| id | yes | String | An identifier that is used to reference the creative set. |
| renderOption | no | null | 'div' | 'iframe' | A url encoded string of your search sentence. |
| startDate | yes | UTC Date String | A date string for when you want the creative set to go live, example: "2024-12-10T23:00:00.000Z" |
| endDate | no | UTC Date String | A date string for when you want the creative set to end, example: "2024-12-12T23:00:00.000Z" |
| userState | yes | 'APPROVED' | 'INCOMPLETE' | 'PAUSED' | Approved will go live, the other two will pause the creative set from delivering. |
| name | yes | String | A name for the creative set. |
| billingCurrency | yes | String of currencu eg: 'NOK' | The currency you want the billing to be in. Will have to be a currency that's setup in the network |
![\"\"/](\"//assets.adnuntius.com/aO59MDnCKaLBQNA0G0DUCc7nj8wJA0e149OPTkQCww8.jpg\")
",
"type": "INTERNAL",
"url": "/api/v1/creatives/7007clfzcm78jkjg"
}
],
"totalCount": 1
}
```
## POST
Post object contains the following keys:
| Name | Required | Restriction | Description |
| ---------------------- | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| name | Yes | String | The name of the creative. |
| description | | String | The description for the creative. |
| userState | | `NOT_READY`, `REQUIRES_REVIEW`, `APPROVED`, `REJECTED`, `PAUSED` | The state of the creative. Defaults to `APPROVED` if not specified. |
| rejectedReason | No\* | `ADULT_CONTENT`, `BLANK_CONTENT`, `MALFORMED_CLICK_THROUGH`, `DRUG_RELATED_CONTENT`, `WEAPON_RELATED_CONTENT`, `ABUSIVE_CONTENT`, `HATE_SPEECH_CONTENT`, `LANDING_PAGE_REJECTED`, `OFFENSIVE_CONTENT`, `UNACCEPTABLE_VISUAL_EFFECTS`, `DECEPTIVE_CONTENT`, `GAMBLING_CONTENT`, `PROHIBITED_ELECTION_RELATED_CONTENT`, `SHOCKING_CONTENT`, `MALWARE_CONTENT` | (\*required if `userState` is `REJECTED`) The reason for the creative being in the `REJECTED` state. |
| layout | Yes | String | The layout ID to be associated with the creative. |
| dimensionType | | `FIXED`, `FLEXIBLE`, `FIXED_WIDTH`, `FIXED_HEIGHT` | The library creative dimension type. Defaults to `FIXED` if not specified. |
| width | No\* | Int | (\*required if dimensionType is `FIXED` or `FIXED_WIDTH`) The width of the creative. |
| height | No\* | Int | (\*required if dimensionType is `FIXED` or `FIXED_HEIGHT`) The height of the creative. |
| targeting | | Object | The targeting for the creative. |
| impressionTrackingUrls | | Array | The impression tracking URL for the creative. |
| thirdPartyContent | | Object | The third party content. |
| type | | `INTERNAL`, `EXTERNAL` | The type of creative. Defaults to `INTERNAL` if not specified. |
| sponsorshipPercentage | | Number | The sponsorship percentage for the creative. |
| externalDemandSource | | String | The external demand source ID to be associated with the creative. |
| externalAdUnit | | Array | The external ad unit IDs to be associcated with the creative. |
| copyrightStatus | | `UNSPECIFIED`, `ADVERTISER_CONFIRMED`, `ADVERTISER_UNCONFIRMED` | The copyright status. Defaults to `UNSPECIFIED` if not specified. |
| source | | `SELF_SERVICE`, `MARKETPLACE`, `DIRECT` | The source of the creative. Defaults to `DIRECT` if not specified. |
| verifiedSafe | Yes | Boolean | The creative is verified to be safe. |
| libraryCreative | | String | The library creative ID to be associated with the creative. If the library creative is specified then `layout`, `dimensionType`, `width`, `height`, `layoutParameters`, `targeting`, `thirdPartyContent`, `copyrightStatus`, `source`, `verifiedSafe` fields will be overwritten with values from the library creative unless specified in `overrideFields` |
| overrideFields | | Array | Override the fields if `libraryCreative` is specified. The following fields are overrideable: `dimensionType`, `width`, `height`, `layoutParameters`, `targeting`, `copyrightStatus`, `source`, `verifiedSafe` |
Creative ID can be set to whatever string value the user would like as long as it is unique within the network.
Example POST request: `{id}` will be required when posting to the API.
```http
POST https://api.adnuntius.com/api/v1/creatives/{id}
```
Example post body:
```javascript
{
"constraintsToAssets": {
"image1": "asset_1",
"image2": {
"id": "asset_2"
},
"image3": null
},
"constraintsToText": {
"headline": "Man bites Dog!",
"content": "Click here..."
},
"constraintsToUrls": {
"destinationUrl": "www.example.com"
},
"description": "The description for the creative",
"height": 300,
"impressionTrackingUrls": [ "http://imp.tradedoubler.com/imp?type(inv)g(20367306)a(2095715)" ],
"layout": "layout_1",
"lineItem": "lineitem_1",
"name": "My First Creative",
"userState": "REQUIRES_REVIEW",
"width": 200,
"type": "INTERNAL"
}
```
example POST response
```javascript
{
"lineItem": {
"id": "lineitem_1",
"url": "/api/v1/lineitems/lineitem_1",
"name": "My Line Item"
},
"constraintsToAssets": {
"image1": {
"id": "asset_1",
"url": "/api/v1/assets/creative_1/asset_1"
},
"image2": {
"id": "asset_2",
"url": "/api/v1/assets/creative_1/asset_2"
},
"image3": null
},
"constraintsToText": {
"headline": "Man bites Dog!",
"content": "Click here..."
},
"constraintsToUrls": {
"destinationUrl": "www.example.com"
},
"thirdPartyContent": {},
"createTime": "2016-01-01T10:20:30Z",
"createUser": {
"id": "create_user",
"url": "/api/v1/users/create_user",
"name": "Alice"
},
"description": "The description for the creative",
"height": 300,
"id": "creative_1",
"impressionTrackingUrls": [ "http://imp.tradedoubler.com/imp?type(inv)g(20367306)a(2095715)" ],
"layout": {
"id": "layout_1",
"url": "/api/v1/layouts/layout_1",
"name": "My Layout"
},
"name": "My First Creative",
"network": {
"id": "network_1",
"url": "/api/v1/networks/network_1"
},
"objectState": "ACTIVE",
"targeting": {
"adUnitMatchingLabelTargets": [],
"adUnitTarget": {
"adUnits": []
},
"categoryTargets": [],
"dateTarget": {
"dateRanges": [],
"timeZoneSetting": "SYSTEM"
},
"deviceTargets": [],
"geospatialTargets": [],
"keyValueTargets": [],
"keywordTargets": [],
"namedLocationTarget": {
"locations": []
},
"retargetingTargets": [],
"siteTarget":{
"sites": []
},
"userSegmentTargets": [],
"dayPartingTargets": [],
"ipAddressTarget": {
"addresses":[]
}
},
"updateTime": "2016-01-11T10:20:30Z",
"updateUser": {
"id": "update_user",
"url": "/api/v1/users/update_user",
"name": "Bob"
},
"userState": "REQUIRES_REVIEW",
"url": "/api/v1/creatives/creative_1",
"validationWarnings": [],
"width": 200,
"type": "INTERNAL"
}
```
# /customeventtypes
## GET
A `GET` request can always be filtered by the get [parameters](http://docs.adnuntius.com/api/api-requests) defined in the introduction section of the api documentation.
**Example GET request:**
```http
GET https://api.adnuntius.com/api/v1/contextserviceconnections?context=Date in UTC
(2020-01-01T23:00:00:00.000Z)
| Start date of the report | | endDate | required |Date in UTC
(2020-01-01T23:00:00:00.000Z)
| End date of the report | | all | optional | lineItem, order, creative, advertiser | Selects the endpoint for which to get the data. | | groupBy | optional | ORDER, LINE\_ITEM, ADVERTISER | Defines how to group the "chunks" | | includeAll | optional | Boolean | Weather or not to show items that has 0 impressions. | | includeChunkRange | optional | boolean | Includes all the dates even if there are no stats on those dates | | aggregateTo | optional | ORDER, LINE\_ITEM, ADVERTISER | Determine what chunks should be in the response. | ### Example request ```javascript /stats ?auth_token=PDXS2YodiUqV0ur... &aggregateTo=LINE_ITEM &all=lineItem &context=
\n
\n\n \n \n \n \n \n\n \n \n\n\n \n\n\n",
"matchedAdCount": 1,
"rts": [
"yyyyyy"
]
}
{
"auId": "xyz987",
"targetId": "adn-xyz987",
"html": "\n\n\n \n \n\n \n\n\n\n![\"\"/](\"//assets.adnuntius.com/creative.jpg\")
\n\n\n\n\n
\n\n\n\n\n\n\n
\n\n \n \n \n \n \n\n \n \n\n\n \n\n\n",
"matchedAdCount": 1,
"rts": [
"zzzzzz"
]
}
],
"metaData": {
"network!usi": "aaaa",
"network!sessionId": "bbbb",
"i": "0AAAAAZa9gZwGAQAAAACEPAA="
},
"duplicateFilter": "ccccc",
"segments": [],
"keywords": []
}
```
### Targeting Parameters
You can include targeting information with the HTTP request to the ad server that can control which line items or creatives match your request.
#### Key-value targeting
Key values can be sent to the ad server through HTTP like this:
```http
http://delivery.adnuntius.com/i?tzo=-120&auId=00000000000481f7&kv=%5B%7B%22myKey%22%3A%5B%22myValue1%22%2C%22myValue2%22%5D%7D%5D
```
The `kv=` will be a URL encoded Json of what you wish to send. In the above case it's this:
```javascript
kv: [{'myKey': ['myValue1', 'myValue2']}]
```
#### Category Targeting
Category targeting can be sent to the adserver using the `c=` parameter.
```http
&c=category1&c=sport%2Fbasketball&c=politics
```
Woud be the equivalent of sending this in the ad request:
```javascript
c: ['category1', 'sport/basketball', 'politics']
```
the content of the category should be URL encoded.
# Cookieless Advertising
Advertising without cookies is easy at Adnuntius. No first-party cookies, no third-party cookies and no local storage is necessary.
We call it anonymous advertising: we don’t need to know anything about who we serve ads to nor leave any trace behind to track anyone.
## HTML5 Ads and Third-Party Creatives
HTML5 and third-party creatives allow advertisers to upload scripts and ads from third-parties that might use cookies. Those scripts and ads from third-party systems are not under our direct control.
Nevertheless, we can do our utmost to block all third-party cookie usage even with HTML5 ads and third-party creatives. We are generally able to block all use of third-party cookies, especially on browsers such as Safari, Firefox and Brave. Occasionally on the Chrome or Edge browsers, some third-party cookies manage to slip through.
{% hint style="info" %}
If you want to be 100% safe you can as an administrator restrict the [layouts](/adnuntius-advertising/admin-ui/design/layouts) that can be used; you can therefore solve this problem by not allowing third party creatives or html creatives to be uploaded to your account.
{% endhint %}
Some HTML5 ads and third-party creatives will not appear or function in a user’s browser if cookies are blocked. If this is a problem, we do provide the ability to turn strict cookie blocking on or off at a granular level, which means particular ads can be delivered without cookie restrictions when required.
## The Technical Details
Please note that these details build on the information [provided here](/adnuntius-advertising/requesting-ads/intro). By default, Adnuntius uses cookies and local storage when delivering ads. To avoid cookies, you can do either of the two things:
* add this code to the top of your web page `adn.useCookies(false);`
* in your ad request, add `useCookies: false` into your ad request as below:
```javascript
adn.request({useCookies: false, adUnits: [{adId: "000000000023"}]});
```
To avoid the use of local storage, you add the following to your page: `adn.useLocalStorage(false);`
To block the use of cookies and local storage in HTML5 ads and third-party cookies, add `isolateFrame: true` into your ad request as below:
```javascript
adn.request({isolateFrame: true, adUnits: [{adId: "000000000023"}]});
```
Note: using the `isolateFrame` option might cause some HTML5 ads or third-party creatives to fail to function or display in a user's browser.
Putting all these options together, you might end up with something like this:
```javascript
window.adn = window.adn || {}; adn.calls = adn.calls || [];
adn.calls.push(function() {
adn.useLocalStorage(false);
adn.request({ useCookies: false, isolateFrame: true,
adUnits: [ { auId: '00000000000432e3' } ]
});
});
```
## What We Can't Do When Advertising Anonymously
If you choose to advertise anonymously, with neither cookies or local storage in use, there are two features we cannot provide:
* Per-user caps on ad delivery;
* Accurate unique user counts.
We can provide these two features if cookies or local storage is enabled, but not if both are disabled.
You can still deliver ads anonymously and enjoy both features if you are able to provide a user ID with each ad request.
We keep no retrievable record of the user ID you pass into us because we utilise a mathematical technique called one-way hashing. With one-way hashing, we transform the ID into another set of characters that cannot then be transformed back into the original ID. This means we can count how many unique users have seen an ad but without knowing which particular user IDs saw the ad.
## Implementing Cookieless with a CMP
If you have implemented a consent management platform (CMP) that lets your website visitors consent to or reject tracking, then you can most likely use that CMP to set up for cookieless adserving. The logic is as follows, where a website visitor should get a cookieless ad or a normal one depending on their decision.
Below are examples of code that will be placed on the page in order to secure the logic. They use an event listener that will fire the ad request depending on the consent that is given. Usually this is easy for developers to support. The important part for Adnuntius is the useCookie: false parameter, and the other parameters described above.
**Usercentrics:**
```javascript
```
**Cookiebot:**
```javascript
```
**Piwik Pro** (please note that there also needs to be a piwik script on the page for this CMP):
```javascript
```
{% hint style="info" %}
Do you need a CMP to allow users to consent to or reject tracking, where all this works automatically? [Reach out to us](https://adnuntius.com/contact) for a demonstration of Adnuntius Connect.
{% endhint %}
{% hint style="info" %}
Please note that different CMPs have different ways of triggering events, and the code must be changed accordingly.
{% endhint %}
---
[Next Page](/llms-full.txt/1)
\n\n\n\n\n\n
\n\n\n\n\n\n