文档

Unity Offerwall

Offerwall Android SDK

Offerwall iOS SDK

Offerwall Unity SDK

Unity Offerwall

内容管理

使用 Tapjoy Offerwall Reporting API 有效管理您的 Offerwall 配置，例如您的应用、内容卡片、广告位和虚拟货币。
阅读时间6 分钟最后更新于 25 天前
Reporting API 可用于管理内容并查看事件和广告集的配置详细信息。

先决条件

您必须通过 API 的身份验证。请参阅 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 卡片设置。
参考：createPlacementsAndContents 变更
以下突变将为指定 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    }  }}