【PayPalで楽アフィリエイト】 オンラインマニュアル

最新バージョンについて

現在の最新バージョンは2.25です。このページのマニュアルも2.25のものです。
2017-2018年PayPalのセキュリティ計画へ対応済みです。

動作環境

  • PayPalのビジネスアカウントかプレミアアカウント(いずれもクレジットカードが必要)が必須です。
  • PayPalの【ウェブ ペイメント スタンダード-今すぐ購入ボタン】、【Express Checkout(単品のみ対応)】で購入できるWebでの単体商品販売のみ対応しています。 【ショッピングカート】や【購読と定期支払い】などの他の決済には対応していません。
  • 決済タイプは、PayPalのクレジットでの支払いとPayPal残高送金にのみ対応しています。
  • CGI版PHPバージョン7がインストールされているサーバーで動作します。スクリプト版では動作しません。確認はバージョン7.2.8で行っています。 詳しくは【インストール前のPHP調査-PHP版の確認】を参照してください。
  • 通常モード(safeモードでない)のPHPで動かされることをお勧めします。セーフモードでも動きますが一部の機能が制限されます。 詳しくは【インストール前のPHP調査-PHPモードの確認】を参照してください。
  • アフィリエイト報酬の支払いを自動化する場合は、お使いのPayPalアカウントで一括支払(マスペイ)が利用できることが必須です。 この場合、報酬支払い先はPayPalになります。アフィリエイターはPayPalに会員登録が必須になり、PayPalで報酬支払を受けることになります。
  • 楽天銀行の【WEB-FB総合振込】用振込予約csvの出力の自動化、一括支払での支払いを自動化する場合は、お使いのサーバーでcronなどの自動実行機能が利用できる必要があります。
    楽天銀行の【WEB-FB総合振込】については、 法人用総合振込個人事業主用総合振込 などをご参照ください。ご質問も楽天銀行へお願いします。
  • 管理画面はGoogle Chromeで動作確認しています。

2016-2017年PayPalのセキュリティ計画への対応チェック

  1. 付属の【phpinfo.php】をサーバーにアップロードします。
  2. ブラウザからアクセスします。
  3. 【PayPal接続結果】が【PayPal_Connection_OKbool(true)】なら対応しています。
対応してない場合、お使いのサーバーを対応させる必要があります。方法についてはお使いのサーバー管理会社に問い合わせてください。
2016-2017年PayPalのセキュリティ計画への対応について-お使いのサーバーの対応状況の確認も合わせてご覧ください。

インストール前のPHP調査

PHPバージョンの確認

【PayPalで楽アフィリエイト】は、CGI版 PHP バージョン7で動作します。 PHP バージョン5でも動作しますが、できればPHP バージョン7で動かしてください。
  1. 付属の【phpinfo.php】をサーバーにアップロードします。
  2. ブラウザからアクセスします。
  3. 【PHP Version】の項目です。7.x.xx(xは任意の数字)ならバージョン7です。
サーバーによっては、ディレクトリごとにバージョンを切り替えることもできます。
バージョン7以外のPHPでコーディングされた他のソフトウェアを動かしておられる場合は、ディレクトリごとにバージョンを切り替えて運用されることをお勧めします。 バージョンの変更方法やディレクトリごとのバージョンの変更ができるかどうかは、お使いのサーバーのマニュアルをご覧いただくか、サーバー管理会社に問い合わせてください。

PHP版の確認

サーバー、あるいは同じサーバーでもアカウントによってCGI版のPHPが動いていたり、スクリプト版のPHPが動いていたりすることがあります。 お使いの環境で何のPHPが動いているか分からない場合は、次の要領でチェックしてください。

  1. 付属の【phpinfo.php】をサーバーにアップロードします。
  2. ブラウザからアクセスします。
  3. 【Server API】に【CGI】の文字が含まれていればCGI版が動いています。この場合はそのままインストールできます。
    【Server API】が【CGI】以外の場合は、PHPをCGIとして動かす設定が必要になります。
    主なサーバーの設定方法は付属の【各サーバー設定法.txt】をご覧ください。 これ以外のサーバーの場合は、各サーバーのマニュアルをご覧いただくか、レンタルサーバー会社に問い合わせてください。 設定ファイル1つでCGI版PHPが動く場合もありますし、全く動かない場合もあります。

