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
Es gibt typspezifische Attribute, die du dieser Abfrage hinzufügen kannst, 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. Dazu wird der Wert asset.type
(eine Liste der möglichen Typwerte finden Sie in der Dokumentation) nach YoutubeVideoAsset
gefiltert.
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 können Asset-Messwerte auf jeder entsprechenden Ebene abgefragt werden.
Wenn Sie beispielsweise die Ressource ad_group_asset
abfragen, können Sie mit dem Feld ad_group.id
die Ergebnisse segmentieren und so Messwerte für jede eindeutige Kombination von 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.
ad_group_ad_asset_view
stellt das ansichtenspezifische Attribut performance_label
bereit, das Aufschluss über die Leistungsmerkmale dieser bestimmten Kombination aus Asset und Anzeige 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 | 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. Möglicherweise wird es noch geprüft. |
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
.