👩🏼‍🤝‍👩🏻 💅🏼 📦 マーケティング担当者を支援するために、視覚化を使用してAdfoxから自動データアップロードを作成します 🐃 🎙️ 🧘

前回の記事では、Yandex Metricsからの自動データアップロードの設定例を検討しました。これにより、定期的なアンロードが容易になりますが、メソッドは半自動です。スクリプトを実行し、アンロードの結果を自分にコピーして、引き続き設計する必要があります。プロセスを完全に自動化する方法を見てみましょう。たとえば、広告システムAdfoxのデータアップロードを使用します。

Adfoxには既製のレポートが多数ありますが、レポート要件の単純な複雑さでも問題が発生します。通常のレポートを設定するオプションがありますが、ほとんどの場合、アップロードの組み合わせを自分で設定する必要があります。

この記事では、アカウントで使用可能なすべてのバナーのCTRをアンロードするスクリプトを作成する方法を示します（これを手動で行うのは時間的に非現実的です）。これを単純なHTMLページとしてチャートに表示する方法と同様に。つまり、すべてのキャンペーンとフライトを順次確認し、すべてのバナーのインプレッションとクリックを取得して、CTRのグラフを描画します。前の記事と同様に、Amazon Web Servicesインスタンスで作業するため、ユニバーサルで最も重要なことは無料です。 PHPでデータをアンロードし、Highchartsでグラフィックを描画します。コードは、改善なしでデータをアップロードおよび処理する最も簡単な方法を実装します。その結果、昨日の毎日更新される毎日のページを取得します。

AWSでアカウントを作成することから始めます（まだない場合）。この手順の詳細については、ドキュメントdocs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-ug.pdf （開始前）で説明しています。次に、「チュートリアル：Amazon LinuxにLAMP Webサーバーをインストールする」の章の同じドキュメントで説明されている段階を実行します：データをアップロードおよび保存するために必要なPHPとMySQLをインストールします（将来、MySQLでの作業はテキストファイルよりも優れています）。もちろん、組み込みのPythonを使用してこれを行わなくても実行できます。 Amazon Linuxインスタンスを起動します（詳細については、Ubuntu Serverインスタンスを選択した前回の記事を参照してください）。ここでは、UbuntuではなくLinuxが必要です。 UbuntuでLAMP Webサーバーを実行するには、ドキュメントhelp.ubuntu.com/community/ApacheMySQLPHPを参照してください。そのため、Amazon Linuxインスタンスを選択し、セキュリティグループをチェックして、プライベートキーがあることを確認します。数分後、インスタンスのパブリックDNSを取得し、Putty（Windowsの場合）またはMACのターミナルを介してインスタンスに接続します。

LAMP Webサーバーを配置します。最新の更新があることを確認するコマンドを実行します。
$ sudo yum update -y

私たちに適したPHPバージョンを配置します。
$ sudo yum install -y httpd24 php56 mysql55-server php56-mysqlnd

Apache Webサーバーを起動します。
$ sudo service httpd start

システムが起動するたびにApache Webサーバーが起動するようにします。
$ sudo chkconfig httpd on

すべてが成功したことをテストします。インスタンスのパブリックDNSブラウザーにコピーして貼り付け、次のページを取得します。

これで、ルートディレクトリ/ var / www /はルートユーザーによって「所有」されます。そこでec2-userユーザーアクセスを作成しましょう。

グループ「www」を作成します。
$ sudo groupadd www

ユーザーec2-userをwwwグループに追加します。
$ sudo usermod -a -G www ec2-user

変更を有効にするには、PuttyまたはTerminal（exitコマンド）を閉じて、インスタンスに再度接続します。ユーザーec2-userがwwwグループに登録されていることを確認します。
$グループ
ec2-userホイールwww

/ var / wwwフォルダーの所有者を変更します。
$ sudo chown -R root：www / var / www

ユーザーec2-userおよびwwwグループのその他のユーザーに/ var / wwwフォルダーを変更する機能を追加します。
$ sudo chmod 2775 / var / www
$ find / var / www -type d -exec sudo chmod 2775 {} +
$ find / var / www -type f -exec sudo chmod 0664 {} +

/ var / wwwディレクトリにPHPファイルを作成できることをテストします。これを行うには、phpinfo.phpファイルを作成して<？Php phpinfo（）を書き込みます。？>：
$ echo "<？php phpinfo（）;？>"> /var/www/html/phpinfo.php

