Sie können eine Liste von Assets und ihren Attributen abrufen, indem Sie eine GAQL-Abfrage (Google Ads Query Language) an den Google AdsService senden. Assets werden durch die Entität asset dargestellt, die eine Reihe von assetspezifischen Feldern enthält.
Asset-Attribute
Mit der folgenden GAQL-Abfrage werden alle Assets im Konto eines Werbetreibenden zusammen mit dem Ressourcennamen und -typ aufgelistet.
SELECT
asset.id,
asset.name,
asset.resource_name,
asset.type
FROM asset
Es gibt typspezifische Attribute, die Sie der obigen Abfrage hinzufügen können, um spezifische Attribute von Assets wie ImageAsset oder YoutubeVideoAsset zu lesen.
Die folgende Abfrage listet beispielsweise die YouTube-Video-IDs für alle YoutubeVideoAsset-Objekte in einem Konto auf. Dazu wird nach YoutubeVideoAsset der Wert asset.type gefiltert. Eine Liste möglicher Typwerte finden Sie in der Dokumentation.
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 verschiedene Ressourcen zur Verfügung gestellt:
Mit diesen Ressourcen können Asset-Messwerte auf der jeweiligen Ebene abgefragt werden.
Wenn beispielsweise die Ressource ad_group_asset abgefragt wird, können die Ergebnisse mithilfe des Felds ad_group.id segmentiert werden. Dadurch werden Messwerte für jede eindeutige Kombination aus ad_group und asset abgerufen:
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 Einzelanzeige erfasst. Bei der Abfrage dieser Ansicht wird also eine Zeile pro Anzeigengruppe und Anzeige zurückgegeben.
Der ad_group_ad_asset_view stellt das ansichtsspezifische Attribut performance_label bereit, das Aufschluss über die Leistungsmerkmale dieser speziellen Kopplung zwischen Asset und Anzeigen gibt. Die möglichen Werte der performance_label-Felder sind in der folgenden Tabelle aufgeführt.
performance_label | Beschreibung |
|---|---|
BEST | Leistungsstärkste Assets |
GOOD | Assets mit guter Leistung |
LOW | Assets mit der schlechtesten Leistung |
LEARNING | Mit dem Asset werden Impressionen erzielt, aber die Statistiken sind statistisch nicht signifikant genug, um ein Asset-Leistungslabel zu erhalten. |
PENDING | Für dieses Asset gibt es noch keine Leistungsinformationen. Das könnte daran liegen, dass die Überprüfung noch nicht abgeschlossen ist. |
UNKNOWN | Stellt einen unbekannten Wert in dieser Version dar. |
UNSPECIFIED | Nicht angegeben. |
Die folgende GAQL-Abfrage gibt Impressionen, Klicks, Kosten und Conversions für alle Assets in einem Konto während des letzten Monats 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