Struktur der Search Ads 360 Reporting API

Die Hauptkomponenten der Search Ads 360 Reporting API sind Ressourcen und Dienste. Eine Ressource stellt eine Search Ads 360-Entität dar. Sie verwenden einen Dienst zum Abrufen von Search Ads 360-Entitäten.

Objekthierarchie

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

  • Die Ressource der obersten Ebene eines Kontos ist der Kunde.

  • Jedes Konto enthält mindestens eine aktive Kampagne.

  • Jede Campaign enthält eine oder mehrere Anzeigengruppen, in denen Ihre Anzeigen in logischen Sammlungen zusammengefasst sind.

  • Jede AdGroup enthält mindestens eine Anzeige der 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 Kriteriumstypen wie Keywords, Altersgruppen und Standorte. Auf Kampagnenebene definierte Kriterien wirken sich auf alle anderen Ressourcen in der Kampagne aus. Außerdem können Sie für die gesamte Kampagne geltende Budgets und Termine angeben.

Ressourcen

Ressourcen stellen die Entitäten 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. in allen Search Ads 360-Konten, während andere nur innerhalb eines begrenzten Bereichs eindeutig sind.

Bereich der Eindeutigkeit der Objekt-ID
Budget-ID Global
Kampagnen-ID Global
Anzeigengruppen-ID Global
Anzeigen-ID Anzeigengruppe

Jedes AdGroupId / AdId-Paar ist global eindeutig.
ID des Anzeigengruppenkriteriums Anzeigengruppe

Jedes AdGroupId / CriterionId-Paar ist global eindeutig.
ID des Kampagnenkriteriums Kampagne

Jedes CampaignId / CriterionId-Paar ist global eindeutig.
Anzeigenerweiterungen Kampagne

Jedes CampaignId / AdExtensionId-Paar ist global eindeutig.
Feed-ID Global
ID des Feedelements Global
Feed-Attribut-ID Feed
Feed-Mapping-ID Global
Label-ID Global
Nutzerlisten-ID Global

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 das Feld type, das seinen Inhalt beschreibt. Beispielsweise kann AdGroupAd sich auf eine Textanzeige, eine Hotelanzeige oder eine lokale Anzeige beziehen. Sie können über das Feld AdGroupAd.ad.type auf den Typwert zugreifen. Der Wert wird in der AdType-Enum zurückgegeben.

Ressourcennamen

Jede Ressource ist eindeutig durch einen resource_name-String gekennzeichnet, der die Ressource und ihre übergeordneten Elemente zu einem Pfad verkettet.

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 enthält die resource_name:

customers/1234567/campaigns/987654

Dienste

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

Suchdienst
SearchAds360Service ist der einzige, einheitliche Dienst zum Abrufen aller Ressourcenobjekte und Leistungsstatistiken. Es bietet zwei Methoden: Search und SearchStream. Beide Methoden erfordern eine Abfrage, die die abzufragende Ressource, die abzurufenden Ressourcenattribute und Leistungsmesswerte, die Prädikate zum Filtern der Anfrage und die Segmente für die weitere Aufschlüsselung von Leistungsstatistiken angibt. Weitere Informationen finden Sie unter Suchberichte erstellen und Search Ads 360 Query Language.
Außendienst
SearchAds360FieldService ruft Metadaten zu Ressourcen ab, z. B. die verfügbaren Attribute für eine Ressource und ihren 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 stellen eine GET-Anfragemethode bereit, mit der eine einzelne Ressourceninstanz abgerufen wird. Dies ist nützlich, um die Struktur einer Ressource zu untersuchen.

Beispiele für entitätsspezifische Dienste: