Sie können eine Liste von Assets und ihren Attributen abrufen, indem Sie eine Google Ads Query
Language (GAQL)-Abfrage an den GoogleAdsService senden. Assets
werden durch die asset Entität dargestellt, die eine Reihe
assetspezifischer Felder enthält.
Asset-Attribute
Die folgende GAQL-Abfrage listet alle Assets im Konto eines Werbetreibenden 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 Konto auf, indem der Wert
asset.type gefiltert wird. Eine Liste der
möglichen Typwerte für YoutubeVideoAsset finden Sie hier.
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
Leistungsmesswerte auf Anzeigenebene für Assets werden in the
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.
The ad_group_ad_asset_view enthält das
ansichtsspezifische Attribut
performance_label, das
Aufschluss über die Leistungsmerkmale dieser bestimmten 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 Leistungslabel für das Asset zu erhalten. |
PENDING | Für dieses Asset liegen noch keine Leistungsinformationen vor. Das kann daran liegen, dass es noch überprüft wird. |
UNKNOWN | Der Wert ist in dieser Version unbekannt. |
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 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
mutable
-Assets genau.
Verwenden Sie für die Quelle von RSA-Assets
AdGroupAdAsset.source.