मेथड: PUT /api/v1/advertiser/campaign/{id}
विवरण: आप अपने HilltopAds खाते के लिए API के माध्यम से एक बनाया गया विज्ञापन अभियान अपडेट कर सकते हैं।
कृपया ध्यान दें, यह विधि केवल पॉपअंडर मोबाइल और पॉपअंडर डेस्कटॉप प्रारूपों के लिए उपलब्ध है।
पैरामीटर:
नाम | विवरण | उदाहरण | टिप्पणी |
key | आपके HilltopAds खाते के API खंड में एक विशेष API कुंजी जो आप उत्पन्न कर सकते हैं | nXzgO3Bc | यह अनुरोध में एक आवश्यक पैरामीटर है। |
campaignID | विज्ञापन अभियान की ID जिसे अपडेट किया जाना है
| 123456 | आप केवल एक विज्ञापन अभियान की ID निर्दिष्ट कर सकते हैं। यह अनुरोध में एक आवश्यक पैरामीटर है। |
format | अभियान में अपडेट किए जाने वाले विज्ञापन प्रारूप | पॉपअंडर मोबाइल | आप केवल एक विज्ञापन प्रारूप निर्दिष्ट कर सकते हैं। यह अनुरोध में एक आवश्यक पैरामीटर है। |
rate | 1000 प्रतिबिंब पर मूल्य (सीपीएम)। | 1.53 | सभी मूल्य (दर) अनुरोध में मूल्यित किए जाते हैं बिना मुद्रा के, लेकिन परिणाम में यूएसडी में निर्धारित होंगे। यह अनुरोध में एक आवश्यक पैरामीटर है। |
capTotal | प्रतिबिंब विवेकता अधिकतम। यह पैरामीटर एक विज्ञापन को दिखाया जाने की बार-बार संख्या दर्शाता है। | 2 | आप केवल एक संख्या निर्दिष्ट कर सकते हैं। |
capResetAfter | प्रतिबिंब विवेकता अधिकतम। यह पैरामीटर विज्ञापन को कितनी देर तक दिखाया जाएगा, दर्शाता है। | 12 | आप केवल एक संख्या निर्दिष्ट कर सकते हैं। |
capForCampaign | प्रतिबिंब विवेकता अधिकतम। यह पैरामीटर नियम विज्ञापन या बैनर के लिए लागू होता है। | अभियान | पॉपअंडर प्रारूप के लिए, आप केवल "अभियान" निर्दिष्ट कर सकते हैं। |
channels | विज्ञापन को अपडेट करने के लिए खंड और यातायात श्रेणी। | मुख्य धारावाहिक / गैर-मुख्य उच्च गति मुख्य धारावाहिक / गैर-मुख्य मध्यम गति मुख्य धारावाहिक / गैर-मुख्य कम गति | एक्टिविटी के कई वर्गों को निर्दिष्ट करने के लिए, उन्हें अल्पविरामों के साथ सूचीबद्ध करें। ध्यान दें, आप केवल एक यातायात श्रेणी - प्रमुख या गैर-प्रमुख - को ही निर्दिष्ट कर सकते हैं। यह अनुरोध में एक आवश्यक पैरामीटर है। |
type | एक विज्ञापन अभियान के प्रकार | CPM, CPC | कृपया ध्यान दें, वर्तमान में आप केवल सीपीएम अभियान प्रकार को ही निर्दिष्ट कर सकते हैं। यह अनुरोध में एक आवश्यक पैरामीटर है। |
name | विज्ञापन अभियान का नाम। | Popunder_API | अभियान का नाम अद्वितीय होना चाहिए और पहले से ही बनाए गए अभियानों के नामों के साथ दोहराया नहीं जाना चाहिए। यह अनुरोध में एक आवश्यक पैरामीटर है। |
url | ऑफर यूआरएल लिंक जहां यातायात भेजा जाना है। | आप केवल एक लिंक निर्दिष्ट कर सकते हैं। यह अनुरोध में एक आवश्यक पैरामीटर है। | |
active | अपडेट किए गए अभियान की स्थिति निर्दिष्ट करें: सच - ऑन, झूठ - ऑफ | सच, झूठ | अभियान की स्थिति को सच (चालू) के रूप में निर्दिष्ट करते समय, अभियान को केवल मॉडरेशन के बाद सक्रिय होगा। |
targeting | विज्ञापन अभियान के लिए आवश्यक निर्दिष्ट निश्चित करना। | भूगोल; ब्राउज़र; ओएस; उपकरण; मोबाइल कैरियर; आईपी सीमा; ओएस संस्करण; अनुप्रयोग | ये पैरामीटर एक ऑब्जेक्ट के रूप में पारित किए जाते हैं। प्रत्येक नए टारगेटिंग पैरामीटर को एक अल्पविराम के साथ निर्दिष्ट किया जाता है। |
अनुरोध उदाहरण:
निर्मित विज्ञापन अभियान में निम्नलिखित पैरामीटरों को अपडेट करने के लिए अनुरोध 123456 के साथ:
दर - $2.53 में बदलें
फ़्रीक्वेंसी कैपिंग - प्रतिदिन 24 घंटे के लिए 1 प्रदर्शन को कैपिंग में बदलें
URL - को https://mywebsit2.comमें बदलें।
कृपया ध्यान दें कि यदि आपका लिंक '&' प्रतीक शामिल है, तो आपको इसे URL संग्रहित स्वरूप में कोडित करने की आवश्यकता है। अन्यथा, आपको लिंक परिवर्तन अनुरोध के प्रतिसाद में त्रुटि मिल सकती है।
उदाहरण के लिए, लिंक
https://mywebsite.com/?token={{ctoken}}&zone={{zone_id}}को निम्नलिखित रूप में निर्दिष्ट किया जाना चाहिए
https%3A%2F%2Fmywebsite.com%2F%3Ftoken%3D%26zone%3D
अपने लिंक को URL संग्रहित स्वरूप में कोडित करने के लिए, आप "उपकरण" का उपयोग कर सकते हैं। आपको निम्नलिखित प्रारूप में एक अनुरोध लिखना होगा:
curl -X PUT --data '{"rate":"2.53","capTotal":1,"capResetAfter":24,"capForCampaign":"campaign","url":"https%3A%2F%2Fmywebsite.com%2F%3Ftoken%3D%26zone%3D"}' https://hilltopads.com/api/v1/advertiser/campaign/123456?key=nXzgO3Bc