SuggestKeywordsFromExistingKeywords-Dienstvorgang – Ad Insight

Artikel
12/21/2023

Schlägt Schlüsselwörter vor, die eine bessere Leistung als die angegebenen Schlüsselwörter aufweisen könnten.

Anfordern von Elementen

Das SuggestKeywordsFromExistingKeywordsRequest-Objekt definiert den Text und die Headerelemente der Dienstvorgangsanforderung. Die Elemente müssen in der gleichen Reihenfolge wie im Anforderungs-SOAP dargestellt sein.

Hinweis

Sofern unten nicht anders angegeben, sind alle Anforderungselemente erforderlich.

Anforderungstextelemente

Element	Beschreibung	Datentyp
AdGroupId	Der Bezeichner der Anzeigengruppe für vorgeschlagene Schlüsselwörter. Dieses Element wird noch nicht unterstützt und kann verwendet werden, um Schlüsselwort (keyword) Vorschläge in einer zukünftigen Version zu beeinflussen.	Lange
CampaignId	Der Bezeichner der Kampagne für vorgeschlagene Schlüsselwörter. Dieses Element wird noch nicht unterstützt und kann verwendet werden, um Schlüsselwort (keyword) Vorschläge in einer zukünftigen Version zu beeinflussen.	Lange
ExcludeBrand	Ein -Wert, der bestimmt, ob die Ergebnisse Markenschlüsselwörter ausschließen. Um Markenschlüsselwörter im Ergebnis auszuschließen, legen Sie auf true fest. Der Standardwert ist „false“.	boolean
Schlüsselwörter	Ein Array von Schlüsselwörtern, für die Sie vorgeschlagene Schlüsselwörter abrufen möchten, die eine bessere Leistung erzielen könnten. Das Array kann maximal 1.000 Schlüsselwörter enthalten, und jedes Schlüsselwort (keyword) darf maximal 100 Zeichen enthalten.	Zeichenfolgenarray
Sprache	Die Sprache, in der die Schlüsselwort (keyword) geschrieben wird. Mögliche Werte, bei denen die Groß-/Kleinschreibung beachtet wird, sind Englisch, Französisch und Deutsch. Eine Liste der Anbieter, die für jede Sprache unterstützt werden, finden Sie weiter unten im Abschnitt "Hinweise ". Der Standardwert ist Englisch.	Zeichenfolge
MaxSuggestionsPerKeyword	Die maximale Anzahl von Schlüsselwort (keyword) Vorschlägen, die pro angegebenem Schlüsselwort (keyword) zurückgegeben werden sollen. Wenn SuggestionType auf 4 festgelegt ist, können Sie maximal 200 Vorschläge pro Schlüsselwort (keyword) anfordern. Andernfalls können Sie maximal 100 Vorschläge anfordern. Der Standardwert ist 50.	int
PublisherCountries	Die Ländercodes der Länder/Regionen, die als Datenquelle für die Bestimmung der vorgeschlagenen Schlüsselwörter verwendet werden sollen. Sie können einen oder mehrere Ländercodes angeben. Jedes land/jede Region, die Sie angeben, muss die Sprache unterstützen, die Sie im Language-Element angegeben haben. Unterstützte Werte finden Sie weiter unten im Abschnitt "Hinweise" . Die Standardeinstellung sind alle Länder/Regionen, die die angegebene Sprache unterstützen.	Zeichenfolgenarray
RemoveDuplicates	Ein boolescher Wert, der bestimmt, ob doppelte Schlüsselwörter aus der Liste der vorgeschlagenen Schlüsselwörter entfernt werden sollen. Um Duplikate zu entfernen, legen Sie auf true fest. Der Standardwert ist „false“.	boolean
SuggestionType	Der Anbieter, der zum Generieren der Schlüsselwort (keyword) Vorschläge verwendet werden soll. Eine Liste der möglichen Anbieter, die Sprach- und Länder-/Regionseinschränkungen der einzelnen Anbieter sowie den Standardanbieter nach Land/Region finden Sie im Abschnitt "Hinweise " weiter unten.	int

