Reporting API - パブリッシャー

パブリッシャーは Tapjoy Offerwall の Reporting API にアクセスし、詳細なデータの取得、アプリのパフォーマンスの監視と評価、収益化戦略の最適化を行うことができます。

読み終わるまでの所要時間 4 分

最終更新 6日前

パブリッシャーは Reporting API を使用して、Offerwall を提供するアプリのレポートデータを取得できます。

前提条件

API を使用して認証する必要があります。API の認証を参照してください。

Reporting API を使用してコンテンツを管理する方法については、コンテンツ管理を参照してください。
Reporting API のエラー処理と制限事項については、Reporting API のベストプラクティスを参照してください。

パブリッシャーレポート指標

Reporting API を使用して、クリック数、コンバージョン数、収益合計額などの指標を含む、Offerwall コンテンツのパフォーマンスデータをリクエストできます。利用可能なパブリッシャーレポート指標はすべて、以下の表に列挙されています。パブリッシャーには、以下の基本クエリからパフォーマンス指標の取得を開始することをお勧めします。


{  publisher {    placements(appId: "00000000-0000-0000-0000-000000000000") {      id      name      insights(        timeRange: {from: "YYYY-MM-DDT00:00:00Z", until: "YYYY-MM-DDT00:00:00Z"}      ) {        timestamps        reports {          dailyUniqueViewers          earnings        }      }    }  }}

パブリッシャー指標	説明	国	アプリグループ	単一のパブリッシャーアプリ	プレースメント	すべてのパブリッシャーアプリの合計
`averageDuc`	アプリ、プレースメント、またはコンテンツカードで Offerwall 広告をコンバージョンした平均ユニークユーザー数 (ユーザーごとに 24 時間に 1 回カウント) を日数で割った値	はい	はい	はい	はい	はい
`arpdau`	1 日のアクティブユーザーあたりの平均収益 (収益合計額を 1 日のアクティブユーザー数で割った値)	はい	はい	はい	いいえ	はい
`arpduv`	1 日のユニーク Offerwall ビューアーあたりの平均収益 (収益合計額をアプリで Offerwall を表示したユニークユーザー数で割った値 (ユーザーごとに 24 時間に 1 回カウント))	はい	はい	はい	いいえ	はい
`averageDau`	1 日あたりの平均アクティブユーザー数 (ユーザーごとに 24 時間に 1 回カウント) を日数で割った値	はい	はい	はい	いいえ	はい
`averageDuv`	アプリで Offerwall を表示した平均ユニークユーザー数 (ユーザーごとに 24 時間に 1 回カウント) を日数で割った値	はい	はい	はい	いいえ	はい
`clicks`	プレースメントから発生したクリック数	はい	いいえ	いいえ	はい	いいえ
`conversions`	プレースメントから発生したコンバージョン数	はい	いいえ	いいえ	はい	いいえ
`dailyActiveUsers`	1 日あたりのアクティブユーザー数	はい	はい	はい	いいえ	はい
`dailyUniqueConversions`	このプレースメントまたはコンテンツカードから広告をコンバージョンしたユーザーの数 (ユーザーごとに 24 時間に 1 回カウント)。現在、Offerwall コンテンツカードにのみ適用されます	はい	いいえ	いいえ	はい	いいえ
`dailyUniqueOfferwallEngagements`	アプリ内の Offerwall 広告でコンバージョンしたユニークユーザー数 (ユーザーごとに 24 時間に 1 回カウント)	はい	はい	はい	いいえ	はい
`dailyUniqueOfferwallViewers`	アプリ内で Offerwall を表示したユニークユーザー数 (ユーザーごとに 24 時間に 1 回カウント)	はい	はい	はい	いいえ	はい
`dailyUniqueViewers`	このプレースメントまたはコンテンツカードで広告を表示したユニークユーザーの数 (ユーザーごとに 24 時間に 1 回カウント)。現在、Offerwall コンテンツカードにのみ適用されます	はい	いいえ	いいえ	はい	いいえ
`ducduv`	このプレースメントまたはコンテンツカードから広告をコンバージョンしたユーザーの数 (ユーザーごとに 24 時間に 1 回カウント) をこのプレースメントまたはコンテンツカードで広告を表示したユーザーの数で割った値 (ユーザーごとに 24 時間に 1 回カウント)	はい	はい	はい	はい	はい
`duvDau`	アプリ内で Offerwall を表示したユニークユーザーの数 (ユーザーごとに 24 時間に 1 回カウント) を 1 日のアクティブユーザー数で割った値	はい	はい	はい	いいえ	はい
`earnings`	獲得合計金額	はい	いいえ	いいえ	はい	いいえ
`eCPM`	収益合計額 / (開いている Offerwall の総数 / 1000)。これはドルで表されます。	はい	いいえ	いいえ	はい	いいえ
`impressions`	プレースメントから発生したインプレッション数	はい	いいえ	いいえ	はい	いいえ
`newUsers`	新規ユーザー数	はい	はい	はい	いいえ	はい
`offerwallViews`	開かれた Offerwall の総数	はい	はい	はい	いいえ	はい
`sessions`	アプリが開かれた回数	はい	はい	はい	いいえ	はい
`totalRevenue`	収益合計額	はい	はい	はい	いいえ	はい

