AuctionInsightResult データ オブジェクト - Ad Insight

GetAuctionInsightData 操作の呼び出しによる、クエリ分析情報の結果を定義します。

構文

XML

<xs:complexType name="AuctionInsightResult" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:sequence>
    <xs:element minOccurs="0" name="Segments" nillable="true" type="tns:ArrayOfAuctionSegment" />
    <xs:element minOccurs="0" name="Entries" nillable="true" type="tns:ArrayOfAuctionInsightEntry" />
    <xs:element minOccurs="0" name="UsedImpressions" type="xs:double" />
    <xs:element minOccurs="0" name="UsedKeywords" type="xs:double" />
  </xs:sequence>
</xs:complexType>

JSON

{
  "Entries": [
    {
      "AggregatedKpi": {
        "AboveRate": DoubleValueHere,
        "AbsoluteTopOfPageRate": DoubleValueHere,
        "AveragePosition": DoubleValueHere,
        "ImpressionShare": DoubleValueHere,
        "OutrankingShare": DoubleValueHere,
        "OverlapRate": DoubleValueHere,
        "Segments": [
          "ValueHere"
        ],
        "TopOfPageRate": DoubleValueHere
      },
      "DisplayDomain": "ValueHere",
      "SegmentedKpis": [
        {
          "AboveRate": DoubleValueHere,
          "AbsoluteTopOfPageRate": DoubleValueHere,
          "AveragePosition": DoubleValueHere,
          "ImpressionShare": DoubleValueHere,
          "OutrankingShare": DoubleValueHere,
          "OverlapRate": DoubleValueHere,
          "Segments": [
            "ValueHere"
          ],
          "TopOfPageRate": DoubleValueHere
        }
      ]
    }
  ],
  "Segments": [
    "ValueHere"
  ],
  "UsedImpressions": DoubleValueHere,
  "UsedKeywords": DoubleValueHere
}

要素

AuctionInsightResult オブジェクトには、Entries、Segments、UsedImpressions、UsedKeywords という要素があります。

要素	説明	データ型
Entries	1 つ以上のオークション分析情報エントリ (つまり、オークションで競合したドメインごとに 1 つの結果)。	AuctionInsightEntry 配列
セグメント	GetAuctionInsightData 要求で 1 つ以上の AuctionSegmentSearchParameter を介して指定された場合のセグメント。 オークション セグメントの一覧は、[ オークション][セグメント ] の値セット (日、週、月、四半期、DayOfWeek、デバイス) と同じ順序です。 たとえば、2018 年 5 月 1 日の日、デバイス、四半期のセグメントを要求した場合、この要素には、次の順序で 3 つのオークション セグメントの一覧が含まれます: 日、四半期、デバイス。	AuctionSegment 配列
UsedImpressions	オークション分析情報エントリの生成に使用されたインプレッションの割合。 値の範囲は 0 から 1.0 です。たとえば、0.8 はインプレッションの 80% が使用されたことを示します。	複
UsedKeywords	オークション分析情報エントリの生成に使用されたキーワードの数。	複

要件

Service: AdInsightService.svc v13
Namespace: https://bingads.microsoft.com/AdInsight/v13

使用ページ

GetAuctionInsightData