Railsたった14行でアドサーバーAPIができた話

     - プログラム言語 ,  


こんにちは。駆け出しエンジニアの近江です。

最近Railsにハマっているので、私が2年間担当しているアドサーバの、簡易版をRailsで作ってみました。
広告やキャンペーンを登録する管理画面はある前提で、ここからたった14行追加するだけでアドサーバーのHTTP APIを作りたいと思います。ついでに配信期間の制御も入れたいと思います。
 

テーブル構成

まずホーム画面イメージです。
oomi_capture1

キャンペーン、広告、サイト、エリア、サイズ、広告主の6つのテーブルがあります。 広告のアップロードは※CarrierWaveを使ってユーザーがローカルから画像アップロードしたら指定したディレクトリに保存されるようにしてます。

※CarrierWave…ファイルアップロード用のgemで、画像アップロードした時の保存先や表示する際の参照先などが簡単に実装できます。

 

キャンペーン作成

キャンペーン作成画面です。
oomi_capture2
キャンペーン作成前に広告、サイト、エリア、サイズ、広告主を先に登録しておきます。 登録したデータはこのキャンペーン作成画面でプルダウンから選べるようになってます。 配信期間は開始、終了日時をプルダウンから選択します。 後ほど説明するAPIのところで、配信期間内でなければ画像を表示しないようにするためです。

 

API作成

ユーザーがURLで枠情報を指定してAPIとして叩けるように、API用のルーティング設定を行います。

まずはAPI用のコントローラーの作成
rails g controller Apis

次にルーティング設定
vi config/routes.rb(一番下の2行を追加!)

[ruby]
Rails.application.routes.draw do

root ‘top#index’

resources :advertisers
resources :sites
resources :areas
resources :sizes
resources :creatives
resources :campaigns

resources :apis
get ‘/api/SITE=:site/AREA=:area/SIZE=:size’ => ‘apis#index’
[/ruby]

 

ルーティング設定に追加された事を確認(一番下がAPIに使うURLの定義です。)
rake routes

[ruby]
apis GET /apis(.:format) apis#index
POST /apis(.:format) apis#create
new_api GET /apis/new(.:format) apis#new
edit_api GET /apis/:id/edit(.:format) apis#edit
api GET /apis/:id(.:format) apis#show
PATCH /apis/:id(.:format) apis#update
PUT /apis/:id(.:format) apis#update
DELETE /apis/:id(.:format) apis#destroy
GET /api/SITE=:site/AREA=:area/SIZE=:size(.:format) apis#index
[/ruby]

 

コントローラーの設定
vi app/controllers/apis_controller.rb(9行追加!)

[ruby]
class ApisController < ApplicationController
def index
@campaign = Campaign.find_by(site: params[:site], area: params[:area], size: params[:size])
@creative = Creative.find_by(name: @campaign.creative)
if @campaign.startdate > DateTime.now || @campaign.enddate < DateTime.now
@creative = nil
end
end
end
[/ruby]

このコントローラーの設定で、URLからパラメータを受け取り、データベースからキャンペーンを特定し、
該当するキャンペーンの広告名に紐づくデータをクリエイティブテーブルから取得します。
そしてここで配信期間を確認します。 現在時刻が該当したキャンペーンの配信期間内でなければ、取得したクリエイティブテーブルの中身をnilにしています。

 

表示部分
vi app/views/apis/index.html.erb(3行追加!)

[ruby]
<% if @creative %>
<%= image_tag @creative.file.url %>
<% end %>
[/ruby]

コントローラーから受け取ったクリエイティブデータを確認し、trueであれば画像を表示する。nilになってたら表示しない。

 

実際にAPIを叩いて画像が返ってきた時のブラウザイメージ
oomi_capture3

はい、ソースに2+9+3=14行追加するだけでHTTP APIを作ることができました。

まだ配信期間の判定しかできてないですが、更に広告をローテーションしつつimpを考慮してキャンペーンの選択ができるようになると、だいぶアドサーバらしくなるので、どんどん機能拡張していきたいと思います。
弊社のアドサーバーラインナップに並ぶ日も近い!?

 


