KeywordIdea Data Object – Ad Insight

Definiert ein Objekt, das eine vorgeschlagene Schlüsselwort (keyword) mit Historischen Statistiken enthält, z. B. monatliches Suchvolumen, Wettbewerb, vorgeschlagenes Mindestgebot und Anzeigenimpressungsanteil.

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
}

Elemente

Das KeywordIdea-Objekt weist die folgenden Elemente auf: AdGroupId, AdGroupName, AdImpressionShare, Competition, Keyword, MonthlySearchCounts, Relevance, Source, SuggestedBid.

Element	Beschreibung	Datentyp
AdGroupId	Der negative Anzeigengruppenbezeichner, der Schlüsselwort (keyword) Ideen in vorgeschlagene neue Anzeigengruppen gruppiert. Schlüsselwortideen für vorhandene Anzeigengruppenbezeichner werden nicht unterstützt. Wenn die Anzeigengruppen-ID NULL ist, wird das Schlüsselwort (keyword) Ideenquelle-Element auf Seed festgelegt, und es gibt keine bestimmte empfohlene Anzeigengruppe.	lang
AdGroupName	Der vorgeschlagene Name der Anzeigengruppe für die Schlüsselwort (keyword) Idee. Wenn der Name der Anzeigengruppe NULL ist, wird das element Schlüsselwort (keyword) Idea Source auf Seed festgelegt, und es gibt keine bestimmte empfohlene Anzeigengruppe.	Zeichenfolge
AdImpressionShare	Die Anzeigeneindrucksfreigabe ist die Anzahl der erhaltenen Impressionen dividiert durch die Gesamtzahl der Suchvorgänge für den Standort und das Netzwerk, das Sie als Ziel verwenden und die genau mit dem Schlüsselwort (keyword) im letzten Kalendermonat übereinstimmten.	doppelt
Wettbewerb	Bestimmt durch die Anzahl der Inserenten, die auf diese Schlüsselwort (keyword) im Verhältnis zu allen anderen Schlüsselwörtern in Microsoft Advertising bieten.	CompetitionLevel
Schlüsselwort	Die vorgeschlagene Schlüsselwort (keyword).	Zeichenfolge
MonthlySearchCounts	Gibt an, wie oft dieser Schlüsselwort (keyword) als Suchbegriff für jeden Monat innerhalb des ausgewählten Datumsbereichs und der ausgewählten Zieleinstellungen verwendet wurde. Standardmäßig ist die Größe der Liste 12, und die verfügbaren Daten der letzten 12 Monate werden zurückgegeben. Die Suchanzahl wird in der Reihenfolge sortiert, beginnend mit den Daten des letzten Monats unter MonthlySeachCounts[0]. Es kann bis zu 72 Stunden dauern, bis die Daten des vorherigen Kalendermonats verfügbar sind. Wenn Sie beispielsweise Schlüsselwort (keyword) Ideen am 1., 2. oder 3. August anfordern und die Daten von Juli nicht bereit sind, basiert die Antwort auf den Daten vom Juni. Wenn Sie den DateRangeSearchParameter nicht in die GetKeywordIdeas-Anforderung einschließen, können Sie nicht bestätigen, ob es sich bei dem ersten Listenelement um Daten für den vorherigen Monat oder den Vorherigen Monat handelt. Wenn der Datumsbereich angegeben ist und die Daten des letzten Monats noch nicht verfügbar sind, gibt GetKeywordIdeas einen Fehler zurück.	langes Array
Relevanz	Die Schlüsselwort (keyword) Relevanzbewertung. Höhere Relevanz bedeutet "relevanter". Es gibt keinen definierten Bereich, aber als Beispiel können Sie Werte wie 1,00 oder 87.083,82 sehen. Obwohl die Werte nicht angezeigt werden, wird relevanz verwendet, um Schlüsselwort-Planner Ergebnisse nach Relevanz in der Microsoft Advertising-Benutzeroberfläche zu sortieren.	doppelt
Quelle	Die Quelle oder der Ausgangswert für die Schlüsselwort (keyword).	SourceType
SuggestedBid	Das vorgeschlagene Mindestgebot für diesen Schlüsselwort (keyword). Wir erstellen diesen Vorschlag anhand des von Ihnen einbezogenen Standort- und Netzwerkkriteriums sowie der durchschnittlichen Kosten pro Klick (CPC) Werbetreibenden, die für diese Schlüsselwort (keyword) bezahlen. Dieser Betrag ist nur eine Schätzung, und Ihr tatsächlicher CPC kann variieren.	doppelt

Anforderungen

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

Verwendet von

GetKeywordIdeas