ここでも、ブラウザのアドレスバーにインスタンスのパブリックDNSをコピーし、「/ phpinfo.php」を追加します。 PHPの設定を含む次のページを取得する必要があります。

セキュリティ上の理由から、作成したphpinfo.phpファイルを削除します。
$ rm /var/www/html/phpinfo.php

素晴らしい、Adfoxからデータをアップロードする準備ができました！

Adfoxの統計情報をアンロードする
Adfox APIのドキュメントは、 help.adfox.ru （ページの下部にあるダウンロードリンク）にあります。一般に、ドキュメントはあまりコンパイルされていないため、一般的な場合、次のルールを使用できます：APIでレポートのリンクを取得する必要がある場合は、ブラウザーからリンクをコピーし、ユーザー名とパスワード+ '＆isXML = 1'を使用して形式のデータを受信しますXML 検索機能またはキャンペーン設定が必要な場合は、APIドキュメントを確認する必要があります。

一般に、Adfox APIへのリクエストには、ログイン時（ログイン時）とパスワードからのSHA-256ハッシュが伴います。検索クエリ「sha-256 online」に対して、任意のサイトでパスワードハッシュを生成できます。たとえば、こちら： www.xorbin.com/tools/sha256-hash-calculator

パスワードが「12345」の場合、APIにアクセスするには、「5994471abb01112afcc18159f6cc74b4f511b99806da59b3caf5a9c173cacfc5」という値をパスワードとして使用します。

アルゴリズムは2つのステップで構成されます。

ステップ1 利用可能なすべてのキャンペーンのリストを取得します。
利用可能なキャンペーンのリストを取得します。キャンペーンが多数ある場合は、たとえば8月1日から開始されたキャンペーンに制限できます。
login.adfox.ru/API.php?object=account&action=list&actionObject=superCampaign&dateAddedFrom=2015-08-01&loginAccount=login&loginPassword=password-sha-256&isXML=1

ブラウザで、次のXMLファイルを取得します。

ステップ2 各キャンペーンには、名前（タグ）とID（）があります。各IDについて、バナーレポートを取得します（たとえば、ID = 55555のキャンペーンの場合）：
login.adfox.ru/commonReportsOutputForm.php?period=&startDate=start-date&endDate=end-date&criteria=superCampaignBanner&isNewSearch=on&objectName=superCampaign&objectID=55&loginloginloginloginloginloginloginloginloginloginloginloginloginloginloginloginloginlogin

この手順を毎日実行し、データをファイルに書き込むスクリプトを作成しましょう。最も簡単な方法は、/ var / www / htmlフォルダーに移動し、そこにadfoxフォルダーを作成し、次のコードでdaily.phpファイルを作成することです。

Adfoxデータアップロードコード

