3.1.5. クリエイティブを管理する

フリーテキスト広告を作成する

[URL]
キャンペーンへ追加する場合 : http://api.adlantis.jp/api/mobile/campaign/create_ad
デフォルトの自社広告を作成する場 合 : http://api.adlantis.jp/api/mobile/zone/default_ad/create

[メソッド]
POST

[引 数]
campaign_id[※] : キャンペーンID。キャンペーンにクリエイティブを追加する場合は必須。

zone_ids : クリエイティブを登録する広告枠ID。カンマ区切りで複数指定可能。キャンペーンへクリエイティブを追加する場合は必須。

zone_id : 広告枠ID。デフォルトの自社広告を作成する場合には必須。

ad_type[※] : 広告の種類。「101」で固定。

title
[※] : タイトル行の文言を指定する。全角40文字(半角80文字)以内です。
             絵文字の入力が可能です。指定方法は1. 定数一覧 を参照してください。  
text
: 本文(二行目)の文言を指定する。全角40文字(半角80文字)以内です。
         絵文字の入力が可能です。指定方法は1. 定数一覧 を参照してください。     
name : 広告名。

priority_flg : 配信優先度の設定。
  • 0 : 優先度を指定して配信する。
  • 1 : AdLantisによる自動化配信。
priority_order : 配信の優先度設定。1 〜 5までの数値を指定する。優先度を指定して配信する設定(priority_flg = 0)のみ有効。
    指定 しない場合は5が設定される。

has_title_link
[※] : タイトルに対してリンクを貼るかどうか指定する。
    has_title_link若しくはhas_text_linkは少なくとも片方はtrueでなければならない。
  • true : タイトルに対してリンクを貼る。
  • false : タイトルに対してリンクを貼らない。
has_text_link[※] : 本文に対してリンクを貼るかどうか指定する。
    has_title_link若しくはhas_text_linkは少なくとも片方はtrueでなけれ ばならない。
  • true : 本文に対してリンクを貼る。
  • false : 本文に対してリンクを貼らない。
allow_au : auに対して配信するかどうか。
    配信比率を指定しない広告の場合は必須。そうでない場合は広告枠の指定が優先される。
  • true : auに対して配信する。
  • false : auに対して配信しない
allow_softbank : Softbankに対して配信するかどうか。
    配信比率を指定しない広告の場合は必須。そうでな い場合は広告枠の指定が優先される。

  • true : Softbankに対して配信する。
  • false : Softbankに対して配信しない
allow_docomo : DoCoMoに対して配信するかどうか。
    配信比率を指定しない広告の場合は必須。そうでない場 合は広告枠の指定が優先される。

  • true : DoCoMoに対して配信する。
  • false : DoCoMoに対して配信しない
allow_others : その他のキャリアに対して配信するかどうか。
    配信比率を指定しない広告の場合は必須。そうでない場合は広告枠の指定が優先される。

  • true : その他のキャリアに対して配信する。
  • false : その他のキャリアに対して配信しない
au_url : auのクリック先URLを指定する。指定しない場合はデフォルトで「http://」になります。

softbank_url : Softbankのクリック先URLを指定する。指定しない場合はデフォルトで「http://」になります。

docomo_url : DoCoMoのクリック先URLを指定する。指定しない場合はデフォルトで「http://」になります。

others_url : その他のキャリアのクリック先URLを指定する。指定しない場合はデフォルトで「http://」になります。

start_date : 広告の配信開始日(yyyy/MM/dd)。

start_hour : 広告の配信開始時刻(hh)。start_dateを指定して、このパラメータを指定しない場合は、00(0時)が設定されたことになります。

end_date : 広告の配信終了日(yyyy/MM/dd)。

end_hour : 広告の配信終了時刻(hh)。end_dateを指定して、このパラメータを指定しない場合は、00(0時)が設定されたことになります。

[戻り値]
ad:
ad-id : 作成したクリエイティブのID。

