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 zur Struktur der Search Ads 360 Reporting API
Berichte zur Suche
Die Suche hat in der neuen API einen eigenen Dienst. Der Suchdienst ersetzt den alten Berichts-Dienst. Alle Anfragen werden über SearchAds360Service gesendet. Diese API bietet zwei Methoden, SearchStream und Search, zum Suchen und Abrufen von Berichtsdaten und ‑messwerten. Beide Suchmethoden geben alle SearchAds360Row-Objekte zurück, die Ihrer Suchanfrage entsprechen. Weitere Informationen finden Sie unter Suchberichte erstellen.
Ressourcenmetadaten
Mit SearchAds360FieldService können Sie den Katalog für Ressourcen, Ressourcenfelder, Segmentierungsschlüssel und Messwerte, die in den SearchAds360Service-Suchmethoden verfügbar sind, dynamisch anfordern. Weitere Informationen finden Sie unter Ressourcenmetadaten abrufen.
Feldnamen
In der API werden verschachtelte Feldnamen eingeführt, die durch Punkte getrennt sind. Beispiel: campaign.id und ad_group.id. Sie können auch weitere Elemente verschachteln, z. B. ad_group.campaign.id. Weitere Informationen zur Struktur der Search Ads 360 Reporting API
Berichte in der vorherigen Search Ads 360 API basieren auf separaten Feldern für ähnliche Konzepte in verschiedenen Entitäten. Sowohl der Bericht campaign als auch der Bericht adgroup enthalten beispielsweise ein separates Feld campaignId.
Abfragesprache
Mit der API wird die Search Ads 360-Abfragesprache eingeführt. Diese flexible, SQL-ähnliche Sprache ermöglicht es Ihnen, Abfragen zu definieren, um die spezifischen Berichtsdaten abzurufen, die am besten zu Ihrem Unternehmen passen. Weitere Informationen zur Search Ads 360-Abfragesprache
Anfragen erhalten
In der neuen API hat die Suche einen eigenen Dienst (SearchAds360Service), aber GET-Anfragen sind weiterhin für den jeweiligen Dienst der einzelnen Einheiten verfügbar. Sie können beispielsweise Informationen zu benutzerdefinierten Spalten aus CustomColumnService abrufen.
Weitere Informationen zu 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 dem neuen CustomColumnService können benutzerdefinierte Spalten erstellt werden. Sofern 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 Verwaltungs-, untergeordneten Verwaltungs- und Kundenkonten organisiert. Ein Verwaltungskonto entspricht dem Agenturkonto, und untergeordnete Verwaltungskonten entsprechen Werbetreibendenkonten in der vorherigen Search Ads 360-Version. Weitere Informationen zu Search Ads 360-Verwaltungskonten
Sie können den Kontobaum abfragen und dann Anfragen für jedes Konto senden, für das Sie Berichtsdaten erhalten möchten.
Aufgrund der Änderung der Kontohierarchie wurden Felder, die sich auf das Konzept von Werbetreibenden/Agenturen beziehen, durch geeignete Alternativen ersetzt, um nach Möglichkeit funktionale Parität zu erreichen. Eine Liste der betroffenen Felder und ihrer Ersatzfelder finden Sie unter Feldzuordnungen.
Header für die Kundennummer für die Anmeldung
login-customer-id ist ein neuer Header, der erforderlich ist, wenn Sie mit einem Verwaltungskonto auf ein untergeordnetes Verwaltungskonto oder ein Kundenkonto zugreifen. Weitere Informationen finden Sie unter Header für die Kunden-ID für die Anmeldung.
Versionsverwaltung
Für die Search Ads 360 Reporting API wird semantische Versionierung verwendet. Es gibt Haupt- und Nebenversionen, die als vMAJOR_MINOR formatiert sind. Weitere Informationen finden Sie unter Versionsverwaltung.