Sie können eine Liste von Assets und ihren Attributen abrufen, indem Sie eine Google Ads Query Language
-Abfrage (GAQL) an den
GoogleAdsService senden. Assets werden durch
die asset Entität dargestellt, die eine Reihe von assetspezifischen
Feldern enthält.
Asset-Attribute
Die folgende GAQL-Abfrage listet alle Assets in einem Google Ads-Konto zusammen mit ihrem Ressourcennamen und ‑typ auf.
SELECT
asset.id,
asset.name,
asset.resource_name,
asset.type
FROM asset
Sie können dieser Abfrage typspezifische Attribute hinzufügen, um Eigenschaften
abzurufen, die für Assets wie ImageAsset oder
YoutubeVideoAsset spezifisch sind.
Die folgende Abfrage listet beispielsweise die YouTube-Video-IDs für alle
YoutubeVideoAsset-Objekte in einem Google Ads
-Konto auf, indem sie den Wert asset.type filtert. Liste der möglichen asset.type Werte ansehen
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 der jeweiligen Ebene abfragen.
Wenn Sie beispielsweise die ad_group_asset Ressource abfragen, können Sie das
ad_group.id Feld verwenden, um die Ergebnisse zu segmentieren und so Messwerte für jede
eindeutige Kombination aus ad_group und asset abzurufen:
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
Wichtiger Hinweis: ad_group_ad_asset_view gibt nur
Informationen zu Assets zurück, die mit App-Anzeigen, Demand Gen-Anzeigen und
responsiven Suchanzeigen verknüpft sind.
Leistungsmesswerte auf Anzeigenebene für Assets 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 also eine Zeile pro Anzeigengruppe und Anzeige zurückgegeben.
Die ad_group_ad_asset_view enthält das ansichtsspezifische Attribut performance_label, das Einblicke in die Leistungsmerkmale dieser spezifischen Asset-Anzeigen Kombination gibt. In der folgenden Tabelle sind die möglichen Werte der Felder performance_label aufgeführt.
performance_label | Beschreibung |
|---|---|
BEST | Assets mit der besten Leistung. |
GOOD | Assets mit guter Leistung. |
LOW | Assets mit der schlechtesten Leistung. |
LEARNING | Das Asset hat Impressionen erzielt, aber die Statistiken sind nicht statistisch signifikant genug, um ein Label für die Asset-Leistung zu erhalten. |
PENDING | Für dieses Asset liegen noch keine Leistungsinformationen vor. Möglicherweise wird es noch überprüft. |
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 Google Ads-Konto im letzten Monat zurück, sortiert nach ihrem 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änderbare
Assets genau.
Verwenden Sie für die Quelle von Assets für responsive Suchanzeigen
ad_group_ad_asset_view.source.