内容管理
使用 Tapjoy Offerwall Reporting API 有效管理您的 Offerwall 配置，例如您的应用、内容卡片、广告位和虚拟货币。
阅读时间6 分钟最后更新于 2 天前
Reporting API 可用于管理内容并查看事件和广告集的配置详细信息。
先决条件
您必须通过 API 的身份验证。请参阅 API 身份验证。
- 如需了解如何通过 Reporting API 获取报告数据，请参阅 Reporting API - 发行商。
- 如需了解 Reporting API 的错误处理机制和限制，请参阅 Reporting API 最佳实践。
管理应用
添加应用
这是您将通过 Offerwall 变现的应用。您还可以在后台中添加应用。如需了解更多信息，请参阅 Offerwall 设置指南。
注意
完成此步骤不要求您的应用在 App Store 或 Google Play 应用商店中上线（storeUrl 参数是可选参数）。
参考：createPublisherApp 变更
以下突变会创建一个新的发布者 app，无论有没有商店网址。
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 类型
以下查询最多返回 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 } } } }}
查找特定 App ID 的广告位信息
参考：Publisher#placements 字段、Placement 类型
以下查询返回指定的app的所有广告位，包括其 ID、名称和聚合名称。
query { publisher{ placements(appId: "00000000-0000-0000-0000-000000000000"){ id name mediationName } }}
响应返回为指定 app 配置的放置列表。
{ "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 卡片设置。
以下突变将为指定 app 创建新的放置/位置及其关联的内容卡。
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 类型
以下查询返回指定的app的所有广告位及其关联的内容卡。
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 变更
以下突变将为指定app创建新的虚拟货币，设置其速率和到期级别。
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 } }}