PHPモードの確認

  1. 付属の【phpinfo.php】をサーバーにアップロードします。
  2. ブラウザからアクセスします。
  3. 【safe_mode】が【Off】になっていれば通常モードで動いています。この場合はそのままインストールできます。
    【safe_mode】が【On】になっている場合は通常モードで動かす必要があります。
    レンタルサーバーの管理画面からモードを変更できる場合があります。 詳しくは、各サーバーのマニュアルをご覧いただくか、レンタルサーバー会社に問い合わせてください。
    また、【php.ini】が使えるサーバーでは、【php.ini】の設定を変えると通常モードで動かすことができる場合があります。 【php.ini】に【safe_mode=false】を書き加えてサーバーにアップロードしてください。【php.ini】は【.php】ディレクトリにある場合が多いです。

インストール

ここでは仮に【sample.desu】ディレクトリに、【ppaff】ディレクトリを作成してインストールするとします。
実際には、【sample.desu】はご自分の環境のディレクトリへ置き換えて見ていただき、【ppaff】はお好きなディレクトリ名にしてください。

  1. ダウンロードしたファイル【PayPalAff.zip】を解凍します。
  2. FTPソフトを立ち上げて、お使いのサーバーに接続します。【PayPalで楽アフィリエイト】をインストールするディレクトリを作成します。
    ディレクトリはブラウザからアクセスが許されていて、かつPHPが動作するディレクトリの下へ作成してください。 具体的にどのディレクトリの下へ作成したらよいかはサーバーによって違いますので、各サーバーのマニュアルをご覧ください。 PHPやCGIを設置するディレクトリとして説明されているはずです。
  3. もしインストール前のPHP調査がまだの場合、【ppaff】ディレクトリに対してPHPバージョンの確認PHPモードの確認PHP版の確認を行い、動作環境を整えてください。
  4. 【ppaff】ディレクトリに、解凍したファイルのうち、【ppaff】ディレクトリ以下の全てのファイルとディレクトリをアップロードします。
    お使いのPCによっては、【dlpage】、【typage】の2つのディレクトリと、【admin】の下にある【bk】、【body】、【data】、【log】の4つのディレクトリが、解凍されないことがあります。 その場合は、FTPソフトからこれら6つのディレクトリを作成してください。

  5. 【dlpage】、【typage】と【admin】の下にある【bk】、【body】、【data】、【log】の6つのディレクトリのパーミッションを【700】に設定します。 もし【700】で動かないようなら【704】や【705】に設定してみてください。

バージョンアップ

バージョンアップは決済の少ない時間帯に行われることをお勧めいたします。

バージョンの表記とバージョンアップについて

ソフトウェアのバージョンは通常【1.2.03.04】のように表示し、【メジャーバージョン.マイナーバージョン.リビジョン.ビルド】を表します。
  • メジャーバージョン:根本的な変更
  • マイナーバージョン:大幅な仕様変更・機能追加
  • リビジョン:仕様変更・機能追加
  • ビルド:修正パッチ
ですが【PayPalで楽アフィリエイト】ではそこまで厳密に表記していません。 メジャーバージョンとマイナーバージョン、リビジョンとビルドをそれぞれ一緒に表記しているイメージです。
例えばバージョン1.02の場合、1がメジャーバージョンとマイナーバージョン(以下メジャーバージョン)、02がリビジョンとビルド(以下リビジョン)となります。
  • メジャーバージョンが同じ場合
    リビジョンの番号が最新(最大)の物でバージョンアップしてください。最新のリビジョンに過去の変更分が全て含まれています (迷われないように最新のリビジョンしかダウンロードできないようにしております)。
    ex.) 最新バージョンが1.09で1.02をお使いの場合、1.09をダウンロード、バージョンアップしてください。
    負担が少なく、間違いも少ないと考えられるバージョンアップ方法を2つ記載しておきます。
    それぞれメリット・デメリットがありますので、ご自身に合う方法を選択してください。
    載せている2つの方法が絶対ではありませんので、ご自身のやりやすい方法でバージョンアップしてください。
  • メジャーバージョンが異なる場合
    新バージョンご購入時あるいはお手続き時にメールでご案内している方法と、ダウンロード画面の説明をご参照ください。