ダッシュボードで利用可能なその他のパブリッシャー指標:

インプレッション/ビュー
コンバージョン率 (CVR)

指標のセグメント化

クエリにセグメントフィールドを追加することで、API はアプリ、プレースメント、国ごとのパフォーマンスデータを返すことができます。 Reporting API は、以下の内訳でのセグメント化に対応しています。

country
id (アプリグループ ID)
id (パブリッシャーアプリ ID)
プレースメント
platform
全パブリッシャーアプリの合計

セグメント化の例

国別のセグメント


{  publisher {    placements(appId: "00000000-0000-0000-0000-000000000000") {      id      insights(timePreset: TODAY) {        timestamps        reports {          country          dailyUniqueViewers        }      }    }  }}

アプリグループ別のセグメント


{  publisher {    apps(first: 3) {      nodes {        appGroupId        insights(timePreset: TODAY) {          reports {            dailyActiveUsers          }        }      }    }  }}

パブリッシャーアプリ別のセグメント


query {  publisher {    apps(first:3) {      edges {        node {          name          insights(timePreset:TODAY) {            reports {              dailyActiveUsers            }          }        }      }    }  }}

プレースメント別のセグメント


{  publisher{    placements(appId: "00000000-0000-0000-0000-000000000000") {      id      name      insights(timePreset: TODAY) {        reports {          impressions        }        timestamps      }    }  }}

プラットフォーム別のセグメント


{  publisher {    placements(appId: "00000000-0000-0000-0000-000000000000") {      id      insights(timePreset: TODAY) {        timestamps        reports {          platform          dailyUniqueViewers        }      }    }  }}

すべてのパブリッシャーアプリの合計

これは、このパブリッシャーの下にあるすべてのアプリについて、リクエストされた指標の総数または合計を表します。


{  publisher {    publisherAppInsights(timePreset: TODAY) {      timestamps      reports {        ecpm        totalRevenue        offerwallViews      }    }  }}

フィルタリング機能

クエリにフィルターを追加すると、API は指定されたソースからのみパフォーマンス指標を返します。Reporting API は以下のフィルタリング機能に対応しています。

appid (単一アプリ)
apps (最初または最後の x 個のアプリ)
appGroupId
content
country
platform
timePreset
timeRange

フィルタリングの例

アプリによるフィルター

これにより、結果が単一アプリに制限されます


{  publisher{    app(id: "<app ID>") {      id      name      insights(timePreset: TODAY) {        reports {          arpdau        }        timestamps      }    }  }}

複数のアプリによるフィルター

これにより、結果が最初または最後の x 個のアプリに制限されます


{  publisher {    apps(first: 3) {      nodes {        id        platform        insights {          reports {            arpdau            totalRevenue          }        }      }    }  }}

アプリグループ ID によるフィルター

これにより、結果が特定のアプリグループ ID のアプリに限定されます