Anforderungsheaderelemente

Element	Beschreibung	Datentyp
AuthenticationToken	Das OAuth-Zugriffstoken, das die Anmeldeinformationen eines Benutzers darstellt, der über Berechtigungen für Microsoft Advertising-Konten verfügt. Weitere Informationen finden Sie unter Authentifizierung mit OAuth.	Zeichenfolge
CustomerAccountId	Der Bezeichner des Anzeigenkontos, das die Entitäten in der Anforderung besitzt oder zugeordnet ist. Dieses Headerelement muss denselben Wert wie das AccountId-Body-Element aufweisen, wenn beides erforderlich ist. Dieses Element ist für die meisten Dienstvorgänge erforderlich, und als bewährte Methode sollten Sie es immer festlegen. Weitere Informationen finden Sie unter Abrufen Von Konto- und Kunden-IDs.	Zeichenfolge
Customerid	Der Bezeichner des Vorgesetztenkontos (Kunde), auf das der Benutzer zugreift oder von dort aus arbeitet. Ein Benutzer kann Zugriff auf mehrere Managerkonten haben. Dieses Element ist für die meisten Dienstvorgänge erforderlich, und als bewährte Methode sollten Sie es immer festlegen. Weitere Informationen finden Sie unter Abrufen Von Konto- und Kunden-IDs.	Zeichenfolge
DeveloperToken	Das Entwicklertoken, das für den Zugriff auf die Bing Ads-API verwendet wird. Weitere Informationen finden Sie unter Abrufen eines Entwicklertokens.	Zeichenfolge
Kennwort	Dieses Element ist für die interne Verwendung reserviert und wird aus einer zukünftigen Version der API entfernt. Sie müssen das AuthenticationToken-Element verwenden, um Benutzeranmeldeinformationen festzulegen.	Zeichenfolge
UserName	Dieses Element ist für die interne Verwendung reserviert und wird aus einer zukünftigen Version der API entfernt. Sie müssen das AuthenticationToken-Element verwenden, um Benutzeranmeldeinformationen festzulegen.	Zeichenfolge

Antwortelemente

Das SuggestKeywordsFromExistingKeywordsResponse-Objekt definiert den Text und die Headerelemente der Dienstvorgangsantwort. Die Elemente werden in der gleichen Reihenfolge zurückgegeben, in der die Antwort-SOAP gezeigt wird.

Antworttextelemente

Element	Beschreibung	Datentyp
KeywordSuggestions	Ein Array von KeywordSuggestion-Datenobjekten . Das Array enthält ein Element für jede in der Anforderung angegebene Schlüsselwort (keyword). Das -Objekt enthält eine Liste der vorgeschlagenen Schlüsselwörter, die möglicherweise eine bessere Leistung als die angegebene Schlüsselwort (keyword). Für jede vorgeschlagene Schlüsselwort (keyword) enthält das Objekt eine Bewertung, die die Wahrscheinlichkeit angibt, dass die Verwendung des Schlüsselwort (keyword) dazu führen würde, dass eine Anzeige in die Ergebnisse einer Suchabfrage aufgenommen wird. Wenn keine Vorschläge für eine Schlüsselwort (keyword) vorhanden sind, ist das SuggestionsAndConfidence-Element NULL.	KeywordSuggestion-Array

Antwortheaderelemente

Element	Beschreibung	Datentyp
TrackingId	Der Bezeichner des Protokolleintrags, der die Details des API-Aufrufs enthält.	Zeichenfolge

SOAP anfordern

Diese Vorlage wurde von einem Tool generiert, um die Reihenfolge der Text- und Headerelemente für die SOAP-Anforderung anzuzeigen. Informationen zu unterstützten Typen, die Sie mit diesem Dienstvorgang verwenden können, finden Sie oben in der Referenz zu Anforderungstextelementen .

