Die Search Ads 360 Reporting API basiert auf einer modernen Plattform und bietet eine Reihe neuer Konzepte. Diese 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 Search Ads 360 Reporting API-Struktur.
Suchberichte
Die Suche hat in der neuen API einen eigenen Dienst. Der Suchdienst ersetzt den bisherigen Berichtsservice. Alle Abfragen durchlaufen SearchAds360Service, das die beiden Methoden SearchStream und Search zum Suchen und Abrufen von Berichtsdaten und -messwerten bereitstellt. Mit beiden Suchmethoden werden alle SearchAds360Row-Objekte zurückgegeben, die mit Ihrer Suchanfrage übereinstimmen. Weitere Informationen finden Sie unter Suchberichte erstellen.
Ressourcenmetadaten
Mit SearchAds360FieldService können Sie den Katalog nach Ressourcen, Ressourcenfeldern, Segmentierungsschlüsseln und Messwerten, die in den SearchAds360Service-Suchmethoden verfügbar sind, dynamisch anfordern. Weitere Informationen finden Sie unter Ressourcenmetadaten abrufen.
Feldnamen
Die API führt verschachtelte Feldnamen ein, die durch die Punktnotation getrennt sind. Beispiel: campaign.id und ad_group.id. Sie können auch weitere Verschachteln erstellen, z. B. ad_group.campaign.id. Weitere Informationen finden Sie unter Search Ads 360 Reporting API-Struktur.
Die Berichte in der vorherigen Search Ads 360 API basieren auf separaten Feldern in verschiedenen Entitäten für ähnliche Konzepte. So enthalten beispielsweise sowohl die Berichte campaign als auch adgroup ein separates Feld campaignId.
Abfragesprache
Mit der API wird die Search Ads 360-Abfragesprache eingeführt. 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 Suchanfragesprache in Search Ads 360.
Anfragen abrufen
In der neuen API hat die Suche einen eigenen Dienst (SearchAds360Service), aber für den spezifischen Dienst jeder Entität gibt es weiterhin GET-Anfragen. So können Sie beispielsweise Informationen zu benutzerdefinierten Spalten aus der CustomColumnService 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 Schaltfläche CustomColumnService können Sie benutzerdefinierte Spalten erstellen. Wenn Sie die erforderlichen Berechtigungen haben, können Sie CustomColumn-Ressourcen anfordern, die zu einem beliebigen Konto im Kontobaum gehören.
Kontoverwaltung
In der neuen Search Ads 360-Version werden Konten in einer Hierarchie von Verwaltungskonten, untergeordneten Verwaltungskonten und Kundenkonten organisiert. Ein Verwaltungskonto entspricht dem Agenturkonto, und untergeordnete Verwaltungskonten entsprechen Werbetreibendenkonten in der vorherigen Search Ads 360-Version. Weitere Informationen finden Sie unter Search Ads 360-Verwaltungskonten.
Sie können den Kontobaum abfragen und dann Anfragen für jedes Konto senden, aus dem Sie Berichtsdaten abrufen möchten.
Aufgrund der Änderung der Kontohierarchie wurden Felder, die sich auf das Konzept „Werbetreibender/Werbeagentur“ beziehen, durch geeignete Alternativen ersetzt, um nach Möglichkeit für funktionale Parität zu sorgen. Eine Liste der betroffenen Felder und ihrer Ersatzfelder finden Sie unter Felderzuordnungen.
Kopfzeile für Kundennummer beim Anmelden
login-customer-id ist eine neue Kopfzeile, die erforderlich ist, wenn Sie über ein Verwaltungskonto auf ein untergeordnetes Verwaltungskonto oder ein Kundenkonto zugreifen. Weitere Informationen finden Sie im Header der Log-in-Kundennummer.
Versionsverwaltung
Die Search Ads 360 Reporting API verwendet semantisches Versionskontrollsystem.
Es gibt Haupt- und Nebenversionen im Format vMAJOR_MINOR. Weitere Informationen finden Sie unter Versionsverwaltung.