<?php //   ,    : startDate  endDate //      Adfox .. date_default_timezone_set("Europe/Moscow"); //$startDate = '04.09.15'; //$endDate = '04.09.15'; //           $startDate = date('dmy', strtotime('-1 day')); $endDate = $startDate; //  getCampaigns      //   $campIDs  ID    //      dateAddedFrom     ,      function getCampaigns() { $ch = curl_init(); $options = array( CURLOPT_URL => 'https://login.adfox.ru/API.php?object=account&action=list&actionObject=superCampaign&dateAddedFrom=2015-08-01&loginAccount=&loginPassword=-sha-256&isXML=1', CURLOPT_HEADER => "Content-Type:application/xml", CURLOPT_HTTPAUTH => CURLAUTH_BASIC, CURLOPT_SSL_VERIFYPEER => FALSE, CURLOPT_RETURNTRANSFER => TRUE ); curl_setopt_array($ch, $options); $data = curl_exec($ch); curl_close($ch); //    Adfox  ,      // file_put_contents('request.txt', $data, FILE_APPEND); //   Adfox  XML   vals $parser=xml_parser_create('UTF-8'); xml_parse_into_struct($parser, $data, $vals, $index); $campIDs = array(); $j = 0; //   vals,     ID         campIDs for ($i = 0; $i < count($vals); ++$i) { if ($vals[$i]["tag"]=="ID") { $ID = $vals[$i]["value"]; } if ($vals[$i]["tag"]=="NAME") { $name = $vals[$i]["value"]; $campIDs[$j]['id'] = $ID; $campIDs[$j]['name'] = $name; $j += 1; } } return $campIDs; } //  getBanners      ID     //     campReport   ID  +   -   -  -  function getBanners($id, $startDate, $endDate) { $ch = curl_init(); $options = array( CURLOPT_URL => 'https://login.adfox.ru/commonReportsOutputForm.php?period=&startDate='.$startDate.'&endDate='.$endDate.'&criteria=superCampaignBanner&isNewSearch=on&objectName=superCampaign&objectID='.$id.'&ignoreStartDate=off&loginAccount=&loginPassword=-sha-256&isXML=1', CURLOPT_HEADER => "Content-Type:application/xml", CURLOPT_HTTPAUTH => CURLAUTH_BASIC, CURLOPT_SSL_VERIFYPEER => FALSE, CURLOPT_RETURNTRANSFER => TRUE ); curl_setopt_array($ch, $options); $data = curl_exec($ch); curl_close($ch); //   Adfox  ,      //file_put_contents('request.txt', $data, FILE_APPEND); $parser=xml_parser_create('UTF-8'); xml_parse_into_struct($parser, $data, $vals, $index); $campReport = array(); $j = 0; for ($i = 0; $i < count($vals); ++$i) { if ($vals[$i]["tag"]=="CRITERIA") { $bannername = $vals[$i]["value"]; } if ($vals[$i]["tag"]=="FLIGHTNAME") { $flightname = $vals[$i]["value"]; } if ($vals[$i]["tag"]=="IMPRESSIONS") { $impressions = $vals[$i]["value"]; } if ($vals[$i]["tag"]=="CLICKS") { $clicks = $vals[$i]["value"]; $campReport[$j]['campaign'] = $id; $campReport[$j]['flightname'] = $flightname; $campReport[$j]['bannername'] = $bannername; $campReport[$j]['impressions'] = $impressions; $campReport[$j]['clicks'] = $clicks; $j += 1; } } return $campReport; } //     $campIDs = getCampaigns(); //        for ($i = 0; $i < count($campIDs); ++$i) { $campReport = getBanners($campIDs[$i]['id'], $startDate, $endDate); //       data.txt       //    data.txt        Cron for ($j = 0; $j < count($campReport); ++$j) { file_put_contents('/var/www/html/adfox/data.txt', $startDate."\t".$campReport[$j]['campaign']."\t".$campReport[$j]['flightname']."\t".$campReport[$j]['bannername']."\t".$campReport[$j]['impressions']."\t".$campReport[$j]['clicks']."\n", FILE_APPEND); //        () echo 'Record created - '.$startDate.' - '.$campReport[$j]['bannername']."\n"; } }

数日（たとえば9月1〜4日）にコードを実行し、startDateとendDateの日付を01.09.15から09.09.15に置き換えます。その結果、9月1日から4日までの毎日の各バナーの統計は、data.txtファイルに蓄積されます。

データをグラフに表示し、スクリプトを自動的に更新するために残ります。グラフを描画するには、 www.highcharts.com / demo / line-basicを使用します。ライブラリをインスタンスにダウンロードするか、Highcharts Webサイトのライブラリにアクセスできます。この例では、2番目のオプションを使用します。すべての例のコードは、グラフの下の[JSFIDDLEで編集]ボタンをクリックして、www.highcharts.com / demo / line-basicで表示できます。

ライブラリが正しく機能するには、 jQueryが必要です。サイトから、またはコンソールで直接/ var / www / html / adfoxフォルダーにダウンロードします。
$ wget code.jquery.com/jquery-1.11.3.js

report.htmlファイルにチャートコードを追加します。