現在インストールしているシステムファイルを上書きしてバージョンアップ

  • メリット
    基本的には新しいバージョンのファイルをサーバーに上書きアップロードするだけなので簡単です。
  • デメリット
    新しいバージョンが動かなかった場合、元のバージョンに戻すのにやや時間がかかる上、本当に元に戻ったか確認するのも手間がかかります。

  1. ご購入時にメールでお知らせいたしましたダウンロードページから、最新バージョンのファイルをダウンロードし、解凍します。
  2. FTPソフトを立ち上げて、【PayPalで楽アフィリエイト】をインストールしたサーバーに接続します。
  3. バックアップのため、サーバーの【ppaff】ディレクトリのファイルをローカルにダウンロードします。
    特に【admin】ディレクトリにある、作成した商品IDのディレクトリは確実にバックアップしてください。
    古いバージョンの【PayPalAff.zip】も、新しいバージョンが正常に動いていることが確認できるまで消さずに取っておいてください。
  4. 【ppaff】ディレクトリに、新しいバージョンのファイルをアップロードします。
    インストール時に、【rakutencsv.php】、【reward.php】、【masspay.php】の先頭のPHPのパスを変更した場合は、インストール時と同様にパスを変更してからアップロードしてください。
  5. もし動作しない場合は、ローカルにバックアップしたファイルの内、PHP、Javascriptなどの実行ファイルをサーバーに書き戻してください。
    書き戻すのはPHP(拡張子php)、Javascript(拡張子js)などの実行ファイルのみです。データファイル(拡張子csv、txt、htmlなど)は書き戻さないでください。 サーバーのデータファイルの方が新しい場合、データファイルを書き戻してしまうとデータが古くなってしまいます。
    書き戻すのは、
    ・ppaffディレクトリ下のファイル(affsoftname.txtは除く)
    ・ppaff/adminディレクトリ下のファイル
    ・ppaff/admin/classディレクトリ下のファイル
    ・ppaff/admin/class/processディレクトリ下のファイル
    ・ppaff/class ディレクトリ下のファイル
    ・ppaff/class/processディレクトリ下のファイル
    です。
    ディレクトリ構造に【PayPalで楽アフィリエイト】のディレクトリ構造があります。)

新旧を切り替えてバージョンアップ

  • メリット
    新しいバージョンが動かなかった場合、ディレクトリ名の変更だけで元のバージョンに戻すことができます。
  • デメリット
    新しいバージョンをインストールして、パーミッションなどを設定しないといけないので手間がかかります。

沢山手順がありますが大まかな流れは、
古いバージョンのファイル群をサーバーにコピーしてパーミッションなどを設定、
片方だけバージョンアップ、
になります。
  1. ご購入時にメールでお知らせいたしましたダウンロードページから、最新バージョンのファイルをダウンロードし、解凍します。
  2. FTPソフトを立ち上げて、【PayPalで楽アフィリエイト】をインストールしているサーバーに接続します。
  3. 【PayPalで楽アフィリエイト】をインストールしているディレクトリ【ppaff】と同じ階層に【ppaff_new】ディレクトリを作成します。
  4. サーバーの【ppaff】下の全ディレクトリと全ファイルをローカルにダウンロードします。
  5. 【ppaff_new】ディレクトリへ、ダウンロードした全ディレクトリと全ファイルをアップロードします。
    ここまでの作業で、【ppaff】のファイルとディレクトリを丸ごと【ppaff_new】へコピーしています。
  6. 【ppaff】にPHPをCGIで動かすといったPHPの設定やサーバーの設定をしている場合は、【ppaff_new】にも設定してください。
  7. 【ppaff_new】のディレクトリとファイルのパーミッションを、【ppaff】と同じに設定します。
    ディレクトリは【700】に、ファイルは【600】になっているはずです。
    ここまでの作業で、【ppaff】と【ppaff_new】ディレクトリが全く同じになっているはずです。
  8. 【ppaff_new】に解凍した新しいバージョンのファイルをアップロードします。
  9. 【ppaff_new】へログインし、ライセンス登録の項目を確認してください。
    インストールURLは【ppaff_new】ではなく、【ppaff】で設定してください。
  10. ざっとでいいので、動作を確認してください。
    動いているようなら 【ppaff】を【ppaff_old】に、【ppaff_new】を【ppaff】に変更します。
  11. これで新しいバージョンに切り替わりますので、正しく動くかきちんと確認してください。
    もし正常に動かない場合は、【ppaff】を【ppaff_new】へ、【ppaff_old】を【ppaff】に変更すれば、元に戻すことができます。
  12. もし作業の途中で決済があった場合や、動かなくて【ppaff_old】と【ppaff_new】を切り替えながら決済を通した場合、データファイルの同期も行ってください。
    データファイルは
    ・admin/dataディレクトリ下のファイル
    ・admin/各商品IDのディレクトリ下のディレクトリとファイル
    になります。

