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 und Sie verwenden einen Dienst, um Search Ads 360-Entitäten abzurufen.

Objekthierarchie

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

  • Die oberste Ressource eines Kontos ist der Kunde.

  • Jedes Konto enthält eine oder mehrere aktive Kampagnen.

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

  • Jede AdGroup enthält eine oder mehrere Anzeigen in Anzeigengruppen.

  • Sie können einer Anzeigengruppe oder Kampagne eine oder mehrere AdGroupCriterion oder CampaignCriterion hinzufügen. Mit Kriterien wird festgelegt, wie Anzeigen ausgelöst werden.

    • Es gibt viele Kriterienstypen, z. B. Keywords, Altersgruppen und Standorte. Auf Kampagnenebene definierte Kriterien wirken sich auf alle anderen Ressourcen innerhalb der Kampagne aus. Außerdem können Sie für die gesamte Kampagne geltende Budgets und Termine angeben.

Ressourcen

Ressourcen repräsentieren die Entitäten in Ihrem Search Ads 360-Konto. Beispiele für Ressourcen 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, während andere nur in einem begrenzten Umfang eindeutig sind.

Gültigkeitsbereich der Eindeutigkeit der Objekt-ID
Budget-ID Global
Kampagnen-ID Global
Anzeigengruppen-ID Global
Anzeigen-ID Anzeigengruppe

Jedes AdGroupId / AdId-Paar ist weltweit 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
UserList-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 ein type-Feld, das den Inhalt beschreibt. AdGroupAd kann beispielsweise auf eine Textanzeige, eine Hotelanzeige oder eine lokale Anzeige verweisen. Sie können über das Feld AdGroupAd.ad.type auf den Typwert zugreifen. Der Wert wird im Enum AdType zurückgegeben.

Ressourcennamen

Jede Ressource wird durch einen eindeutigen resource_name-String identifiziert, der die Ressource und ihre übergeordneten Elemente zu einem Pfad zusammenfasst.

Ressourcennamen von Kampagnen haben beispielsweise das Format:

customers/CUSTOMER_ID/campaigns/CAMPAIGN_ID

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

customers/1234567/campaigns/987654

Dienste

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

Suchdienst
SearchAds360Service ist der einzige einheitliche Dienst zum Abrufen aller Ressourcenobjekte und Leistungsstatistiken. Es bietet zwei Methoden: Search und SearchStream. Für beide Methoden ist eine Abfrage erforderlich, in der die abzufragende Ressource, die abzurufenden Ressourcenattribute und Leistungsmesswerte, die zum Filtern der Anfrage verwendeten Prädikate und die Segmente für eine weitere Aufschlüsselung der Leistungsstatistiken angegeben werden. Weitere Informationen finden Sie unter Suchberichte erstellen und Such Ads 360-Abfragesprache.
Außendienst
SearchAds360FieldService ruft Metadaten zu Ressourcen ab, z. B. die verfügbaren Attribute für eine Ressource und deren 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. Das ist nützlich, um die Struktur einer Ressource zu untersuchen.

Beispiele für entitätsspezifische Dienste: