Sie können eine Liste der Assets und ihrer Attribute abrufen, indem Sie eine Google Ads Query Language-Abfrage (GAQL) 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 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.
Ü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_label | Beschreibung |
|---|---|
BEST | Leistungsstärkste Assets |
GOOD | Assets mit guter Leistung. |
LOW | Assets mit der schlechtesten Leistung. |
LEARNING | Für das Asset werden Impressionen erzielt, aber die Statistiken sind nicht statistisch signifikant genug, um ein Leistungslabels für das Asset zu erhalten. |
PENDING | Für dieses Asset liegen noch keine Informationen zur Leistung vor. Das kann daran liegen, dass die App noch überprüft wird. |
UNKNOWN | Stellt einen unbekannten Wert in dieser Version dar. |
UNSPECIFIED | Nicht 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.