コンテンツ管理
Tapjoy Offerwall Reporting API を使用して、アプリ、コンテンツカード、プレースメント、ゲーム内通貨などの Offerwall の設定を効率的に管理できます。
読み終わるまでの所要時間 9 分最終更新 7日前
Reporting API を使用して、コンテンツを管理し、イベントと広告セットの設定の詳細を確認できます。
前提条件
API を使用して認証する必要があります。API の認証 を参照してください。
- Reporting API によるレポートデータの取得については、Reporting API - パブリッシャー を参照してください。
- Reporting API のエラー処理と制限事項については、Reporting API のベストプラクティス を参照してください。
アプリの管理
アプリの追加
これは、Offerwallで収益化するアプリケーションです。ダッシュボードでアプリを追加することもできます。詳細については、Offerwall 設定ガイド を参照してください。
注
このステップを実行するために、アプリがアプリストアや Google Play ストアで公開されている必要はありません (storeUrl パラメーターは任意です)。
参照情報: createPublisherApp ミューテーション
以下の変異により、ストア URL ありとなしで新しいパブリッシャーアプリケーションが作成されます。
mutation createPublisherAppWithStoreUrl { createPublisherApp(input: { name: "App Created With Store URL", platform: ANDROID, storeUrl: "https://play.google.com/store/apps/details?id=com.tapjoy.tapout&gl=us", orientation: PORTRAIT }) { app { id name timezone realWorldCurrency } }}mutation createPublisherAppWithoutStoreUrl { createPublisherApp(input: { name: "App Created WithOUT Store URL", platform: ANDROID, orientation: PORTRAIT, currency: KRW, timezone: TOKYO_SEOUL }) { app { id name timezone realWorldCurrency } }}
アプリとプレースメント情報の検索
プレースメント ID、コンテンツ、説明など、アプリのプレースメント情報を確認します。
参照情報: Publisher#apps フィールド、PublisherApp タイプ
以下のクエリは、最大 50 個のアプリケーションとその ID、名前、および関連する配置の詳細を返します。
query { publisher{ apps(first: 50){ edges{ node{ id name placements{ id name mediationName } } } pageInfo { endCursor hasNextPage } } }}
反応は、アプリケーションとそのプレースメントのリストと、使用可能な結果が多いかどうかを示すページ処理情報を返します。
{ "data": { "publisher": { "apps": { "edges": [ { "node": { "id": "00000000-0000-0000-0000-000000000000", "name": "XXX YYY ZZZ", "placements": [ { "id": "00000000-0000-0000-0000-000000000000", "name": "XXX YYY ZZZ", "mediationName": null }, { "id": "00000000-0000-0000-0000-000000000000", "name": "XXX YYY ZZZ", "mediationName": null }, { "id": "00000000-0000-0000-0000-000000000000", "name": "XXX YYY ZZZ", "mediationName": "ironsource" }, { "id": "00000000-0000-0000-0000-000000000000", "name": "XXX YYY ZZZ", "mediationName": null } ] } }, { "node": { "id": "00000000-0000-0000-0000-000000000000", "name": "XXX YYY ZZZ", "placements": [] } } ], "pageInfo": { "endCursor": "Mg", "hasNextPage": true } } } }}
特定のアプリ ID のプレースメント情報の検索
参照情報: Publisher#placements フィールド、Placement タイプ
以下のクエリは、ID、名前、メディエーション名など、特定のアプリケーションのすべてのプレースメントを返します。
query { publisher{ placements(appId: "00000000-0000-0000-0000-000000000000"){ id name mediationName } }}
反応は、指定されたアプリケーション用に設定されたプレースメントのリストを返します。
{ "data": { "publisher": { "placements": [ { "id": "00000000-0000-0000-0000-000000000000", "name": "AppLaunch", "mediationName": null }, { "id": "00000000-0000-0000-0000-000000000000", "name": "InsufficientCurrency", "mediationName": null }, ] } }}
プレースメントとコンテンツカードの管理
プレースメントは、アプリ内でオファーウォールを表示可能な特定のエリアです。コンテンツカードは、特定のプレースメントに表示する広告の種類を定義します。
プレースメントとコンテンツカードの作成
プレースメントとコンテンツカードはダッシュボードで作成できます。詳細については、プレースメント と Offerwall カードの設定 をそれぞれ参照してください。
参照情報: createPlacementsAndContents ミューテーション
以下の変換により、指定されたアプリケーション用の新しい配置とそれに関連付けられたコンテンツ カードが作成されます。
mutation createPlacementAndContent { createPlacementsAndContents(input: {entries: [ { appId: "<PASTE_YOUR_APP_ID_HERE>", placementName: "Placement from API" } ]}) { placements { id name description contents { id name type isSkippable } } }}
コンテンツカード設定の検索
コンテンツカード ID、タイプ、設定されている A/B テストの状態などの情報を確認できます。
参照情報: Placement#contents フィールド、ContentCard タイプ
以下のクエリは、特定のアプリケーションのすべてのプレースメントとそれらに関連するコンテンツ カードを返します。
query { publisher { placements (appId:"00000000-0000-0000-0000-000000000000") { id name contents { id name } } }}
反応は、各配置とその設定済みコンテンツ カードを返します。
{ "data": { "publisher": { "placements": [ { "id": "00000000-0000-0000-0000-000000000000", "name": "AppLaunch", "contents": [ { "id": "00000000-0000-0000-0000-000000000000", "name": "Content for AppLaunch testing by Tapjoy" }, { "id": "00000000-0000-0000-0000-000000000000", "name": "Content for testing placement by Tapjoy" } ] }, { "id": "00000000-0000-0000-0000-000000000000", "name": "InsufficientCurrency", "contents": [ { "id": "00000000-0000-0000-0000-000000000000", "name": "Content for InsufficientCurrency testing by Tapjoy" }, { "id": "00000000-0000-0000-0000-000000000000", "name": "Content for testing placement by Tapjoy" } ] } ] } }}
ゲーム内通貨の管理
Tapjoy で収益化するためにはゲーム内通貨が必要です。アプリ ID、通貨名、交換レート、成熟度を指定する必要があります。
詳細については、ゲーム内通貨の概要 を参照してください。
ゲーム内通貨の作成
API でこのアクションを実行するには、アプリ ID、通貨名、交換レート、成熟度を指定する必要があります。ダッシュボードでゲーム内通貨を作成することもできます。
参照情報: createCurrency ミューテーション
以下の変換では、指定されたアプリケーションに新しいゲーム内通貨を作成し、その為替レートと成熟度レベルを設定します。
mutation createCurrency { createCurrency(input: { appId: "<PASTE_YOUR_APP_ID_HERE>", name: "New Virtual Currency", exchangeRate: 100, maturity: MEDIUM }) { currency { id name exchangeRate initialBalance maturity } }}
ゲーム内通貨の更新
以下のミューテーションを使用してゲーム内通貨を更新することもできます。
参照情報: updateCurrency ミューテーション
以下の変換は、既存のゲーム内通貨の名前、満期レベル、および初期残高を更新します。
mutation updateCurrency { updateCurrency(input: { id: "<CURRENCY_ID>", maturity: HIGH, name: "Shell Bells", initialBalance:100 }) { currency { id name exchangeRate initialBalance maturity callbackUrl } }}