ad-type : 作成したクリエイティブの種類。「101」で固定。

ビッグテキスト広告を作成する

[URL]
キャンペーンへ追加する場合 : http://api.adlantis.jp/api/mobile/campaign/create_ad
デフォルトの自社広告を作成する場 合 : http://api.adlantis.jp/api/mobile/zone/default_ad/create

[メソッド]
POST

[引 数]
campaign_id[※] : キャンペーンID。キャンペーンにクリエイティブを追加する場合は必須。

zone_ids : クリエイティブを登録する広告枠ID。カンマ区切りで複数指定可能。キャンペーンへクリエイティブを追加する場合は必須。

zone_id : 広告枠ID。デフォルトの自社広告を作成する場合には必須。

ad_type[※] : 広告の種類。「102」で固定。

title
[※] : タイトル行の文言を指定する。全角で8文字(半角16文字)以内です。
            絵文字の入力が可能です。指定方法は1. 定数一覧 を参照してください。  
text
[※]: 本文(二行目)の文言を指定する。全角で10文字(半角20文 字)以内です。
              絵文字の入力が可能です。指定方法は1. 定数一覧 を参照してください。    
name : 広告名。

priority_flg : 配信優先度の設定。
  • 0 : 優先度を指定して配信する。
  • 1 : AdLantisによる自動化配信。
priority_order : 配信の優先度設定。1 〜 5までの数値を指定する。優先度を指定して配信する設定(priority_flg = 0)のみ有効。
    指定 しない場合は5が設定される。

has_title_link[※] : タイトルに対してリンクを貼るかどうか指定する。
    has_title_link若しくはhas_text_linkは少なくとも片方はtrueでなければならない。
  • true : タイトルに対してリンクを貼る。
  • false : タイトルに対してリンクを貼らない。
has_text_link[※] : 本文に対してリンクを貼るかどうか指定する。
    has_title_link 若しくはhas_text_linkは少なくとも片方はtrueでなけれ ばならない。
  • true : 本文に対してリンクを貼る。
  • false : 本文に対してリンクを貼らない。
allow_au : auに対して配信するかどうか。
    配 信比率を指定しない広告の場合は必須。そうでない場合は広告枠の指定が優先される。
  • true : auに対して配信する。
  • false : auに対して配信しない
allow_softbank : Softbankに対して配信するかどうか。
    配信比率を指定しない広告の場合は必須。そうでな い場合は広告枠の指定が優先される。

  • true : Softbankに対して配信する。
  • false : Softbankに対して配信しない
allow_docomo : DoCoMoに対して配信するかどうか。
    配信比率を指定しない広告の場合は必須。そうでない場 合は広告枠の指定が優先される。

  • true : DoCoMoに対して配信する。
  • false : DoCoMoに対して配信しない
allow_others : その他のキャリアに対して配信するかどうか。
    配信比率を指定しない広告の場合は必須。そうでない場合は広告枠の指定が優先される。

  • true : その他のキャリアに対して配信する。
  • false : その他のキャリアに対して配信しない
au_url : auのクリック先URLを指定する。指定しない場合はデフォルトで「http://」になります。

softbank_url : Softbankのクリック先URLを指定する。指定しない場合はデフォルトで「http://」になります。

docomo_url : DoCoMoのクリック先URLを指定する。指定しない場合はデフォルトで「http://」になります。

others_url : その他のキャリアのクリック先URLを指定する。指定しない場合はデフォルトで「http://」になります。

start_date : 広告の配信開始日(yyyy/MM/dd)。

start_hour : 広告の配信開始時刻(hh)。start_dateを指定して、このパラメータを指定しない場合は、00(0時)が設定されたことになります。

end_date : 広告の配信終了日(yyyy/MM/dd)。

end_hour : 広告の配信終了時刻(hh)。end_dateを指定して、このパラメータを指定しない場合は、00(0時)が設定されたことになります。

[戻り値]
ad:
ad-id : 作成したクリエイティブのID。

