Page cover image

Partner Slot ID API Report

Adgebra Partner Slot ID Report Api Integration Guidelines

Adgebra Partner Slot Id Report Api Integration Guidelines

The Adgebra Partner SLOT ID Report API integration guidelines will be able to fetch numbers from Adgebra Partner SLOT ID reports in real time by sending the required parameters in an API call. In response, adgebra will send data as per the below-mentioned format

SLOT ID API Format :

  1. Request Format:

https://adgebra.co.in/pssreport/GetPSSReportWS?p1=[PartnerID]&p2=[Date]&p3=[SiteName]&p4=[Uniwque-Pin]&p7=[Geo]&p8=[Currency]&p10=1

Request Parameters :

p1: This parameter is the Partner ID of which the reports need to be fetched ex:p1=Partner Id of which the reports need to be fetched ex:'432'.

p2: This Parameter is the date of the report that needs to be fetched. The Date format for this field is "DD-MMM-YYYY". Ex: 01-Nov-2023

p3: This parameter represents the site name. The default is 'all'. If you need data on any particular site, you can enter the site name in the p3 parameter. Please note site names need to be entered the same as whitelisted in adgebra.

p4: This Parameter is the unique PIN associated with the partner. Here, you need to contact your partner manager to get the unique PIN. Ex: z8Sgxc82Mnxrb9me

p7: This Parameter is the Geo field. The default is 'All'. Hence, your report will be shown for all geos. Removing this parameter will run the reports by site instead of geo.

p8: This parameter is the currency format that you wish to fetch in the report. The default is 'USD'. You cannot change it to any other currency as of now.

p9: This parameter Fetches widget-wise reporting data.(default value as: 1) to fetch reports per widget.

p10: This parameter fetches SLOT ID-wise reporting data. (default value as: 1) to fetch reports per the slot ID passed by the partner.

Request Example:

https://adgebra.co.in/pssreport/GetPSSReportWS?p1=490&p2=02-Nov-2023&p3=all&p4=z8Sgxc82Mnxrb9r3&p7=all&p8=usd&p9=1
  1. Response Format:

Sample Request: https://adgebra.co.in/pssreport/GetPSSReportWS?p1=490&p2=02-Nov-2023&p3=all&p4=z8Sgxc82Mnxrb9r3&p8=usd&p10=1

  "Site_Device": [
    {
      "Slot ID": "[Slot Value]", // Passed by the publisher
      "CTR": "[Count]", CLick Through Rate
      "Revenue": "[Count]",  Only slot pecific revenue
      "Impression": "[Count]",  // Only Slot specific impressions
      "Clicks": "[Count]",  // Only unique clicks count.
      "eCPM:"[Count]", Only Slot Specific ecpm
    }
  ]
}

Response Example:

{
  "prfd-sarkaryojana.in_Mobile": [
    {
      "Slot": "Gamezoof1",
      "CTR": "0.45",
      "Revenue": "5.75",
      "Impression": "500",
      "Clicks": "225",
       "eCPM: "0.12",
    },
    {
     "Slot": "Gamezoof2",
      "CTR": "0.00",
      "Rev": "0.00",
      "Impression": "30",
      "Clicks": "0"
      "eCPM: "0.12",
    },
  ],
"pwco-outlookbusiness.com_Laptop": [
    {
      "Slot": "Gamezoof3",
      "CTR": "0.00",
      "Rev": "0.00",
      "Impression": "30",
      "Clicks": "0"
      "eCPM: "0.12",
    },
]
}

3. Response Format: If any partner wants to fetch the report by slot id and geo

Sample Request https://adgebra.co.in/pssreport/GetPSSReportWS?p1=490&p2=02-Nov-2023&p3=all&p4=z8Sgxc82Mnxrb9r3&p7=all&p8=usd&p10=1

 "Site_Device": [
    {
      "Geo": "[Country]" // If p7=all, return geo-wise breakdown, else this field will not be shown.
      "Slot ID": "[Slot Value]", // Passed by the publisher
      "CTR": "[Count]", CLick Through Rate
      "Revenue": "[Count]",  Only slot pecific revenue
      "Impression": "[Count]",  // Only Slot specific impressions
      "Clicks": "[Count]",  // Only unique clicks count.
      "eCPM:"[Count]", Only Slot Specific ecpm
    }
  ]
}

