GetHistoricalSearchCount-Dienstvorgang – Ad Insight

Artikel
12/21/2023

Ruft die Häufigkeit ab, mit der der normalisierte Ausdruck während des angegebenen Zeitraums in einer Suche verwendet wurde. Die Ergebnisse werden nach Gerätetyp aggregiert.

Anfordern von Elementen

Das GetHistoricalSearchCountRequest-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
Geräte	Eine Liste mit einem oder mehreren der folgenden Gerätetypen: Computer, Nichtsmartphones, Smartphones, Tablets. Der Standardwert ist Computer. Die Antwort enthält die Anzahl der Suchvorgänge für die Gerätetypen, die Sie nur angeben, sofern verfügbar.	Zeichenfolgenarray
EndDate	Das Enddatum des Datumsbereichs, der die Daten identifiziert, die Sie verwenden möchten, um die Anzahl der historischen Suchvorgänge zu bestimmen. Das Datum darf nicht nach dem heutigen Datum sein und muss später als oder mit dem angegebenen Startdatum übereinstimmen. Das effektive Enddatum kann angepasst werden, wenn das angegebene TimePeriodRollup wöchentlich oder monatlich ist.	DayMonthAndYear
Schlüsselwörter	Ein Array von Schlüsselwörtern, für die Sie bestimmen möchten, wie oft die Schlüsselwort (keyword) in einer Suchabfrage verwendet wurde. 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üsselwörter geschrieben werden. Die Länder/Regionen, die Sie im PublisherCountries-Element angeben, müssen die angegebene Sprache unterstützen. Mögliche Werte finden Sie unter Unterstützte Sprachen.	Zeichenfolge
PublisherCountries	Die Ländercodes der Länder/Regionen, die als Quelle der Verlaufsdaten verwendet werden sollen. Sie können einen oder mehrere Ländercodes angeben. Jedes Land/jede Region, die Sie angeben, muss die im Language-Element angegebene Sprache unterstützen. Mögliche Werte finden Sie unter Anzeigensprachen. Bei Null werden standardmäßig alle Länder/Regionen verwendet, die die angegebene Sprache unterstützen.	Zeichenfolgenarray
StartDate	Das Startdatum des Datumsbereichs, der die Daten identifiziert, die Sie verwenden möchten, um die Anzahl der historischen Suchvorgänge zu bestimmen. Dieses Datum muss vor oder mit dem angegebenen Enddatum identisch sein. Das Datum sollte nach dem maximal verfügbaren Verlaufsdatenbereich liegen, der dem angegebenen TimePeriodRollup-Element entspricht. Das effektive Startdatum kann angepasst werden, wenn das angegebene TimePeriodRollup wöchentlich oder monatlich ist.	DayMonthAndYear
TimePeriodRollup	Sie können angeben, ob täglich, wöchentlich oder monatlich aggregierte Daten zurückgegeben werden sollen. Eine Liste der unterstützten Werte finden Sie weiter unten im Abschnitt "Hinweise" .	Zeichenfolge

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 GetHistoricalSearchCountResponse-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
KeywordSearchCounts	Ein Array von KeywordSearchCount-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. Jede KeywordSearchCount enthält ein Array von SearchCountsByAttributes. Das Array enthält ein Element für jedes eindeutige Gerät, das in der Anforderung angegeben ist.	KeywordSearchCount-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">GetHistoricalSearchCount</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>
    <GetHistoricalSearchCountRequest 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>
      <StartDate i:nil="false">
        <Day>ValueHere</Day>
        <Month>ValueHere</Month>
        <Year>ValueHere</Year>
      </StartDate>
      <EndDate i:nil="false">
        <Day>ValueHere</Day>
        <Month>ValueHere</Month>
        <Year>ValueHere</Year>
      </EndDate>
      <TimePeriodRollup i:nil="false">ValueHere</TimePeriodRollup>
      <Devices i:nil="false" xmlns:a1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
        <a1:string>ValueHere</a1:string>
      </Devices>
    </GetHistoricalSearchCountRequest>
  </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>
    <GetHistoricalSearchCountResponse xmlns="https://bingads.microsoft.com/AdInsight/v13">
      <KeywordSearchCounts d4p1:nil="false" xmlns:d4p1="http://www.w3.org/2001/XMLSchema-instance">
        <KeywordSearchCount>
          <Keyword d4p1:nil="false">ValueHere</Keyword>
          <SearchCountsByAttributes d4p1:nil="false">
            <SearchCountsByAttributes>
              <Device d4p1:nil="false">ValueHere</Device>
              <HistoricalSearchCounts d4p1:nil="false">
                <HistoricalSearchCountPeriodic>
                  <SearchCount>ValueHere</SearchCount>
                  <DayMonthAndYear d4p1:nil="false">
                    <Day>ValueHere</Day>
                    <Month>ValueHere</Month>
                    <Year>ValueHere</Year>
                  </DayMonthAndYear>
                </HistoricalSearchCountPeriodic>
              </HistoricalSearchCounts>
            </SearchCountsByAttributes>
          </SearchCountsByAttributes>
        </KeywordSearchCount>
      </KeywordSearchCounts>
    </GetHistoricalSearchCountResponse>
  </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<GetHistoricalSearchCountResponse> GetHistoricalSearchCountAsync(
	IList<string> keywords,
	string language,
	IList<string> publisherCountries,
	DayMonthAndYear startDate,
	DayMonthAndYear endDate,
	string timePeriodRollup,
	IList<string> devices)
{
	var request = new GetHistoricalSearchCountRequest
	{
		Keywords = keywords,
		Language = language,
		PublisherCountries = publisherCountries,
		StartDate = startDate,
		EndDate = endDate,
		TimePeriodRollup = timePeriodRollup,
		Devices = devices
	};

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

static GetHistoricalSearchCountResponse getHistoricalSearchCount(
	ArrayOfstring keywords,
	java.lang.String language,
	ArrayOfstring publisherCountries,
	DayMonthAndYear startDate,
	DayMonthAndYear endDate,
	java.lang.String timePeriodRollup,
	ArrayOfstring devices) throws RemoteException, Exception
{
	GetHistoricalSearchCountRequest request = new GetHistoricalSearchCountRequest();

	request.setKeywords(keywords);
	request.setLanguage(language);
	request.setPublisherCountries(publisherCountries);
	request.setStartDate(startDate);
	request.setEndDate(endDate);
	request.setTimePeriodRollup(timePeriodRollup);
	request.setDevices(devices);

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

static function GetHistoricalSearchCount(
	$keywords,
	$language,
	$publisherCountries,
	$startDate,
	$endDate,
	$timePeriodRollup,
	$devices)
{

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

	$request = new GetHistoricalSearchCountRequest();

	$request->Keywords = $keywords;
	$request->Language = $language;
	$request->PublisherCountries = $publisherCountries;
	$request->StartDate = $startDate;
	$request->EndDate = $endDate;
	$request->TimePeriodRollup = $timePeriodRollup;
	$request->Devices = $devices;

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

response=adinsight_service.GetHistoricalSearchCount(
	Keywords=Keywords,
	Language=Language,
	PublisherCountries=PublisherCountries,
	StartDate=StartDate,
	EndDate=EndDate,
	TimePeriodRollup=TimePeriodRollup,
	Devices=Devices)

Hinweise

Die folgenden Werte, bei der die Groß-/Kleinschreibung beachtet wird, können angegeben werden, und Die Daten werden bis zum entsprechenden maximal verfügbaren Verlaufsdatenbereich zurückgegeben.

TimePeriodRollup	Verfügbare Verlaufsdaten
Täglich	Bis zu 45 Tage vor dem letzten abgeschlossenen Tag.
Wöchentlich	Bis zu 15 Wochen vor der letzten abgeschlossenen Woche. Das angegebene StartDate wird wieder auf den nächsten Sonntag angepasst, und das EndDate wird vorwärts an den nächsten Samstag angepasst.
Monatlich	Bis zu 24 Monate vor dem letzten abgeschlossenen Monat. Das angegebene StartDate wird wieder an den Anfang des Monats angepasst, und das EndDate wird vor dem Ende des Monats angepasst.

Unterstützte Sprachen

Dies sind die unterstützten Sprachen für das Textelement der Sprachanforderung :

Unterstützte Sprachen
Dänisch
Niederländisch
Englisch
Finnisch
Französisch
Deutsch
Italienisch
Norwegisch
Portugiesisch
VereinfachtChinesisch
Spanisch
Schwedisch
TraditionalChinesisch

Sprachen und Länder-/Regionszuordnung

Hier ist eine Tabelle der Sprachen und der Länder-/Regionszuordnung:

Sprache	CountryCode	Land/Region	Language@Country
Dänisch	DK	Dänemark	Danish@Denmark
Niederländisch	NL	Niederlande	Dutch@Netherlands
Englisch	AU	Australien	English@Australia
Englisch	CA	Kanada	English@Canada
Englisch	FR	Frankreich	English@France
Englisch	DE	Deutschland	English@Germany
Englisch	IN	Indien	English@India
Englisch	ID	Indonesien	English@Indonesia
Englisch	IE	Irland	English@Ireland
Englisch	IT-Abteilung	Italien	English@Italy
Englisch	MEINE	Malaysia	English@Malaysia
Englisch	NL	Niederlande	English@Netherlands
Englisch	NZ	NewZealand	English@NewZealand
Englisch	PH	Philippinen	English@Philippines
Englisch	SG	Singapur	English@Singapore
Englisch	ES	Spanien	English@Spain
Englisch	SE	Schweden	English@Sweden
Englisch	CH	Schweiz	English@Switzerland
Englisch	TH	Thailand	English@Thailand
Englisch	GB	Vereinigtes Königreich	English@UK
Englisch	US	Vereinigte Staaten	English@US
Englisch	VN	Vietnam	English@Vietnam
Finnisch	FI	Finnland	Finnish@Finland
Französisch	CA	Kanada	French@Canada
Französisch	FR	Frankreich	French@France
Französisch	CH	Schweiz	French@Switzerland
Französisch	GB	Vereinigtes Königreich	French@UK
Französisch	US	Vereinigte Staaten	French@US
Deutsch	AU	Australien	German@Australia
Deutsch	AT	Österreich	German@Austria
Deutsch	CA	Kanada	German@Canada
Deutsch	FR	Frankreich	German@France
Deutsch	DE	Deutschland	German@Germany
Deutsch	CH	Schweiz	German@Switzerland
Deutsch	GB	Vereinigtes Königreich	German@UK
Deutsch	US	Vereinigte Staaten	German@US
Italienisch	IT-Abteilung	Italien	Italian@Italy
Norwegisch	NEIN	Norwegen	Norwegian@Norway
Portugiesisch	BR	Brasilien	Portuguese@Brazil
VereinfachtChinesisch	CN	China	SimplifiedChinese@China
Spanisch	AR	Argentinien	Spanish@Argentina
Spanisch	CL	Chile	Spanish@Chile
Spanisch	CO	Kolumbien	Spanish@Colombia
Spanisch	MX	Mexiko	Spanish@Mexico
Spanisch	PE	Peru	Spanish@Peru
Spanisch	ES	Spanien	Spanish@Spain
Spanisch	US	US	Spanish@US
Spanisch	VE	Venezuela	Spanish@Venezuela
Schwedisch	SE	Schweden	Swedish@Sweden
TraditionalChinesisch	HK	HongKongSAR	TraditionalChinese@HongKongSAR
TraditionalChinesisch	TW	Taiwan	TraditionalChinese@Taiwan

Anforderungen

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

Share via