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

毎月の検索量、コンテスト、おすすめの最小の入札単価、広告インプレッションシェアなど、過去の統計を含む推奨キーワードを含むオブジェクトを定義します。

構文

XML

<xs:complexType name="KeywordIdea" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:sequence>
    <xs:element minOccurs="0" name="AdGroupId" nillable="true" type="xs:long" />
    <xs:element minOccurs="0" name="AdGroupName" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="AdImpressionShare" nillable="true" type="xs:double" />
    <xs:element minOccurs="0" name="Competition" nillable="true" type="tns:CompetitionLevel" />
    <xs:element minOccurs="0" name="Keyword" nillable="true" type="xs:string" />
    <xs:element xmlns:q24="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="MonthlySearchCounts" nillable="true" type="q24:ArrayOflong" />
    <xs:element minOccurs="0" name="Relevance" nillable="true" type="xs:double" />
    <xs:element minOccurs="0" name="Source" nillable="true" type="tns:SourceType" />
    <xs:element minOccurs="0" name="SuggestedBid" nillable="true" type="xs:double" />
  </xs:sequence>
</xs:complexType>

JSON

{
  "AdGroupId": "LongValueHere",
  "AdGroupName": "ValueHere",
  "AdImpressionShare": DoubleValueHere,
  "Competition": "ValueHere",
  "Keyword": "ValueHere",
  "MonthlySearchCounts": [
    "LongValueHere"
  ],
  "Relevance": DoubleValueHere,
  "Source": "ValueHere",
  "SuggestedBid": DoubleValueHere
}

要素

KeywordIdea オブジェクトには、AdGroupId、AdGroupName、AdImpressionShare、Competition、Keyword、MonthlySearchCounts、Relevance、Source、SuggestedBid の各要素があります。

要素	説明	データ型
AdGroupId	アイデアを提案された新しい広告グループキーワード (keyword)グループ化する否定的な広告グループ識別子。 既存の広告グループ識別子のキーワードアイデアはサポートされていません。 広告グループ ID が null の場合、キーワード (keyword)アイデアの Source 要素は Seed に設定され、特定の推奨される広告グループはありません。	long
AdGroupName	キーワード (keyword)アイデアの広告グループの推奨名。 広告グループ名が null の場合、キーワード (keyword)アイデアの Source 要素は Seed に設定され、特定の推奨される広告グループはありません。	string
AdImpressionShare	広告インプレッション シェアは、受け取ったインプレッションの数を、ターゲットとする場所とネットワークの検索の合計数で割り、過去 1 か月のキーワード (keyword)と正確に一致しました。	複
競争	Microsoft Advertising 全体の他のすべてのキーワードに対して、このキーワード (keyword)に入札する広告主の数によって決まります。	CompetitionLevel
キーワード	推奨されるキーワード (keyword)。	string
MonthlySearchCounts	このキーワード (keyword)が、選択した日付範囲内およびターゲット設定内の各月の検索用語として使用された回数。 既定では、リストのサイズは 12 で、使用可能なデータの過去 12 か月間が返されます。 検索カウントは、 MonthlySeachCounts[0]の最新の月のデータから順に並べ替えられます。 前のカレンダー月のデータが使用可能になるまでに最大 72 時間かかる場合があります。 たとえば、8 月 1 日、2 日、3 日にキーワード (keyword)アイデアを要求し、7 月のデータの準備ができていない場合、応答は 6 月のデータに基づいて行われます。 GetKeywordIdeas 要求に DateRangeSearchParameter を含めなかった場合、最初のリスト アイテムが前の月のデータか、前の月のデータであるかを確認できません。 日付範囲が指定されていて、最新の月のデータがまだ使用できない場合、 GetKeywordIdeas はエラーを返します。	long 配列
関連性	キーワード (keyword)関連スコア。 関連性が高いということは、"関連性が高い" という意味です。 定義された範囲はありませんが、一例として、1.00 や 87,083.82 などの値が表示される場合があります。 値は表示されませんが、関連性は、Microsoft Advertising UI でキーワードPlanner結果を関連性別に並べ替えるために使用されます。	複
ソース	キーワード (keyword)のソースまたはシード。	SourceType
SuggestedBid	このキーワード (keyword)に推奨される最小入札価格。 この提案は、含まれている場所とネットワークの基準と、このキーワード (keyword)に対して支払う平均クリック単価 (CPC) 広告主を使用して作成されます。 この金額は見積もりのみで、実際の CPC は異なる場合があります。	複

要件

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

使用ページ

GetKeywordIdeas