Response Example:

{
  "prfd-sarkaryojana.in_Mobile": [
    {
      "Geo": "India"
      "Slot": "Gamezoof1",
      "CTR": "0.45",
      "Revenue": "5.75",
      "Impression": "500",
      "Clicks": "225",
       "eCPM: "0.12",
    },
    {
      "Geo": "Indonesia",
      "Slot": "Gamezoof2",
      "CTR": "0.00",
      "Rev": "0.00",
      "Impression": "30",
      "Clicks": "0"
      "eCPM: "0.12",
    },
  ],
"pwco-outlookbusiness.com_Laptop": [
    {
      "Geo": "Bahrain",
      "Slot": "Gamezoof3",
      "CTR": "0.00",
      "Rev": "0.00",
      "Impression": "30",
      "Clicks": "0"
      "eCPM: "0.12",
    },
]
}

Example Response without p7 and p9 value, if you remove the p7 value from api, below is a sample response that will be shown without geos. Sample Request: https://adgebra.co.in/pssreport/GetPSSReportWS?p1=490&p2=02-Nov-2023&p3=all&p4=z8Sgxc82Mnxrb9r3&p8=usd&p10=1

{
  "prfd-sarkaryojana.in_Mobile": [
    {
      "Slot": "Gamezoof4",
      "CTR": "0.45",
      "Revenue": "5.75",
      "Impression": "500",
      "Clicks": "225",
    },
    {
      "Slot": "Gamezoof5",
      "CTR": "0.00",
      "Rev": "0.00",
      "Impression": "30",
      "Clicks": "0"
      "eCPM: "0.12",
    },
  ],
"pwco-outlookbusiness.com_Laptop": [
    {
      "Slot": "Gamezoof6",
      "CTR": "0.00",
      "Rev": "0.00",
      "Impression": "30",
      "Clicks": "0"
      "eCPM: "0.12",
    },
    {
      "Slot": "Gamezoof7",
      "CTR": "0.00",
      "Rev": "0.00",
      "Impression": "30",
      "Clicks": "0"
      "eCPM: "0.12",
    },
]
}

Example Response with p9=1 and p10=1 value, data will be shown by the widget and slot

Sample Request: https://adgebra.co.in/pssreport/GetPSSReportWS?p1=198&p2=25-Jun-2025&p3=esakal.com&p4=uRcgiSYu2k&p8=usd&p9=1&p10=1

{
  "prfd-sarkaryojana.in_Mobile": [
    {
      "Template": "8246_Home_Sec_Page_Sakal_GRP_Marathi",
      "Slot": "Gamezoof4",
      "CTR": "0.45",
      "Revenue": "5.75",
      "Impression": "500",
      "Clicks": "225",
    },
    {
      "Template": "46_Marathi",
      "Slot": "Gamezoof5",
      "CTR": "0.00",
      "Rev": "0.00",
      "Impression": "30",
      "Clicks": "0"
      "eCPM: "0.12",
    },
  ],
"pwco-outlookbusiness.com_Laptop": [
    {      "Template": "82_Marathi",
      "Slot": "Gamezoof6",
      "CTR": "0.00",
      "Rev": "0.00",
      "Impression": "30",
      "Clicks": "0"
      "eCPM: "0.12",
    },
    {
      "Template": "82GRP_Marathi",      "Slot": "Gamezoof7",
      "CTR": "0.00",
      "Rev": "0.00",
      "Impression": "30",
      "Clicks": "0"
      "eCPM: "0.12",
    },
]
}

Note:

  1. If any partner is passing a slot ID dynamically, please ensure that it does not contain any special characters other than hyphen (-), underscore (_), period (.), or tilde (~). The slot ID data log only accepts letters, digits, and the aforementioned characters.

  2. If any reponse is blank, please check the values entered in the parameters. The response will also be blank in case there is no data.

Last updated

Was this helpful?