广告管理

上次更新时间:2024年12月11日

概览

Reporting API可用于管理您的广告,并查看事件和广告的配置详情。

**开始之前:**您必须按照此处 的步骤使用该API进行身份验证。

1. 管理您的广告

查看您的广告配置详情,例如出价金额、定位数据和广告系列状态。

参考:Advertiser#adSets 字段,AdSet 类型

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

更改广告的出价

注意:返回的出价金额以微单位表示(即百万分之一美元)。更多信息,请参阅Money类型 文档

参考:AdSetBiddingUpdateInput 类型

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

2. 管理您的多重奖励事件

查看您的多重奖励优惠的事件级信息,包括出价金额、事件名称和事件线性。

注意:无论出价金额、状态或转化次数如何,广告中的所有事件都会被返回。

参考:MultiRewardEngagementEvent 类型

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

创建和删除多奖励事件

注意:创建和删除 MultiRewardEngagementEvents 只需一次更改即可完成。您必须提供 AdSet ID以及至少两个 MultiRewardEngagementEvents 的列表。要停用某个事件,请添加 disable: true 属性。停用事件时,仍需提供 eventNameeventValue 属性,以防止意外删除。

参考:AdSetBiddingUpdateInput 类型,MultiRewardEngagementEventInput 类型

Mutation
Result
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
      }
    }
  }
}

3. 管理您的应用特定配置

查看启用了开发者应用特定出价的多重奖励广告的事件级信息。这将返回按开发者应用划分的事件信息,例如出价金额、事件名称和事件线性。

注意:任何非开发者应用特定的事件配置都将列在空应用下。

参考:MultiRewardEngagementEvent 类型,AppReference 类型

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

创建和删除Per-App的事件配置

注意:与 MultiRewardEngagementEvents 类似,创建和删除 AppBiddingGroups 只需一次更改即可完成。您必须提供至少一个开发者 AppReference ID 以及至少两个 MultiRewardEngagementEvents 的列表。当给定开发者 AppReference 内部发生转化时,这些事件的金额将代替最高层级的配置值。

要停用某个事件或per-app-bid的出价组,请向对象添加 disable: true。停用per-app-bid的出价组会自动停用其子事件。停用事件时,需要提供 eventNameeventValue 参数,以防止意外删除。

参考:AdSetBiddingUpdateInput 类型、AppBiddingGroupInput 类型、MultiRewardEngagementEventInput 类型、AppReference 类型

Mutation
Result
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
      }
    }
  }
}