ad-type : 作成したクリエイティブの種類。「102」で固定。

スモールテキスト広告を作成する

[URL]
キャンペーンへ追加する場合 : http://api.adlantis.jp/api/mobile/campaign/create_ad
デフォルトの自社広告を作成する場合 : http://api.adlantis.jp/api/mobile/zone/default_ad/create

[メソッド]
POST

[引数]
campaign_id[※] : キャンペーンID。キャンペーンにクリエイティブを追加する場合は必須。

zone_ids : クリエイティブを登録する広告枠ID。カンマ区切りで複数指定可能。キャンペーンへクリエイティブを追加する場合は必須。

zone_id : 広告枠ID。デフォルトの自社広告を作成する場合には必須。

ad_type[※] : 広告の種類。「103」で固定。

title
[※] : タイトル行の文言を指定する。全角で6文字(半角12文字)以内です。
            絵文字の入力が可能です。指定方法は1. 定数一覧 を参照してください。  
text
[※] : 本文(二行目)の文言を指定する。全角で8文字(半角16文字)以内です。
              絵文字の入力が可能です。指定方法は1. 定数一覧 を参照してください。    
name : 広告名。

priority_flg : 配信優先度の設定。
  • 0 : 優先度を指定して配信する。
  • 1 : AdLantisによる自動化配信。
priority_order : 配信の優先度設定。1 〜 5までの数値を指定する。優先度を指定して配信する設定(priority_flg = 0)のみ有効。
    指定しない場合は5が設定される。

has_title_link[※] : タイトルに対してリンクを貼るかどうか指定する。
    has_title_link若しくはhas_text_linkは少なくとも片方はtrueでなければならない。
  • true : タイトルに対してリンクを貼る。
  • false : タイトルに対してリンクを貼らない。
has_text_link[※] : 本文に対してリンクを貼るかどうか指定する。
    has_title_link 若しくはhas_text_linkは少なくとも片方はtrueでなけれ ばならない。
  • true : 本文に対してリンクを貼る。
  • false : 本文に対してリンクを貼らない。
allow_au : auに対して配信するかどうか。
    配信比率を指定しない広告の場合は必須。そうでない場合は広告枠の指定が優先される。
  • true : auに対して配信する。
  • false : auに対して配信しない
allow_softbank : Softbankに対して配信するかどうか。
    配信比率を指定しない広告の場合は必須。そうでな い場合は広告枠の指定が優先される。

  • true : Softbankに対して配信する。
  • false : Softbankに対して配信しない
allow_docomo : DoCoMoに対して配信するかどうか。
    配信比率を指定しない広告の場合は必須。そうでない場 合は広告枠の指定が優先される。

  • true : DoCoMoに対して配信する。
  • false : DoCoMoに対して配信しない
allow_others : その他のキャリアに対して配信するかどうか。
    配信比率を指定しない広告の場合は必須。そうでない場合は広告枠の指定が優先される。

  • true : その他のキャリアに対して配信する。
  • false : その他のキャリアに対して配信しない
au_url : auのクリック先URLを指定する。指定しない場合はデフォルトで「http://」になります。

softbank_url : Softbankのクリック先URLを指定する。指定しない場合はデフォルトで「http://」になります。

docomo_url : DoCoMoのクリック先URLを指定する。指定しない場合はデフォルトで「http://」になります。

others_url : その他のキャリアのクリック先URLを指定する。指定しない場合はデフォルトで「http://」になります。

start_date : 広告の配信開始日(yyyy/MM/dd)。

start_hour : 広告の配信開始時刻(hh)。start_dateを指定して、このパラメータを指定しない場合は、00(0時)が設定されたことになります。

end_date : 広告の配信終了日(yyyy/MM/dd)。

end_hour : 広告の配信終了時刻(hh)。end_dateを指定して、このパラメータを指定しない場合は、00(0時)が設定されたことになります。

[戻り値]
ad:
ad-id : 作成したクリエイティブのID。

