Berichterstellung

Sie können eine Liste mit Assets und ihren Attributen abrufen, indem Sie eine GAQL-Abfrage (Google Ads Query Language) an den GoogleAdsService senden. Assets werden durch die Entität asset repräsentiert, die eine Reihe von assetspezifischen Feldern bietet.

Asset-Attribute

Mit der folgenden GAQL-Abfrage werden alle Assets im Konto eines Werbetreibenden zusammen mit ihrem Ressourcennamen und -typ aufgelistet.

SELECT
  asset.id,
  asset.name,
  asset.resource_name,
  asset.type
FROM asset

Beachten Sie, dass es typspezifische Attribute gibt, die Sie der obigen Abfrage hinzufügen können, um spezifische Attribute für Assets wie ImageAsset oder YoutubeVideoAsset zu lesen.

Mit der folgenden Abfrage werden beispielsweise die YouTube-Video-IDs für alle YoutubeVideoAsset-Objekte in einem Konto aufgelistet. Dazu wird der Wert asset.type für YoutubeVideoAsset gefiltert. In der Dokumentation finden Sie eine Liste der möglichen Typwerte.

SELECT
  asset.id,
  asset.name,
  asset.resource_name,
  asset.youtube_video_asset.youtube_video_id
FROM asset
WHERE asset.type = 'YOUTUBE_VIDEO'

Asset-Messwerte

Asset-Messwerte stehen über verschiedene Ressourcen zur Verfügung:

Mit diesen Ressourcen können Asset-Messwerte auf der jeweiligen Ebene abgefragt werden. Bei der Abfrage der Ressource ad_group_asset kann beispielsweise das Feld ad_group.id verwendet werden, um die Ergebnisse zu segmentieren und auf diese Weise Messwerte für jede eindeutige Kombination aus ad_group und asset abzurufen:

SELECT
  ad_group.id,
  asset.id,
  metrics.clicks,
  metrics.impressions
FROM ad_group_asset
WHERE segments.date DURING LAST_MONTH
ORDER BY metrics.impressions DESC

Messwerte auf Anzeigenebene

Leistungsmesswerte auf Anzeigenebene für Assets werden in der ad_group_ad_asset_view zusammengefasst. In dieser Ansicht werden Messwerte für Assets pro Einzelanzeige erfasst. Bei der Abfrage dieser Ansicht wird daher eine Zeile pro Anzeigengruppe und Anzeige zurückgegeben.

Über die ad_group_ad_asset_view wird das ansichtsspezifische Attribut performance_label bereitgestellt, das einen Einblick in die Leistungsmerkmale dieses spezifischen Asset-Anzeigen-Paars bietet. In der folgenden Tabelle sind die möglichen Werte der performance_label-Felder aufgeführt.

`performance_label`	Beschreibung
`BEST`	Leistungsstärkste Assets
`GOOD`	Assets mit guter Leistung
`LOW`	Leistungsschwächste Assets
`LEARNING`	Das Asset erhält zwar Impressionen, aber die Statistiken sind statistisch nicht signifikant genug, um ein Asset-Leistungslabel zu erhalten.
`PENDING`	Für dieses Asset liegen noch keine Leistungsinformationen vor. Möglicherweise wird es noch überprüft.
`UNKNOWN`	Stellt einen in dieser Version unbekannten Wert dar.
`UNSPECIFIED`	Nicht angegeben.

Die folgende GAQL-Abfrage gibt Impressionen, Klicks, Kosten und Conversions für alle Assets in einem Konto im letzten Monat sortiert nach performance_label zurück:

SELECT
  ad_group_ad_asset_view.ad_group_ad,
  ad_group_ad_asset_view.asset,
  ad_group_ad_asset_view.field_type,
  ad_group_ad_asset_view.performance_label,
  metrics.impressions,
  metrics.clicks,
  metrics.cost_micros,
  metrics.conversions
FROM ad_group_ad_asset_view
WHERE segments.date DURING LAST_MONTH
ORDER BY ad_group_ad_asset_view.performance_label

Zurück

Automatisch erstellte Assets

Weiter

Assets