レンダリング付きのHTMLページコード

 <html> <head> <script src="jquery-1.11.3.js"></script> <script src="http://code.highcharts.com/highcharts.js"></script> <script src="http://code.highcharts.com/modules/exporting.js"></script> </head> <body> <script> //   ,      data.txt var banners = []; //  ,   ,     data.txt //  CTR (   )  var dates1 = []; var shows1 = []; var clicks1 = []; var ctr1 = []; var dates2 = []; var shows2 = []; var clicks2 = []; var ctr2 = []; var dates3 = []; var shows3 = []; var clicks3 = []; var ctr3 = []; //   data.txt  $.get("data.txt", function(data){ var lines = data.split("\n"); for (var i = 0, len = lines.length; i < len; i++) { //   ,     //console.log(lines[i]); //        6 ,    data.txt elements = lines[i].split("\t"); //       ,      elements // (   -      0,    1) banners.push(elements[2]); } // ,      //console.log(banners); //         bannerNames  3  Array.prototype.unique = function() { var tmp = {}, out = []; for(var i = 0, n = this.length; i < n; ++i) { if(!tmp[this[i]]) { tmp[this[i]] = true; out.push(this[i]); } } return out; } bannersNames = banners.unique().slice(0, 3); // ,   3    //console.log(bannersNames); //      data.txt   ,        bannerNames for (var i = 0, len = lines.length; i < len; i++) { elements = lines[i].split("\t"); //     data.txt    ,     ,       if (elements[2] == bannersNames[0]) { dates1.push(elements[0]); shows1.push(parseInt(elements[4])); clicks1.push(parseInt(elements[5])); // toFixed(3) -   CTR      if (parseInt(elements[4]) > 0) { ctr1.push(Number(parseFloat(elements[5] / elements[4] * 100).toFixed(3))); } else { ctr1.push(0); } } //       if (elements[2] == bannersNames[1]) { dates2.push(elements[0]); shows2.push(parseInt(elements[4])); clicks2.push(parseInt(elements[5])); if (parseInt(elements[4]) > 0) { ctr2.push(Number(parseFloat(elements[5] / elements[4] * 100).toFixed(3))); } else { ctr2.push(0); } } //       if (elements[2] == bannersNames[2]) { dates3.push(elements[0]); shows3.push(parseInt(elements[4])); clicks3.push(parseInt(elements[5])); if (parseInt(elements[4]) > 0) { ctr3.push(Number(parseFloat(elements[5] / elements[4] * 100).toFixed(3))); } else { ctr3.push(0); } } } // ,    CTR (   )    // : [0.22, 0.25, 0.30, 0.24] //console.log(ctr1); //console.log(ctr2); //console.log(ctr3); //   CTR   $(function () { //   container      <div id="container"...   $('#container').highcharts({ //   title: { text: 'Campaign banners CTR', x: -20 //center }, //    subtitle: { text: 'Source: ADFOX', x: -20 }, //         dates1 xAxis: { categories: dates1 }, //    yAxis: { title: { text: 'CTR %' }, plotLines: [{ value: 0, width: 1, color: '#808080' }] }, //       tooltip: { valueSuffix: '%' }, //   legend: { layout: 'vertical', align: 'right', verticalAlign: 'middle', borderWidth: 0 }, //  ,     :     CTR    series: [{ name: bannersNames[0], data: ctr1 }, { name: bannersNames[1], data: ctr2 }, { name: bannersNames[2], data: ctr3 }], credits: { enabled: false } }); }); }); </script> <div id="container" style="min-width: 310px; height: 400px; margin: 0 auto"></div> </body> </html>

ファイルがadfoxフォルダーにあることを忘れずに、report.htmlページをブラウザーで開きます。

スクリプトを毎日更新するようにします（たとえば、インスタンスのシステム時間に応じて8:00に、コンソールのdateコマンドで確認できます）。これを行うには、コンソールで以下を実行します。
$ crontab -e

デフォルトでは、vimエディターが開きます。ファイルを編集するには、「i」（編集モード）を押して次の行を追加します（Shift + Insを使用してエディターに貼り付けます）。
00 08 * * * / usr / bin / php /var/www/html/adfox/daily.php> / var / www / html / adfox / out

次に、esc（編集モードを終了）を押して「：wq」と入力し、保存して終了します。コンソールに次の行が表示されます。
crontab：新しいcrontabのインストール

スケジュール設定を確認するには：
$ crontab -l
00 08 * * * / usr / bin / php /var/www/html/adfox/daily.php> / var / www / html / adfox / out

outファイルでは、cronタスクの結果を追跡できます。たとえば、スクリプトの実行中にエラーが発生した場合。

AWSでのCronの詳細： docs.aws.amazon.com/opsworks/latest/userguide/workingcookbook-extend-cron.html

すべて準備完了です。合計で、昨日の昨日の昨日の利用可能なすべてのバナーのインプレッションとクリックを毎朝更新するスクリプトがあります。また、過去数日間のCTRバナーのダイナミクスをいつでも確認できるHTMLページもあります。 AWSには、安全なデータアクセスを設定するための多くのオプションがあります。また、このアプローチを改善しながら、MySQLデータベースにデータを書き込むことができます。これは、テキストファイルよりも作業がはるかに簡単です。このアプローチにより、Adfoxを定期的に使用しながら時間を節約できることを願っています。

マーケティング担当者を支援するために、視覚化を使用してAdfoxから自動データアップロードを作成します

More articles: