Partner networks

Creating ad spaces for partner networks

  • Before you start using an API for partner networks, ask the manager to add the subnetwork tag to your publisher account in Admitad.
  • To use the method, you need to obtain access_token. Auth Description
  • In the parameter scope, send the right name "manage_websites".

Parameters

HTTP method Access rights URL Note
POST manage_websites https://api.admitad.com/subnetworks/v1/websites/create/
  • Request data format application/json
  • Returns the created ad space or validation errors info in the JSON format.

List of request parameters

In body, the request receives the list of json objects with the parameters of the ad space to be created.

Name Type Required Settings restrictions Note, allowed values
name string

 

Max length – 200  
url string

 

Max length – 255  
category array of integers

 

  Categories of affiliate programs
region array of strings

 

  Ad space regions
native_kind string

 

   

Example of a request for creating 3 ad spaces

curl -i -L -H 'Authorization: Bearer ${ACCESS_TOKEN_HERE}' -H "Content-Type: application/json" -X POST
http://api.admitad.loc/subnetworks/v1/create/ -d '[{ "name": "Test subnetwork with native 615125QCQ",
"native_kind":"social_network", "url": "https://google1.com/", "region": ["RU","BY"]}, { "name": "Test subnetwork with native 623225QQC", "native_kind":"social_network","url": "https://google1.com/",
"region": ["UA", "GB"]}, { "name": "Test subnetwork with native 73135QCQ",
"native_kind":"social_network", "url": "https://google1.com/", "category": [1,2,3], "region": ["US",
"CN"]}]'

Example of a response after successful request processing

If the request was successfully processed, the response will be a json object with the created key, where the key is the index of the ad space specified in the request, and the value is the object of the created ad space.

HTTP/1.1 200 OK

{
"0": {
"status": "active",
"kind": "subnetwork",
"is_old": false,
"account_id": "",
"verification_code": "8dfcc8fec5",
"creation_date": "2020-12-02T17:15:28",
"id": 349022,
"site_url": "https://google1.com/",
"validation_passed": false,
"name": "Test subnetwork with native 61",
"is_lite": false
},
"1": {
"status": "active",
"kind": "subnetwork",
"is_old": false,
"account_id": "",
"verification_code": "8c6210ac87",
"creation_date": "2020-12-02T17:15:28",
"id": 349023,
"site_url": "https://google1.com/",
"validation_passed": false,
"name": "Test subnetwork with native 62",
"is_lite": false
},
"2": {
"status": "active",
"kind": "subnetwork",
"is_old": false,
"account_id": "",
"verification_code": "a82bdc1022",
"creation_date": "2020-12-02T17:15:28",
"id": 349024,
"site_url": "https://google1.com/",
"validation_passed": false,
"name": "Test subnetwork with native 73",
"is_lite": false
}
}

Important:

  • If an invalid value is sent in the parameter for at least one of the partner network’s ad spaces, the request will not be processed, and none of the ad spaces will be created.

  • If ad spaces are successfully created, a scheduled task on connecting all the partner network’s created ad spaces to all affiliate programs the partner network’s main to which ad space is connected, will be created. It may take some time to connect the created ad spaces (usually, no longer than a couple of minutes).

Example of a response to an invalid request

The response will be a json object.

HTTP/1.1 400 Bad Request

{
"0": {
"name": [
"У вас уже есть площадка с таким названием"
]
},
"1": {
"name": [
"У вас уже есть площадка с таким названием"
]
},
"2": {
"name": [
"У вас уже есть площадка с таким названием"
]
}
}

Example of a response to a partially invalid request

HTTP/1.1 400 Bad Request

{
"0": "ok",
"1": "ok",
"2": {
"name": [
"У вас уже есть площадка с таким названием"
]
}

Status of connecting a partner network's ad space to an affiliate program

  • Before you start using an API for partner networks, ask the manager to add the subnetwork tag to your publisher account in Admitad.
  • To use the method, you need to obtain access_token. Auth Description
  • In the parameter scope, send the right name "advcampaigns_for_website".

Parameters

HTTP method Access rights URL Note
GET advcampaigns_for_website http://api.admitad.loc/subnetworks/v1/advcampaign/${ADVCAMPAIGN_ID}/statuses/
  • ${ADVCAMPAIGN_ID} is the affiliate program ID for getting statuses and links
  • Returns the ad space-program connection status in JSON and a goto link enriched with the tool, if the connection status is active.
  • In the parameter websites_id, send IDs of spaces, separated with a comma.
  • The parameter websites_id may not contain more than 30 ad space IDs.

Example of a request for getting the ad space-program connection status

curl -L -H 'Authorization: Bearer ${ACCESS_TOKEN}' -X GET
https://api.admitad.com/subnetworks/v1/advcampaign/${ID_ADVCAMPAIGN}/statuses/\?
websites_id\=349001,349004

Example of a JSON response

HTTP/1.1 200 OK

[
{
"gotolink": "http://192.168.50.1:5000/g/xxmfo49zqsfbe235de1202e3d93061/?i=15",
"connection_status": "active",
"website_id": 349001,
"advcampaign_id": 15939
},
{
"gotolink": "",
"connection_status": "disabled",
"website_id": 349004,
"advcampaign_id": 15939
}
]