コンテンツ管理
Tapjoy Offerwall Reporting API を使用して、アプリ、コンテンツカード、プレースメント、ゲーム内通貨などの Offerwall の設定を効率的に管理できます。
読み終わるまでの所要時間 3 分最終更新 10日前
Reporting API を使用して、コンテンツを管理し、イベントと広告セットの設定の詳細を確認できます。
前提条件
API を使用して認証する必要があります。API の認証 を参照してください。- Reporting API によるレポートデータの取得については、Reporting API - パブリッシャー を参照してください。
- Reporting API のエラー処理と制限事項については、Reporting API のベストプラクティス を参照してください。
アプリの管理
アプリの追加
これは、Offerwall で収益化するアプリです。ダッシュボードでアプリを追加することもできます。詳細については、Offerwall 設定ガイド を参照してください。注
このステップを実行するために、アプリが App Store または Google Play ストアで稼働中である必要はありません (storeUrl パラメーターは任意)。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 タイプ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 タイプ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 を表示可能な特定のエリアです。コンテンツカードは、特定のプレースメントに表示する広告の種類を定義します。プレースメントとコンテンツカードの作成
プレースメントとコンテンツカードはダッシュボードで作成できます。詳細については、プレースメント と 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 } }}