<s:Envelope xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
  <s:Header xmlns="https://bingads.microsoft.com/AdInsight/v13">
    <Action mustUnderstand="1">SuggestKeywordsFromExistingKeywords</Action>
    <AuthenticationToken i:nil="false">ValueHere</AuthenticationToken>
    <CustomerAccountId i:nil="false">ValueHere</CustomerAccountId>
    <CustomerId i:nil="false">ValueHere</CustomerId>
    <DeveloperToken i:nil="false">ValueHere</DeveloperToken>
  </s:Header>
  <s:Body>
    <SuggestKeywordsFromExistingKeywordsRequest xmlns="https://bingads.microsoft.com/AdInsight/v13">
      <Keywords i:nil="false" xmlns:a1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
        <a1:string>ValueHere</a1:string>
      </Keywords>
      <Language i:nil="false">ValueHere</Language>
      <PublisherCountries i:nil="false" xmlns:a1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
        <a1:string>ValueHere</a1:string>
      </PublisherCountries>
      <MaxSuggestionsPerKeyword i:nil="false">ValueHere</MaxSuggestionsPerKeyword>
      <SuggestionType i:nil="false">ValueHere</SuggestionType>
      <RemoveDuplicates i:nil="false">ValueHere</RemoveDuplicates>
      <ExcludeBrand i:nil="false">ValueHere</ExcludeBrand>
      <AdGroupId i:nil="false">ValueHere</AdGroupId>
      <CampaignId i:nil="false">ValueHere</CampaignId>
    </SuggestKeywordsFromExistingKeywordsRequest>
  </s:Body>
</s:Envelope>

Antwort-SOAP

Diese Vorlage wurde von einem Tool generiert, um die Reihenfolge der Text- und Headerelemente für die SOAP-Antwort anzuzeigen.

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
  <s:Header xmlns="https://bingads.microsoft.com/AdInsight/v13">
    <TrackingId d3p1:nil="false" xmlns:d3p1="http://www.w3.org/2001/XMLSchema-instance">ValueHere</TrackingId>
  </s:Header>
  <s:Body>
    <SuggestKeywordsFromExistingKeywordsResponse xmlns="https://bingads.microsoft.com/AdInsight/v13">
      <KeywordSuggestions d4p1:nil="false" xmlns:d4p1="http://www.w3.org/2001/XMLSchema-instance">
        <KeywordSuggestion>
          <Keyword d4p1:nil="false">ValueHere</Keyword>
          <SuggestionsAndConfidence d4p1:nil="false">
            <KeywordAndConfidence>
              <SuggestedKeyword d4p1:nil="false">ValueHere</SuggestedKeyword>
              <ConfidenceScore>ValueHere</ConfidenceScore>
            </KeywordAndConfidence>
          </SuggestionsAndConfidence>
        </KeywordSuggestion>
      </KeywordSuggestions>
    </SuggestKeywordsFromExistingKeywordsResponse>
  </s:Body>
</s:Envelope>

Codesyntax

Die Beispielsyntax kann mit Bing Ads SDKs verwendet werden. Weitere Beispiele finden Sie unter Codebeispiele für die Bing Ads-API .

public async Task<SuggestKeywordsFromExistingKeywordsResponse> SuggestKeywordsFromExistingKeywordsAsync(
	IList<string> keywords,
	string language,
	IList<string> publisherCountries,
	int? maxSuggestionsPerKeyword,
	int? suggestionType,
	bool? removeDuplicates,
	bool? excludeBrand,
	long? adGroupId,
	long? campaignId)
{
	var request = new SuggestKeywordsFromExistingKeywordsRequest
	{
		Keywords = keywords,
		Language = language,
		PublisherCountries = publisherCountries,
		MaxSuggestionsPerKeyword = maxSuggestionsPerKeyword,
		SuggestionType = suggestionType,
		RemoveDuplicates = removeDuplicates,
		ExcludeBrand = excludeBrand,
		AdGroupId = adGroupId,
		CampaignId = campaignId
	};

	return (await AdInsightService.CallAsync((s, r) => s.SuggestKeywordsFromExistingKeywordsAsync(r), request));
}

