Die Search Ads 360 Reporting API basiert auf einer modernen Plattform und enthält eine Reihe neuer Konzepte. Sie werden in den folgenden Abschnitten beschrieben.
Ressourcen
Ressourcenobjekte ersetzen Berichtstypen. Anstatt vordefinierte Berichtstypen anzufordern, können Sie jetzt alle Ressourcen mit einer neuen SQL-ähnlichen Abfragesprache abfragen. Weitere Informationen finden Sie unter Struktur der Search Ads 360 Reporting API.
Suchberichte
Die Suche hat in der neuen API einen eigenen Dienst. Der Suchdienst ersetzt den alten Berichtsdienst. Alle Abfragen durchlaufen SearchAds360Service
, das zwei Methoden (SearchStream
und Search
) zum Suchen und Abrufen von Berichtsdaten und Messwerten bietet. Beide Suchmethoden geben alle SearchAds360Row
-Objekte zurück, die der Suchanfrage entsprechen. Weitere Informationen finden Sie unter Suchberichte erstellen.
Ressourcenmetadaten
Mit SearchAds360FieldService
können Sie den Katalog dynamisch für Ressourcen, Ressourcenfelder, Segmentierungsschlüssel und Messwerte anfordern, die in den SearchAds360Service
-Suchmethoden verfügbar sind. Weitere Informationen finden Sie unter Ressourcenmetadaten abrufen.
Feldnamen
Die API führt verschachtelte Feldnamen ein, die durch einen Punkt getrennt sind. Beispiel: campaign.id
und ad_group.id
. Eine weitere Verschachtelung ist möglich, z. B. ad_group.campaign.id
. Weitere Informationen finden Sie unter Struktur der Search Ads 360 Reporting API.
Die Berichterstellung in der vorherigen Search Ads 360 API basiert auf separaten Feldern auf verschiedenen Entitäten für ähnliche Konzepte. Sowohl der Bericht campaign
als auch der Bericht adgroup
enthalten beispielsweise ein separates Feld campaignId
.
Abfragesprache
Die API führt die Search Ads 360 Query Language ein. Dies ist eine flexible, SQL-ähnliche Sprache, mit der Sie Abfragen definieren können, um die spezifischen Berichtsdaten abzurufen, die für Ihr Unternehmen am besten geeignet sind. Weitere Informationen finden Sie unter Search Ads 360 Query Language.
Anfragen abrufen
In der neuen API gibt es für die Suche einen eigenen Dienst (SearchAds360Service
), aber GET
-Anfragen sind weiterhin für den spezifischen Dienst jeder Entität vorhanden. Aus dem CustomColumnService
können Sie beispielsweise Informationen zu benutzerdefinierten Spalten abrufen. Weitere Informationen finden Sie unter Formatänderungen in der Search Ads 360 Reporting API.
Benutzerdefinierte Spalten
In der neuen Search Ads 360-Version werden Formelspalten und benutzerdefinierte Conversions als benutzerdefinierte Spalten bezeichnet. Weitere Informationen zu benutzerdefinierten Spalten Mit der neuen CustomColumnService
werden benutzerdefinierte Spalten aktiviert. Sofern Sie die erforderlichen Berechtigungen haben, können Sie CustomColumn
-Ressourcen anfordern, die einem beliebigen Konto in der Kontostruktur gehören.
Kontoverwaltung
In der neuen Search Ads 360-Version werden Konten hierarchisch nach Verwaltungskonten, untergeordneten Verwaltungskonten und Kundenkonten organisiert. Ein Verwaltungskonto entspricht dem Agenturkonto und untergeordnete Verwaltungskonten für Werbetreibendenkonten in der vorherigen Search Ads 360-Version. Weitere Informationen zu Search Ads 360-Verwaltungskonten
Sie können die Kontostruktur abfragen und dann für jedes Konto, für das Sie Berichtsdaten abrufen möchten, Anfragen senden.
Aufgrund der Änderung in der Kontohierarchie wurden Felder, die sich auf das Konzept von Werbetreibenden und Agenturen beziehen, durch geeignete Alternativen ersetzt, um nach Möglichkeit funktionale Einheitlichkeit zu gewährleisten. Eine Liste der betroffenen Felder und ihrer Ersatzfelder finden Sie unter Feldzuordnungen.
Kopfzeile der Log-in-Kundennummer
login-customer-id
ist ein neuer Header, der erforderlich ist, wenn über ein Verwaltungskonto auf ein untergeordnetes Verwaltungs- oder Kundenkonto zugegriffen werden soll. Weitere Informationen finden Sie unter Login-Kundennummer-Header.
Versionsverwaltung
Die Search Ads 360 Reporting API verwendet die semantische Versionsverwaltung.
Es gibt Haupt- und Nebenversionen im Format vMAJOR_MINOR
. Weitere Informationen finden Sie unter Versionsverwaltung.