apiご登録マニュアル ip geolocation api どこどこjp...ip geolocation database surfpoint...
TRANSCRIPT
Copyright © 2019 Geolocation Technology,Inc. All rights reserved. Page 1 of 34
APIご登録マニュアル
第 2.7版 2019年 3月 4日改訂
【履歴】
版 日 付 内 容
第 1.0版 2010年 9月 6日 初版
第 1.1版 2013年 3月 11日 改訂
第 1.2版 2015年 9月 1日 改訂
第 2.0版 2016年 2月 18日 API版のバージョンアップに伴う修正(v5)
第 2.1版 2016年 10月 24日 改訂
第 2.2版 2017年 1月 11日 改訂
第 2.3版 2017年 3月 6日 改訂
第 2.4版 2017年 6月 1日 改訂
第 2.5版 2017年 7月 11日 改訂
第 2.6版 2019年 2月 4日 改訂
第 2.7版 2019年 3月 4日 改訂
Copyright © 2019 Geolocation Technology,Inc. All rights reserved. Page 2 of 34
目次
概要 ................................................................................................................................................... 3 商標について ....................................................................................................................................... 3 お問い合わせ先 ..................................................................................................................................... 3 ご利用料金のお支払いについて ................................................................................................................. 4 APIキーの発行手順 ............................................................................................................................... 5
1. アカウントの登録 ...................................................................................................................... 5 2. メールアドレス登録 ................................................................................................................... 6 3. ワンタイムキー入力 ................................................................................................................... 7 4. ご利用ドメインの登録................................................................................................................. 8 5. ご連絡先登録 .......................................................................................................................... 10 6. 登録内容のご確認 .................................................................................................................... 11 7. APIキーご利用登録の完了 ......................................................................................................... 12
お客様向けのサービス管理画面について .................................................................................................... 13 管理画面の機能 ................................................................................................................................... 14
APIキーの管理 ................................................................................................................................ 14 APIキーの停止 ................................................................................................................................ 15 APIキー実装例の確認 ........................................................................................................................ 17 IPアドレスの復号 .........................................................................................................................1819 オプションデータ ..........................................................................................................................1919 APIキーの追加発行 ........................................................................................................................... 25 各種設定変更 ................................................................................................................................... 27 Webプロキシ ..............................................................................................................................3333 IP SURVEYOR ..............................................................................................................................3434
Copyright © 2019 Geolocation Technology,Inc. All rights reserved. Page 3 of 34
概要
どこどこ JP は、WEB サイトに訪れたユーザの IP アドレスを元にアクセス地域(国、都道府県、市区町村)、ドメイン名、
組織名、業種などのユーザ属性判定を行うサービスです。IP アドレスからアクセス地域などのユーザ属性を判定するために、
IP Geolocation Database SURFPOINT™ を利用しております。
本文書は、どこどこ JP の API をご利用いただくまでの流れについて記載しています。本文書を担当の方にご一読いただき、
本システムの特徴・注意点をご留意いただいた上でのご利用をお願いいたします。
商標について
弊社商標について
どこどこ JP、SURFPOINTは、株式会社 Geolocation Technologyの登録商標です。
他社商標について
Google および Google Analyticsは Google Inc. の登録商標です。
なお、Google Analyticsを Googleアナリティクスと記述しています。
その他記載されている製品名などの固有名詞は、各社の商標または登録商標です。
お問い合わせ先
お問い合わせは弊社Webサイトの下記フォームをご利用ください。
https://www.docodoco.jp/contact/index.html
お電話でのお問い合わせ先は下記の通りです。
株式会社 Geolocation Technology カスタマーサポートセクション
TEL :055-991-5544 FAX:055-991-5540
受付時間:午前 8時 30分~午前 12時 / 午後 1時~午後 5時 30分(土・日・祝対応)
万が一パスワードを紛失された場合は、弊社サポート窓口までご連絡をお願いいたします。
Copyright © 2019 Geolocation Technology,Inc. All rights reserved. Page 4 of 34
ご利用料金のお支払いについて
「どこどこ JP」サービスのご利用料金のお支払い方法はオンラインご利用登録の手順の中で「銀行振込」または「クレジット
カード払い」から選択していただく事ができます。
サービスご利用中のお支払い方法の確認・変更は、お客様サービス管理画面の「設定変更画面へ」にて行っていただけます。
設定方法の詳細については、本文書の「管理画面の機能 - 各種詳細設定 - お支払い方法」を参照してください。
ご利用登録日(APIキー発行日)から 14日間は無料お試し期間となり、無料お試し期間の終了日までは
無料でお使いいただけます。APIキーのご利用をキャンセルされる場合には、無料お試し期間の終了日
までに APIキーの利用停止手続きを行ってください。期日を経過すると、APIキーへの課金(ご利用料
金のご請求)を開始いたします。
(APIキーの利用停止手続きについては、本文書の「APIキーの停止」を参照してください。)
Copyright © 2019 Geolocation Technology,Inc. All rights reserved. Page 5 of 34
APIキーの発行手順
どこどこ JPを利用するために必要な APIキーの発行手順をご案内します。
o APIキー発行に関しての留意点
ご利用登録されたサイト以外で利用しようとした場合は、正常に処理されません。APIキー登録時に入力した
ドメイン名と、ご利用になろうとしているサイトのドメイン名に間違いがないかご確認ください。
1. アカウントの登録 まずは APIキーを扱うためのアカウントを取得する必要があります。
どこどこ JPのサイト(http://www.docodoco.jp/index.html)にて、ページ上部の「無料トライアル」を
クリックします。
Copyright © 2019 Geolocation Technology,Inc. All rights reserved. Page 6 of 34
「ご利用登録」ページが表示されます。
2. メールアドレス登録
「メールアドレス(ログイン ID)」、「パスワード」の入力、「利用形態」の選択、「個人情報のお取り扱い」への同
意を行い、「次へ」をクリックします。
Copyright © 2019 Geolocation Technology,Inc. All rights reserved. Page 7 of 34
3. ワンタイムキー入力 2項で入力されたメールアドレス宛に「ご利用登録のご案内」のメールが届きます。本文中にワンタイムキ
ーの記載がありますので、ご確認ください(ワンタイムキーの有効期限は 24時間ですので、ご注意くださ
い)。
メール本文に記載されている URLにアクセスし、先ほど入力されたパスワードとワンタイムキーを入力し、「次へ」
をクリックします。
Copyright © 2019 Geolocation Technology,Inc. All rights reserved. Page 8 of 34
4. ご利用ドメインの登録 「ご利用サイト URL」の入力、「ご利用目的」の選択※1,2、商用利用の方は「お支払い方法」の選択※3、
「利用規約」への同意を行い、「次へ」をクリックします。
Copyright © 2019 Geolocation Technology,Inc. All rights reserved. Page 9 of 34
Copyright © 2019 Geolocation Technology,Inc. All rights reserved. Page 10 of 34
※1:「ご利用目的」で「Googleアナリティクスとの連携」を選択したお客様は、お手数ではございますが
「Googleアナリティクス ご利用状況について」も合わせて選択をお願いします。
※2:無料お試し期間中は、リバース機能をご利用いただけません。リバース機能のご利用のお客様は、「ご利
用目的」で「無料お試し期間を利用しない」にチェックを入れると、すぐにリバース機能をご利用いただくこ
とが可能です。
※3:「お支払い方法」で「クレジットカード払い」を選択したお客様には、お手数ではございますが、お支払
に利用されるカードに関する情報の入力をお願いします。
5. ご連絡先登録 お客様の「お名前」・「所属」・「ご連絡先」・「ご請求先」・「ご請求に関する連絡先」に関する情報を
入力し、「次へ」をクリックしてください。
Copyright © 2019 Geolocation Technology,Inc. All rights reserved. Page 11 of 34
6. 登録内容のご確認 「お申込み内容」と「ご連絡先」に関する情報を確認し、「確定」をクリックします。
Copyright © 2019 Geolocation Technology,Inc. All rights reserved. Page 12 of 34
7. APIキーご利用登録の完了 以上で APIキーのご利用登録が完了します。発行した APIキー1が表示されますので、念のためメモ帳アプ
リケーションなどを使って記録をしてください。ログイン ID及びパスワードを入力し「管理画面にログイ
ン」をクリックすると、管理画面に移動します。
弊社からお客様宛に「ご利用登録完了のお知らせ」メールを送信しておりますので、あわせてご確認くださ
い。
Copyright © 2019 Geolocation Technology,Inc. All rights reserved. Page 13 of 34
お客様向けのサービス管理画面について
管理画面では、APIタグの確認のほか、利用停止や各種設定の変更などを行うことができます。ログイン ID及びパス
ワードを入力し、「ログイン」をクリックします。
Copyright © 2019 Geolocation Technology,Inc. All rights reserved. Page 14 of 34
管理画面の機能
APIキーの管理
現在までに発行されている APIキーを一覧で確認できるほか、それぞれの APIキーをご利用になっている URLをクリック
する事で、その APIキーの月ごとの「リクエスト数」、「請求書及び納品書(PDF)」、「ご請求金額」、利用している
「オプション機能」、「オプションデータ」を参照することができます。
Copyright © 2019 Geolocation Technology,Inc. All rights reserved. Page 15 of 34
APIキーの停止
ご利用中の APIキーの利用を停止するには、管理画面「ホーム」にて「FQDN/URL」のリストから停止する URLをクリック
し、「利用停止」をクリックします。
Copyright © 2019 Geolocation Technology,Inc. All rights reserved. Page 16 of 34
「利用停止」の確認メッセージが表示されますので、「はい」を選択します。
「利用停止」処理が完了すると、管理画面ホームの「FQDN/URL」のリストのアイコンが「停止済」になります。登録メー
ルアドレス宛に「利用停止完了のお知らせ」のメールが届きますので、あわせてご確認ください。
Copyright © 2019 Geolocation Technology,Inc. All rights reserved. Page 17 of 34
APIキー実装例の確認
「種類」「形式」を用途に応じてお選びいただくと、その選択に応じてタグの実装例が表示されます。
REST版のご利用をご希望の方は、カスタマーサポートセクションまでお問い合わせください。
Copyright © 2019 Geolocation Technology,Inc. All rights reserved. Page 18 of 34
IPアドレスの復号
IPアドレス暗号形式の復号は Excelの数式を用いて行います。「IPアドレスの復号」をクリックします。
入力欄に復号したいセルを入力し「数式表示」をクリックすると、復号用の数式が取得できますので、任意のセルへ貼り付
けてください。
Copyright © 2019 Geolocation Technology,Inc. All rights reserved. Page 19 of 34
オプションデータ
どこどこ JPの属性値と「オプションデータ」を紐付けることにより、さまざまなデータを利用してデータの分析やターゲ
ティングを行うことができます。
「オプションデータ」をご利用いただくには、 まず管理画面[ホーム]にて「FQDN/URL」のリストから適用する URLをク
リックし、画面下のタブメニューの「オプションデータ」タグを開きます。「オプションデータの管理」内にご利用可能な
データの一覧が表示されます。(「オプションデータ」の種類は今後も拡充する予定です。)
利用する「オプションデータ」の種類の「有効」ボタンを選択し、「適用する」ボタンをクリックします。
Copyright © 2019 Geolocation Technology,Inc. All rights reserved. Page 20 of 34
「オプションデータご利用確認」画面が表示されます。「申込み内容」「ご請求額」をご確認の上、「確定」をクリックしま
す。
【注意】
オプションデータの料金は従量課金となる場合がございます。詳しくはデータ詳細画面(後述)をご確認ください。
「確定」をクリックすると、以下の表示のように表示されます。
Copyright © 2019 Geolocation Technology,Inc. All rights reserved. Page 21 of 34
適用された「オプションデータ」の種類が表示されます。
データ名をクリックいただくと該当のデータの詳細をご確認いただけます。
以下、「法人番号関連データ」の詳細画面となります。他データにつきましては、管理画面からご確認ください。
Copyright © 2019 Geolocation Technology,Inc. All rights reserved. Page 22 of 34
Copyright © 2019 Geolocation Technology,Inc. All rights reserved. Page 23 of 34
Copyright © 2019 Geolocation Technology,Inc. All rights reserved. Page 24 of 34
サンプルの項目にて、「REST(XML)」「REST(JSON)」を選択すると、各々のレスポンスを確認することができます。
Copyright © 2019 Geolocation Technology,Inc. All rights reserved. Page 25 of 34
APIキーの追加発行
現在お使いの APIキーに加え、新たに APIキーの発行を行っていただけます。
まず管理画面「ホーム」にある、「APIキー 追加発行はこちら」をクリックします。
「APIキーの追加発行申請」にて、「利用規約に同意する」をクリックします。
Copyright © 2019 Geolocation Technology,Inc. All rights reserved. Page 26 of 34
「APIキーの追加発行申請」にて、「ご利用サイト URL」を入力、「利用目的」を選択していただき、「次へ」をクリックし
ます。
「APIキーの追加発行申請」にて、「申込み内容」及び「ご請求金額」を確認し、「確定」をクリックします。
Copyright © 2019 Geolocation Technology,Inc. All rights reserved. Page 27 of 34
各種設定変更 「アカウント設定」、「ユーザ情報」、「請求先情報」、「お支払い方法」を変更することができます。
Copyright © 2019 Geolocation Technology,Inc. All rights reserved. Page 28 of 34
・ユーザ情報
「お名前」、「所属」、「連絡先」、「ログイン ID」、「パスワード」に関する情報を変更することができます。
Copyright © 2019 Geolocation Technology,Inc. All rights reserved. Page 29 of 34
・請求先情報
「所属」、「連絡先」に関する情報を変更することができます。
Copyright © 2019 Geolocation Technology,Inc. All rights reserved. Page 30 of 34
「変更する」ボタンを押下後、請求先情報の画面に入力されたメールアドレスに以下のようなメールが届きます。メール本
文にある URLにアクセスいただき、請求先情報の確定をお願いいたします。
Copyright © 2019 Geolocation Technology,Inc. All rights reserved. Page 31 of 34
・お支払い方法
ご利用料金のお支払い方法を変更することができます。
Copyright © 2019 Geolocation Technology,Inc. All rights reserved. Page 32 of 34
※1:「お支払い方法」で「クレジットカード決済」を選択したお客様には、どこどこ JPの管理画面上で「選
択する」ボタンを押下後、ご登録いただいたメールアドレスにクレジットカード情報登録の連絡をいたしま
す。本文中にある「クレジットカード情報登録」ボタンよりクレジットカードの情報を登録ください。
※2:クレジットカードの有効期限などの更新は、お手数ですが下記メールアドレスまで変更内容をご連絡いた
だきたく存じます。
メールアドレス:[email protected] 件名:メール件名: 【どこどこ JP】クレジットカード変更依頼
Copyright © 2019 Geolocation Technology,Inc. All rights reserved. Page 33 of 34
Webプロキシ 弊社が用意している Proxyサーバを利用する事により、特定の地域からのアクセスを疑似的に再現する事ができます。管理
画面[Webプロキシ]にて、「Webプロキシ」「設定方法」を参考に、各種ブラウザで設定をしたうえでお使いください。
詳細な設定方法につきましては、実際のサイトにてご確認をお願いいたします。
また、ご利用に必要なパスワードは月末に変更されます。
最新の情報は管理画面[Webプロキシ]に掲載されますので、ご利用の際には必ずご確認をお願いいたしま
す。
Copyright © 2019 Geolocation Technology,Inc. All rights reserved. Page 34 of 34
IP SURVEYOR IPアドレスリストに対して地域情報や、組織情報を付与することができるWindows用デスクトップツールをダウンロード
してご利用いただけます。