概要:このAPIを使用して、CSVファイルでローデータレポートを取得できます。
Pull API ローデータ
- Pull APIを使用すると、ローデータレポートをCSVファイルで取得できますローデータレポートの詳細はこちら
- 利用可能なオプションでフィルター:メディアソース、日付範囲、アプリ内イベント名、地域。
- Pull APIの追加機能は次のとおりです:
- 通貨を選択
- タイムゾーンを選択
Pull API経由で利用可能なローデータレポート
| レポート | 説明 | 更新頻度 |
|---|---|---|
| ローデータレポート(非オーガニック) | ||
| インストール | 非オーガニックインストールを記録します。ユーザーがアプリを初回起動した際に記録が生成されます。 | リアルタイム |
| アプリ内イベント | ユーザーが実行したイベントを記録します。 | リアルタイム |
| アンインストール | ユーザーがアプリをアンインストールしたときに記録します。 | 毎日 |
| 再インストール | アプリをアンインストールした後に、UAメディアソースと接触し、再アトリビューション期間中にアプリを再インストールしたユーザーを記録します。 | リアルタイム |
| ローデータレポート(オーガニック) | ||
| オーガニックインストール | ユーザーが初めてアプリを起動したときに記録します。 | 継続的 |
| オーガニックアプリ内イベント | ユーザーが実行したイベントの詳細を記録します。 | 継続的 |
| オーガニックアンインストール | ユーザーがアプリをアンインストールした記録。 | 毎日 |
| オーガニック再インストール | リエンゲージメント期間中にリターゲティングメディアにアトリビュートされたユーザーによる広告収益を記録します。 | 毎日 |
| リターゲティング | ||
| コンバージョン | リターゲティングキャンペーンに接触した後にアプリを開いたユーザーの記録。 | リアルタイム |
| アプリ内イベント | リエンゲージメント期間中にユーザーが実行したアプリ内イベント。 | リアルタイム |
| 広告収益のローデータ | ||
| 帰属広告収益 | メディアソースに紐づくユーザーの広告収益を記録します。 | 毎日 |
| オーガニック広告収益 | メディアソースに紐づかないユーザーの広告収益を記録します。 | 毎日 |
| Protect360 不正防止 | ||
| インストール | 不正と識別されたためどのメディアソースの成果にも紐づいていないインストールを記録します。 | リアルタイム |
| アトリビューション後のインストール | 不正と識別されたため一切計測されなかったアプリ内イベントを記録します。 | リアルタイム |
| アプリ内イベント | Protect360が不正と認定したアプリ内イベントを記録します。 | 毎日 |
| アトリビューション後のアプリ内イベント | 一度メディアソースへアトリビューションされたが不正と判断されたインストールに紐づくアプリ内イベント、もしくはインストール自体に関係なく不正と判定されたアプリ内イベントを記録します。 | 毎日 |
| クリック | Protect360によりブロックされたユーザーが実行したクリックを記録します。 | 毎日 |
| ブロックされたインストールのポストバック | ブロックされたインストールと判断されたメディアソースに送信されたポストバックのコピーを記録します。 | リアルタイム |
| ポストバック | ||
| インストールポストバック | ユーザーがアプリを初回起動した際に生成されるインストールイベントを記録します。 | 毎日 |
| アプリ内イベントポストバック | メディアソースに送信されたアプリ内イベントポストバックを記録します。 | 毎日 |
| リターゲティングアプリ内イベントポストバック | リエンゲージメント期間中にユーザーが実行したアプリ内イベントを記録します。 | リアルタイム |
| リターゲティングコンバージョンのポストバック | リエンゲージメント期間中にユーザーが実行したアプリ内イベントを記録します。 | リアルタイム |
Pull API ローデータの使用
Pull APIローデータを使用するには:
-
APIトークンを取得します。管理者はトークンを取得する必要があります。
- 認証ヘッダーで使用するためにAPIトークンをデベロッパーに渡します。
- 次のセクションで説明するように、APIコールを行うときに入力するパラメーターを開発者へ渡してください。パラメーターは、レポートが何に焦点を当て、どのように編成されるかを決定し、レポートの時間枠を定義します。
- 開発者に、開発者ハブのPull APIローデータ手順に従うように伝えます。
パラメーター
| パラメータ | 説明 |
|---|---|
| 開始 |
|
| 終了 | 終了日。fromfromについて |
| media_source |
およびの両方のパラメータを次のように設定します:
|
| 最大行数 | 1回のAPI呼び出しで返される行の最大数。
|
| イベント名 |
指定したイベントでアプリ内イベントをフィルタリングします。カンマ区切りのリストで複数のイベントを選択します。 例: |
| リターゲティング | リターゲティングアトリビューションデータを設定します。
|
| 追加フィールド |
デフォルト項目に加えて追加項目を取得します。 例: |
| 通貨 |
収益と費用の通貨
例:アプリ固有の通貨がEURの場合、 |
| タイムゾーン | [デフォルト] データはUTCが使用されます。
|
| 地域 |
国コードでデータをフィルターします。 制限:API呼び出しごとに設定できる国コードのフィルターは1件のみです。 例: |
| インストール時間から |
|
| インストール時間まで | 終了日。について |
| 代理店 | 特定の代理店に通話を制限(フィルター)します。 |
Protect360の項目
時間枠の項目
APIの結果が最大値を超える場合、時間と分でレポートを分割してください。以下を適用してください:
- 開始/終了: yyyy-mm-dd hh:mm
-
開始:
- 日付のみ = 選択された日付の開始 (00:00) より
- 日付と時間 = 00:00を含む
- パラメータ まで:
- 日付のみ = 選択された日の終わり (24:00) まで
- 日付と時間 = 表示された時間まで(その時間は含まれません)
例: あるアプリの所有者は全てのソースから毎日130万件のインストールがあります。100万行の制限を解決するために、アプリ所有者は一日を12時間のURIコールに分割します。その方法について次の表を参照してください。
| API呼び出し | 開始日 | 終了日 |
|---|---|---|
| 最初のAPI呼び出し |
開始=yyyy-mm-dd 例:
|
終了=yyyy-mm-dd 12:00 例:
|
|
オプションA: 2回目のAPI呼び出し
例:
|
from=yyyy-mm-dd 12:00 例:
|
to=yyyy-mm-dd 例:
|
| オプションB:2回目のAPIコール |
from=yyyy-mm-dd 12:00 例:
|
to=yyyy-mm-dd+1 00:00 +1 = 翌日の00:00 例:
|
| 注意: オプションAまたはBのどちらかを使用してください。両者は同じ結果になります。 | ||
追加フィールド
追加のレポート項目は既定の項目の一覧に追加されないため、新しい項目が既存のインポートおよび取り込みプロセスに影響を与えることはありません。デフォルト以外のフィールドを取得するには、additional_fields パラメーターを使用します。
- 項目は一度のみ記載します。
- 利用可能なフィールドのリストをご覧ください。
- 例:
デフォルトの項目
| デフォルト Pull API 項目 |
|---|
| 属性付けタッチタイプ |
| Attributed Touch Time |
| インストール時刻 |
| Event Time |
| イベント名 |
| イベント値 |
| イベント収益 |
| Event Revenue Currency |
| イベント収益USD |
| Event source |
| Is Receipt Validated |
| パートナー |
| メディアソース |
| チャネル |
| Keywords |
| キャンペーン |
| キャンペーンID |
| 広告セット |
| 広告セットID |
| 広告 |
| 広告ID |
| 広告タイプ |
| サイトID |
| サブサイトID |
| Sub Param 1 |
| Sub Param 2 |
| Sub Param 3 |
| Sub Param 4 |
| Sub Param 5 |
| コストモデル |
| Cost Value |
| コスト通貨 |
| Contributor 1 Partner |
| Contributor 1 Media Source |
| Contributor 1 Campaign |
| Contributor 1 Touch Type |
| Contributor 1 Touch Time |
| Contributor 2 Partner |
| Contributor 2 Media Source |
| Contributor 2 Campaign |
| Contributor 2 Touch Type |
| Contributor 2 Touch Time |
| Contributor 3 Partner |
| Contributor 3 Media Source |
| Contributor 3 Campaign |
| Contributor 3 Touch Type |
| Contributor 3 Touch Time |
| 地域 |
| 国コード |
| 州 |
| 市 |
| Postal code |
| DMA |
| IP |
| WIFI |
| オペレーター |
| Carrier |
| 言語 |
| AppsFlyer ID |
| Advertising ID |
| IDFA |
| Android ID |
| Customer User ID |
| IMEI |
| IDFV |
| プラットフォーム |
| デバイスタイプ |
| OSバージョン |
| App Version |
| SDKバージョン |
| App ID |
| アプリ名 |
| バンドルID |
| リターゲティング |
| リターゲティングコンバージョンタイプ |
| Attribution Lookback |
| リエンゲージメント期間 |
| Is Primary Attribution |
| ユーザーエージェント |
| HTTPリファラー |
| 元のURL |
追加情報
特性と制限
| 特性 | 備考 |
|---|---|
| 必要なAPIトークンタイプ |
|
| アドネットワークのアクセス | いいえ |
| 代理店によるデータアクセス | はい |
| 代理店の運用媒体の開示設定 | はい。ただし、代理店フィルタとメディアソースフィルタの両方を使う場合、メディアソースフィルタは非透明な代理店に対しては適用されません。これは、非透明な代理店の場合、フィルタリングされたメディアソース以外のすべてのデータが含まれることを意味します。 |
| App-specific currency | はい |
| アプリ固有のタイムゾーン | はい |
| データ更新頻度 |
|
| 過去データ | はい。 リテンションおよびレート制限ポリシーに従います。 |
| 非オーガニックデータ | はい |
| オーガニックデータ | はい |
| レート制限 |
生データに関するAPIの制限。 |
| サイズ制限 |
|
| Install_date_fromと install_date_to | インストールの日付範囲は、アクティビティの日付範囲より前である必要があります。 |
トラブルシューティング
| 症状/メッセージ | 解決策 |
|---|---|
| 選択された設定期間に対して期待されるデータがレポートに含まれていない、またはローデータレポートと集計データレポートの間に不一致がある状況です。 |
|