ad-type : 作成したクリエイティブの種類。「103」で固定。

バナー広告を作成する


[URL]
キャンペーンへ追加する場合 : http://api.adlantis.jp/api/mobile/campaign/create_ad
デフォルトの自社広告を作成する場合 : http://api.adlantis.jp/api/mobile/zone/default_ad/create

画像フォーマット:GIF/JPG/PNG

[メソッド]
POST

[引数]
campaign_id[※] : キャンペーンID。キャンペーンにクリエイティブを追加する場合は必須。

ad_type[※] : 広告の種類。「104」で固定。

zone_ids : クリエイティブを登録する広告枠ID。カンマ区切りで複数指定可能。キャンペーンへクリエイティブを追加する場合は必須。

zone_id : 広告枠ID。デフォルトの自社広告を作成する場合には必須。

external_image_flg : 画像をアップロードするか、外部画像URLを指定するか決める。
  • 0 : 画像をアップロードする。
  • 1 : 外部画像URLを指定する。
banner_image : バナーの画像ソースファイルへのパス。画像をアップロードするexternal_image_flgが0の)場合は必須。

external_image_url : 画像の外部URL。外部画像URLを指定する(external_image_flgが0の)場合は必須

alt
[※]: 画像が表示できないときの代替テキスト。

name : 広告名。

priority_flg : 配信優先度の設定。
  • 0 : 優先度を指定して配信する。
  • 1 : AdLantisによる自動化配信。
priority_order : 配信の優先度設定。1 〜 5までの数値を指定する。優先度を指定して配信する設定(priority_flg = 0)のみ有効。
    指定しない場合は5が設定される。


has_title_link[※] : タイトルに対してリンクを貼るかどうか指定する。
    has_title_link若しくはhas_text_linkは少なくとも片方はtrueでなければならない。
  • true : タイトルに対してリンクを貼る。
  • false : タイトルに対してリンクを貼らない。
has_text_link[※] : 本文に対してリンクを貼るかどうか指定する。
    has_title_link 若しくはhas_text_linkは少なくとも片方はtrueでなければならない。
  • true : 本文に対してリンクを貼る。
  • false : 本文に対してリンクを貼らない。
allow_au : auに対して配信するかどうか。
    配信比率を指定しない広告の場合は必須。そうでない場合は広告枠の指定が優先される。
  • true : auに対して配信する。
  • false : auに対して配信しない
allow_softbank : Softbankに対して配信するかどうか。
    配信比率を指定しない広告の場合は必須。そうでない場合は広告枠の指定が優先される。

  • true : Softbankに対して配信する。
  • false : Softbankに対して配信しない
allow_docomo : DoCoMoに対して配信するかどうか。
    配信比率を指定しない広告の場合は必須。そうでない場合は広告枠の指定が優先される。

  • true : DoCoMoに対して配信する。
  • false : DoCoMoに対して配信しない
allow_others : その他のキャリアに対して配信するかどうか。
    配信比率を指定しない広告の場合は必須。そうでない場合は広告枠の指定が優先される。

  • true : その他のキャリアに対して配信する。
  • false : その他のキャリアに対して配信しない
au_url : auのクリック先URLを指定する。指定しない場合はデフォルトで「http://」になります。

softbank_url : Softbankのクリック先URLを指定する。指定しない場合はデフォルトで「http://」になります。

docomo_url : DoCoMoのクリック先URLを指定する。指定しない場合はデフォルトで「http://」になります。

others_url : その他のキャリアのクリック先URLを指定する。指定しない場合はデフォルトで「http://」になります。

start_date : 広告の配信開始日(yyyy/MM/dd)。

start_hour : 広告の配信開始時刻(hh)。start_dateを指定して、このパラメータを指定しない場合は、00(0時)が設定されたことになります。

end_date : 広告の配信終了日(yyyy/MM/dd)。

end_hour : 広告の配信終了時刻(hh)。end_dateを指定して、このパラメータを指定しない場合は、00(0時)が設定されたことになります。

