{"id":28023,"date":"2018-09-28T16:01:05","date_gmt":"2018-09-28T14:01:05","guid":{"rendered":"https:\/\/www.exoclick.com\/api-master-class-3-campaign-performance\/"},"modified":"2018-09-28T16:04:41","modified_gmt":"2018-09-28T14:04:41","slug":"api-master-class-3-campaign-performance","status":"publish","type":"post","link":"https:\/\/www.exoclick.com\/de\/api-master-class-3-campaign-performance\/","title":{"rendered":"API Master Class #3 Campaign Performance"},"content":{"rendered":"<p>Welcome to our final API Masterclass! In Part 1 we covered <a href=\"https:\/\/www.exoclick.com\/api-masterclass-1-data-collection\/\">Data Collection<\/a>, in Part 2 we explained <a href=\"https:\/\/www.exoclick.com\/api-master-class-2-zone-optimization\/\">Zone Optimization<\/a>. In this third API Masterclass, we show you how to evaluate the performance of your campaigns then automatically adjust (up or down) your bids for each one. The aim is for you as an advertiser to use our examples to help get you started using the API and then later, when you feel more confident you can start creating your own examples and tasks.<\/p>\n<p><strong>The spreadsheet<\/strong><br \/>\nFor this tutorial, we will be using two of the sheets on this <a href=\"https:\/\/docs.google.com\/spreadsheets\/d\/1OPmcXU9RFZ6RxNH5F_VPgw9_dMwBGJeDYCdv80U-oWI\/edit#gid=1191502958\" target=\"_blank\" rel=\"noopener\">spreadsheet<\/a>: \u2018Campaign Performance\u2019 and \u2018Mock Affiliate Network Data\u2019. The purpose of the spreadsheet is to help you compare campaign data. In addition, some formulas have been supplied in order to estimate new bid values which we will demonstrate in Part 2 of this blog post.\u00a0The relevant information that you will need from the \u2018Mock Affiliate Network Data\u2019 sheet (orange) is some fake data which you can substitute with real data later once you are familiar with how this process works.<\/p>\n<p><img loading=\"lazy\" class=\"alignnone size-full wp-image-27934\" src=\"https:\/\/www.exoclick.com\/wp-content\/uploads\/2018\/09\/external-data.png\" alt=\"\" width=\"372\" height=\"123\" \/><\/p>\n<p>So let\u2019s get started!<\/p>\n<p><strong>Step 1<\/strong><br \/>\nIn order to use ExoClick\u2019s API, you must set a Session Token. To set a token, you must have a valid account with the required username and password. The API Token creation is available from the API tab within the Admin Panel.<\/p>\n<p><img loading=\"lazy\" class=\"alignnone size-full wp-image-24807\" src=\"https:\/\/www.exoclick.com\/wp-content\/uploads\/2018\/07\/token3.jpg\" alt=\"\" width=\"1005\" height=\"335\" \/><\/p>\n<p><strong>Step 2<\/strong><br \/>\nCopy the <a href=\"https:\/\/docs.google.com\/spreadsheets\/d\/1OPmcXU9RFZ6RxNH5F_VPgw9_dMwBGJeDYCdv80U-oWI\/edit#gid=1191502958\" target=\"_blank\" rel=\"noopener\">spreadsheet<\/a> to your Google Drive and then open it. All of the API coding is done using Google script language, so when you open the spreadsheet simply go to the Tools menu and select Script Editor.<\/p>\n<p><strong>Step 3<\/strong><br \/>\nOpen the \u2018Campaign Performance\u2019 sheet and copy and paste your API token in the spreadsheet as shown in the diagram below.<\/p>\n<p><img loading=\"lazy\" class=\"alignnone size-full wp-image-27989\" src=\"https:\/\/www.exoclick.com\/wp-content\/uploads\/2018\/09\/gen-data2.jpg\" alt=\"\" width=\"282\" height=\"500\" \/><\/p>\n<p><strong>Part 1 &#8211; Get Campaign Data<\/strong><\/p>\n<p><strong>Step 4<\/strong><br \/>\nNow set the date parameters by adding them into the date fields (Date from, Date to). This will establish the period from which you wish to request the data.<\/p>\n<p><strong>Step 5<\/strong><br \/>\nNow you can filter your results by cost using \u2018ascending\u2019 or \u2018descending\u2019 modes by clicking on the field Order by [asc-dec]: In our example, we have chosen &#8216;d&#8217; for descending. Then select how many campaigns you wish to pull data for by inserting a number value in the Limit field. In our spreadsheet example we have put the Limit at 2, this will pull data for the 2 campaigns we have spent the most money on, because the deciding parameter here is Cost. But you can select as many as you want, however, we recommend you concentrate on the bigger spend campaigns.<\/p>\n<p><strong>Step 6<\/strong><br \/>\nThen simply click on the Generate Data button on the spreadsheet and the data will be displayed as in our example below:<\/p>\n<p><img loading=\"lazy\" class=\"alignnone size-full wp-image-27961\" src=\"https:\/\/www.exoclick.com\/wp-content\/uploads\/2018\/09\/gen-data.jpg\" alt=\"\" width=\"1119\" height=\"568\" \/><\/p>\n<p><strong>Part 2 &#8211; Update Your Bids<\/strong><br \/>\nThis function allows you to update +\/- the bid depending on the data comparison and calculations done in Part 1.<\/p>\n<p>Here is an example of the 2 campaigns we pulled to show you how the formulas work:<\/p>\n<p><img loading=\"lazy\" class=\"alignnone size-full wp-image-27970\" src=\"https:\/\/www.exoclick.com\/wp-content\/uploads\/2018\/09\/part-2.jpg\" alt=\"\" width=\"1245\" height=\"130\" \/><\/p>\n<p>In our 2 campaigns you will see that all the green coloured header fields are now filled with the data for that campaign: Campaign ID, Campaign name, Ad Type, Price Model, Bid, Clicks, Impressions, Goals and Cost. As we mentioned before, the orange\u00a0header fields have been pulled with the mock data from the Affiliate Network, these are your variables. The magenta coloured header fields contain the calculation: D Cost calculates the difference between the campaign\u2019s cost versus the external affiliate cost and D% Cost is the same but in %. In this example you will see it is negative or positive, in this first campaign it is negative at -9.58%. When this value is negative, it means you have to lower your bid, when it is positive you need to put the bid higher. This sheet automatically calculates the new bid for you which you can see under Estimated Value Change.<\/p>\n<p><strong>Step 7 &#8211;\u00a0How to update the bid with the API<\/strong><\/p>\n<p>To the far right of the spreadsheet you will see the purple header fields, which contain the CID, New Bid and Response Message. The CID is the campaign id that needs to be added manually, the New Bid is a calculation between Current Bid (green) and Estimated Value Change (magenta). Then click the large Update Bid button and the API will automatically adjust your bid price. If the bid has been correctly updated the Response Message will be (\u201cCampaign successfully updated\u201d)<\/p>\n<p><img loading=\"lazy\" class=\"alignnone size-full wp-image-27979\" src=\"https:\/\/www.exoclick.com\/wp-content\/uploads\/2018\/09\/bid.jpg\" alt=\"\" width=\"376\" height=\"399\" \/><\/p>\n<p>Now, why don\u2019t you try with some real data and see how ExoClick\u2019s API can help you adjust your bids to help you drive those conversions for your offers.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>In this third API Masterclass, we show you how to evaluate the performance of your campaigns then automatically adjust (up or down) your bids for each one.<\/p>\n","protected":false},"author":20,"featured_media":28014,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":[],"categories":[155,90,142],"tags":[],"yoast_head":"<!-- This site is optimized with the Yoast SEO Premium plugin v19.4 (Yoast SEO v18.0) - https:\/\/yoast.com\/wordpress\/plugins\/seo\/ -->\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/www.exoclick.com\/de\/api-master-class-3-campaign-performance\/\" \/>\n<meta property=\"og:locale\" content=\"de_DE\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"API Master Class #3 Campaign Performance - ExoClick\" \/>\n<meta property=\"og:description\" content=\"In this third API Masterclass, we show you how to evaluate the performance of your campaigns then automatically adjust (up or down) your bids for each one.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/www.exoclick.com\/de\/api-master-class-3-campaign-performance\/\" \/>\n<meta property=\"og:site_name\" content=\"ExoClick\" \/>\n<meta property=\"article:published_time\" content=\"2018-09-28T14:01:05+00:00\" \/>\n<meta property=\"article:modified_time\" content=\"2018-09-28T14:04:41+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/www.exoclick.com\/wp-content\/uploads\/2018\/09\/API-Master-Class-3.png\" \/>\n\t<meta property=\"og:image:width\" content=\"810\" \/>\n\t<meta property=\"og:image:height\" content=\"430\" \/>\n\t<meta property=\"og:image:type\" content=\"image\/png\" \/>\n<meta name=\"twitter:label1\" content=\"Written by\" \/>\n\t<meta name=\"twitter:data1\" content=\"Juanma Cortes\" \/>\n\t<meta name=\"twitter:label2\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data2\" content=\"4 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https:\/\/www.exoclick.com\/#organization\",\"name\":\"ExoClick\",\"url\":\"https:\/\/www.exoclick.com\/\",\"sameAs\":[],\"logo\":{\"@type\":\"ImageObject\",\"@id\":\"https:\/\/www.exoclick.com\/#logo\",\"inLanguage\":\"de-DE\",\"url\":\"https:\/\/www.exoclick.com\/wp-content\/uploads\/2015\/04\/exoclick_new_baseline.png\",\"contentUrl\":\"https:\/\/www.exoclick.com\/wp-content\/uploads\/2015\/04\/exoclick_new_baseline.png\",\"width\":1500,\"height\":613,\"caption\":\"ExoClick\"},\"image\":{\"@id\":\"https:\/\/www.exoclick.com\/#logo\"}},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/www.exoclick.com\/#website\",\"url\":\"https:\/\/www.exoclick.com\/\",\"name\":\"ExoClick\",\"description\":\"The innovative ad network\",\"publisher\":{\"@id\":\"https:\/\/www.exoclick.com\/#organization\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/www.exoclick.com\/?s={search_term_string}\"},\"query-input\":\"required name=search_term_string\"}],\"inLanguage\":\"de-DE\"},{\"@type\":\"ImageObject\",\"@id\":\"https:\/\/www.exoclick.com\/de\/api-master-class-3-campaign-performance\/#primaryimage\",\"inLanguage\":\"de-DE\",\"url\":\"https:\/\/www.exoclick.com\/wp-content\/uploads\/2018\/09\/API-Master-Class-3.png\",\"contentUrl\":\"https:\/\/www.exoclick.com\/wp-content\/uploads\/2018\/09\/API-Master-Class-3.png\",\"width\":810,\"height\":430},{\"@type\":\"WebPage\",\"@id\":\"https:\/\/www.exoclick.com\/de\/api-master-class-3-campaign-performance\/#webpage\",\"url\":\"https:\/\/www.exoclick.com\/de\/api-master-class-3-campaign-performance\/\",\"name\":\"API Master Class #3 Campaign Performance - ExoClick\",\"isPartOf\":{\"@id\":\"https:\/\/www.exoclick.com\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\/\/www.exoclick.com\/de\/api-master-class-3-campaign-performance\/#primaryimage\"},\"datePublished\":\"2018-09-28T14:01:05+00:00\",\"dateModified\":\"2018-09-28T14:04:41+00:00\",\"breadcrumb\":{\"@id\":\"https:\/\/www.exoclick.com\/de\/api-master-class-3-campaign-performance\/#breadcrumb\"},\"inLanguage\":\"de-DE\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/www.exoclick.com\/de\/api-master-class-3-campaign-performance\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/www.exoclick.com\/de\/api-master-class-3-campaign-performance\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/www.exoclick.com\/de\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"API Master Class #3 Campaign Performance\"}]},{\"@type\":\"Article\",\"@id\":\"https:\/\/www.exoclick.com\/de\/api-master-class-3-campaign-performance\/#article\",\"isPartOf\":{\"@id\":\"https:\/\/www.exoclick.com\/de\/api-master-class-3-campaign-performance\/#webpage\"},\"author\":{\"@id\":\"https:\/\/www.exoclick.com\/#\/schema\/person\/86c17743ee91b9d52e7b648e03a56168\"},\"headline\":\"API Master Class #3 Campaign Performance\",\"datePublished\":\"2018-09-28T14:01:05+00:00\",\"dateModified\":\"2018-09-28T14:04:41+00:00\",\"mainEntityOfPage\":{\"@id\":\"https:\/\/www.exoclick.com\/de\/api-master-class-3-campaign-performance\/#webpage\"},\"wordCount\":764,\"commentCount\":0,\"publisher\":{\"@id\":\"https:\/\/www.exoclick.com\/#organization\"},\"image\":{\"@id\":\"https:\/\/www.exoclick.com\/de\/api-master-class-3-campaign-performance\/#primaryimage\"},\"thumbnailUrl\":\"https:\/\/www.exoclick.com\/wp-content\/uploads\/2018\/09\/API-Master-Class-3.png\",\"articleSection\":[\"Anleitung\",\"API\",\"Plattformfunktionen\"],\"inLanguage\":\"de-DE\",\"potentialAction\":[{\"@type\":\"CommentAction\",\"name\":\"Comment\",\"target\":[\"https:\/\/www.exoclick.com\/de\/api-master-class-3-campaign-performance\/#respond\"]}]},{\"@type\":\"Person\",\"@id\":\"https:\/\/www.exoclick.com\/#\/schema\/person\/86c17743ee91b9d52e7b648e03a56168\",\"name\":\"Juanma Cortes\",\"image\":{\"@type\":\"ImageObject\",\"@id\":\"https:\/\/www.exoclick.com\/#personlogo\",\"inLanguage\":\"de-DE\",\"url\":\"https:\/\/www.exoclick.com\/wp-content\/uploads\/cache\/2017\/10\/juanma-small\/392160680.jpg\",\"contentUrl\":\"https:\/\/www.exoclick.com\/wp-content\/uploads\/cache\/2017\/10\/juanma-small\/392160680.jpg\",\"caption\":\"Juanma Cortes\"},\"description\":\"Head of Technical Support\",\"url\":\"https:\/\/www.exoclick.com\/de\/author\/juanma-cortes\/\"}]}<\/script>\n<!-- \/ Yoast SEO Premium plugin. -->","yoast_head_json":{"robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/www.exoclick.com\/de\/api-master-class-3-campaign-performance\/","og_locale":"de_DE","og_type":"article","og_title":"API Master Class #3 Campaign Performance - ExoClick","og_description":"In this third API Masterclass, we show you how to evaluate the performance of your campaigns then automatically adjust (up or down) your bids for each one.","og_url":"https:\/\/www.exoclick.com\/de\/api-master-class-3-campaign-performance\/","og_site_name":"ExoClick","article_published_time":"2018-09-28T14:01:05+00:00","article_modified_time":"2018-09-28T14:04:41+00:00","og_image":[{"width":810,"height":430,"url":"https:\/\/www.exoclick.com\/wp-content\/uploads\/2018\/09\/API-Master-Class-3.png","type":"image\/png"}],"twitter_misc":{"Written by":"Juanma Cortes","Est. reading time":"4 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"Organization","@id":"https:\/\/www.exoclick.com\/#organization","name":"ExoClick","url":"https:\/\/www.exoclick.com\/","sameAs":[],"logo":{"@type":"ImageObject","@id":"https:\/\/www.exoclick.com\/#logo","inLanguage":"de-DE","url":"https:\/\/www.exoclick.com\/wp-content\/uploads\/2015\/04\/exoclick_new_baseline.png","contentUrl":"https:\/\/www.exoclick.com\/wp-content\/uploads\/2015\/04\/exoclick_new_baseline.png","width":1500,"height":613,"caption":"ExoClick"},"image":{"@id":"https:\/\/www.exoclick.com\/#logo"}},{"@type":"WebSite","@id":"https:\/\/www.exoclick.com\/#website","url":"https:\/\/www.exoclick.com\/","name":"ExoClick","description":"The innovative ad network","publisher":{"@id":"https:\/\/www.exoclick.com\/#organization"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/www.exoclick.com\/?s={search_term_string}"},"query-input":"required name=search_term_string"}],"inLanguage":"de-DE"},{"@type":"ImageObject","@id":"https:\/\/www.exoclick.com\/de\/api-master-class-3-campaign-performance\/#primaryimage","inLanguage":"de-DE","url":"https:\/\/www.exoclick.com\/wp-content\/uploads\/2018\/09\/API-Master-Class-3.png","contentUrl":"https:\/\/www.exoclick.com\/wp-content\/uploads\/2018\/09\/API-Master-Class-3.png","width":810,"height":430},{"@type":"WebPage","@id":"https:\/\/www.exoclick.com\/de\/api-master-class-3-campaign-performance\/#webpage","url":"https:\/\/www.exoclick.com\/de\/api-master-class-3-campaign-performance\/","name":"API Master Class #3 Campaign Performance - ExoClick","isPartOf":{"@id":"https:\/\/www.exoclick.com\/#website"},"primaryImageOfPage":{"@id":"https:\/\/www.exoclick.com\/de\/api-master-class-3-campaign-performance\/#primaryimage"},"datePublished":"2018-09-28T14:01:05+00:00","dateModified":"2018-09-28T14:04:41+00:00","breadcrumb":{"@id":"https:\/\/www.exoclick.com\/de\/api-master-class-3-campaign-performance\/#breadcrumb"},"inLanguage":"de-DE","potentialAction":[{"@type":"ReadAction","target":["https:\/\/www.exoclick.com\/de\/api-master-class-3-campaign-performance\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/www.exoclick.com\/de\/api-master-class-3-campaign-performance\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/www.exoclick.com\/de\/"},{"@type":"ListItem","position":2,"name":"API Master Class #3 Campaign Performance"}]},{"@type":"Article","@id":"https:\/\/www.exoclick.com\/de\/api-master-class-3-campaign-performance\/#article","isPartOf":{"@id":"https:\/\/www.exoclick.com\/de\/api-master-class-3-campaign-performance\/#webpage"},"author":{"@id":"https:\/\/www.exoclick.com\/#\/schema\/person\/86c17743ee91b9d52e7b648e03a56168"},"headline":"API Master Class #3 Campaign Performance","datePublished":"2018-09-28T14:01:05+00:00","dateModified":"2018-09-28T14:04:41+00:00","mainEntityOfPage":{"@id":"https:\/\/www.exoclick.com\/de\/api-master-class-3-campaign-performance\/#webpage"},"wordCount":764,"commentCount":0,"publisher":{"@id":"https:\/\/www.exoclick.com\/#organization"},"image":{"@id":"https:\/\/www.exoclick.com\/de\/api-master-class-3-campaign-performance\/#primaryimage"},"thumbnailUrl":"https:\/\/www.exoclick.com\/wp-content\/uploads\/2018\/09\/API-Master-Class-3.png","articleSection":["Anleitung","API","Plattformfunktionen"],"inLanguage":"de-DE","potentialAction":[{"@type":"CommentAction","name":"Comment","target":["https:\/\/www.exoclick.com\/de\/api-master-class-3-campaign-performance\/#respond"]}]},{"@type":"Person","@id":"https:\/\/www.exoclick.com\/#\/schema\/person\/86c17743ee91b9d52e7b648e03a56168","name":"Juanma Cortes","image":{"@type":"ImageObject","@id":"https:\/\/www.exoclick.com\/#personlogo","inLanguage":"de-DE","url":"https:\/\/www.exoclick.com\/wp-content\/uploads\/cache\/2017\/10\/juanma-small\/392160680.jpg","contentUrl":"https:\/\/www.exoclick.com\/wp-content\/uploads\/cache\/2017\/10\/juanma-small\/392160680.jpg","caption":"Juanma Cortes"},"description":"Head of Technical Support","url":"https:\/\/www.exoclick.com\/de\/author\/juanma-cortes\/"}]}},"_links":{"self":[{"href":"https:\/\/www.exoclick.com\/de\/wp-json\/wp\/v2\/posts\/28023"}],"collection":[{"href":"https:\/\/www.exoclick.com\/de\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.exoclick.com\/de\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.exoclick.com\/de\/wp-json\/wp\/v2\/users\/20"}],"replies":[{"embeddable":true,"href":"https:\/\/www.exoclick.com\/de\/wp-json\/wp\/v2\/comments?post=28023"}],"version-history":[{"count":1,"href":"https:\/\/www.exoclick.com\/de\/wp-json\/wp\/v2\/posts\/28023\/revisions"}],"predecessor-version":[{"id":28032,"href":"https:\/\/www.exoclick.com\/de\/wp-json\/wp\/v2\/posts\/28023\/revisions\/28032"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.exoclick.com\/de\/wp-json\/wp\/v2\/media\/28014"}],"wp:attachment":[{"href":"https:\/\/www.exoclick.com\/de\/wp-json\/wp\/v2\/media?parent=28023"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.exoclick.com\/de\/wp-json\/wp\/v2\/categories?post=28023"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.exoclick.com\/de\/wp-json\/wp\/v2\/tags?post=28023"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}