Pull API ローデータの使用

URIテンプレートについて

• 管理画面から確認できるURIテンプレートには、アプリIDとレポートタイプが既に入力されています。
• APIトークンとレポート期間（from/to）用のプレースホルダが含まれていますので、それらを編集する必要があります。
• URIのクエスションマーク（?）より右側の部分は、パラメータを含んでいます。各パラメータはアンパサンド（&）で始まります。 パラメータは、フィルタの設定、追加フィールドの追加、通貨やタイムゾーンの指定に使用されます。例えば、ローデータレポートで特定のメディアソースを指定（フィルタリング）する場合、「media_source」パラメータを使います： &media_source=facebook
• Pull API の理解を深めるには、次のチュートリアルを実行してください。

初めてPull APIを使用する際のチュートリアル

• 管理者に管理画面で確認できる Pull APIトークン についてお問い合わせください。

管理画面からレポートをダウンロードするには：

1. [インテグレーション] > [APIアクセス] へ進みます。
   APIアクセスページが開きます。
2. レポートタイプを選択します。例えば、[ローデータレポート] > [リターゲティングコンバージョン]
   URIテンプレートが表示されます。 
3. クリックしてURIをコピーします。
4. ブラウザの新しいタブを開き、URIを貼り付けます。
5. URIを編集します：
   1. トークンプレースホルダを、管理者から提供されたPull APIトークンに置き換えます。
      例：次のようにトークンプレースホルダを置き換えます。 &api_token=12345678-1234-1234-1234-123456789012. 注意！ スペースや点等は含みません。
   2. from/to プレースホルダを日付に置き換えます。
      例： &from=2020-01-20&to=2020-01-31 注意！スペースは含みません。「&」を削除しないでください。 
6. EnterキーをクリックしてAPIコールを送ります。 
   レポートがダウンロードされます。

Protect360ローデータガイドを参照してください。

結果が最大値を超えた場合は、時間と分を使用してレポートを分割します。 以下を適用してください：

• from/to: yyyy-mm-dd hh:mm 
• from: 
  • 日付のみ = 選択した日付の開始（00:00）から
  • 日付と時刻 = 00:00以降
• パラメータ to: 
  • 日付のみ = 選択した日付の終了（24:00）まで
  • 日付と時刻 = 表示する時刻まで（ただしその時刻を含まない）

例： あるアプリでは全メディアソースから、1日に30万件のインストールがあります。100万行の制限を解決するために、アプリ所有者は一日を12時間のURIコールに分割します。その方法について次の表を参照してください。 

新しい項目がインポートおよび取り込みプロセスに影響を与えないように、レポート項目はデフォルトの項目リストには追加されません。 additional_fields パラメータを使用して、デフォルト以外の項目を取得してください。

• 項目は一度のみ記載します。
• 利用できる項目リスト をご覧ください。
• いくつかのURIの例には、追加項目が含まれます。必要に応じて、さらに項目を追加します。 
• 例: additional_fields=device_download_time,deeplink_url
• 次の表に示す項目の結果は、常に返されます。

https://hq.appsflyer.com/export/<APP ID HERE>/installs_report/v5?
        api_token=<API TOKEN HERE>&from=yyyy-mm-dd&to=yyyy-mm-dd
        &additional_fields=device_download_time,deeplink_url

ローデータ： API V4は引き続き利用可能です。ファイル形式とヘッダーに変更はありません。