API का उपयोग करके विज्ञापन अभियान कैसे बनाएं?
विधि: POST /api/v1/advertiser/campaign
विवरण: आप अपने HilltopAds विज्ञापन खाते के लिए API के माध्यम से विज्ञापन अभियान बना सकते हैं।
कृपया ध्यान दें कि यह विधि केवल फॉर्मेट "पॉपअंडर मोबाइल और पॉपअंडर डेस्कटॉप" के लिए ही उपलब्ध है।
पैरामीटर:
नाम | विवरण | उदाहरण | टिप्पणी |
key | एक अद्वितीय एपीआई कुंजी जो आप अपने HilltopAds खाते के एपीआई खंड में उत्पन्न कर सकते हैं | nXzgO3Bc | यह एक अनिवार्य पैरामीटर है जो अनुरोध में निर्दिष्ट किया जाता है। |
format | विज्ञापन प्रारूप जिसके लिए अभियान बनाया जाना चाहिए। | Popunder mobile | आप केवल एक विज्ञापन प्रारूप निर्दिष्ट कर सकते हैं। यह एक अनिवार्य पैरामीटर है जो अनुरोध में निर्दिष्ट किया जाता है। |
rate | 1000 प्रदर्शनों के लिए मूल्य (सीपीएम)। | 1.53 | सभी मूल्य (दर) अनुरोध में मुद्रा के बिना निर्दिष्ट किए जाते हैं, लेकिन परिणाम में यूएसडी में सेट किए जाते हैं। यह एक अनिवार्य पैरामीटर है जो अनुरोध में निर्दिष्ट किया जाता है। |
capTotal | प्रभाव परिवर्तन कैप। यह पैरामीटर एक विज्ञापन को दिखाया गया है कितनी बार दिखाई गई है। | 2 | आप केवल एक संख्या निर्दिष्ट कर सकते हैं। |
capResetAfter | प्रभाव परिवर्तन कैप। यह पैरामीटर यह दिखाता है कि विज्ञापन को कितने समय तक दिखाया जाना है। | 12 | आप केवल एक संख्या निर्दिष्ट कर सकते हैं। |
capForCampaign | प्रभाव परिवर्तन कैप। यह पैरामीटर यह दिखाता है कि नियम क्या अभियान या बैनर पर लागू होता है। | अभियान | पॉपअंडर प्रारूप के लिए, आप केवल अभियान को निर्दिष्ट कर सकते हैं। |
channels | उपसगम और यातायात वर्ग जिसके लिए विज्ञापन लॉन्च किया जाना चाहिए।
| मुख्य / गैर-मुख्य उच्च गतिविधि मुख्य / गैर-मुख्य मध्य गतिविधि मुख्य / गैर-मुख्य कम गतिविधि | एक्टिविटी सेगमेंट को निर्दिष्ट करने के लिए, उन्हें अल्पविरामों के साथ सूचीबद्ध करें। ध्यान दें, आप केवल एक यातायात श्रेणी - मुख्यधारा या गैर-मुख्यधारा - को निर्दिष्ट कर सकते हैं। यह एक अनिवार्य पैरामीटर है जो अनुरोध में निर्दिष्ट किया जाता है। |
type | विज्ञापन अभियान के प्रकार | CPM, CPC | कृपया ध्यान दें, वर्तमान में आप केवल सीपीएम अभियान प्रकार को ही निर्दिष्ट कर सकते हैं। यह एक अनिवार्य पैरामीटर है जो अनुरोध में निर्दिष्ट किया जाता है। |
name | एक विज्ञापन अभियान का नाम। | Popunder_API | अभियान का नाम अद्वितीय होना चाहिए और पहले से ही बनाए गए अभियानों के नामों के साथ दोहराया नहीं जाना चाहिए। यह एक अनिवार्य पैरामीटर है जो अनुरोध में निर्दिष्ट किया जाता है। |
url | यात्रा करने के लिए प्रस्ताव यूआरएल लिंक जहां यातायात भेजा जाना है। | आप केवल एक लिंक निर्दिष्ट कर सकते हैं। यह एक अनिवार्य पैरामीटर है जो अनुरोध में निर्दिष्ट किया जाता है। | |
active | बनाए गए अभियान की स्थिति को निर्दिष्ट करें: सही - ऑन, गलत - ऑफ। | सही, गलत | अभियान की स्थिति को सही (ऑन) के रूप में निर्दिष्ट करते समय, अभियान केवल मॉडरेशन के बाद सक्रिय होगा। |
limitImpressionsTotal | निर्दिष्ट कुल इंप्रेशन सीमा | 200000 | आप निर्दिष्ट कर सकते हैं केवल एक ही नंबर. |
limitImpressionsDaily | निर्दिष्ट दैनिक छापों सीमा | 20000 | आप निर्दिष्ट कर सकते हैं केवल एक ही नंबर. न्यूनतम. दैनिक छापों की सीमा 15,000. |
limitBudgetTotal | निर्दिष्ट कुल बजट की सीमा | 2000 | आप निर्दिष्ट कर सकते हैं केवल एक ही नंबर. |
limitBudgetDaily | निर्दिष्ट दैनिक बजट की सीमा | 50 | आप निर्दिष्ट कर सकते हैं केवल एक ही नंबर. न्यूनतम. दैनिक बजट की सीमा है $20. |
filters | आप कर सकते हैं की अनुमति दें/अस्वीकार प्रॉक्सी और WebView यातायात फिल्टर । | प्रॉक्सी WebView | इन पैरामीटर पारित हो जाता है के रूप में एक वस्तु. |
targeting | आवश्यक लक्ष्यीकरण सेटिंग के लिए विज्ञापन अभियान.
| भू ब्राउज़र ओएस डिवाइस mobilecarrier iprange osversions एप्लिकेशन | इन मानकों को पारित कर रहे हैं के रूप में एक वस्तु. प्रत्येक नया लक्ष्यीकरण पैरामीटर निर्दिष्ट किया जाता है, एक अल्पविराम के साथ. |
uniformDistributionDaily | कैसे चुनें अभियान सीमा पर पहुँच जाना चाहिए. | ASAP Evenly | Asap पहुंच निर्दिष्ट अभियान की सीमा के रूप में जल्दी संभव के रूप में |
लक्ष्यीकरण वस्तु
नाम | उदाहरण | विवरण |
भू | हमें जीबी AU | दर्ज दो-अक्षर के कोड की आवश्यकता देश/देशों में, अल्पविराम के द्वारा अलग. |
ब्राउज़र | क्रोम फ़ायरफ़ॉक्स सफारी |
|
ओएस | Android iOS |
|
डिवाइस | मोबाइल/स्मार्टफोन गोली |
|
mobilecarrier | औ~वोडाफोन |
|
iprange | 127.0.0.1 |
|
osversions | आईओएस 15 Win 7 |
सभी उपलब्ध संस्करणों |
एप्लिकेशन |
|
लक्ष्यीकरण वस्तु
नाम | उदाहरण |
प्रॉक्सी | की अनुमति नामंज़ूर केवल |
WebView | की अनुमति नामंज़ूर केवल |
अनुरोध उदाहरण:
निम्नलिखित पैरामीटरों के साथ एक विज्ञापन अभियान बनाने के लिए:
विज्ञापन प्रारूप - पॉपअंडर मोबाइल
दर - $1.53
फ्रिक्वेंसी कैपिंग - प्रति 12 घंटे के लिए 2 प्रदर्शन कैंपेन के लिए
चैनल - मुख्यधारा उच्च गतिविधि और माध्यम गतिविधि
प्रकार - सीपीएम (पॉपअंडर विज्ञापन प्रारूप के लिए आप केवल सीपीएम को निर्दिष्ट कर सकते हैं)
नाम - पॉपअंडर_एपीआई
यूआरएल - https://mywebsite.com।
सक्रिय - सत्य
लक्ष्ययोजन - भूगोल: यूएस, यूके, डीई; ब्राउज़र: क्रोम, सफारी; उपकरण - मोबाइल
कृपया ध्यान दें कि अगर आपका लिंक '&' चिह्न को शामिल करता है, तो आपको इसे यूआरएल-एन्कोडेड प्रारूप में कोड करने की आवश्यकता है। अन्यथा, आपको लिंक परिवर्तन अनुरोध के प्रतिसाद में त्रुटि मिल सकती है।
उदाहरण के लिए, लिंक
https://mywebsite.com/?token={{ctoken}}&zone={{zone_id}}
को निम्नलिखित रूप में निर्दिष्ट किया जाना चाहिए
https%3A%2F%2Fmywebsite.com%2F%3Ftoken%3D%26zone%3D
अपने लिंक को यूआरएल-एन्कोडेड प्रारूप में कोड करने के लिए, आप "टूल" का उपयोग कर सकते हैं।
आपको निम्नलिखित प्रारूप में अनुरोध लिखना होगा:
curl -X POST --data '{"format":"Popunder mobile","channels":["Mainstream High Activity", "Mainstream Medium Activity"],"type":"CPM","rate":1.53,"name":"Popunder_API","url":"https%3A%2F%2Fmywebsite.com%2F%3Ftoken%3D%26zone%3D","active":true,"capTotal":2,"capResetAfter":12,"capForCampaign":"campaign","targeting":{"geo":{"operator":"in","operand":["US","UK","DE"]},"browser":{"operator":"in","operand":["Chrome","Safary"]},"device":{"operator":"in","operand":["Mobile/smartphone"]}}}' https://api.hilltopads.com/v1/advertiser/campaign?key=nXzgO3Bc
HilltopAds विज्ञापन नेटवर्क API की पूरी क्षमता का लाभ उठाएं!