Berichte

Sie können eine Liste der Assets und ihrer Attribute abrufen, indem Sie eine Google Ads Query Language (GAQL)-Abfrage an den GoogleAdsService senden. Assets werden durch die Entität asset dargestellt, die eine Reihe von assetspezifischen Feldern enthält.

Asset-Attribute

In der folgenden GAQL-Abfrage werden alle Assets im Konto eines Werbetreibenden zusammen mit dem Ressourcennamen und dem Ressourcentyp aufgeführt.

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

Es gibt typspezifische Attribute, die du dieser Abfrage hinzufügen kannst, um assetspezifische Properties wie ImageAsset oder YoutubeVideoAsset zu lesen.

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

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 sind über verschiedene Ressourcen verfügbar:

Mit diesen Ressourcen können Asset-Messwerte auf jeder entsprechenden Ebene abgefragt werden. Wenn Sie beispielsweise die Ressource ad_group_asset abfragen, können Sie mit dem Feld ad_group.id die Ergebnisse segmentieren und so Messwerte für jede eindeutige Kombination von ad_group und asset abrufen:

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 ad_group_ad_asset_view zusammengefasst. In dieser Ansicht werden Messwerte für Assets pro einzelner Anzeige erfasst. Wenn Sie diese Ansicht abfragen, wird also eine Zeile pro Anzeigengruppe und Anzeige zurückgegeben.

ad_group_ad_asset_view stellt das ansichtenspezifische Attribut performance_label bereit, das Aufschluss über die Leistungsmerkmale dieser bestimmten Kombination aus Asset und Anzeige gibt. Die möglichen Werte der performance_label-Felder sind in der folgenden Tabelle aufgeführt.

performance_labelBeschreibung
BESTLeistungsstärkste Assets
GOODAssets mit guter Leistung
LOWAssets mit der schlechtesten Leistung.
LEARNINGDas Asset erzielt zwar Impressionen, die Statistiken sind aber nicht statistisch signifikant genug, um ein Asset-Leistungslabel zu erhalten.
PENDINGFür dieses Asset liegen noch keine Informationen zur Leistung vor. Möglicherweise wird es noch geprüft.
UNKNOWNStellt den Wert „Unbekannt“ in dieser Version dar.
UNSPECIFIEDNicht angegeben.

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

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

Asset-Quelle

Asset.source ist nur für mutable-Assets korrekt.

Verwenden Sie für die Quelle der RSA-Assets AdGroupAdAsset.source.