广告系列管理

使用 Tapjoy Reporting API 管理广告系列，包括查看和更新广告集配置、出价金额、事件设置和特定于应用的设置，从而优化广告系列效果。

阅读时间4 分钟

最后更新于 3 个月前

Reporting API 可用于管理广告系列并查看事件和广告集的配置详细信息。

先决条件

您必须按照此处的步骤通过 API 的身份验证。

如需了解如何通过 Reporting API 获取报告数据，请参阅 Reporting API - 广告主。
如需了解 Reporting API 的错误处理机制和限制，请参阅 Reporting API 最佳实践。

管理广告集

查看广告集配置的详细信息，例如出价金额、定向投放数据和广告系列状态。参考：Advertiser#adSets 字段、AdSet 类型


query {  advertiser {    adSets(first: 50) {      edges {        node {          id          bidding {            amount          }          campaign {            objective          }        }      }      pageInfo {        endCursor        hasNextPage      }    }  }}


{  "data": {    "advertiser": {      "adSets": {        "edges": [          {            "node": {              "id": "00000000-0000-0000-0000-000000000000",              "bidding": {                "amount": 0.02              },              "campaign": {                "objective": "VIEWS"              }            }          },          {            "node": {              "id": "00000000-0000-0000-0000-000000000001",              "bidding": {                "amount": 0.04              },              "campaign": {                "objective": "VIEWS"              }            }          }        ],        "pageInfo": {          "endCursor": "Mg==",          "hasNextPage": false        }      }    }  }}

更改广告集出价

注意

返回的出价金额以微单位表示（1/1,000,000 美元）。如需了解更多信息，请参阅货币标量类型文档。

参考：AdSetBiddingUpdateInput 类型


mutation {  updateAdSetBidding(input: {    id: "00000000-0000-0000-0000-000000000000",    bidding: {amount: 1000000}  }) {    bidding {      amount    }  }}


{  "data": {    "bidding": {      "amount": 1000000    }  }}

管理多重奖励事件

查看多重奖励任务的事件级别信息，包括出价金额、事件名称和事件线性度。

注意

广告集上的所有事件都将返回，无论出价金额、状态或转化次数如何。

参考：MultiRewardEngagementEvent 类型


{  adSet(id: "00000000-0000-0000-0000-000000000000") {    multiRewardEngagementSettings {      events {        eventName        eventValue        amount      }    }  }}


{  "data": {    "adSet": {      "multiRewardEngagementSettings": [        {          "events": [            {              "eventName": "level_#",              "eventValue": "5",              "amount": 0            },            {              "eventName": "level_#",              "eventValue": "10",              "amount": 480000            },            }          ]        }      ]    }  }}

创建和删除多重奖励事件

注意

创建和删除 MultiRewardEngagementEvents 的操作在单次变更中完成。您必须提供 AdSet ID 以及至少包含两个 MultiRewardEngagementEvents 的列表。要禁用事件，请添加 disable: true 属性。禁用事件时仍需要 eventName 和 eventValue 以防止意外删除。

参考：AdSetBiddingUpdateInput 类型、MultiRewardEngagementEventInput 类型


mutation {  updateAdSetBidding(    input:{      id: "00000000-0000-0000-0000-000000000000"      bidding: {        multiRewardEngagementEvents: [          {            eventName:"TUTORIAL_COMPLETE",            eventValue: "",            amount: 2200000          },          {            eventName:"LEVEL_ONE",            eventValue: "",            amount: 12200000          },          {            eventName:"LEVEL_TWO",            eventValue: "",            disable: true          }        ]      }    }  ) {    bidding {      multiRewardEngagementEvents {        eventName        eventValue        amount      }    }  }}


{  "data": {    "updateAdSetBidding": {      "bidding": {        "multiRewardEngagementEvents": [          {            "eventName": "TUTORIAL_COMPLETE",            "eventValue": "",            "amount": 2200000          },          {            "eventName": "LEVEL_ONE",            "eventValue": "",            "amount": 12200000          }        ]      }    }  }}

