<?xml version="1.0" encoding="UTF-8"?><rss xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:content="http://purl.org/rss/1.0/modules/content/" xmlns:atom="http://www.w3.org/2005/Atom" version="2.0" xmlns:cc="http://cyber.law.harvard.edu/rss/creativeCommonsRssModule.html">
    <channel>
        <title><![CDATA[Stories by Edgard Gomes on Medium]]></title>
        <description><![CDATA[Stories by Edgard Gomes on Medium]]></description>
        <link>https://medium.com/@edgardgomezsennovskaya?source=rss-d6c1808e134c------2</link>
        <image>
            <url>https://cdn-images-1.medium.com/fit/c/150/150/0*4Q9zEvFfwlyrWi7C.</url>
            <title>Stories by Edgard Gomes on Medium</title>
            <link>https://medium.com/@edgardgomezsennovskaya?source=rss-d6c1808e134c------2</link>
        </image>
        <generator>Medium</generator>
        <lastBuildDate>Wed, 18 Nov 2026 02:39:26 GMT</lastBuildDate>
        <atom:link href="https://medium.com/@edgardgomezsennovskaya/feed" rel="self" type="application/rss+xml"/>
        <webMaster><![CDATA[yourfriends@medium.com]]></webMaster>
        <atom:link href="http://medium.superfeedr.com/" rel="hub"/>
        <item>
            <title><![CDATA[Получаем статистику Яндекс Директ в Google Spreadsheets по API]]></title>
            <link>https://medium.com/@edgardgomezsennovskaya/%D0%BF%D0%BE%D0%BB%D1%83%D1%87%D0%B0%D0%B5%D0%BC-%D1%81%D1%82%D0%B0%D1%82%D0%B8%D1%81%D1%82%D0%B8%D0%BA%D1%83-%D1%8F%D0%BD%D0%B4%D0%B5%D0%BA%D1%81-%D0%B4%D0%B8%D1%80%D0%B5%D0%BA%D1%82-%D0%B2-google-spreadsheets-%D0%BF%D0%BE-api-69e7e67761ae?source=rss-d6c1808e134c------2</link>
            <guid isPermaLink="false">https://medium.com/p/69e7e67761ae</guid>
            <category><![CDATA[google-apps-script]]></category>
            <category><![CDATA[google-spreadsheets]]></category>
            <category><![CDATA[яндексдирект]]></category>
            <category><![CDATA[контекстная-реклама]]></category>
            <category><![CDATA[таргетированнаяреклама]]></category>
            <dc:creator><![CDATA[Edgard Gomes]]></dc:creator>
            <pubDate>Mon, 14 Jan 2019 12:13:33 GMT</pubDate>
            <atom:updated>2019-01-14T12:14:54.074Z</atom:updated>
            <content:encoded><![CDATA[<p>Попробуем начать серию мини-статеек по получению данных из API рекламных систем и систем веб-аналитики.</p><p>Лично мною Google Spreadsheets был очень не любим долгое время, однако многие им пользуются, а Apps Script (которые охватывает практически всю гугловскую экосистему) позволяет многое что автоматизировать, конечно, со своими ограничениями. ETL тут не построишь, но для отдельного взятого клиента (или для себя) вполне можно смастерить что-то вполне удобное, типа автообноляемого отчетика.</p><p>Собственно, этим мы и займемся.</p><p>Начнем с Яндекс Директ.</p><p>Пропустим часть по получению токена — она подробно описана в документации (ну или позже сделаю мини-пост об этом).</p><p>Создаем наш документ и открываем редактор скриптов:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*QILS1gzyGCal65nwbbs1xQ.png" /><figcaption>Переход в редактор скриптов</figcaption></figure><p>Далее нам необходимо где-то сохранить нужные нам переменные: токен Яндекс Директ, базовый URL API, может быть логин клиента, по которому мы хотим получать данные. Сохранять их прямо в теле скрипта можно, но все же не очень красиво. Для этого лучше воспользоваться <strong>свойствами скрипта (находится в Файл — Свойства проекта):</strong></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/711/1*mCyN_N5a0h25OntORXZNLA.png" /><figcaption>Свойства скрипта</figcaption></figure><p>Тут есть кнопочка (на скрине не видно, но она ниже) “Добавить строку” и таким образом мы можем добавлять наши переменные: пара ключ-значение. Естественно в самом скрипте мы можем забирать эти значения и использовать для запросов к API Яндекс Директ.</p><p>Вернемся к самому скрипту. Состоять он будет из 3х частей:</p><ol><li>Кастомная менюшка — чтобы можно было принудительно ткнуть кнопочку и отчет обновился.</li><li>Функция для получения отчета из API Яндекс Директ.</li><li>Функция для записи полученных данных на лист.</li></ol><p>Создадим меню. Тут все очень просто и понятно:</p><pre>// создать меню при открытии спредшита<br>function onOpen() {<br>  var ui = SpreadsheetApp.getUi();<br>  ui.createMenu(&#39;Название пункта меню&#39;)<br>  .addItem(&#39;Текст кнопки для обновления&#39;, &#39;Название функции, которая будет запускаться по клику&#39;)<br>  .addToUi();  <br>}</pre><p>После этого перезагрузим наш файл и получим, что-то вроде:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/842/1*s4ECmQ1OJHEEIC3qMUsNzQ.png" /><figcaption>Создание кастомного меню в Google Spreadsheets</figcaption></figure><p>Теперь необходимо написать функцию для получения отчета (в примере: CAMPAIGN_PERFORMANCE_REPORT)</p><pre>// Получение статистики из API Яндекс Директ</pre><pre>function getYdStats() {<br>  var base_url = PropertiesService.getScriptProperties().getProperty(&#39;yd_base_url&#39;);<br>  var yd_token = PropertiesService.getScriptProperties().getProperty(&#39;yd_token&#39;);<br>  var client_name = PropertiesService.getScriptProperties().getProperty(&#39;yd_client_login&#39;);<br>  var report_url = base_url + &#39;reports&#39;<br>  var payload = {<br>    &#39;params&#39;: {<br>      &#39;SelectionCriteria&#39;: {<br>        &#39;DateFrom&#39;: &#39;2018-09-01&#39;,  // начало периода<br>        &#39;DateTo&#39;: Utilities.formatDate(new Date(), &quot;GMT+3&quot;, &quot;yyyy-MM-dd&quot;) // конец периода (сегодня)<br>      },<br>      &#39;FieldNames&#39;: [&#39;Month&#39;, &#39;CampaignType&#39;, &#39;CampaignId&#39;, &#39;CampaignName&#39;, &#39;Impressions&#39;, &#39;Clicks&#39;, &#39;Cost&#39;, &#39;AvgImpressionPosition&#39;],<br>      &#39;ReportName&#39;: client_name + &#39;_report_final_&#39; + Utilities.formatDate(new Date(), &quot;GMT+3&quot;, &quot;dd-MM-yyyy&quot;),<br>      &#39;ReportType&#39;: &#39;CAMPAIGN_PERFORMANCE_REPORT&#39;,<br>      &#39;DateRangeType&#39;: &#39;CUSTOM_DATE&#39;,      <br>      &#39;Format&#39;: &#39;TSV&#39;,<br>      &#39;IncludeVAT&#39;: &#39;YES&#39;,<br>      &#39;IncludeDiscount&#39;: &#39;NO&#39;<br>    }<br>  }<br>  var options = {<br>    &#39;headers&#39;: {<br>      &#39;Authorization&#39;: &#39;Bearer &#39; + yd_token,<br>      &#39;Accept-Language&#39;: &#39;ru&#39;,<br>      &#39;Client-Login&#39;: client_name,<br>      &#39;skipReportHeader&#39;: &#39;true&#39;,<br>      &#39;skipColumnHeader&#39;: &#39;true&#39;,<br>      &#39;skipReportSummary&#39;: &#39;true&#39;,<br>      &#39;processingMode&#39;: &#39;offline&#39;<br>    },<br>    &#39;muteHttpExceptions&#39;: true, <br>    &#39;payload&#39;: JSON.stringify(payload)    <br>  }<br>  var yd_data = [];<br>  while (true) {<br>    var response = UrlFetchApp.fetch(report_url, options);<br>    if (response.getResponseCode() == 200){<br>      Logger.log(&#39;yandex report ready&#39;);<br>      for (i=0; i &lt; parseInt(response.getContentText().split(&#39;\n&#39;).length-1); i++) {<br>        var tmp = response.getContentText().split(&#39;\n&#39;)[i].split(&#39;\t&#39;)        <br>        yd_data.push([tmp[0], tmp[1], tmp[2], tmp[3], tmp[4], tmp[5], parseInt(tmp[6])/1000000/1.18, tmp[7].replace(&#39;.&#39;,&#39;,&#39;).replace(&#39;--&#39;,0)]);<br>      }      <br>      return yd_data;<br>      break<br>    } else if (response.getResponseCode() == 201) {<br>      Logger.log(&#39;yandex report queued&#39;);<br>      Logger.log(response.getAllHeaders());<br>      Utilities.sleep(parseInt(response.getAllHeaders()[&#39;retryin&#39;])*1000)<br>    } else if (response.getResponseCode() == 202) {<br>      Logger.log(&#39;yandex report is being processed&#39;);<br>      Logger.log(response.getAllHeaders());<br>      Utilities.sleep(parseInt(response.getAllHeaders()[&#39;retryin&#39;])*1000)<br>    } else {<br>      Logger.log(&#39;failed &#39; + response);<br>      break<br>    }<br>  }<br>}</pre><p>Пол-дела мы уже сделали — получили данные из Яндекс Директ и теперь нам осталось только написать функцию для вставки данных на лист и готово!</p><pre>// Запись данных на лист<br>// rowValues -  собственно данные<br>// rowAValues - заголовки таблицы (надо самим создать массив и в нем перечислить название столбцов, либо переделать запрос к API и получить названия из него, а затем немного переделать ниже следующую функцию<br>// col - костылек, передаю крайний правый столбец</pre><pre>function writeToMultipleRanges(spreadsheetId, sheetName, rowValues, rowAValues, col) {<br>  Logger.log(rowValues)<br>  var request = {<br>    &#39;valueInputOption&#39;: &#39;USER_ENTERED&#39;,<br>    &#39;data&#39;: [<br>      {<br>        &#39;range&#39;: sheetName + &#39;!A1:&#39;+col+&#39;1&#39;,<br>        &#39;majorDimension&#39;: &#39;ROWS&#39;,<br>        &#39;values&#39;: rowAValues,<br>      },<br>      {<br>        &#39;range&#39;: sheetName + &#39;!A2:&#39;+col+(Number((rowValues.length))+1),<br>        &#39;majorDimension&#39;: &#39;ROWS&#39;,<br>        &#39;values&#39;: rowValues,<br>      },<br>    ],<br>  };<br>  try {<br>           SpreadsheetApp.getActiveSpreadsheet().getSheetByName(sheetName).clearContents(); // сотрем старые данные<br>      SpreadsheetApp.flush();<br>      } catch(error) {<br>      Logger.log(error);<br>      }<br>  Sheets.Spreadsheets.Values.batchUpdate(request, spreadsheetId); // запишем новые<br>  SpreadsheetApp.getActiveSpreadsheet().setNamedRange(sheetName, SpreadsheetApp.getActiveSpreadsheet().getRange(sheetName + &#39;!A1:&#39;+col+ (Number(rowValues.length)+1))); // добавим именованный диапазон (это для последующих личных целей)<br>}</pre><p>Остался последний шажок — нужно напсать мини функцию-апдейтер, которая, по сути, будет последовательно запускать две предыдущие (название этой функции и нужно прописать в самом первом сниппете данного поста):</p><pre>function refresher() {  <br>  spreadsheet_id = SpreadsheetApp.getActiveSpreadsheet().getId();<br>  yd_stats = getYdStats(); <br>  writeToMultipleRanges(spreadsheet_id, &#39;YD&#39;, yd_stats, rowYdValues, &#39;H&#39;);<br>  Logger.log(&#39;getYdStats() - done&#39;);  <br>}</pre><p>На всякий случай rowYdValues (rowAValues):</p><pre>var rowYdValues = [<br>    [<br>      &#39;Month&#39;, <br>      &#39;CampaignType&#39;,<br>      &#39;CampaignId&#39;,<br>      &#39;CampaignName&#39;,<br>      &#39;Impressions&#39;, <br>      &#39;Clicks&#39;, <br>      &#39;Cost&#39;,<br>      &#39;AvgImpressionPosition&#39;<br>    ]<br>  ];</pre><p>Вот и все! Не забывайте, что токен выдается на год (до этого обновлять его не нужно). Все работает как часы (на гигантских аккаунтах не проверял — теоретически может отработать из-за тайм аута, когда выбран большой период, а данных очень много) и вполне годится для микро-автоматизации “на коленке” — можно построить дашборды, можно подключиться с помощью Google Data Studio, можно высылать клиентам. Win-win.</p><p>В следующем посте расскажу про получение данных из API Яндекс Метрика — вообще все предельно просто, нам надо бдет только поменять одну функцию, все остальное — неизменно, а далее если все получится — Google Analytics, Facebook, VK, myTarget, т.е. практически полный стек рядового таргетолога, директолога (конректолога), демонолога, рекламиста и т.п. кем бы вы ни назывались =)</p><p>П.С. Не будучи профессиональным программистам, мой код может быть неоптимизирован, некрасив, содержать мелкие ошибки — так что поправляйте если хотите.</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=69e7e67761ae" width="1" height="1" alt="">]]></content:encoded>
        </item>
    </channel>
</rss>