广告主示例

1. 更新出价

Query
Result
mutation {
  updateAdSet(input: {
    id: "00000000-0000-0000-0000-000000000000",
    bidding: {amount: 1000000}
  }) {
    adSet {
      id
    }
  }
}

请注意,在这种情况下的出价金额。 有关更多信息,请参阅 Money 的文档。

2. 查看广告信息

无过滤条件

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

请注意,您可以使用上述响应中的 endCursor 来请求下一页。示例如下:

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

有过滤条件

Query
Result
query {
  advertiser {
    adSets(first: 50, configuredStatus: ACTIVE) {
      edges {
        node {
          id
        }
      }
    }
  }
}

3. 查看广告数据

不分组数据

Query
Result
query {
  adSet(id: "00000000-0000-0000-0000-000000000000") {
    insights(timeRange: {from: "2018-03-06T00:00:00Z", until: "2018-03-07T00:00:00Z"}) {
      timestamps
      reports {
        impressions
        conversions
        spend
      }
    }
  }
}

按国家分组数据

Query
Result
query {
  adSet(id: "00000000-0000-0000-0000-000000000000") {
    insights(timePreset: TODAY) {
      reports {
        country
        impressions
        conversions
        spend
      }
    }
  }
}

按子渠道分组数据

注意:2018年10月15日之前的数据将没有关联的应用程序。在这种情况下,“app”将简单地为“null”(如下面结果中的示例)。

注意:bundleId和storeId只有在联系Tapjoy后才可用。 hashedId 是每个应用程序的加密唯一标识符。

Query
Result
query {
  adSet(id: "00000000-0000-0000-0000-000000000000") {
    ads {
      id
      insights(timePreset: TODAY) {
        reports {
          app {
            bundleId
            hashedId
          }
          impressions
          conversions
          spend
        }
      }
    }
  }
}

Across all Ad Sets

Query
Result
query {
  advertiser {
    adSets(first: 50, configuredStatus: ACTIVE) {
      edges {
        node {
          id

          insights(timeRange: {from: "2018-03-06T00:00:00Z", until: "2018-03-07T00:00:00Z"}) {
            timestamps
            reports {
              conversions
              spend
            }
          }
        }
      }
    }
  }
}

4. 查看用户时区

请注意,utcOffset是 +/- UTC时区的小时数和分钟数。 如果时区为UTC,则返回为+00:00。

此外,数据将根据时区当前是否正在经历夏令时而改变。 例如,您可能会看到EDT或EST是东部时间的缩写。

Query
Result
query {
  user {
    firstName
    lastName

    timeZone {
      utcOffset
      name
      abbreviation
    }
  }
}

5. 查看配置事件

这会列出广告上的所有multiRewardEngagementEvents,无论出价金额、状态或转化次数如何。

Query
Result
{
  adSet(id: "ace4b134-c5ab-4e97-bc81-95406682682c") {
    multiRewardEngagementSettings {
      events {
        eventName
        eventValue
        amount
      }
    }
  }
}

6. 创建和删除事件

创建和删除MultiRewardEngagementEvents是在单个更新中完成的。 您必须提供一个AdSet id以及至少两个MultiRewardEngagementEvents的列表。

要禁用事件,请添加 disable: true属性。 禁用事件时,仍然需要 eventNameeventValue以防止意外删除。

在下面的示例中,我们将配置我们的 AdSet 以具有两个事件:TUTORIAL_COMPLETELEVEL_ONE。 我们还将禁用 LEVEL_TWO 事件。

Query
Result
mutation {
  updateAdSetBidding(
    input:{
      id: "<your adset id>"
      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
      }
    }
  }
}

7. 查看per-app事件配置

这列出了 adSet 上的所有 multiRewardEngagementEvents 数据,包括特定开发者应用的出价设置。 非特定开发者应用事件配置将列在null应用下。

Query
Result
{
  adSet(id: "ace4b134-c5ab-4e97-bc81-95406682682c") {
    multiRewardEngagementSettings {
      app {
        bundleId
      }
      events {
        eventName
        eventValue
        amount
      }
    }
  }
}

8. 创建和删除per-app事件配置

就像 MultiRewardEngagementEvents一样,创建和删除 AppBiddingGroups 是在单个更新中完成的。您必须提供至少一个开发者 AppReference id 以及至少两个 MultiRewardEngagementEvents 的列表。当在给定的开发者AppReference中发生转化时,这些事件的数量将用于代替顶级配置值。

要禁用事件或per-app-bid组,请将 disable: true 添加到对象。禁用 per-app-bid 组会自动禁用其子事件。禁用事件时需要 eventNameeventValue 以防止意外删除。

在下面的示例中,我们将配置我们的 AdSet 以具有两个事件:TUTORIAL_COMPLETELEVEL_ONE。同时我们将分别配置 2.2 美元和 12.2 美元的出价。默认情况下,这将是针对所有子渠道的出价。我们还将禁用一个事件LEVEL_TWO

接下来,对于示例开发者应用程序1,我们将为第一个事件使用 5.5 美元的出价,并为第二个事件禁用任何自定义出价。

最后,对于示例开发者应用程序2,将完全禁用该组,这也将禁用所有事件。

Query
Result
mutation {
  updateAdSetBidding(
    input:{
      id: "<your adset id>"
      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
      }
    }
  }
}