{publisher {  publisherAppInsights(timePreset: TODAY, filter: {appGroupIds: ["00000000-0000-0000-0000-000000000000"]}) {    timestamps    reports {      offerwallViews      eCPM      totalRevenue    }  }

コンテンツカードによるフィルター

これにより、結果が単一のコンテンツカード ID に制限されます


{  publisher {    placements(appId: "<app ID>") {      id      name      content(id: "<content ID>") {        id        type        insights(timePreset: TODAY) {        timestamps          reports {            earnings          }        }      }    }  }}

国によるフィルター

これにより、結果が指定された地理的地域に制限されます


{publisher {  publisherAppInsights(timePreset: TODAY, filter: {countries: ["KR, US"]}) {    timestamps    reports {      offerwallViews      eCPM      totalRevenue    }  }

プラットフォームによるフィルター

これにより、結果が指定されたプラットフォームに制限されます


{publisher {  publisherAppInsights(timePreset: TODAY, filter: {platforms: [ios]}) {    timestamps    reports {      offerwallViews      eCPM      totalRevenue    }  }

プリセット期間によるフィルター

これにより、結果がプリセットされた期間に制限されます。これは相対的な時間範囲であり、クエリの実行時間によって結果が異なります。 オプション:

_LAST_30D_

、

_LAST_WEEK_

、

_TODAY_

、

_YESTERDAY_

。

注

データ集計のレベルを定義するには、timeIncrement を組み込みます。timeIncrement は

_DAILY_

、

_HOURLY_

、

_MONTHLY_

の値を取ることができます。timeIncrement はオプションのパラメーターで、デフォルトは

_ALL_

です。


{  publisher {    placements(appId: "<app ID>") {      content(id: "<content card ID>") {        insights(timePreset:LAST_30D, timeIncrement: DAILY) {        timestamps          reports {            dailyUniqueViewers          }        }      }    }  }}

絶対時間範囲によるフィルター

これにより、結果が指定された絶対時間範囲に制限されます。最大範囲は 3 か月で、サポートされる最も古い日付は過去 2 年間です。

注

データ集計のレベルを定義するには、timeIncrement を組み込みます。timeIncrement は DAILY、HOURLY、MONTHLY の値を取ることができます。timeIncrement はオプションのパラメーターで、デフォルトは ALL です。


{  publisher {    placements(appId: "<app ID>") {      content(id: "<content card ID>") {        insights(timeRange: {from: "2024-11-15T00:00:00Z", until: "2024-11-17T00:00:00Z"}, timeIncrement: DAILY) {        timestamps          reports {            dailyUniqueViewers          }        }      }    }  }}

非推奨のディメンション

以下の古いディメンションは、2025 年 2 月 3 日に Reporting API から削除されます。API クエリが、以下の太字でリストされているディメンションを 参照していない ことを確認してください。これにより、Tapjoy の Offerwall からデータを取得するときのエラーを回避できます。 Objects > ContentCard > ecpmSettings Enums > PublisherContentType:

```
ANNOUNCEMENT
```
```
DIRECT_PLAY_HOUSE_AD
```
```
FEATURED
```
```
FSI_HOUSE_AD
```
```
IAP_PROMOTION
```
```
INTERSTITIAL_VIDEO
```
```
MEDIATED_DIRECT_PLAY
```
```
MEDIATED_FSI
```
```
PREVIEW_CODE
```
```
PROGRAMMATIC_INTERSTITIAL_VIDEO
```
```
PROGRAMMATIC_REWARDED_VIDEO
```
```
REWARDED_VIDEO
```
```
TJ_RECOMMENDED
```
```
REWARD_UNLOCK
```

Input Objects >

CreatePlacementAndContentSetInput

> ecpmSettingsToAdd Input Objects >

UpdatePlacementAndContentSetInput

```
ecpmSettingsToAdd
```
```
ecpmSettingsToDelete
```
```
ecpmSettingsToUpdate
```

ドキュメント

エンジン

サービス

Grow

産業

サポート

Offerwall

収益化の開始

ユーザー獲得の開始

Unity SDK の統合

Offerwall

Reporting API - パブリッシャー

前提条件

パブリッシャーレポート指標

パブリッシャー指標

説明

国

アプリグループ

単一のパブリッシャーアプリ

プレースメント

すべてのパブリッシャーアプリの合計

指標のセグメント化

セグメント化の例

国別のセグメント

アプリグループ別のセグメント

パブリッシャーアプリ別のセグメント

プレースメント別のセグメント

プラットフォーム別のセグメント

すべてのパブリッシャーアプリの合計

フィルタリング機能

フィルタリングの例

アプリによるフィルター

複数のアプリによるフィルター

アプリグループ ID によるフィルター

コンテンツカードによるフィルター

国によるフィルター

プラットフォームによるフィルター

プリセット期間によるフィルター

絶対時間範囲によるフィルター

非推奨のディメンション