Struktur der Search Ads 360 Reporting API

Die primären Komponenten der Search Ads 360 Reporting API sind Ressourcen und Dienste. Eine Ressource stellt eine Search Ads 360-Einheit dar. Sie verwenden einen Dienst, um Search Ads 360-Einheiten abzurufen.

Objekthierarchie

Ein Search Ads 360-Konto ist eine Hierarchie von Objekten.

• Die Ressource der obersten Ebene eines Kontos ist customer.

• Jedes Konto enthält mindestens eine aktive Kampagne.

• Jede Campaign enthält eine oder mehrere Anzeigengruppen, in denen Ihre Anzeigen logisch gruppiert werden.

• Jede AdGroup enthält mindestens eine Anzeige aus einer Anzeigengruppe.

• Sie können einer Anzeigengruppe oder Kampagne ein oder mehrere AdGroupCriterion oder CampaignCriterion hinzufügen. Kriterien definieren, wie Anzeigen ausgelöst werden.

  • Es gibt viele Kriterientypen, z. B. Keywords, Altersgruppen und Standorte. Kriterien, die auf Kampagnenebene definiert werden, wirken sich auf alle anderen Ressourcen in der Kampagne aus. Sie können auch kampagnenweite Budgets und Zeiträume festlegen.

Ressourcen

Ressourcen stellen die Einheiten in Ihrem Search Ads 360-Konto dar. Beispielressourcen sind Customer, Campaign und AdGroup.

Objekt-IDs

Jedes Objekt in Search Ads 360 wird durch eine eigene ID identifiziert. Einige IDs sind global eindeutig, d. h. für alle Search Ads 360-Konten, andere nur innerhalb eines bestimmten Bereichs.

Diese ID-Regeln können beim Entwerfen des lokalen Speichers für Ihre Search Ads 360-Objekte hilfreich sein.

Objekttypen

Einige Objekte können für mehrere Entitätstypen verwendet werden. In diesem Fall enthält das Objekt ein type-Feld, das seinen Inhalt beschreibt. AdGroupAd kann sich beispielsweise auf eine Textanzeige, eine Hotelanzeige oder eine lokale Anzeige beziehen. Sie können über das Feld AdGroupAd.ad.type auf den Typwert zugreifen. Sein Wert wird im Enum AdType zurückgegeben.

Ressourcennamen

Jede Ressource wird eindeutig durch einen resource_name-String identifiziert, in dem die Ressource und ihre übergeordneten Elemente zu einem Pfad verkettet werden.

Ressourcennamen von Kampagnen haben beispielsweise das folgende Format:

customers/CUSTOMER_ID/campaigns/CAMPAIGN_ID

Eine Kampagne mit der ID 987654 im Search Ads 360-Konto mit der Kundennummer 1234567 hat die folgenden resource_name:

customers/1234567/campaigns/987654

Dienste

Mit Diensten können Sie Ihre Search Ads 360-Entitäten und ‑Metadaten abrufen. Es gibt drei Servicetypen:

Suchdienst

SearchAds360Service ist der einzige einheitliche Dienst zum Abrufen aller Ressourcenobjekte und Leistungsstatistiken. Es gibt zwei Methoden: Search und SearchStream. Für beide Methoden ist eine Abfrage erforderlich, in der die abzufragende Ressource, die abzurufenden Ressourcenattribute und Leistungsmesswerte, die für das Filtern der Anfrage zu verwendenden Prädikate und die Segmente angegeben werden, mit denen die Leistungsstatistiken weiter aufgeschlüsselt werden sollen. Weitere Informationen finden Sie unter Suchberichte erstellen und Search Ads 360 Query Language.

Kundendienst

Mit

SearchAds360FieldService werden Metadaten zu Ressourcen abgerufen, z. B. die verfügbaren Attribute für eine Ressource und ihr Datentyp. Sie können den Katalog für Ressourcen, Ressourcenfelder, Segmentierungsschlüssel und Messwerte anfordern, die in den SearchAds360Service-Suchmethoden verfügbar sind. Weitere Informationen finden Sie unter Ressourcenmetadaten abrufen.

Entitätsspezifische Dienste

Diese Dienste bieten eine GET-Anfragemethode, mit der eine einzelne Ressourceninstanz abgerufen wird. Dies ist nützlich, um die Struktur einer Ressource zu untersuchen.

Beispiele für entitätsspezifische Dienste:

• CustomColumnService, der die angeforderte benutzerdefinierte Spalte mit allen Details zurückgibt.