Adgora
डेवलपर्स

एपीआई संदर्भ

आरईएसटी एपीआई v1: प्रमाणीकरण, आँकड़े, अभियान, बैलेंस और क्षेत्र, साथ ही S2S रूपांतरण पोस्टबैक और मैक्रोज़।

1 मिनट पढ़ें 283 शब्द
सहायता लेखएपीआई संदर्भ

Adgora REST API से आप प्रोग्राम द्वारा आँकड़े पढ़ सकते हैं, अभियान सूचीबद्ध और रोक सकते हैं, शेष राशि जाँच सकते हैं तथा ज़ोन सूचीबद्ध कर सकते हैं। मूल URL: https://api.adgora.net. सभी जवाब JSON प्रारूप में होते हैं।

प्रमाणीकरण

कुंजी की जोड़ी यहाँ बनाएँ: अपनी प्रोफ़ाइल (गुप्त कुंजी केवल एक बार दिखाई जाती है)। इसे प्रत्येक /v1 अनुरोध के साथ भेजें:

http
Authorization: Bearer {public_key}:{secret}

अनुरोधों की सीमा है प्रति खाते प्रति मिनट 120; सीमा पार करने पर जवाब में 429 और Retry-After हेडर मिलता है। कुंजियों के अनुमति दायरे हैं (stats, campaigns, balance, zones); आवश्यक दायरा न होने पर जवाब मिलता है 403.

एंडपॉइंट

विधि & पथअनुमति दायराजवाब
GET /v1/balancebalanceविज्ञापनदाता & प्रकाशक की USD शेष राशि
GET /v1/stats?days=7statsदैनिक रिकॉर्ड (यह जोड़ें: role=publisher ताकि प्रकाशक का दृश्य दिखे)
GET /v1/campaignscampaignsआपके अभियान
POST /v1/campaigns/{id}/pausecampaignsअभियान रोकता है
POST /v1/campaigns/{id}/resumecampaignsअभियान फिर शुरू करता है
GET /v1/zoneszonesआपके प्रकाशक ज़ोन

उदाहरण

curl
curl -H "Authorization: Bearer PUBLICKEY:SECRET" \
  "https://api.adgora.net/v1/stats?days=30"

S2S रूपांतरण पोस्टबैक

CPA रूपांतरणों को ट्रैक करने के लिए रूपांतरण होने पर विज्ञापनदाता के सर्वर से पोस्टबैक URL कॉल करें। निम्न {clickid} मैक्रो क्लिक URL के माध्यम से आपके लैंडिंग पेज पर भेजा जाता है — इसे सहेजें और वापस भेजें:

url
https://api.adgora.net/s2s?clickid={clickid}&status=confirmed&secret=YOUR_OFFER_SECRET&order_ref=ORDER123

status के मान हो सकते हैं confirmed, delivered, rejected या returned; order_ref आपका वैकल्पिक ऑर्डर पहचानकर्ता है। ऑफ़र की गुप्त कुंजी ऑफ़र पेज पर मिलेगी।

लैंडिंग URL मैक्रो

इन मैक्रो को विज्ञापन क्रिएटिव के लैंडिंग URL में जोड़ें — Adgora क्लिक के समय इन्हें बदल देता है:

{ }
{clickid} {zoneid} {campaignid} {creativeid} {geo} {country} {device} {sub1}…{sub5}
अनुरोध निर्माता

एक अनुरोध बनाएं

एक एंडपॉइंट और पैरामीटर चुनें - जैसे-जैसे आप आगे बढ़ते हैं, कमांड अपडेट होता है। कुंजी प्लेसहोल्डर बनी रहती हैं: कभी भी किसी गुप्त को वेब पृष्ठ में न डालें।

भूमिका
GEThttps://api.adgora.net/v1/balance
curl
curl -H "Authorization: Bearer PUBLICKEY:SECRET" "https://api.adgora.net/v1/balance"

PUBLICKEY:SECRET एक प्लेसहोल्डर है। अपने प्रोफ़ाइल में एक कुंजी बनाएं और अपने सर्वर पर रहस्य रखें।

समर्थन

अभी भी फंसे हैं? एक व्यक्ति उत्तर देगा

सहायता डेस्क अभियानों, साइटों, जमा और भुगतान का प्रबंधन करती है। अपने खाते के ईमेल से लिखें; भुगतान के लिए, लेनदेन हैश जोड़ें - यह प्रश्नों के एक दौर को बचाता है।

  1. अपने खाते के ईमेल से लिखें
  2. अभियान, साइट या क्षेत्र ID का नाम दें
  3. भुगतान के लिए, लेनदेन हैश जोड़ें

मुफ्त उपकरण

कैल्कुलेटर और चेकर्स जो आपके ब्राउज़र में चलते हैं - कोई खाता नहीं।

और जानें

शब्दकोश

CPM, eCPM, भरने की दर और बाकी की साधारण परिभाषाएँ।

और जानें

शुरू करने के लिए तैयार हैं?

एक मुफ्त खाता बनाएं और इसे व्यवहार में लाएं - विज्ञापनदाता, प्रकाशक, या दोनों।