[戻り値]
ad:
ad-id : 作成したクリエイティブのID。

ad-type : 作成したクリエイティブの種類。「104」で固定。

アニメーション広告を作成する


[URL]
キャンペーンへ追加する場合 : http://api.adlantis.jp/api/mobile/campaign/create_ad
デフォルトの自社広告を作成する場合 : http://api.adlantis.jp/api/mobile/zone/default_ad/create

画像フォーマット : GIF

[メソッド]
POST

[引数]
campaign_id[※] : キャンペーンID。キャンペーンにクリエイティブを追加する場合は必須。

ad_type[※] : 広告の種類。「105」で固定。

zone_ids : クリエイティブを登録する広告枠ID。カンマ区切りで複数指定可能。キャンペーンへクリエイティブを追加する場合は必須。

zone_id : 広告枠ID。デフォルトの自社広告を作成する場合には必須。

external_image_flg : 画像をアップロードするか、外部画像URLを指定するか決める。
  • 0 : 画像をアップロードする。
  • 1 : 外部画像URLを指定する。
banner_image : バナーの画像ソースファイルへのパス。画像をアップロードするexternal_image_flgが0の)場合は必須。

external_image_url : 画像の外部URL。外部画像URLを指定する(external_image_flgが0の)場合は必須

alt
[※]: 画像が表示できないときの代替テキスト。

name : 広告名。

priority_flg : 配信優先度の設定。
  • 0 : 優先度を指定して配信する。
  • 1 : AdLantisによる自動化配信。
priority_order : 配信の優先度設定。1 〜 5までの数値を指定する。優先度を指定して配信する設定(priority_flg = 0)のみ有効。
    指定しない場合は5が設定される。


has_title_link[※] : タイトルに対してリンクを貼るかどうか指定する。
    has_title_link若しくはhas_text_linkは少なくとも片方はtrueでなければならない。
  • true : タイトルに対してリンクを貼る。
  • false : タイトルに対してリンクを貼らない。
has_text_link[※] : 本文に対してリンクを貼るかどうか指定する。
    has_title_link 若しくはhas_text_linkは少なくとも片方はtrueでなければならない。
  • true : 本文に対してリンクを貼る。
  • false : 本文に対してリンクを貼らない。
allow_au : auに対して配信するかどうか。
    配信比率を指定しない広告の場合は必須。そうでない場合は広告枠の指定が優先される。
  • true : auに対して配信する。
  • false : auに対して配信しない
allow_softbank : Softbankに対して配信するかどうか。
    配信比率を指定しない広告の場合は必須。そうでない場合は広告枠の指定が優先される。

  • true : Softbankに対して配信する。
  • false : Softbankに対して配信しない
allow_docomo : DoCoMoに対して配信するかどうか。
    配信比率を指定しない広告の場合は必須。そうでない場合は広告枠の指定が優先される。

  • true : DoCoMoに対して配信する。
  • false : DoCoMoに対して配信しない
allow_others : その他のキャリアに対して配信するかどうか。
    配信比率を指定しない広告の場合は必須。そうでない場合は広告枠の指定が優先される。

  • true : その他のキャリアに対して配信する。
  • false : その他のキャリアに対して配信しない
au_url : auのクリック先URLを指定する。指定しない場合はデフォルトで「http://」になります。

softbank_url : Softbankのクリック先URLを指定する。指定しない場合はデフォルトで「http://」になります。

docomo_url : DoCoMoのクリック先URLを指定する。指定しない場合はデフォルトで「http://」になります。

others_url : その他のキャリアのクリック先URLを指定する。指定しない場合はデフォルトで「http://」になります。

start_date : 広告の配信開始日(yyyy/MM/dd)。

start_hour : 広告の配信開始時刻(hh)。start_dateを指定して、このパラメータを指定しない場合は、00(0時)が設定されたことになります。

end_date : 広告の配信終了日(yyyy/MM/dd)。

