Berichte

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

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

Sie können dieser Abfrage typspezifische Attribute hinzufügen, um asset-spezifische Eigenschaften 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, indem der Wert asset.type gefiltert wird. Eine Liste der möglichen Typwerte für YoutubeVideoAsset finden Sie hier.

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 einige Ressourcen verfügbar:

Mit diesen Ressourcen können Sie Asset-Messwerte auf jeder entsprechenden Ebene abfragen. Wenn Sie beispielsweise die Ressource ad_group_asset abfragen, können Sie die Ergebnisse mit dem Feld ad_group.id segmentieren und so Messwerte für jede eindeutige Kombination aus 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 aggregiert. In dieser Ansicht werden Messwerte für Assets pro Anzeige erfasst. Wenn Sie diese Ansicht abfragen, wird also eine Zeile pro Anzeigengruppe und Anzeige zurückgegeben.

Über ad_group_ad_asset_view wird das ansichtsspezifische Attribut performance_label verfügbar gemacht, das Aufschluss über die Leistungsmerkmale dieser spezifischen Kombination aus Asset und Anzeige gibt. In der folgenden Tabelle sind die möglichen Werte der Felder performance_label aufgeführt.

performance_labelBeschreibung
BESTLeistungsstärkste Assets
GOODAssets mit guter Leistung.
LOWAssets mit der schlechtesten Leistung.
LEARNINGFür das Asset werden Impressionen erzielt, aber die Statistiken sind nicht statistisch signifikant genug, um ein Leistungslabels für das Asset zu erhalten.
PENDINGFür dieses Asset liegen noch keine Informationen zur Leistung vor. Das kann daran liegen, dass die App noch überprüft wird.
UNKNOWNStellt einen unbekannten Wert in dieser Version dar.
UNSPECIFIEDNicht angegeben.

Mit der folgenden GAQL-Abfrage werden Impressionen, Klicks, Kosten und Conversions für alle Assets in einem Konto im letzten Monat zurückgegeben, 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 genau.

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