विधि: 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 | बनाए गए अभियान की स्थिति को निर्दिष्ट करें: सही - ऑन, गलत - ऑफ। | सही, गलत | अभियान की स्थिति को सही (ऑन) के रूप में निर्दिष्ट करते समय, अभियान केवल मॉडरेशन के बाद सक्रिय होगा। |
targeting | विज्ञापन अभियान के लिए आवश्यक टारगेटिंग सेटिंग्स।
| जियो ब्राउज़र ओएस उपकरण मोबाइल कैरियर आईपी रेंज ओएस संस्करण एप | ये पैरामीटर एक ऑब्जेक्ट के रूप में पारित किए जाते हैं। प्रत्येक नए टारगेटिंग पैरामीटर को अल्पविराम के साथ निर्दिष्ट किया जाता है। |
अनुरोध उदाहरण:
निम्नलिखित पैरामीटरों के साथ एक विज्ञापन अभियान बनाने के लिए:
विज्ञापन प्रारूप - पॉपअंडर मोबाइल
दर - $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://hilltopads.com/api/v1/advertiser/campaign?key=nXzgO3Bc