内容管理
使用 Tapjoy Offerwall Reporting API 有效管理您的 Offerwall 配置，例如您的应用、内容卡片、广告位和虚拟货币。
阅读时间4 分钟最后更新于 4 天前
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 } }}
查找应用和广告位信息
查看应用的广告位信息，例如广告位的 Placement 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 } } } }}
查找特定 App 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 进行变现，需要虚拟货币。您应该提供 App ID、货币名称、兑换比例和成熟时间点。 如需了解更多信息，请参阅虚拟货币概述。创建虚拟货币
要在 API 中执行此操作，应提供 App 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 } }}