管理特定于应用的配置

查看在启用特定于发行商应用的竞价后多重奖励任务的事件级别信息。这种情况下将返回按发行商应用划分的事件信息，例如出价金额、事件名称和事件线性度。

注意

任何非特定于发行商应用的事件配置都将列在 null 应用下。

参考：MultiRewardEngagementEvent 类型、AppReference 类型


{  adSet(id: "00000000-0000-0000-0000-000000000000") {    multiRewardEngagementSettings {      app {        bundleId      }      events {        eventName        eventValue        amount      }    }  }}


{  "data": {    "adSet": {      "multiRewardEngagementSettings": [        {          "app": null,          "events": [            {              "eventName": "level_#",              "eventValue": "5",              "amount": 0            },            {              "eventName": "level_#",              "eventValue": "10",              "amount": 480000            },          ]        },        {          "app": {            "bundleId": "com.app.example"          },          "events": [            {              "eventName": "level_#",              "eventValue": "10",              "amount": 520000            },            {              "eventName": "level_#",              "eventValue": "30",              "amount": 1680000            },          ]        }      ]    }  }}

创建和删除每个应用的事件配置

注意

与 MultiRewardEngagementEvents 类似，创建和删除 AppBiddingGroups 的操作在单次变更中完成。您必须提供至少一个发行商 AppReference ID 以及至少包含两个 MultiRewardEngagementEvents 的列表。当转化发生在给定发行商 AppReference 中时，这些事件的金额将用于取代顶层配置的值。

要禁用某个事件或按应用出价组，请为对象添加 disable: true。禁用按应用出价组会自动禁用其子事件。禁用事件时需要 eventName 和 eventValue 以防止意外删除。参考：AdSetBiddingUpdateInput 类型、AppBiddingGroupInput 类型、MultiRewardEngagementEventInput 类型、AppReference 类型


mutation {  updateAdSetBidding(    input:{      id: "00000000-0000-0000-0000-000000000000"      bidding: {        perAppBidGroups: [{          pubAppId:"<example_publisher_app_id>"          multiRewardEngagementEvents: [            {              eventName:"TUTORIAL_COMPLETE",              eventValue: "",              amount: 5500000            },            {              eventName:"LEVEL_ONE",              eventValue: "",              disable: true,            }            ]        },        {          pubAppId:"<example_publisher_app_id_2>",          disable: true        }],        multiRewardEngagementEvents: [          {            eventName:"TUTORIAL_COMPLETE",            eventValue: "",            amount: 2200000          },          {            eventName:"LEVEL_ONE",            eventValue: "",            amount: 12200000          },          {            eventName:"LEVEL_TWO",            eventValue: "",            disable: true          }        ]      }    }  ) {    bidding {      multiRewardEngagementEvents {        eventName        eventValue        amount      }      perAppBidGroups {          pubApp {            id            name          }        }        multiRewardEngagementEvents {          eventName          eventValue          amount      }    }  }}


{  "data": {    "updateAdSetBidding": {      "bidding": {        "multiRewardEngagementEvents": [          {            "eventName": "TUTORIAL_COMPLETE",            "eventValue": "",            "amount": 2200000          },          {            "eventName":"LEVEL_ONE",            "eventValue": "",            "amount": 12200000          }        ],        "perAppBidGroups": [          {            "pubApp": {              "id": "example_publisher_app_id",              "name": "Example Publisher App"            },            "multiRewardEngagementEvents": [              {                "eventName": "TUTORIAL_COMPLETE",                "eventValue": "",                "amount": 5500000              },              {                "eventName": "LEVEL_ONE",                "eventValue": "",                "amount": 15500000              }            ]          }        ]      }    }  }}

文档

Development

User Acquisition

Monetization

工业

文档