static SuggestKeywordsFromExistingKeywordsResponse suggestKeywordsFromExistingKeywords(
	ArrayOfstring keywords,
	java.lang.String language,
	ArrayOfstring publisherCountries,
	int maxSuggestionsPerKeyword,
	int suggestionType,
	boolean removeDuplicates,
	boolean excludeBrand,
	java.lang.Long adGroupId,
	java.lang.Long campaignId) throws RemoteException, Exception
{
	SuggestKeywordsFromExistingKeywordsRequest request = new SuggestKeywordsFromExistingKeywordsRequest();

	request.setKeywords(keywords);
	request.setLanguage(language);
	request.setPublisherCountries(publisherCountries);
	request.setMaxSuggestionsPerKeyword(maxSuggestionsPerKeyword);
	request.setSuggestionType(suggestionType);
	request.setRemoveDuplicates(removeDuplicates);
	request.setExcludeBrand(excludeBrand);
	request.setAdGroupId(adGroupId);
	request.setCampaignId(campaignId);

	return AdInsightService.getService().suggestKeywordsFromExistingKeywords(request);
}

static function SuggestKeywordsFromExistingKeywords(
	$keywords,
	$language,
	$publisherCountries,
	$maxSuggestionsPerKeyword,
	$suggestionType,
	$removeDuplicates,
	$excludeBrand,
	$adGroupId,
	$campaignId)
{

	$GLOBALS['Proxy'] = $GLOBALS['AdInsightProxy'];

	$request = new SuggestKeywordsFromExistingKeywordsRequest();

	$request->Keywords = $keywords;
	$request->Language = $language;
	$request->PublisherCountries = $publisherCountries;
	$request->MaxSuggestionsPerKeyword = $maxSuggestionsPerKeyword;
	$request->SuggestionType = $suggestionType;
	$request->RemoveDuplicates = $removeDuplicates;
	$request->ExcludeBrand = $excludeBrand;
	$request->AdGroupId = $adGroupId;
	$request->CampaignId = $campaignId;

	return $GLOBALS['AdInsightProxy']->GetService()->SuggestKeywordsFromExistingKeywords($request);
}

response=adinsight_service.SuggestKeywordsFromExistingKeywords(
	Keywords=Keywords,
	Language=Language,
	PublisherCountries=PublisherCountries,
	MaxSuggestionsPerKeyword=MaxSuggestionsPerKeyword,
	SuggestionType=SuggestionType,
	RemoveDuplicates=RemoveDuplicates,
	ExcludeBrand=ExcludeBrand,
	AdGroupId=AdGroupId,
	CampaignId=CampaignId)

Hinweise

Im Folgenden finden Sie die möglichen Vorschlagsanbieter, die Sie angeben können.

Vorschlagstyp	Beschreibung
1	Gibt Suchabfragen zurück, die die Schlüsselwort (keyword) enthalten.
2	Gibt Schlüsselwörter aus anderen Anzeigengruppen zurück, die die angegebene Schlüsselwort (keyword) enthalten.
3	Gibt Suchabfragen zurück, die sich auf die angegebene Schlüsselwort (keyword) beziehen.
4	Gibt die besten Vorschläge der anderen Anbieter zurück.

Im Folgenden sind die Anbieter aufgeführt, die von jedem Land/jeder Region unterstützt werden.

Land/Region	Sprache	Unterstützte Anbietertypen	Standardanbietertyp
Australien (AU)	Englisch	2,3,4	4
Kanada (CA)	Englisch	2,3,4	4
Frankreich (FR)	Französisch	2,3,4	4
Deutschland (DE)	Deutsch	1,2,3,4	4

Anforderungen

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

Share via