Sie können eine Liste der Assets und ihrer Attribute abrufen, indem Sie eine GAQL-Abfrage (Google Ads Query Language) an die GoogleAdsService senden. Assets werden durch die Entität asset dargestellt, die eine Reihe von Asset-spezifischen Feldern enthält.
Asset-Attribute
In der folgenden GAQL-Abfrage werden alle Assets in einem Google Ads-Konto zusammen mit ihrem Ressourcennamen und -typ aufgeführt.
SELECT
asset.id,
asset.name,
asset.resource_name,
asset.type
FROM asset
Sie können dieser Abfrage typspezifische Attribute hinzufügen, um Properties zu lesen, die für Assets wie ImageAsset oder YoutubeVideoAsset spezifisch sind.
Mit der folgenden Abfrage werden beispielsweise die YouTube-Video-IDs für alle YoutubeVideoAsset-Objekte in einem Google Ads-Konto aufgelistet, indem der Wert asset.type gefiltert wird. Liste der möglichen asset.type-Werte
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 werden über einige Ressourcen zur Verfügung gestellt:
Mit diesen Ressourcen können Sie Asset-Messwerte auf der jeweiligen Ebene abfragen.
Wenn Sie beispielsweise die Ressource ad_group_asset abfragen, können Sie das Feld ad_group.id verwenden, um die Ergebnisse zu segmentieren. So erhalten Sie Messwerte für jede eindeutige Kombination aus ad_group und asset:
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
Wichtig: ad_group_ad_asset_view gibt nur Informationen zu Assets zurück, die mit App-Anzeigen, Demand Gen-Anzeigen und responsiven Suchanzeigen zusammenhängen.
Leistungsmesswerte für Assets auf Anzeigenebene werden in der ad_group_ad_asset_view zusammengefasst. In dieser Ansicht werden Messwerte für Assets pro Einzelanzeige erfasst. Wenn Sie diese Ansicht abfragen, wird eine Zeile pro Anzeigengruppe und Anzeige zurückgegeben.
Die ad_group_ad_asset_view stellt das ansichtsspezifische Attribut performance_label bereit, das Aufschluss über die Leistungsmerkmale dieser spezifischen Asset-Anzeigen-Kombination gibt. 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 | Assets mit der schlechtesten Leistung. |
LEARNING | Das Asset hat begonnen, Impressionen zu erzielen, aber die Statistiken sind nicht statistisch signifikant genug, um ein Asset-Leistungslabel zu erhalten. |
PENDING | Für dieses Asset liegen noch keine Informationen zur Leistung vor. Das kann daran liegen, dass es noch überprüft wird. |
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 Google Ads-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 veränderliche Assets korrekt.
Verwenden Sie für die Quelle von RSA-Assets ad_group_ad_asset_view.source.