上次更新时间:2024年12月11日
Reporting API可用于管理您的广告,并查看事件和广告的配置详情。
**开始之前:**您必须按照此处 的步骤使用该API进行身份验证。
查看您的广告配置详情,例如出价金额、定位数据和广告系列状态。
参考:Advertiser#adSets 字段,AdSet 类型
query {
advertiser {
adSets(first: 50) {
edges {
node {
id
bidding {
amount
}
campaign {
objective
}
}
}
pageInfo {
endCursor
hasNextPage
}
}
}
}
mutation {
updateAdSetBidding(input: {
id: "00000000-0000-0000-0000-000000000000",
bidding: {amount: 1000000}
}) {
bidding {
amount
}
}
}
{
adSet(id: "00000000-0000-0000-0000-000000000000") {
multiRewardEngagementSettings {
events {
eventName
eventValue
amount
}
}
}
}
注意:创建和删除 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
}
}
}
}
查看启用了开发者应用特定出价的多重奖励广告的事件级信息。这将返回按开发者应用划分的事件信息,例如出价金额、事件名称和事件线性。
注意:任何非开发者应用特定的事件配置都将列在空应用下。
参考:MultiRewardEngagementEvent 类型,AppReference 类型
{
adSet(id: "00000000-0000-0000-0000-000000000000") {
multiRewardEngagementSettings {
app {
bundleId
}
events {
eventName
eventValue
amount
}
}
}
}
注意:与 MultiRewardEngagementEvents 类似,创建和删除 AppBiddingGroups 只需一次更改即可完成。您必须提供至少一个开发者 AppReference ID 以及至少两个 MultiRewardEngagementEvents 的列表。当给定开发者 AppReference 内部发生转化时,这些事件的金额将代替最高层级的配置值。
要停用某个事件或per-app-bid的出价组,请向对象添加 disable: true。停用per-app-bid的出价组会自动停用其子事件。停用事件时,需要提供 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
}
}
}
}