他サーバーや他ドメインへの移転

  1. インストール前のPHP調査に従い、移転先サーバーのPHPバージョンの確認PHPモードの確認PHP版の確認を行います。
    CGI版PHPを動かす設定は最初に行ってください。【PayPalで楽アフィリエイト】を動かした後での変更はできません。 順番を間違えると動かなくなることがあります。順番を間違えて動かなくなってしまった場合は、再インストールしてください。
  2. 移転元サーバーの【PayPalで楽アフィリエイト】をローカルにダウンロードします。
  3. インストールの2~3に従い、移転先サーバーに移転元からダウンロードした【PayPalで楽アフィリエイト】をアップロードします。
  4. ご購入時にメールでお知らせいたしましたダウンロードページから、【PayPalで楽アフィリエイト】の最新バージョンをダウンロードし、解凍します。
  5. 最新バージョンを移転先サーバーへアップロードします。
  6. 移転先サーバーのディレクトリとファイルのパーミッションを、移転元サーバーのそれらと同じに設定します。
    ディレクトリは【700】に、ファイルは【600】になっているはずです。
    もし動かないようでしたら、移転先のサーバーに合わせて値を変えてみてください。
  7. URLが変わっている場合は次の3つを行ってください。
    移転先サーバーの【PayPalで楽アフィリエイト】にログインし、【アフィリエイト編集】-【PayPalで楽アフィリエイトのURL】を変更してください。
    購入ボタンを作り直してください。
    PayPalにログインし、一括支払い【IPN通知の設定】の【通知URL】を、新しいURLに変更してください。
  8. 移転先サーバーで【PayPalで楽アフィリエイト】が安定して動作していることが確認できたら、移転元の【PayPalで楽アフィリエイト】をアンインストールします。

個別サポート

どうしてもインストールができない、cronの設定がわからない、バージョンアップができない、サーバー移転をして欲しい、などお困りになった場合は、 個別サポートも行っています。

データ構造

ディレクトリ構造

ルート
  └各種ファイル ・・・ PHPなどの実行用ファイル
  └admin
    └各種ファイル ・・・ 管理画面用PHPなどの実行用ファイル
    └class
      └各種ファイル ・・・ PHPの実行用ファイル
      └process ・・・ PHPの実行用ファイル
    └bk ・・・ バックアップディレクトリ
    └body ・・・ メール本文・添付ファイルディレクトリ
    └data ・・・ 各種データディレクトリ
    └log ・・・ ログディレクトリ
    └商品IDのディレクトリ
      └bk ・・・ 各商品のバックアップディレクトリ
      └body ・・・ 各商品のメール本文・添付ファイルディレクトリ
      └data ・・・ 各商品の各種データディレクトリ
      └log ・・・ 各商品のログディレクトリ
  └class
    └各種ファイル ・・・ PHPの実行用ファイル
    └process ・・・ PHPの実行用ファイル
  └dlpage
    └商品名のディレクトリ ・・・ 各商品のダウンロードページディレクトリ
  └typage ・・・ サンキューページディレクトリ
目次 インストール ログイン 商品登録 決済時 セールスページ
アフィリエイター登録 アフィリエイター編集 成約確認 支払実行 置換
クーポン テスト データの確認 アフィリエイター画面