DACエンジニア採用情報

  関連記事

TypeScriptについてまとめてみた

はじめに JavaScript がとりあえずそのまま動くので、雰囲気で使ってしまいがちな TypeScript。初心者向けに基本的なことをまとめてみました。 TypeScript って何? TypeScript はマイクロソフトが開発したプログラミング言語で、オープンソースでメンテナンスされています …

iOS端末情報をTreasureDataに送るアプリをswiftで作ってみた。

はじめまして、2年目のOyamanです。 通常業務とは別のことになりますが、Swiftに触れる機会が少しあったので、スマホ関連の記事を書かせていただきます。 はじめに SwiftとTreasureDataのSDKを使って、 iOSの端末情報をTreasureDataへ送るアプリを作ってみます。 今回 …

【未経験からのRuby on Rails – 第4回】Railsアプリケーション開発をしよう! 〜開発の準備編〜

こんにちは。新卒のmatsuariです。 Rubyについてまだまだ知るべきことはたくさんありますが、とにかく早くアプリを作りたい! ということで、今回はアプリ開発の準備に取り掛かっていきます。 Rubyはアプリを作成しながら、同時に学んでいきたいと思います。 Railsアプリケーション開発の準備《 …

(社内新卒・PHPビギナー向け)MacでPHP7開発環境を構築しよう!

はじめに みなさんこんにちは、プロダクト開発本部の亀梨です。 普段はXmediaOneというメディアプランニング・広告運用管理・トラッキング・マーケティング分析を行う 統合プラットフォームの開発を担当しています。 えっ!?新卒のプログラミング研修はPHPで行われるって?!俺の得意言語やないか!! は …

no image
gulp.jsで広告タグの開発環境を整える

SEOの観点から、サイト表示速度の高速化のためJavaScriptファイルから不用な空白や改行、 コメントを除去したりやローカル変数名を短縮するminifyが奨励されていますが、 これはタスクランナーのgulp.jsとプラグインを使って自動化する事が可能です。 ※gulpの基本的な使い方については下 …

no image
【未経験からのRuby on Rails – 第1回】楽しく書けるプログラミング言語 “Ruby” とは

こんにちは、はじめまして。新卒1年目のmatsuari(女子)です。 この度、Rubyの勉強を始めることになりまして、 まずはたくさんあるプログラミング言語の中で、なぜ自分がRubyを学ぶのか? しっかりと把握した上で学習に取り組んでいきたいと考え、『Rubyとは何か?』調べました。 超基礎的なこと …

no image
Polymer on Rails

Web Componentsをご存知だろうか。これが普及すればWebの開発は画期的に変わるだろう。 説明すると長くなるので、LIGさんのにその辺はお任せして。(この記事読んでください。) 簡単に言えば、下記にあるような新たに提案されたブラウザ向けAPIの総称。 Custom Elements, 説明 …

Bootstrapのモーダル機能で多重表示する際に解決しなければならない2つの問題

はじめに みなさんこんにちは、プロダクト開発本部の亀梨です。 普段はXmediaOneというメディアプランニング・広告運用管理・トラッキング・マーケティング分析を行う 統合プラットフォームの開発・保守を担当しています。 エンジニアの皆さん、デザインってどうしてます? わたくしはプライベートでとあるW …

PyStanによるはじめてのマルコフ連鎖モンテカルロ法

はじめに こんにちは。システム開発部の中村です。 社内で行っている『データ解析のための統計モデリング入門』(所謂緑本)の輪読会に参加した所、 大変わかりやすい本だったものの、Macユーザには悲しい事に実装サンプルがWinBUGSだったため、 9章の一般化線形モデルのベイズ推定によるアプローチをPyt …

Scala入門 基礎編「Scalaの書き方を理解しよう」 – PHP使いからScala使いへ転身!

はじめに みなさんこんにちは、プロダクト開発本部の亀梨です。 普段はXmediaOneというメディアプランニング・広告運用管理・トラッキング・マーケティング分析を行う 統合プラットフォームの開発を担当しています。 さて、今回はScala入門第二弾として、Scalaの書き方を紹介する基礎編をお送りしま …