end_hour : 広告の配信終了時刻(hh)。end_dateを指定して、このパラメータを指定しない場合は、00(0時)が設定されたことになります。

[戻り値]
ad:
ad-id : 作成したクリエイティブのID。

ad-type : 作成したクリエイティブの種類。「105」で固定。

HTML広告を作成する


[URL]
キャンペーンへ追加する場合 : http://api.adlantis.jp/api/mobile/campaign/create_ad
デフォルトの自社広告を作成する場合 : http://api.adlantis.jp/api/mobile/zone/default_ad/create


[メソッド]
POST

[引数]
campaign_id[※] : キャンペーンID。キャンペーンにクリエイティブを追加する場合は必須。

ad_type[※] : 広告の種類。「109」で固定。

zone_ids : クリエイティブを登録する広告枠ID。カンマ区切りで複数指定可能。キャンペーンへクリエイティブを追加する場合は必須。

zone_id : 広告枠ID。デフォルトの自社広告を作成する場合には必須。

code
[※] : Htmlコード
              絵文字の入力が可能です。指定方法は1. 定数一覧 を参照してください。  
name : 広告名。

priority_flg : 配信優先度の設定。
  • 0 : 優先度を指定して配信する。
  • 1 : AdLantisによる自動化配信。
priority_order : 配信の優先度設定。1 〜 5までの数値を指定する。優先度を指定して配信する設定(priority_flg = 0)のみ有効。
    指定しない場合は5が設定される。


has_title_link[※] : タイトルに対してリンクを貼るかどうか指定する。
    has_title_link若しくはhas_text_linkは少なくとも片方はtrueでなければならない。
  • true : タイトルに対してリンクを貼る。
  • false : タイトルに対してリンクを貼らない。
has_text_link[※] : 本文に対してリンクを貼るかどうか指定する。
    has_title_link 若しくはhas_text_linkは少なくとも片方はtrueでなければならない。
  • true : 本文に対してリンクを貼る。
  • false : 本文に対してリンクを貼らない。
allow_au : auに対して配信するかどうか。
    配信比率を指定しない広告の場合は必須。そうでない場合は広告枠の指定が優先される。
  • true : auに対して配信する。
  • false : auに対して配信しない
allow_softbank : Softbankに対して配信するかどうか。
    配信比率を指定しない広告の場合は必須。そうでな い場合は広告枠の指定が優先される。

  • true : Softbankに対して配信する。
  • false : Softbankに対して配信しない
allow_docomo : DoCoMoに対して配信するかどうか。
    配信比率を指定しない広告の場合は必須。そうでない場合は広告枠の指定が優先される。

  • true : DoCoMoに対して配信する。
  • false : DoCoMoに対して配信しない
allow_others : その他のキャリアに対して配信するかどうか。
    配信比率を指定しない広告の場合は必須。そうでない場合は広告枠の指定が優先される。

  • true : その他のキャリアに対して配信する。
  • false : その他のキャリアに対して配信しない
au_url : auのクリック先URLを指定する。指定しない場合はデフォルトで「http://」になります。

softbank_url : Softbankのクリック先URLを指定する。指定しない場合はデフォルトで「http://」になります。

docomo_url : DoCoMoのクリック先URLを指定する。指定しない場合はデフォルトで「http://」になります。

others_url : その他のキャリアのクリック先URLを指定する。指定しない場合はデフォルトで「http://」になります。

start_date : 広告の配信開始日(yyyy/MM/dd)。

start_hour : 広告の配信開始時刻(hh)。start_dateを指定して、このパラメータを指定しない場合は、00(0時)が設定されたことになります。

end_date : 広告の配信終了日(yyyy/MM/dd)。

end_hour : 広告の配信終了時刻(hh)。end_dateを指定して、このパラメータを指定しない場合は、00(0時)が設定されたことになります。

[戻り値]
ad:
ad-id : 作成したクリエイティブのID。

ad-type : 作成したクリエイティブの種類。「109」で固定。



Comments