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
Sie können dieser Abfrage typspezifische Attribute hinzufügen, 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, indem der Wert asset.type
gefiltert wird. Eine Liste der möglichen Werte für YoutubeVideoAsset
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 kannst du Asset-Messwerte auf jeder entsprechenden Ebene abfragen.
Wenn Sie beispielsweise die Ressource ad_group_asset
abfragen, können Sie die Ergebnisse mithilfe des Felds 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. Bei einer Abfrage dieser Ansicht wird also eine Zeile pro Anzeigengruppe und Anzeige zurückgegeben.
ad_group_ad_asset_view
gibt das ansichtenspezifische Attribut performance_label
aus, das Aufschluss über die Leistungsmerkmale dieser bestimmten Kombination aus Asset und Anzeige 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 erzielt zwar Impressionen, die Statistiken sind aber 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 die Anfrage noch überprüft wird. |
UNKNOWN | Stellt den Wert „Unbekannt“ in dieser Version dar. |
UNSPECIFIED | Nicht 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
.