GetEstimatedBidByKeywords-Dienstvorgang – Ad Insight

Artikel
12/21/2023

Ruft den geschätzten Gebotswert eines oder mehrerer Schlüsselwörter ab, der dazu führen kann, dass eine Anzeige an der Zielposition in den Suchergebnissen angezeigt wird.

Die Schätzungen stellen keine Vorhersage oder Garantie für die zukünftige Leistung dar.

Hinweis

Dieser Vorgang ist für Suchkampagnen mit der erweiterten CPC-Gebotsstrategie vorgesehen.

Anfordern von Elementen

Das GetEstimatedBidByKeywordsRequest-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, deren Leistungsdaten verwendet werden, um die Leistung der Schlüsselwort (keyword) im Kontext der Anzeigengruppe zu bestimmen. Die Angabe einer Anzeigengruppe trägt dazu bei, die Genauigkeit des vorgeschlagenen Gebots zu verbessern. Wenn Sie eine Anzeigengruppe angeben, müssen Sie die Kampagne angeben, zu der sie gehört.	Lange
CampaignId	Der Bezeichner der Kampagne, die besitzer der in AdGroupId angegebenen Anzeigengruppe ist. Wenn Sie keine Anzeigengruppe angeben, werden anhand der Leistungsdaten der Kampagne ermittelt, wie gut die Schlüsselwort (keyword) im Kontext der Kampagne funktionieren könnten. Das Angeben einer Kampagne und einer Anzeigengruppe trägt dazu bei, die Genauigkeit des vorgeschlagenen Gebots zu verbessern. Wenn weder AdGroupId noch CampaignId angegeben sind, verwendet der Vorgang das angegebene CustomerAccountId-Headerelement, um die Leistung der Schlüsselwort (keyword) im Kontext des Kontos zu bestimmen.	Lange
CurrencyCode	Der ISO-Code für die Währungseinheit, die zum Berechnen der Kostenschätzungen und des vorgeschlagenen Gebotswerts verwendet werden soll. Falls nicht festgelegt, bestimmt der Dienst die Währung aus dem Konto, das im Headerelement CustomerAccountId angegeben ist. Wenn weder Currency noch CustomerAccountId festgelegt ist, verwendet der Dienst USD.	CurrencyCode
EntityLevelBid	Bestimmt, ob Schätzungen für Schlüsselwort (keyword), Gebote auf Anzeigengruppenebene oder beides zurückgegeben werden sollen. – Legen Sie EntityLevelBid auf Keyword fest, um ein Array von KeywordEstimatedBid abzurufen, das den angegebenen Schlüsselwörtern entspricht. – Legen Sie EntityLevelBid auf AdGroup fest, um ein EstimatedBidAndTraffic für die angegebene Anzeigengruppe zu erhalten. – Legen Sie EntityLevelBid auf AllEntities fest, um ein Array von KeywordEstimatedBid für Schlüsselwörter und ein EstimatedBidAndTraffic für eine Anzeigengruppe abzurufen. Wenn Sie EntityLevelBid nicht festlegen, wird standardmäßig nur ein Array von KeywordEstimatedBid oder das Äquivalent zum Festlegen von EntityLevelBid auf Keyword zurückgegeben. Wenn Sie EntityLevelBid auf einen anderen Wert alsKeyword, AdGroup oder AllEntities festlegen, gibt der Dienst Code 3501 mit ErrorCode CampaignServiceBidLevelInvalid zurück.	Zeichenfolge
Schlüsselwörter	Eine Liste der KeywordAndMatchType-Datenobjekte , für die Sie vorgeschlagene Gebotswerte abrufen möchten. Sie können maximal 1.000 Schlüsselwörter angeben, und jedes Schlüsselwort (keyword) darf maximal 100 Zeichen enthalten.	KeywordAndMatchType-Array
Sprache	Die Sprache, die parallel zu Standortbezeichnern zum Schätzen der Gebote verwendet wird. Die Sprache muss an jedem der Speicherorte unterstützt werden, die Sie in LocationIds angeben. Mögliche Sprachwerte finden Sie unter Anzeigensprachen. Wenn Sie die Sprache nicht angeben, verwendet der Dienstvorgang die Sprache der angegebenen AdGroupId oder CampaignId. Wenn keine dieser Eigenschaften festgelegt ist, wird standardmäßig EN (Englisch) verwendet.	Zeichenfolge
LocationIds	Der Bezeichner oder die Bezeichner der geografischen Standorte, die für die Schätzung der Gebote verwendet werden sollen. Alle Speicherorte müssen die im Language-Element angegebene Sprache unterstützen. Obwohl Sie mehrere Standortbezeichner angeben können, sollten Sie als bewährte Methode für die genauesten Gebotsschätzungen pro Standort nur einen Standort pro Dienstaufruf angeben. Informationen zu möglichen Standortbezeichnern finden Sie unter Geografische Standortcodes. Wenn Sie keine Standorte angeben, verwendet der Dienstvorgang die Standortkriterien der angegebenen AdGroupId oder CampaignId. Wenn keine dieser Eigenschaften festgelegt ist, wird standardmäßig 190 (USA) verwendet.	langes Array
TargetPositionForAds	Die Position, an der Ihre Anzeigen in den Suchergebnissen angezeigt werden sollen. Der Standardwert ist MainLine1.	TargetAdPosition

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 GetEstimatedBidByKeywordsResponse-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
AdGroupEstimatedBid	Enthält Schätzungen von Klicks, durchschnittlichen Kosten pro Klick (CPC), Impressionen, Klickrate (Click-Through Rate, CTR) und Gesamtkosten für die angegebene Anzeigengruppe, wenn Sie das vorgeschlagene Gebot verwenden würden. Der MatchType-Wert innerhalb von EstimatedBidAndTraffic lautet immer Aggregate. In diesem Kontext stellt es das Standard-Suchgebot für eine Anzeigengruppe dar.	EstimatedBidAndTraffic
KeywordEstimatedBids	Ein Array von KeywordEstimatedBid-Datenobjekten . Das Array enthält ein Element für jede in der Anforderung angegebene Schlüsselwort (keyword). Wenn die Schlüsselwort (keyword) ungültig ist, ist das entsprechende Element im Array NULL. Jedes KeywordEstimatedBid-Element enthält ein Schlüsselwort (keyword)- und EstimatedPositions-Element. Wenn Daten für die Schlüsselwort (keyword) verfügbar sind, gibt EstimatedPositionAndTraffic den vorgeschlagenen Gebotswert an, der dazu führen könnte, dass eine Anzeige an der Zielposition der Suchergebnisse angezeigt wird. Andernfalls wird das EstimatedPositions-Element auf NULL festgelegt.	KeywordEstimatedBid-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">GetEstimatedBidByKeywords</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>
    <GetEstimatedBidByKeywordsRequest xmlns="https://bingads.microsoft.com/AdInsight/v13">
      <Keywords i:nil="false">
        <KeywordAndMatchType>
          <KeywordText i:nil="false">ValueHere</KeywordText>
          <MatchTypes i:nil="false">
            <MatchType>ValueHere</MatchType>
          </MatchTypes>
        </KeywordAndMatchType>
      </Keywords>
      <TargetPositionForAds>ValueHere</TargetPositionForAds>
      <Language i:nil="false">ValueHere</Language>
      <LocationIds i:nil="false" xmlns:a1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
        <a1:long>ValueHere</a1:long>
      </LocationIds>
      <CurrencyCode i:nil="false">ValueHere</CurrencyCode>
      <CampaignId i:nil="false">ValueHere</CampaignId>
      <AdGroupId i:nil="false">ValueHere</AdGroupId>
      <EntityLevelBid i:nil="false">ValueHere</EntityLevelBid>
    </GetEstimatedBidByKeywordsRequest>
  </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>
    <GetEstimatedBidByKeywordsResponse xmlns="https://bingads.microsoft.com/AdInsight/v13">
      <KeywordEstimatedBids d4p1:nil="false" xmlns:d4p1="http://www.w3.org/2001/XMLSchema-instance">
        <KeywordEstimatedBid>
          <Keyword d4p1:nil="false">ValueHere</Keyword>
          <EstimatedBids d4p1:nil="false">
            <EstimatedBidAndTraffic>
              <MinClicksPerWeek d4p1:nil="false">ValueHere</MinClicksPerWeek>
              <MaxClicksPerWeek d4p1:nil="false">ValueHere</MaxClicksPerWeek>
              <AverageCPC d4p1:nil="false">ValueHere</AverageCPC>
              <MinImpressionsPerWeek d4p1:nil="false">ValueHere</MinImpressionsPerWeek>
              <MaxImpressionsPerWeek d4p1:nil="false">ValueHere</MaxImpressionsPerWeek>
              <CTR d4p1:nil="false">ValueHere</CTR>
              <MinTotalCostPerWeek d4p1:nil="false">ValueHere</MinTotalCostPerWeek>
              <MaxTotalCostPerWeek d4p1:nil="false">ValueHere</MaxTotalCostPerWeek>
              <CurrencyCode>ValueHere</CurrencyCode>
              <MatchType>ValueHere</MatchType>
              <EstimatedMinBid>ValueHere</EstimatedMinBid>
            </EstimatedBidAndTraffic>
          </EstimatedBids>
        </KeywordEstimatedBid>
      </KeywordEstimatedBids>
      <AdGroupEstimatedBid d4p1:nil="false" xmlns:d4p1="http://www.w3.org/2001/XMLSchema-instance">
        <MinClicksPerWeek d4p1:nil="false">ValueHere</MinClicksPerWeek>
        <MaxClicksPerWeek d4p1:nil="false">ValueHere</MaxClicksPerWeek>
        <AverageCPC d4p1:nil="false">ValueHere</AverageCPC>
        <MinImpressionsPerWeek d4p1:nil="false">ValueHere</MinImpressionsPerWeek>
        <MaxImpressionsPerWeek d4p1:nil="false">ValueHere</MaxImpressionsPerWeek>
        <CTR d4p1:nil="false">ValueHere</CTR>
        <MinTotalCostPerWeek d4p1:nil="false">ValueHere</MinTotalCostPerWeek>
        <MaxTotalCostPerWeek d4p1:nil="false">ValueHere</MaxTotalCostPerWeek>
        <CurrencyCode>ValueHere</CurrencyCode>
        <MatchType>ValueHere</MatchType>
        <EstimatedMinBid>ValueHere</EstimatedMinBid>
      </AdGroupEstimatedBid>
    </GetEstimatedBidByKeywordsResponse>
  </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<GetEstimatedBidByKeywordsResponse> GetEstimatedBidByKeywordsAsync(
	IList<KeywordAndMatchType> keywords,
	TargetAdPosition targetPositionForAds,
	string language,
	IList<long> locationIds,
	CurrencyCode? currencyCode,
	long? campaignId,
	long? adGroupId,
	string entityLevelBid)
{
	var request = new GetEstimatedBidByKeywordsRequest
	{
		Keywords = keywords,
		TargetPositionForAds = targetPositionForAds,
		Language = language,
		LocationIds = locationIds,
		CurrencyCode = currencyCode,
		CampaignId = campaignId,
		AdGroupId = adGroupId,
		EntityLevelBid = entityLevelBid
	};

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

static GetEstimatedBidByKeywordsResponse getEstimatedBidByKeywords(
	ArrayOfKeywordAndMatchType keywords,
	TargetAdPosition targetPositionForAds,
	java.lang.String language,
	ArrayOflong locationIds,
	CurrencyCode currencyCode,
	java.lang.Long campaignId,
	java.lang.Long adGroupId,
	java.lang.String entityLevelBid) throws RemoteException, Exception
{
	GetEstimatedBidByKeywordsRequest request = new GetEstimatedBidByKeywordsRequest();

	request.setKeywords(keywords);
	request.setTargetPositionForAds(targetPositionForAds);
	request.setLanguage(language);
	request.setLocationIds(locationIds);
	request.setCurrencyCode(currencyCode);
	request.setCampaignId(campaignId);
	request.setAdGroupId(adGroupId);
	request.setEntityLevelBid(entityLevelBid);

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

static function GetEstimatedBidByKeywords(
	$keywords,
	$targetPositionForAds,
	$language,
	$locationIds,
	$currencyCode,
	$campaignId,
	$adGroupId,
	$entityLevelBid)
{

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

	$request = new GetEstimatedBidByKeywordsRequest();

	$request->Keywords = $keywords;
	$request->TargetPositionForAds = $targetPositionForAds;
	$request->Language = $language;
	$request->LocationIds = $locationIds;
	$request->CurrencyCode = $currencyCode;
	$request->CampaignId = $campaignId;
	$request->AdGroupId = $adGroupId;
	$request->EntityLevelBid = $entityLevelBid;

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

response=adinsight_service.GetEstimatedBidByKeywords(
	Keywords=Keywords,
	TargetPositionForAds=TargetPositionForAds,
	Language=Language,
	LocationIds=LocationIds,
	CurrencyCode=CurrencyCode,
	CampaignId=CampaignId,
	AdGroupId=AdGroupId,
	EntityLevelBid=EntityLevelBid)

Anforderungen

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

Share via