Package google.ads.searchads360.v0.resources

Index

AccessibleBiddingStrategy

Stellt eine Ansicht von BiddingStrategies dar, die dem Kunden gehört und mit ihm geteilt wird.

Im Gegensatz zu „BiddingStrategy“ enthält diese Ressource neben den Strategien, die diesem Kunden gehören, auch Strategien, deren Inhaber Manager des Kunden sind und die für diesen Kunden freigegeben wurden. Diese Ressource stellt keine Messwerte bereit und stellt nur eine begrenzte Teilmenge der BiddingStrategy-Attribute bereit.

Felder
resource_name

string

Der Ressourcenname der Gebotsstrategie, auf die zugegriffen werden kann. AccessibleBiddingStrategy-Ressourcennamen haben folgendes Format:

customers/{customer_id}/accessibleBiddingStrategies/{bidding_strategy_id}

id

int64

Die ID der Gebotsstrategie.

name

string

Der Name der Gebotsstrategie.

type

BiddingStrategyType

Der Typ der Gebotsstrategie.

owner_customer_id

int64

Die ID des Kunden, dem die Gebotsstrategie gehört.

owner_descriptive_name

string

description_name des Kunden, dem die Gebotsstrategie gehört.

Union-Feld scheme. Das Gebotsschema.

Es kann nur ein Wert festgelegt werden. Für scheme ist nur einer der folgenden Werte zulässig:

maximize_conversion_value

MaximizeConversionValue

Eine automatische Gebotsstrategie, mit der Sie im Rahmen Ihres Budgets einen möglichst hohen Conversion-Wert für Ihre Kampagnen erzielen.

maximize_conversions

MaximizeConversions

Eine automatische Gebotsstrategie, mit der Sie im Rahmen Ihres Budgets möglichst viele Conversions für Ihre Kampagnen erzielen.

target_cpa

TargetCpa

Eine Gebotsstrategie, bei der Gebote so festgelegt werden, dass Sie mit Ihrem Ziel-CPA (Cost-per-Acquisition) möglichst viele Conversions erzielen

target_impression_share

TargetImpressionShare

Eine Gebotsstrategie, die automatisch im Hinblick auf einen ausgewählten Prozentsatz von Impressionen optimiert wird.

target_roas

TargetRoas

Eine Gebotsstrategie, mit der Sie Ihren Umsatz maximieren und gleichzeitig einen bestimmten Ziel-ROAS (Return on Advertising Spend) erreichen können.

target_spend

TargetSpend

Eine Gebotsstrategie, bei der Ihre Gebote so festgelegt werden, dass Sie mit Ihrem Budget möglichst viele Klicks erzielen.

MaximizeConversionValue

Eine automatische Gebotsstrategie, mit der Sie im Rahmen Ihres Budgets einen möglichst hohen Conversion-Wert für Ihre Kampagnen erzielen.

Felder
target_roas

double

Die Option "Ziel-ROAS" (Return on Advertising Spend). Wenn diese Option festgelegt ist, maximiert die Gebotsstrategie den Umsatz, während der Ziel-ROAS gemittelt wird. Ist der Ziel-ROAS hoch, kann die Gebotsstrategie unter Umständen nicht das gesamte Budget ausgeben. Ist der Ziel-ROAS nicht festgelegt, versucht die Gebotsstrategie, den höchstmöglichen ROAS für das Budget zu erreichen.

MaximizeConversions

Eine automatische Gebotsstrategie, mit der Sie im Rahmen Ihres Budgets möglichst viele Conversions für Ihre Kampagnen erzielen.

Felder
target_cpa

int64

Ziel-CPA (Cost-per-Acquisition) Das ist der durchschnittliche Betrag, den Sie pro Akquisition ausgeben möchten.

target_cpa_micros

int64

Ziel-CPA (Cost-per-Acquisition) Das ist der durchschnittliche Betrag, den Sie pro Akquisition ausgeben möchten.

TargetCpa

Eine automatische Gebotsstrategie, bei der Gebote so festgelegt werden, dass Sie mit Ihrem Ziel-CPA (Cost-per-Acquisition) möglichst viele Conversions erzielen.

Felder
target_cpa_micros

int64

Durchschnittliches CPC-Ziel. Dieses Ziel muss größer oder gleich der abrechenbaren Mindesteinheit basierend auf der Währung für das Konto sein.

TargetImpressionShare

Eine automatische Gebotsstrategie, bei der Gebote so festgelegt werden, dass ein bestimmter Prozentsatz der Suchanzeigen oben auf der ersten Seite (oder in einer anderen Zielregion) erscheint.

Felder
location

TargetImpressionShareLocation

Die Zielregion auf der Suchergebnisseite

location_fraction_micros

int64

Der Anteil der Anzeigen, die in der Zielregion in Mikros ausgewählt werden sollen. Beispiel: 1% entspricht 10.000.

cpc_bid_ceiling_micros

int64

Das höchste CPC-Gebot, das vom automatischen Gebotssystem festgelegt werden darf. Dies ist ein Pflichtfeld, das vom Werbetreibenden ausgefüllt wird, der die Obergrenze festlegt, und das in lokalen Micros-Werten angegeben wird.

TargetRoas

Eine automatische Gebotsstrategie, mit der Sie Ihren Umsatz maximieren und gleichzeitig einen bestimmten Ziel-ROAS (Return on Advertising Spend) erreichen können.

Felder
target_roas

double

Der gewählte Umsatz (basierend auf den Conversion-Daten) pro Ausgabeneinheit.

TargetSpend

Eine automatische Gebotsstrategie, bei der Ihre Gebote so festgelegt werden, dass Sie mit Ihrem Budget möglichst viele Klicks erzielen.

Felder
target_spend_micros
(deprecated)

int64

Das Ausgabenziel, unter dem die Klicks maximiert werden sollen. Eine TargetSpend-Gebotsfunktion versucht, den kleineren Wert oder den natürlichen Drosselungsbetrag auszugeben. Wenn nicht angegeben, wird das Budget als Ausgabenziel verwendet. Dieses Feld ist veraltet und sollte nicht mehr verwendet werden. Weitere Informationen finden Sie unter https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html.

cpc_bid_ceiling_micros

int64

Höchstgrenze, die von der Gebotsstrategie festgelegt werden kann. Der Grenzwert gilt für alle von der Strategie verwalteten Keywords.

Eine Anzeige.

Felder
resource_name

string

Der Ressourcenname der Anzeige. Namen von Anzeigenressourcen haben folgendes Format:

customers/{customer_id}/ads/{ad_id}

final_urls[]

string

Die Liste möglicher endgültige URLs nach allen domainübergreifenden Weiterleitungen für die Anzeige.

type

AdType

Der Typ der Anzeige.

id

int64

Die ID der Anzeige.

display_url

string

Die URL, die in der Anzeigenbeschreibung für einige Formate angezeigt wird.

name

string

Der Name der Anzeige. Diese dient nur dazu, die Anzeige zu identifizieren. Sie muss nicht eindeutig sein und wirkt sich nicht auf die ausgelieferte Anzeige aus. Das Feld "Name" wird derzeit nur für DisplayUploadAd, ImageAd, ShoppingComparisonListingAd und VideoAd unterstützt.

Union-Feld ad_data. Details zum Anzeigentyp. Es muss genau ein Wert festgelegt werden. Für ad_data ist nur einer der folgenden Werte zulässig:
text_ad

SearchAds360TextAdInfo

Details zur Textanzeige

expanded_text_ad

SearchAds360ExpandedTextAdInfo

Details zu einer erweiterten Textanzeige

responsive_search_ad

SearchAds360ResponsiveSearchAdInfo

Details zu einer responsiven Suchanzeige

product_ad

SearchAds360ProductAdInfo

Details zur Produktanzeige

expanded_dynamic_search_ad

SearchAds360ExpandedDynamicSearchAdInfo

Details zu einer erweiterten dynamischen Suchanzeige

Anzeigengruppe

Eine Anzeigengruppe.

Felder
resource_name

string

Der Ressourcenname der Anzeigengruppe. Ressourcennamen für Anzeigengruppen haben folgendes Format:

customers/{customer_id}/adGroups/{ad_group_id}

status

AdGroupStatus

Der Status der Anzeigengruppe.

type

AdGroupType

Der Typ der Anzeigengruppe.

ad_rotation_mode

AdGroupAdRotationMode

Der Modus der Anzeigenrotation der Anzeigengruppe.

creation_time

string

Der Zeitstempel für den Zeitpunkt, zu dem diese Anzeigengruppe erstellt wurde. Der Zeitstempel hat die Zeitzone des Kunden und ist im Format "JJJJ-MM-TT HH:mm:ss.ssssss".

targeting_setting

TargetingSetting

Einstellung für auf Ausrichtung bezogene Funktionen.

labels[]

string

Die Ressourcennamen der Labels, die dieser Anzeigengruppe zugeordnet sind.

engine_id

string

ID der Anzeigengruppe im externen Engine-Konto. Dieses Feld ist nur für Konten, die kein Google Ads-Konto sind, z. B. Yahoo! Japan, Microsoft oder Baidu. Verwenden Sie für Google Ads-Entitäten „ad_group.id“. .

start_date

string

Datum, an dem die Anzeigengruppe beginnt, Anzeigen bereitzustellen. Standardmäßig beginnt die Anzeigengruppe jetzt oder am Startdatum der Anzeigengruppe, je nachdem, was später ist. Ist dieses Feld festgelegt, beginnt die Anzeigengruppe am Anfang des angegebenen Datums in der Zeitzone des Kunden. Dieses Feld ist nur für Microsoft Advertising- und Facebook-Gateway-Konten verfügbar.

Format: JJJJ-MM-TT, Beispiel: 2019-03-14

end_date

string

Datum, an dem die Anzeigengruppe nicht mehr Anzeigen bereitstellt. Standardmäßig endet die Anzeigengruppe am Enddatum der Anzeigengruppe. Ist dieses Feld festgelegt, endet die Anzeigengruppe am Ende des angegebenen Datums in der Zeitzone des Kunden. Dieses Feld ist nur für Microsoft Advertising- und Facebook-Gateway-Konten verfügbar.

Format: JJJJ-MM-TT, Beispiel: 2019-03-14

language_code

string

Die Sprache der Anzeigen und Keywords in einer Anzeigengruppe. Dieses Feld ist nur für Microsoft Advertising-Konten verfügbar. Weitere Informationen: https://docs.microsoft.com/en-us/advertising/guides/ad-languages?view=bingads-13#adlanguage

last_modified_time

string

Der Zeitpunkt der letzten Änderung der Anzeigengruppe. Das Datum und die Uhrzeit hat die Zeitzone des Kunden und ist im Format "JJJJ-MM-TT HH:mm:ss.ssssss".

id

int64

Die ID der Anzeigengruppe.

name

string

Der Name der Anzeigengruppe.

Dieses Feld ist erforderlich und darf beim Erstellen neuer Anzeigengruppen nicht leer sein.

Er muss weniger als 255 UTF-8-Zeichen in voller Breite enthalten.

Er darf keine Null (Codepunkt 0x0), NL-Zeilenvorschub (Codepunkt 0xA) oder Zeilenumbruchzeichen (Codepunkt 0xD) enthalten.

cpc_bid_micros

int64

Das maximale CPC-Gebot (Cost-per-Click).

engine_status

AdGroupEngineStatus

Der Suchmaschinenstatus für die Anzeigengruppe.

AdGroupAd

Anzeige einer Anzeigengruppe

Felder
resource_name

string

Der Ressourcenname der Anzeige. Anzeigengruppennamen für Anzeigenressourcen haben folgendes Format:

customers/{customer_id}/adGroupAds/{ad_group_id}~{ad_id}

status

AdGroupAdStatus

Der Status der Anzeige.

ad

Ad

Die Anzeige.

creation_time

string

Der Zeitstempel für den Zeitpunkt, zu dem die ad_group_ad erstellt wurde. Das Datum und die Uhrzeit hat die Zeitzone des Kunden und ist im Format "JJJJ-MM-TT HH:mm:ss.ssssss".

labels[]

string

Die Ressourcennamen der Labels, die dieser Anzeigengruppenanzeige zugeordnet sind.

engine_id

string

ID der Anzeige im externen Engine-Konto. Dieses Feld gilt nur für ein Search Ads 360-Konto, z. B. Yahoo! Japan, Microsoft oder Baidu. Verwenden Sie für Nicht-Search Ads 360-Elemente „ad_group_ad.ad.id“. .

engine_status

AdGroupAdEngineStatus

Zusätzlicher Status der Anzeige im externen Suchmaschinenkonto. Mögliche Status (je nach Art des externen Kontos) sind "Aktiv", "berechtigt", "Überprüfung steht aus" usw.

last_modified_time

string

Der Zeitpunkt der letzten Änderung der Anzeigengruppenanzeige. Das Datum und die Uhrzeit hat die Zeitzone des Kunden und ist im Format "JJJJ-MM-TT HH:mm:ss.ssssss".

AdGroupAdLabel

Beziehung zwischen einer Anzeige in einer Anzeigengruppe und einem Label.

Felder
resource_name

string

Der Ressourcenname des Anzeigenlabels der Gruppe. Ressourcennamen für Anzeigenlabels für Anzeigengruppen haben das folgende Format: customers/{customer_id}/adGroupAdLabels/{ad_group_id}~{ad_id}~{label_id}

ad_group_ad

string

Die Anzeigengruppe, an die das Label angehängt ist.

label

string

Das Label, das der Anzeigengruppe zugewiesen ist.

AdGroupAsset

Eine Verknüpfung zwischen einer Anzeigengruppe und einem Asset.

Felder
resource_name

string

Der Ressourcenname des Anzeigengruppen-Assets. Ressourcennamen für Anzeigengruppen-Assets haben folgendes Format:

customers/{customer_id}/adGroupAssets/{ad_group_id}~{asset_id}~{field_type}

ad_group

string

Erforderlich. Die Anzeigengruppe, mit der das Asset verknüpft ist.

asset

string

Erforderlich. Das Asset, das mit der Anzeigengruppe verknüpft ist.

status

AssetLinkStatus

Status des Anzeigengruppen-Assets.

AdGroupAssetSet

Ein AdGroupAssetSet ist die Verknüpfung zwischen einer Anzeigengruppe und einem Asset-Satz. Durch das Erstellen eines AdGroupAssetSet wird ein Asset-Satz mit einer Anzeigengruppe verknüpft.

Felder
resource_name

string

Der Ressourcenname der Asset-Gruppe der Anzeigengruppe. Ressourcennamen der Asset-Gruppen einer Anzeigengruppe haben folgendes Format:

customers/{customer_id}/adGroupAssetSets/{ad_group_id}~{asset_set_id}

ad_group

string

Die Anzeigengruppe, mit der diese Asset-Gruppe verknüpft ist.

asset_set

string

Die Asset-Gruppe, die mit der Anzeigengruppe verknüpft ist.

status

AssetSetLinkStatus

Der Status der Asset-Gruppe der Anzeigengruppe. Schreibgeschützt.

AdGroupAudienceView

Eine Zielgruppenansicht für eine Anzeigengruppe Enthält Leistungsdaten aus Interessen und Remarketing-Listen für Anzeigen im Displaynetzwerk und im YouTube-Werbenetzwerk sowie aus Remarketing-Listen für Suchanzeigen, die auf Zielgruppenebene zusammengefasst werden.

Felder
resource_name

string

Der Ressourcenname der Zielgruppenansicht für die Anzeigengruppe. Ressourcennamen für Anzeigengruppen-Zielgruppenansichten haben folgendes Format:

customers/{customer_id}/adGroupAudienceViews/{ad_group_id}~{criterion_id}

AdGroupBidModifier

Bezeichnet eine Gebotsanpassung auf Anzeigengruppenebene.

Felder
resource_name

string

Der Ressourcenname der Anzeigengruppe für die Gebotsanpassung. Ressourcennamen für Gebotsanpassungen für Anzeigengruppen haben folgendes Format:

customers/{customer_id}/adGroupBidModifiers/{ad_group_id}~{criterion_id}

bid_modifier

double

Die Anpassung für das Gebot, wenn das Kriterium übereinstimmt. Die Anpassung muss im Bereich zwischen 0,1 und 10,0 liegen. Der Bereich ist 1,0 bis 6,0 für PreferredContent. Verwenden Sie 0, um einen Gerätetyp zu deaktivieren.

Union-Feld criterion. Das Kriterium dieser Gebotsanpassung auf Anzeigengruppenebene.

Erforderlich bei Erstellungsvorgängen ab Version 5. Für criterion ist nur einer der folgenden Werte zulässig:

device

DeviceInfo

Ein Gerätekriterium.

AdGroupCriterion

Ein Kriterium für die Anzeigengruppe. Der Bericht „ad_group_criterion“ gibt nur Kriterien zurück, die der Anzeigengruppe explizit hinzugefügt wurden.

Felder
resource_name

string

Der Ressourcenname des Anzeigengruppenkriteriums. Ressourcennamen für Anzeigengruppenkriterien haben folgendes Format:

customers/{customer_id}/adGroupCriteria/{ad_group_id}~{criterion_id}

creation_time

string

Der Zeitstempel, zu dem diese Anzeigengruppe-Kriterium erstellt wurde. Der Zeitstempel hat die Zeitzone des Kunden und ist im Format "JJJJ-MM-TT HH:mm:ss.ssssss".

status

AdGroupCriterionStatus

Der Status des Kriteriums.

Dies ist der Status der vom Kunden festgelegten Anzeigengruppen-Kriteriumsentität festgelegt. Hinweis: Berichte der Benutzeroberfläche können zusätzliche Informationen enthalten, die sich darauf auswirken, ob ein Kriterium erstellt werden kann. In einigen Fällen kann ein Kriterium, das in der API entfernt wird, weiterhin in der Benutzeroberfläche als aktiviert angezeigt werden. So werden beispielsweise Kampagnen standardmäßig für Nutzer aller Altersstufen ausgeliefert, sofern nicht welche ausgeschlossen wurden. In der Benutzeroberfläche wird für jede Altersgruppe der Status „Aktiviert“ angezeigt, da die Anzeigen für diese Nutzer ausgeliefert werden können. Für AdGroupCriterion.status wird jedoch "entfernt" angezeigt, da kein positives Kriterium hinzugefügt wurde.

quality_info

QualityInfo

Informationen zur Qualität des Kriteriums.

type

CriterionType

Der Typ des Kriteriums.

labels[]

string

Die Ressourcennamen der Labels, die dieser Anzeigengruppe-Kriterium zugeordnet sind.

position_estimates

PositionEstimates

Schätzungen für Kriteriumsgebote an verschiedenen Positionen

final_urls[]

string

Die Liste möglicher endgültige URLs nach allen domainübergreifenden Weiterleitungen für die Anzeige.

engine_id

string

ID des Anzeigengruppenkriteriums im externen Suchmaschinenkonto. Dieses Feld ist nur für Konten, die kein Google Ads-Konto sind, z. B. Yahoo! Japan, Microsoft oder Baidu. Verwenden Sie für Google Ads-Elemente „ad_group_criterion.criterion_id“. .

last_modified_time

string

Der Zeitpunkt der letzten Änderung der Anzeigengruppe-Kriterium. Das Datum und die Uhrzeit hat die Zeitzone des Kunden und ist im Format "JJJJ-MM-TT HH:mm:ss.ssssss".

criterion_id

int64

Die ID des Kriteriums.

ad_group

string

Die Anzeigengruppe, zu der das Kriterium gehört.

negative

bool

Gibt an, ob das Kriterium für das Targeting (false) oder das Ausschließen (true) verwendet werden soll.

Dieses Feld ist unveränderlich. Wenn Sie ein Kriterium von positiv zu negativ ändern möchten, entfernen Sie es und fügen Sie es noch einmal hinzu.

bid_modifier

double

Die Anpassung für das Gebot, wenn das Kriterium übereinstimmt. Die Anpassung muss im Bereich zwischen 0,1 und 10,0 liegen. Die meisten Zielkriterien unterstützen Anpassungen.

cpc_bid_micros

int64

Das Gebot für den CPC (Cost-per-Click).

effective_cpc_bid_micros

int64

Das effektive Gebot für den CPC (Cost-per-Click).

engine_status

AdGroupCriterionEngineStatus

Der Suchmaschinenstatus für das Anzeigengruppenkriterium.

final_url_suffix

string

URL-Vorlage zum Anfügen von Parametern an die endgültige URL.

tracking_url_template

string

Die URL-Vorlage zum Erstellen einer Tracking-URL.

Union-Feld criterion. Das Kriterium für die Anzeigengruppe.

Es muss genau ein Wert festgelegt werden. Für criterion ist nur einer der folgenden Werte zulässig:

keyword

KeywordInfo

Keyword.

listing_group

ListingGroupInfo

Eintragsgruppe.

age_range

AgeRangeInfo

Altersgruppe.

gender

GenderInfo

Gender.

user_list

UserListInfo

Nutzerliste.

webpage

WebpageInfo

Webseite

location

LocationInfo

Standort.

PositionEstimates

Schätzungen für Kriteriumsgebote an verschiedenen Positionen

Felder
top_of_page_cpc_micros

int64

Die Schätzung des CPC-Gebots, das erforderlich ist, damit die Anzeige oben auf der ersten Seite der Suchergebnisse angezeigt wird.

QualityInfo

Ein Container für Informationen zur Qualität des Anzeigengruppenkriteriums.

Felder
quality_score

int32

Der Qualitätsfaktor.

Dieses Feld wird möglicherweise nicht ausgefüllt, wenn Google nicht genügend Informationen zur Bestimmung eines Werts hat.

AdGroupCriterionLabel

Beziehung zwischen einem Anzeigengruppenkriterium und einem Label

Felder
resource_name

string

Der Ressourcenname des Labels der Anzeigengruppe, das die Kriterien erfüllt. Ressourcennamen des Kriteriumslabels für Anzeigengruppen haben das folgende Format: customers/{customer_id}/adGroupCriterionLabels/{ad_group_id}~{criterion_id}~{label_id}

ad_group_criterion

string

Das Kriterium der Anzeigengruppe, mit dem das Label verknüpft ist.

label

string

Das Label, das dem Gruppenkriterium zugewiesen ist.

AdGroupLabel

Beziehung zwischen einer Anzeigengruppe und einem Label.

Felder
resource_name

string

Der Ressourcenname des Labels der Anzeigengruppe. Ressourcennamen von Anzeigengruppenlabels haben das folgende Format: customers/{customer_id}/adGroupLabels/{ad_group_id}~{label_id}

ad_group

string

Die Anzeigengruppe, mit der das Label verknüpft ist.

label

string

Das Label, das der Anzeigengruppe zugewiesen ist.

AgeRangeView

Eine Altersgruppe.

Felder
resource_name

string

Der Ressourcenname der Altersgruppenansicht. Ressourcennamen für Altersbereiche haben folgendes Format:

customers/{customer_id}/ageRangeViews/{ad_group_id}~{criterion_id}

Asset

Das Asset ist Teil einer Anzeige, das für mehrere Anzeigen verwendet werden kann. Es kann sich dabei um ein Bild (ImageAsset), ein Video (YouTubeVideoAsset) usw. handeln. Assets sind unveränderlich und können nicht entfernt werden. Wenn ein Asset nicht mehr ausgeliefert werden soll, entfernen Sie es aus der Entität, in der es verwendet wird.

Felder
resource_name

string

Der Ressourcenname des Assets. Asset-Ressourcennamen haben folgendes Format:

customers/{customer_id}/assets/{asset_id}

type

AssetType

Typ des Assets.

final_urls[]

string

Eine Liste möglicher finaler URLs nach allen domainübergreifenden Weiterleitungen.

status

AssetStatus

Der Status des Assets.

creation_time

string

Der Zeitstempel für den Zeitpunkt, zu dem dieser Asset erstellt wurde. Der Zeitstempel hat die Zeitzone des Kunden und ist im Format "JJJJ-MM-TT HH:mm:ss.ssssss".

last_modified_time

string

Der Zeitpunkt der letzten Änderung an diesem Asset. Das Datum und die Uhrzeit hat die Zeitzone des Kunden und ist im Format "JJJJ-MM-TT HH:mm:ss.ssssss".

id

int64

Die ID des Inhalts.

name

string

Optionaler Name des Assets.

tracking_url_template

string

Die URL-Vorlage zum Erstellen einer Tracking-URL.

engine_status

AssetEngineStatus

Der Suchmaschinenstatus für ein Asset.

Union-Feld asset_data. Der spezifische Typ des Assets. Für asset_data ist nur einer der folgenden Werte zulässig:
youtube_video_asset

YoutubeVideoAsset

Ein YouTube-Video-Asset.

image_asset

ImageAsset

Ein Bild-Asset.

text_asset

TextAsset

Ein Text-Asset.

callout_asset

UnifiedCalloutAsset

Ein einheitliches Asset mit Zusatzinformationen.

page_feed_asset

UnifiedPageFeedAsset

Ein einheitliches Seitenfeed-Asset.

mobile_app_asset

MobileAppAsset

Ein Asset für mobile Apps.

call_asset

UnifiedCallAsset

Ein einheitliches Anruf-Asset.

call_to_action_asset

CallToActionAsset

Ein Call-to-Action-Asset.

location_asset

UnifiedLocationAsset

Ein einheitliches Standort-Asset.

AssetGroup

Eine Asset-Gruppe. AssetGroupAsset wird verwendet, um ein Asset mit der Asset-Gruppe zu verknüpfen. Über „AssetGroupSignal“ wird einer Asset-Gruppe ein Signal zugeordnet.

Felder
resource_name

string

Der Ressourcenname der Asset-Gruppe. Ressourcennamen für Asset-Gruppen haben folgendes Format:

customers/{customer_id}/assetGroups/{asset_group_id}

id

int64

Die ID der Asset-Gruppe.

campaign

string

Die Kampagne, mit der diese Asset-Gruppe verknüpft ist. Das Asset, das mit der Asset-Gruppe verknüpft ist.

name

string

Erforderlich. Der Name der Asset-Gruppe. Erforderlich. Es muss eine Mindestlänge von 1 und eine maximale Länge von 128 haben. Er muss in einer Kampagne eindeutig sein.

final_urls[]

string

Eine Liste der finalen URLs nach allen domainübergreifenden Weiterleitungen. Bei Performance Max-Kampagnen sind die URLs standardmäßig für eine Erweiterung zugelassen, sofern sie nicht deaktiviert sind.

final_mobile_urls[]

string

Eine Liste der finalen mobilen URLs nach allen domainübergreifenden Weiterleitungen. Bei Performance Max-Kampagnen sind die URLs standardmäßig für eine Erweiterung zugelassen, sofern sie nicht deaktiviert sind.

status

AssetGroupStatus

Der Status der Asset-Gruppe.

path1

string

Erster Teil des Textes, der an die URL in der Anzeige angehängt werden kann.

path2

string

Zweiter Teil des Textes, der an die URL angehängt sein kann, die in der Anzeige angezeigt wird. Dieses Feld kann nur festgelegt werden, wenn „path1“ festgelegt ist.

ad_strength

AdStrength

Gesamtanzeigeneffektivität dieser Asset-Gruppe.

AssetGroupAsset

AssetGroupAsset ist die Verknüpfung zwischen einem Asset und einer Asset-Gruppe. Durch das Hinzufügen eines AssetGroup-Assets wird ein Asset mit einer Asset-Gruppe verknüpft.

Felder
resource_name

string

Der Ressourcenname des Asset-Gruppen-Assets. Asset-Ressourcennamen der Asset-Gruppe haben folgendes Format:

customers/{customer_id}/assetGroupAssets/{asset_group_id}~{asset_id}~{field_type}

asset_group

string

Die Asset-Gruppe, die mit diesem Asset verknüpft wird.

asset

string

Das Asset, das mit diesem Asset-Gruppen-Asset verknüpft wird.

field_type

AssetFieldType

Die Beschreibung des Placements des Assets in der Asset-Gruppe. Beispiele: HEADLINE, YOUTUBE_VIDEO usw.

status

AssetLinkStatus

Der Status der Verknüpfung zwischen einem Asset und einer Asset-Gruppe.

AssetGroupAssetCombinationData

Asset-Kombinationsdaten für Asset-Gruppe

Felder
asset_combination_served_assets[]

AssetUsage

Ausgelieferte Assets

AssetGroupListingGroupFilter

„AssetGroupListingGroupFilter“ steht für einen Eintragsgruppenfilterbaum in einer Asset-Gruppe.

Felder
resource_name

string

Der Ressourcenname des Listenfilters für die Asset-Gruppe. Der Name der Filterressource für Asset-Gruppeneintragsgruppen hat folgendes Format:

customers/{customer_id}/assetGroupListingGroupFilters/{asset_group_id}~{listing_group_filter_id}

asset_group

string

Die Asset-Gruppe, zu der dieser Filter für Asset-Eintragsgruppen gehört.

id

int64

Die ID des ListingGroupFilters.

type

ListingGroupFilterType

Typ eines Eintragsgruppenfilterknotens.

vertical

ListingGroupFilterVertical

Die Branche, die die aktuelle Knotenstruktur darstellt. Alle Knoten in einem Baum müssen zur selben Branche gehören.

case_value

ListingGroupFilterDimension

Dimensionswert, mit dem diese Eintragsgruppe das übergeordnete Element optimiert. Nicht definiert für die Stammgruppe.

parent_listing_group_filter

string

Ressourcenname der übergeordneten Untergruppe der Eintragsgruppe. Null für den Filterknoten der Stammeintragsgruppe.

path

ListingGroupFilterDimensionPath

Der Pfad der Dimensionen, mit denen dieser Eintragsgruppenfilter definiert wird.

AssetGroupSignal

„AssetGroupSignal“ steht für ein Signal in einer Asset-Gruppe. Das Vorhandensein eines Signals gibt der Performance Max-Kampagne Aufschluss darüber, bei wem die Conversion-Wahrscheinlichkeit am höchsten ist. Bei Performance Max-Kampagnen wird das Signal verwendet, um nach neuen Nutzern mit ähnlicher oder stärkerer Kaufabsicht zu suchen, um Conversions in Such-, Display- und Videokampagnen sowie auf anderen Plattformen zu erzielen.

Felder
resource_name

string

Der Ressourcenname des Asset-Gruppensignals. Der Name der Signalressource der Asset-Gruppe hat das folgende Format:

customers/{customer_id}/assetGroupSignals/{asset_group_id}~{signal_id}

asset_group

string

Die Asset-Gruppe, zu der dieses Asset-Gruppensignal gehört.

Union-Feld signal. Das Signal der Asset-Gruppe. Für signal ist nur einer der folgenden Werte zulässig:
audience

AudienceInfo

Das Zielgruppensignal, das in der Performance Max-Kampagne verwendet werden soll.

AssetGroupTopCombinationView

Eine Ansicht, in der die Verwendung der Kombination von Anzeigen-Assets in der Anzeigengruppe dargestellt wird.

Felder
resource_name

string

Der Ressourcenname der obersten Kombinationsansicht der Asset-Gruppe. Die Ressourcennamen der AssetGroup-Liste "Top-Kombinationen" haben folgendes Format: "customers/{customer_id}/assetGroupTopCombinationViews/{asset_group_id}~{asset_combination_category}".

asset_group_top_combinations[]

AssetGroupAssetCombinationData

Die leistungsstärksten Kombinationen der Assets, die zusammen ausgeliefert wurden.

AssetSet

Eine Asset-Gruppe, die eine Sammlung von Assets darstellt. Sie können „AssetSetAsset“ zum Verknüpfen eines Assets mit der Asset-Gruppe verwenden.

Felder
id

int64

Die ID der Asset-Gruppe.

resource_name

string

Der Ressourcenname der Asset-Gruppe. Ressourcennamen für Asset-Gruppen haben folgendes Format:

customers/{customer_id}/assetSets/{asset_set_id}

AssetSetAsset

AssetSetAsset ist die Verknüpfung zwischen einem Asset und einer Asset-Gruppe. Durch das Hinzufügen eines AssetSetAsset wird ein Asset mit einer Asset-Gruppe verknüpft.

Felder
resource_name

string

Der Ressourcenname des Asset-Gruppen-Assets. Asset-Ressourcennamen von Asset-Gruppen haben folgendes Format:

customers/{customer_id}/assetSetAssets/{asset_set_id}~{asset_id}

asset_set

string

Der Asset-Satz, mit dem dieses Asset-Set-Asset verknüpft ist.

asset

string

Das Asset, mit dem dieses Asset-Set-Asset verknüpft ist.

status

AssetSetAssetStatus

Der Status des Assets der Asset-Gruppe. Schreibgeschützt.

Zielgruppe

Zielgruppen sind eine effektive Ausrichtungsoption, bei der sich verschiedene Segmentattribute wie detaillierte demografische Merkmale und Zielgruppen mit gemeinsamen Interessen kombinieren lassen, um Zielgruppen zu erstellen, die bestimmten Bereichen Ihrer Zielsegmente entsprechen.

Felder
resource_name

string

Der Ressourcenname der Zielgruppe. Namen von Zielgruppen haben folgendes Format:

customers/{customer_id}/audiences/{audience_id}

id

int64

ID der Zielgruppe.

name

string

Erforderlich. Name der Zielgruppe. Er sollte für alle Zielgruppen eindeutig sein. Es muss eine Mindestlänge von 1 und eine maximale Länge von 255 Zeichen haben.

description

string

Beschreibung dieser Zielgruppe.

BiddingStrategy

Eine Gebotsstrategie

Felder
resource_name

string

Der Ressourcenname der Gebotsstrategie. Ressourcennamen für Gebotsstrategien haben folgendes Format:

customers/{customer_id}/biddingStrategies/{bidding_strategy_id}

status

BiddingStrategyStatus

Der Status der Gebotsstrategie.

Dieses Feld ist schreibgeschützt.

type

BiddingStrategyType

Der Typ der Gebotsstrategie. Erstellen Sie eine Gebotsstrategie, indem Sie das Gebotsschema festlegen.

Dieses Feld ist schreibgeschützt.

currency_code

string

Die Währung, die bei der Gebotsstrategie verwendet wird (dreistelliger ISO 4217-Code).

Für Gebotsstrategien in Verwaltungskonten kann diese Währung bei der Erstellung festgelegt und standardmäßig auf die Währung des Verwaltungskontos festgelegt werden. Für Kunden, die Anzeigen schalten, kann dieses Feld nicht festgelegt werden. Bei allen Strategien eines Kunden, für den eine Dienstleistung erbracht wird, wird implizit die Währung des entsprechenden Kunden verwendet. In allen Fällen gibt das Feld "effective_currency_code" die von der Strategie verwendete Währung zurück.

id

int64

Die ID der Gebotsstrategie.

name

string

Der Name der Gebotsstrategie. Alle Gebotsstrategien innerhalb eines Kontos müssen eindeutig benannt werden.

Die Länge des Strings sollte zwischen 1 und 255 (einschließlich) in UTF-8-Byte (gekürzt) liegen.

effective_currency_code

string

Die Währung, die bei der Gebotsstrategie verwendet wird (dreistelliger ISO 4217-Code).

Bei Gebotsstrategien in Verwaltungskonten ist dies die Währung, die der Werbetreibende beim Erstellen der Strategie festgelegt hat. Bei Dienstleistungen für Kunden ist dies der „currency_code“ des Kunden.

Messwerte für Gebotsstrategien werden in dieser Währung aufgeführt.

Dieses Feld ist schreibgeschützt.

campaign_count

int64

Die Anzahl der Kampagnen, die dieser Gebotsstrategie zugeordnet sind.

Dieses Feld ist schreibgeschützt.

non_removed_campaign_count

int64

Die Anzahl der nicht entfernten Kampagnen, die mit dieser Gebotsstrategie verknüpft sind.

Dieses Feld ist schreibgeschützt.

Union-Feld scheme. Das Gebotsschema.

Es kann nur ein Wert festgelegt werden. Für scheme ist nur einer der folgenden Werte zulässig:

enhanced_cpc

EnhancedCpc

Bei dieser Gebotsstrategie werden Gebote für Klicks erhöht, die mit höherer Wahrscheinlichkeit zu einer Conversion führen, und für weniger wahrscheinliche Klicks gesenkt.

maximize_conversion_value

MaximizeConversionValue

Eine automatische Gebotsstrategie, mit der Sie im Rahmen Ihres Budgets einen möglichst hohen Conversion-Wert für Ihre Kampagnen erzielen.

maximize_conversions

MaximizeConversions

Eine automatische Gebotsstrategie, mit der Sie im Rahmen Ihres Budgets möglichst viele Conversions für Ihre Kampagnen erzielen.

target_cpa

TargetCpa

Eine Gebotsstrategie, bei der Gebote so festgelegt werden, dass Sie mit Ihrem Ziel-CPA (Cost-per-Acquisition) möglichst viele Conversions erzielen

target_impression_share

TargetImpressionShare

Eine Gebotsstrategie, die automatisch im Hinblick auf einen ausgewählten Prozentsatz von Impressionen optimiert wird.

target_outrank_share

TargetOutrankShare

Eine Gebotsstrategie, bei der Gebote basierend auf dem angestrebten Anteil der Auktionen festgelegt werden, bei denen der Werbetreibende einen bestimmten Mitbewerber übertreffen soll. Die Verwendung dieses Feldes wurde eingestellt. Es kann keine neue Gebotsstrategie mit diesem Feld erstellt oder Gebotsstrategien mit diesem Feld mit einer Kampagne verknüpft werden. Änderungen an Strategien, für die dieses Schema bereits ausgefüllt wurde, sind zulässig.

target_roas

TargetRoas

Eine Gebotsstrategie, mit der Sie Ihren Umsatz maximieren und gleichzeitig einen bestimmten Ziel-ROAS (Return on Advertising Spend) erreichen können.

target_spend

TargetSpend

Eine Gebotsstrategie, bei der Ihre Gebote so festgelegt werden, dass Sie mit Ihrem Budget möglichst viele Klicks erzielen.

Kampagne

Eine Kampagne.

Felder
resource_name

string

Der Ressourcenname der Kampagne. Kampagnenressourcennamen haben folgendes Format:

customers/{customer_id}/campaigns/{campaign_id}

status

CampaignStatus

Der Status der Kampagne.

Wenn eine neue Kampagne hinzugefügt wird, ist der Status standardmäßig ENABLED.

serving_status

CampaignServingStatus

Der Status der Anzeigenbereitstellung der Kampagne.

bidding_strategy_system_status

BiddingStrategySystemStatus

Der Systemstatus der Gebotsstrategie der Kampagne.

ad_serving_optimization_status

AdServingOptimizationStatus

Der Optimierungsstatus der Kampagne für die Anzeigenbereitstellung.

advertising_channel_type

AdvertisingChannelType

Das primäre Bereitstellungsziel für Anzeigen innerhalb der Kampagne. Die Ausrichtungsoptionen können in network_settings optimiert werden.

Dieses Feld ist erforderlich und darf beim Erstellen neuer Kampagnen nicht leer sein.

Kann nur beim Erstellen von Kampagnen festgelegt werden. Nachdem die Kampagne erstellt wurde, kann das Feld nicht mehr geändert werden.

advertising_channel_sub_type

AdvertisingChannelSubType

Optionale Optimierung auf advertising_channel_type. Muss ein gültiger Untertyp des übergeordneten Kanal-Typs sein.

Kann nur beim Erstellen von Kampagnen festgelegt werden. Nachdem die Kampagne erstellt wurde, kann das Feld nicht mehr geändert werden.

url_custom_parameters[]

CustomParameter

Die Liste der Zuordnungen, die verwendet werden, um Tags mit benutzerdefinierten Parametern in tracking_url_template, final_urls oder mobile_final_urls zu ersetzen.

real_time_bidding_setting

RealTimeBiddingSetting

Einstellungen für Echtzeitgebote, eine Funktion, die nur für Kampagnen verfügbar ist, die auf das Ad Exchange-Netzwerk ausgerichtet sind

network_settings

NetworkSettings

Die Werbenetzwerkeinstellungen für die Kampagne.

dynamic_search_ads_setting

DynamicSearchAdsSetting

Einstellung zum Steuern von dynamischen Suchanzeigen.

shopping_setting

ShoppingSetting

Einstellung zur Steuerung von Shopping-Kampagnen

geo_target_type_setting

GeoTargetTypeSetting

Die Einstellung für die geografische Ausrichtung von Anzeigen.

labels[]

string

Die Ressourcennamen der Labels, die dieser Kampagne zugeordnet sind.

bidding_strategy_type

BiddingStrategyType

Der Typ der Gebotsstrategie.

Eine Gebotsstrategie kann erstellt werden, indem entweder das Gebotsschema zum Erstellen einer Standard-Gebotsstrategie oder das Feld bidding_strategy zum Erstellen einer Portfolio-Gebotsstrategie festgelegt wird.

Dieses Feld ist schreibgeschützt.

accessible_bidding_strategy

string

Ressourcenname von AccessibleBiddingStrategy, eine schreibgeschützte Ansicht der uneingeschränkten Attribute der verknüpften Portfolio-Gebotsstrategie, die durch „bidding_strategy“ identifiziert wird. Das Feld ist leer, wenn für die Kampagne keine Portfoliostrategie verwendet wird. Uneingeschränkte Strategieattribute stehen allen Kunden zur Verfügung, für die die Strategie freigegeben ist. Sie werden aus der AccessibleBiddingStrategy-Ressource gelesen. Im Gegensatz dazu sind eingeschränkte Attribute nur für den Inhaber der Strategie und deren Manager verfügbar. Eingeschränkte Attribute können nur aus der BiddingStrategy-Ressource gelesen werden.

frequency_caps[]

FrequencyCapEntry

Eine Liste, mit der begrenzt wird, wie oft die Anzeigen dieser Kampagne jedem Nutzer präsentiert werden.

selective_optimization

SelectiveOptimization

Die selektive Optimierungseinstellung für diese Kampagne. Sie enthält eine Reihe von Conversion-Aktionen, für die die Kampagne optimiert werden soll. Diese Funktion gilt nur für App-Kampagnen, in denen MULTI_CHANNEL als AdvertisingChannelType und APP_CAMPAIGN oder APP_CAMPAIGN_FOR_ENGAGEMENT als AdvertisingChannelSubType verwendet werden.

optimization_goal_setting

OptimizationGoalSetting

Die Einstellung für das Optimierungsziel für diese Kampagne, die eine Reihe von Arten von Optimierungszielvorhaben enthält.

tracking_setting

TrackingSetting

Einstellungen auf Kampagnenebene für Tracking-Informationen.

engine_id

string

ID der Kampagne im externen Engine-Konto. Dieses Feld ist nur für Konten, die kein Google Ads-Konto sind, z. B. Yahoo! Japan, Microsoft oder Baidu. Verwenden Sie für Google Ads-Entitäten „campaign.id“. .

excluded_parent_asset_field_types[]

AssetFieldType

Die Asset-Feldtypen, die aus dieser Kampagne ausgeschlossen werden sollen. Asset-Links mit diesen Feldtypen werden von dieser Kampagne nicht von der obersten Ebene übernommen.

create_time

string

Der Zeitstempel für den Zeitpunkt, zu dem dieser Kampagne erstellt wurde. Der Zeitstempel entspricht der Zeitzone des Kunden und ist im Format „jjjj-MM-tt HH:mm:ss“ angegeben. Format. create_time wird in v1 nicht mehr unterstützt. Verwenden Sie stattdessen „create_time“.

creation_time

string

Der Zeitstempel für den Zeitpunkt, zu dem dieser Kampagne erstellt wurde. Der Zeitstempel hat die Zeitzone des Kunden und ist im Format "JJJJ-MM-TT HH:mm:ss.ssssss".

last_modified_time

string

Der Zeitpunkt der letzten Änderung an diesem Kampagne. Das Datum und die Uhrzeit hat die Zeitzone des Kunden und ist im Format "JJJJ-MM-TT HH:mm:ss.ssssss".

id

int64

Die ID der Kampagne.

name

string

Dies ist der Name der Kampagne.

Dieses Feld ist erforderlich und darf beim Erstellen neuer Kampagnen nicht leer sein.

Er darf keine Null (Codepunkt 0x0), NL-Zeilenvorschub (Codepunkt 0xA) oder Zeilenumbruchzeichen (Codepunkt 0xD) enthalten.

tracking_url_template

string

Die URL-Vorlage zum Erstellen einer Tracking-URL.

campaign_budget

string

Das Budget der Kampagne.

start_date

string

Das Datum, an dem die Kampagne in der Zeitzone des Kunden gestartet wurde im Format JJJJ-MM-TT.

end_date

string

Die letzte Tag der Kampagne in der Zeitzone des Kunden im Format JJJJ-MM-TT. Er wird beim Erstellen auf den 30.12.2037 festgelegt, d. h., die Kampagne läuft auf unbestimmte Zeit. Wenn Sie für eine vorhandene Kampagne eine unbegrenzte Laufzeit festlegen möchten, setzen Sie dieses Feld auf 2037-12-30.

final_url_suffix

string

Suffix zum Anhängen von Suchparametern an Landingpages, die mit parallelem Tracking ausgeliefert werden.

url_expansion_opt_out

bool

Die Deaktivierung der URL-Erweiterung für weitere Ziel-URLs. Ist die Option deaktiviert (true), erfolgt das Targeting nur auf die finalen URLs in der Asset-Gruppe oder URLs, die im Google Merchant Center oder in den Geschäftsdatenfeeds des Werbetreibenden angegeben sind. Ist sie aktiviert (false), erfolgt die Ausrichtung auf die gesamte Domain. Dieses Feld kann nur für Performance Max-Kampagnen festgelegt werden, bei denen der Standardwert „falsch“ ist.

Union-Feld campaign_bidding_strategy. Die Gebotsstrategie für die Kampagne.

Dabei muss es sich entweder um ein Portfolio (erstellt über den BiddingStrategy-Dienst) oder um den Typ „Standard“ handeln, der in die Kampagne eingebettet ist. Für campaign_bidding_strategy ist nur einer der folgenden Werte zulässig:

bidding_strategy

string

Von der Kampagne verwendete Portfolio-Strategie.

manual_cpa

ManualCpa

Manuelle CPA-Standardstrategie. Manuelle Gebotsstrategie, mit der der Werbetreibende das Gebot für jede vom Werbetreibenden angegebene Aktion festlegen kann. Diese Option wird nur für Kampagnen für lokale Dienstleistungen unterstützt.

manual_cpc

ManualCpc

Manuelle CPC-Standardstrategie Manuelle klickbasierte Gebote, bei denen Nutzer pro Klick bezahlen

manual_cpm

ManualCpm

Manuelle CPM-Standardstrategie. Manuelles impressionsbasiertes Gebot, bei dem Nutzer pro 1.000 Impressionen bezahlen

maximize_conversions

MaximizeConversions

Die standardmäßige Gebotsstrategie „Conversions maximieren“, bei der im Rahmen Ihres Budgets automatisch die Anzahl der Conversions maximiert wird.

maximize_conversion_value

MaximizeConversionValue

Die standardmäßige Gebotsstrategie „Conversion-Wert maximieren“, bei der Gebote automatisch so festgelegt werden, dass Sie im Rahmen Ihres Budgets den Umsatz maximieren.

target_cpa

TargetCpa

Standardmäßige Gebotsstrategie „Ziel-CPA“, bei der Gebote automatisch so festgelegt werden, dass Sie mit Ihrem Ziel-CPA (Cost-per-Acquisition) möglichst viele Conversions erzielen.

target_impression_share

TargetImpressionShare

Gebotsstrategie „Angestrebter Anteil an möglichen Impressionen“ Eine automatische Gebotsstrategie, bei der Gebote so festgelegt werden, dass ein bestimmter Prozentsatz von Impressionen erreicht wird.

target_roas

TargetRoas

Standardmäßige Gebotsstrategie „Ziel-ROAS“, die automatisch den Umsatz maximiert und gleichzeitig einen bestimmten Ziel-ROAS (Return on Advertising Spend) senkt.

target_spend

TargetSpend

Standardmäßige Gebotsstrategie „Zielausgaben“, bei der Ihre Gebote automatisch so festgelegt werden, dass Sie mit Ihrem Budget möglichst viele Klicks erzielen.

percent_cpc

PercentCpc

Standardmäßige Cost-per-Click-CPC-Gebotsstrategie, bei der die Gebote einen Bruchteil des beworbenen Preises für eine Ware oder Dienstleistung ausmachen.

target_cpm

TargetCpm

Eine Gebotsstrategie, bei der der Cost-per-1000-Impressions automatisch optimiert wird.

DynamicSearchAdsSetting

Einstellung zum Steuern von dynamischen Suchanzeigen.

Felder
domain_name

string

Erforderlich. Der Name der Internetdomain, für die diese Einstellung steht, z. B. „google.com“ oder "www.google.de".

language_code

string

Erforderlich. Der Sprachcode, der die Sprache der Domain angibt, z. B. „en“.

use_supplied_urls_only

bool

Gibt an, ob für die Kampagne ausschließlich vom Werbetreibenden bereitgestellte URLs verwendet werden

GeoTargetTypeSetting

Eine Sammlung von Einstellungen in Bezug auf die geografische Ausrichtung von Anzeigen

Felder
positive_geo_target_type

PositiveGeoTargetType

Die Einstellung, die in dieser Kampagne für die einschließende geografische Ausrichtung verwendet wird

negative_geo_target_type

NegativeGeoTargetType

Die für die auszuschließende geografische Ausrichtung in dieser Kampagne verwendete Einstellung.

NetworkSettings

Die Werbenetzwerkeinstellungen für die Kampagne.

Felder
target_search_network

bool

Gibt an, ob Anzeigen auf Partnerwebsites im Google Suchnetzwerk ausgeliefert werden (muss für target_google_search ebenfalls true sein).

target_content_network

bool

Gibt an, ob Anzeigen auf bestimmten Placements im Google Displaynetzwerk bereitgestellt werden. Placements werden mithilfe des Placement-Kriteriums angegeben.

target_partner_search_network

bool

Gibt an, ob Anzeigen im Google Partner-Werbenetzwerk ausgeliefert werden. Diese Option ist nur für einige ausgewählte Google Partner-Konten verfügbar.

OptimizationGoalSetting

Die Einstellung für das Optimierungsziel für diese Kampagne, die eine Reihe von Arten von Optimierungszielvorhaben enthält.

Felder
optimization_goal_types[]

OptimizationGoalType

Die Liste der Optimierungszieltypen.

SelectiveOptimization

Die selektive Optimierungseinstellung für diese Kampagne. Sie enthält eine Reihe von Conversion-Aktionen, für die die Kampagne optimiert werden soll. Diese Funktion gilt nur für App-Kampagnen, in denen MULTI_CHANNEL als AdvertisingChannelType und APP_CAMPAIGN oder APP_CAMPAIGN_FOR_ENGAGEMENT als AdvertisingChannelSubType verwendet werden.

Felder
conversion_actions[]

string

Die ausgewählten Conversion-Aktionen zur Optimierung dieser Kampagne.

ShoppingSetting

Die Einstellung für Shopping-Kampagnen Hier werden die Produkte definiert, die mit der Kampagne beworben werden können. Außerdem wird definiert, wie diese Kampagne mit anderen Shopping-Kampagnen interagiert.

Felder
feed_label

string

Feedlabel der Produkte, die in die Kampagne aufgenommen werden sollen. Es kann nur entweder „feed_label“ oder „sales_country“ festgelegt werden. Wird anstelle von „sales_country“ verwendet, akzeptiert das Feld „feed_label“ Ländercodes im selben Format, z. B. „XX“. Andernfalls kann ein beliebiger String für das Feedlabel im Google Merchant Center verwendet werden.

use_vehicle_inventory

bool

Gibt an, ob ein Targeting auf Inventar mit Fahrzeuginformationen erfolgen soll.

merchant_id

int64

ID des Merchant Center-Kontos. Dieses Feld ist für Erstellungsvorgänge erforderlich. Dieses Feld kann für Shopping-Kampagnen nicht geändert werden.

sales_country

string

Das Verkaufsland der Produkte, die in die Kampagne aufgenommen werden sollen.

campaign_priority

int32

Priorität der Kampagne Kampagnen mit numerisch höheren Prioritäten haben Vorrang vor Kampagnen mit niedrigerer Priorität. Dieses Feld ist für Shopping-Kampagnen mit Werten zwischen 0 und 2 erforderlich. Dieses Feld ist für smarte Shopping-Kampagnen optional, muss aber den Wert 3 enthalten.

enable_local

bool

Ob lokal erhältliche Produkte berücksichtigt werden sollen

TrackingSetting

Einstellungen auf Kampagnenebene für Tracking-Informationen.

Felder
tracking_url

string

Die für dynamisches Tracking verwendete URL.

CampaignAsset

Eine Verknüpfung zwischen einer Kampagne und einem Asset.

Felder
resource_name

string

Der Ressourcenname des Kampagnen-Assets. CampaignAsset-Ressourcennamen haben folgendes Format:

customers/{customer_id}/campaignAssets/{campaign_id}~{asset_id}~{field_type}

status

AssetLinkStatus

Status des Kampagnen-Assets.

campaign

string

Die Kampagne, mit der das Asset verknüpft ist.

asset

string

Das Asset, das mit der Kampagne verknüpft ist.

CampaignAssetSet

Das CampaignAssetSet ist die Verknüpfung zwischen einer Kampagne und einer Asset-Gruppe. Durch das Hinzufügen eines CampaignAssetSet wird eine Asset-Gruppe mit einer Kampagne verknüpft.

Felder
resource_name

string

Der Ressourcenname der Asset-Gruppe der Kampagne. Asset-Ressourcennamen von Asset-Gruppen haben folgendes Format:

customers/{customer_id}/campaignAssetSets/{campaign_id}~{asset_set_id}

campaign

string

Die Kampagne, mit der diese Asset-Gruppe verknüpft ist.

asset_set

string

Die Asset-Gruppe, die mit der Kampagne verknüpft ist.

status

AssetSetLinkStatus

Das ist der Status der Asset-Gruppe der Kampagne. Schreibgeschützt.

CampaignAudienceView

Eine Zielgruppenansicht auf Kampagnenebene Enthält Leistungsdaten aus Interessen und Remarketing-Listen für Anzeigen im Displaynetzwerk und im YouTube-Werbenetzwerk sowie aus Remarketing-Listen für Suchanzeigen, die nach Kampagnen- und Zielgruppenkriterium zusammengefasst werden. Diese Ansicht enthält nur Zielgruppen, die auf Kampagnenebene zugeordnet sind.

Felder
resource_name

string

Der Ressourcenname der Zielgruppenansicht auf Kampagnenebene. Ressourcennamen für die Zielgruppenansicht von Kampagnen haben folgendes Format:

customers/{customer_id}/campaignAudienceViews/{campaign_id}~{criterion_id}

CampaignBudget

Ein Kampagnenbudget.

Felder
resource_name

string

Der Ressourcenname des Kampagnenbudgets. Ressourcennamen des Kampagnenbudgets haben folgendes Format:

customers/{customer_id}/campaignBudgets/{campaign_budget_id}

delivery_method

BudgetDeliveryMethod

Die Bereitstellungsmethode, mit der festgelegt wird, mit welcher Rate das Kampagnenbudget ausgegeben wird.

Der Standardwert ist STANDARD, wenn bei einem Erstellungsvorgang nichts angegeben ist.

period

BudgetPeriod

Zeitraum, in dem das Budget ausgegeben werden kann. Der Standardwert ist DAILY, wenn nicht angegeben.

amount_micros

int64

Der Betrag des Budgets in der lokalen Währung des Kontos. Die Menge wird in Mikros angegeben, wobei eine Million einer Währungseinheit entspricht. Die monatlichen Ausgaben sind auf das 30,4-Fache dieses Betrags beschränkt.

CampaignCriterion

Ein Kampagnenkriterium.

Felder
resource_name

string

Der Ressourcenname des Kampagnenkriteriums. Die Ressourcennamen für Kampagnenkriterien haben folgendes Format:

customers/{customer_id}/campaignCriteria/{campaign_id}~{criterion_id}

display_name

string

Der Anzeigename des Kriteriums.

Dieses Feld wird für Mutationen ignoriert.

type

CriterionType

Der Typ des Kriteriums.

status

CampaignCriterionStatus

Der Status des Kriteriums.

last_modified_time

string

Der Zeitpunkt der letzten Änderung an diesem Kampagnenkriterium. Das Datum und die Uhrzeit hat die Zeitzone des Kunden und ist im Format "JJJJ-MM-TT HH:mm:ss.ssssss".

criterion_id

int64

Die ID des Kriteriums.

Dieses Feld wird während der Mutation ignoriert.

bid_modifier

float

Die Anpassung der Gebote, wenn das Kriterium übereinstimmt. Die Anpassung muss im Bereich zwischen 0,1 und 10,0 liegen. Die meisten Zielkriterien unterstützen Anpassungen. Verwenden Sie 0, um einen Gerätetyp zu deaktivieren.

negative

bool

Gibt an, ob das Kriterium für das Targeting (false) oder das Ausschließen (true) verwendet werden soll.

Union-Feld criterion. Das Kampagnenkriterium.

Es muss genau ein Wert festgelegt werden. Für criterion ist nur einer der folgenden Werte zulässig:

keyword

KeywordInfo

Keyword.

location

LocationInfo

Standort.

device

DeviceInfo

Gerät.

age_range

AgeRangeInfo

Altersgruppe.

gender

GenderInfo

Gender.

user_list

UserListInfo

Nutzerliste.

language

LanguageInfo

Sprache

webpage

WebpageInfo

Webseite.

location_group

LocationGroupInfo

Standortgruppe

CampaignLabel

Stellt eine Beziehung zwischen einer Kampagne und einem Label dar.

Felder
resource_name

string

Der Name der Ressource, Ressourcennamen von Kampagnenlabels haben das folgende Format: customers/{customer_id}/campaignLabels/{campaign_id}~{label_id}

campaign

string

Die Kampagne, mit der das Label verknüpft ist.

label

string

Das der Kampagne zugewiesene Label.

CartDataSalesView

Ansicht „Verkäufe mit Warenkorbdaten“.

Felder
resource_name

string

Der Ressourcenname der Ansicht „Verkäufe mit Warenkorbdaten“. Ressourcennamen der Warenkorbdaten-Verkaufsansicht haben das folgende Format: customers/{customer_id}/cartDataSalesView

Conversion

Eine Conversion.

Felder
resource_name

string

Der Ressourcenname der Conversion. Namen von Conversion-Ressourcen haben folgendes Format:

customers/{customer_id}/conversions/{ad_group_id}~{criterion_id}~{ds_conversion_id}

id

int64

ID der Conversion.

criterion_id

int64

Search Ads 360-Kriteriums-ID Der Wert 0 zeigt an, dass das Kriterium nicht zugeordnet ist.

merchant_id

int64

Die Search Ads 360-Inventarkonto-ID mit dem Produkt, auf das geklickt wurde. Diese ID wird in Search Ads 360 generiert, wenn Sie ein Inventarkonto in Search Ads 360 verknüpfen.

ad_id

int64

Ad ID. Der Wert 0 gibt an, dass die Anzeige nicht zugeordnet ist.

click_id

string

Ein eindeutiger String für den Besuch, dem die Conversion zugeordnet wird, und der als Landingpage-URL-Parameter an die Landingpage übergeben wird.

visit_id

int64

Die Search Ads 360-Besuchs-ID, der die Conversion zugeordnet ist.

advertiser_conversion_id

string

Bei Offline-Conversions ist dies eine ID, die von Werbetreibenden bereitgestellt wird. Wenn ein Werbetreibender eine solche ID nicht angibt, generiert Search Ads 360 eine. Bei Online-Conversions entspricht dies der Spalte „id“ oder der Spalte „floodlight_order_id“, je nach Floodlight-Anweisungen des Werbetreibenden.

product_id

string

ID des Produkts, auf das geklickt wurde.

product_channel

ProductChannel

Der Vertriebskanal des Produkts, auf das geklickt wurde: online oder lokal.

product_language_code

string

Die Sprache (ISO-639-1), die für den Merchant Center-Feed festgelegt wurde, der Daten zum Produkt enthält.

product_store_id

string

Das Geschäft in der Anzeige für lokales Inventar, auf das geklickt wurde. Dieser sollte den Geschäfts-IDs entsprechen, die in Ihrem Feed mit lokal erhältlichen Produkten verwendet werden.

product_country_code

string

Das Land (ISO-3166-Format), das für den Inventarfeed registriert ist, auf dem das Produkt angeklickt wurde.

attribution_type

AttributionType

Wozu wird die Conversion zugeordnet: Besuch oder Keyword + Anzeige.

conversion_date_time

string

Der Zeitstempel des Conversion-Ereignisses.

conversion_last_modified_date_time

string

Der Zeitstempel der letzten Änderung der Konvertierung.

conversion_visit_date_time

string

Der Zeitstempel des Besuchs, dem die Conversion zugeordnet ist.

conversion_quantity

int64

Die Anzahl der von der Conversion aufgezeichneten Elemente, wie durch den Parameter "qty url" festgelegt. Der Werbetreibende ist dafür verantwortlich, Parameter dynamisch auszufüllen, z. B. die Anzahl der in der Conversion verkauften Artikel. Andernfalls wird standardmäßig 1 verwendet.

conversion_revenue_micros

int64

Der angepasste Umsatz in Mikros für das Conversion-Ereignis. Der Wert wird immer in der Währung des Dienstkontos angegeben.

floodlight_original_revenue

int64

Der ursprüngliche, unveränderte Umsatz, der mit dem Floodlight-Ereignis (in der Währung des aktuellen Berichts) verknüpft ist, vor der Änderung der Floodlight-Währungsanweisung.

floodlight_order_id

string

Die ID des Floodlight-Auftrags, der vom Werbetreibenden für die Conversion bereitgestellt wurde.

status

ConversionStatus

Der Status der Conversion, entweder AKTIVIERT oder ENTFERNT.

asset_id

int64

Die ID des Assets, mit dem während des Conversion-Ereignisses interagiert wurde.

asset_field_type

AssetFieldType

Asset-Feldtyp des Conversion-Ereignisses.

ConversionAction

Eine Conversion-Aktion.

Felder
resource_name

string

Der Ressourcenname der Conversion-Aktion. Ressourcennamen für Conversion-Aktionen haben folgendes Format:

customers/{customer_id}/conversionActions/{conversion_action_id}

creation_time

string

Zeitstempel für die Erstellung der Floodlight-Aktivität, formatiert nach ISO 8601.

status

ConversionActionStatus

Der Status dieser Conversion-Aktion für Conversion-Ereignisse-Ansammlung.

type

ConversionActionType

Der Typ dieser Conversion-Aktion.

category

ConversionActionCategory

Die Kategorie der Conversions, die für diese Conversion-Aktion erfasst wurden.

value_settings

ValueSettings

Einstellungen, die sich auf den Wert der Conversion-Ereignisse beziehen, die mit dieser Conversion-Aktion verknüpft sind.

attribution_model_settings

AttributionModelSettings

Einstellungen, die sich auf das Attributionsmodell dieser Conversion-Aktion beziehen.

floodlight_settings

FloodlightSettings

Floodlight-Einstellungen für Floodlight-Conversion-Typen.

id

int64

Die ID der Conversion-Aktion.

name

string

Der Name der Conversion-Aktion.

Dieses Feld ist erforderlich und darf beim Erstellen neuer Conversion-Aktionen nicht leer sein.

primary_for_goal

bool

Wenn das „primary_for_goal“-Bit einer Conversion-Aktion „false“ ist, ist die Conversion-Aktion für alle Kampagnen nicht gebotsfähig, unabhängig vom Conversion-Zielvorhaben der Kunden oder der Kampagne. Benutzerdefinierte Conversion-Zielvorhaben berücksichtigen jedoch nicht „primary_for_goal“. Wenn also für eine Kampagne ein benutzerdefiniertes Conversion-Zielvorhaben mit der Conversion-Aktion „primary_for_goal = falsch“ konfiguriert ist, ist diese Conversion-Aktion trotzdem gebotsfähig. Wenn „primary_for_goal“ nicht festgelegt ist, ist standardmäßig „true“ festgelegt. In V9 kann „primary_for_goal“ nur nach der Erstellung durch ein „Update“ auf „false“ gesetzt werden da er nicht als optional deklariert ist.

owner_customer

string

Der Ressourcenname des Kunden, der die Conversion-Aktion ausgeführt hat, oder null, wenn es sich um eine systemdefinierte Conversion-Aktion handelt.

include_in_client_account_conversions_metric

bool

Legt fest, ob diese Conversion-Aktion in der Spalte "client_account_conversions" enthalten sein soll Messwert.

include_in_conversions_metric

bool

Legt fest, ob diese Conversion-Aktion in "Conversions" einbezogen werden soll Messwert.

click_through_lookback_window_days

int64

Die maximale Anzahl von Tagen, die zwischen einer Interaktion (z. B. einem Klick) und einem Conversion-Ereignis liegen können.

app_id

string

Die App-ID für eine App-Conversion-Aktion.

AttributionModelSettings

Einstellungen, die sich auf das Attributionsmodell dieser Conversion-Aktion beziehen.

Felder
attribution_model

AttributionModel

Der Typ des Attributionsmodells dieser Conversion-Aktion.

data_driven_model_status

DataDrivenModelStatus

Der Status des datengetriebenen Attributionsmodells für die Conversion-Aktion.

FloodlightSettings

Einstellungen, die sich auf eine Floodlight-Conversion-Aktion beziehen.

Felder
activity_group_tag

string

String zur Identifizierung einer Floodlight-Aktivitätsgruppe bei der Erfassung von Conversions.

activity_tag

string

String zur Identifizierung einer Floodlight-Aktivität bei der Erfassung von Conversions.

activity_id

int64

ID der Floodlight-Aktivität in DoubleClick Campaign Manager (DCM).

ValueSettings

Einstellungen, die sich auf den Wert der Conversion-Ereignisse beziehen, die mit dieser Conversion-Aktion verknüpft sind.

Felder
default_value

double

Dieser Wert wird verwendet, wenn Conversion-Ereignisse für diese Conversion-Aktion mit einem ungültigen, unzulässigen oder fehlenden Wert gesendet werden oder wenn diese Conversion-Aktion so konfiguriert ist, dass immer der Standardwert verwendet wird.

default_currency_code

string

Der Währungscode, der verwendet wird, wenn Conversion-Ereignisse für diese Conversion-Aktion mit einem ungültigen oder fehlenden Währungscode gesendet werden oder wenn diese Conversion-Aktion so konfiguriert ist, dass immer der Standardwert verwendet wird.

always_use_default_value

bool

Mit dieser Einstellung wird festgelegt, ob anstelle des Werts und Währungscodes, der in Conversion-Ereignissen für diese Conversion-Aktion angegeben wurde, der Standardwert und der Standardwährungscode verwendet werden.

ConversionCustomVariable

Eine benutzerdefinierte Variable für Conversions. Weitere Informationen finden Sie unter „Benutzerdefinierte Floodlight-Messwerte und -Dimensionen in der neuen Search Ads 360-Version“. https://support.google.com/sa360/answer/13567857

Felder
resource_name

string

Der Ressourcenname der benutzerdefinierten Conversion-Variablen. Ressourcennamen von benutzerdefinierten Conversion-Variablen haben folgendes Format:

customers/{customer_id}/conversionCustomVariables/{conversion_custom_variable_id}

id

int64

Die ID der benutzerdefinierten Conversion-Variablen.

name

string

Erforderlich. Der Name der benutzerdefinierten Conversion-Variablen. Der Name muss eindeutig sein. Der Name darf maximal 100 Zeichen lang sein. Vor und nach sollten keine zusätzlichen Leerzeichen eingefügt werden.

tag

string

Erforderlich. Das Tag der benutzerdefinierten Variablen für Conversions. Das Tag muss eindeutig sein und aus einem „u“ bestehen. direkt gefolgt von einer Zahl kleiner als ormequal bis 100. Beispiel: „u4“.

status

ConversionCustomVariableStatus

Der Status der benutzerdefinierten Conversion-Variable für die Erfassung von Conversion-Ereignissen.

owner_customer

string

Der Ressourcenname des Kunden, dem die benutzerdefinierte Conversion-Variable gehört.

family

ConversionCustomVariableFamily

Familie der benutzerdefinierten Conversion-Variablen.

cardinality

ConversionCustomVariableCardinality

Kardinalität der benutzerdefinierten Conversion-Variablen.

floodlight_conversion_custom_variable_info

FloodlightConversionCustomVariableInfo

Felder für benutzerdefinierte Floodlight-Conversion-Variablen in Search Ads 360

custom_column_ids[]

int64

Die IDs der benutzerdefinierten Spalten, in denen diese benutzerdefinierte Conversion-Variable verwendet wird.

FloodlightConversionCustomVariableInfo

Informationen zu benutzerdefinierten Floodlight-Conversion-Variablen in Search Ads 360.

Felder
floodlight_variable_type

FloodlightVariableType

Floodlight-Variablentyp, der in Search Ads 360 definiert ist

floodlight_variable_data_type

FloodlightVariableDataType

In Search Ads 360 definierter Floodlight-Variablen-Datentyp

ConversionTrackingSetting

Eine Sammlung von kundenweiten Einstellungen zum Search Ads 360-Conversion-Tracking.

Felder
accepted_customer_data_terms

bool

Ob der Kunde die Nutzungsbedingungen für Kundendaten akzeptiert hat Wenn Sie kontoübergreifendes Conversion-Tracking verwenden, wird dieser Wert vom Verwaltungskonto übernommen. Dieses Feld ist schreibgeschützt. Weitere Informationen finden Sie unter https://support.google.com/adspolicy/answer/7475709.

conversion_tracking_status

ConversionTrackingStatus

Conversion-Tracking-Status. Sie gibt an, ob der Kunde Conversion-Tracking verwendet und wer der Inhaber des Conversion-Trackings dieses Kunden ist. Wenn dieser Kunde kontoübergreifendes Conversion-Tracking verwendet, unterscheidet sich der zurückgegebene Wert je nach login-customer-id der Anfrage.

enhanced_conversions_for_leads_enabled

bool

Hat der Kunde erweiterte Conversions für Leads aktiviert? Wenn Sie kontoübergreifendes Conversion-Tracking verwenden, wird dieser Wert vom Verwaltungskonto übernommen. Dieses Feld ist schreibgeschützt.

google_ads_conversion_customer

string

Der Ressourcenname des Kunden, bei dem Conversions erstellt und verwaltet werden. Dieses Feld ist schreibgeschützt.

conversion_tracking_id

int64

Die für dieses Konto verwendete Conversion-Tracking-ID. Diese ID sagt im Gegensatz zum Conversion-Tracking-Status nicht aus, ob der Kunde Conversion-Tracking verwendet. Dieses Feld ist schreibgeschützt.

google_ads_cross_account_conversion_tracking_id

int64

Die Conversion-Tracking-ID des Verwaltungskontos des Kunden. Er wird festgelegt, wenn der Kunde Conversion-Tracking aktiviert, und überschreibt „conversion_tracking_id“. Dieses Feld kann nur über die Google Ads-Benutzeroberfläche verwaltet werden. Dieses Feld ist schreibgeschützt.

cross_account_conversion_tracking_id

int64

Die Conversion-Tracking-ID des Verwaltungskontos des Kunden. Wird festgelegt, wenn der Kunde kontoübergreifendes Conversion-Tracking aktiviert, und überschreibt „conversion_tracking_id“.

CustomColumn

Eine benutzerdefinierte Spalte. Weitere Informationen finden Sie unter https://support.google.com/sa360/answer/9633916.

Felder
resource_name

string

Der Ressourcenname der benutzerdefinierten Spalte. Ressourcennamen für benutzerdefinierte Spalten haben folgendes Format:

customers/{customer_id}/customColumns/{custom_column_id}

id

int64

ID der benutzerdefinierten Spalte.

name

string

Benutzerdefinierter Name der benutzerdefinierten Spalte.

description

string

Benutzerdefinierte Beschreibung der benutzerdefinierten Spalte.

value_type

CustomColumnValueType

Der Typ des Ergebniswerts der benutzerdefinierten Spalte.

references_attributes

bool

Dieser Wert ist „True“, wenn sich die benutzerdefinierte Spalte auf ein oder mehrere Attribute bezieht.

references_metrics

bool

Dieser Wert ist „True“, wenn sich die benutzerdefinierte Spalte auf einen oder mehrere Messwerte bezieht.

queryable

bool

"True", wenn die benutzerdefinierte Spalte zur Verwendung in der Abfrage von SearchAds360Service.Search und SearchAds360Service.SearchStream verfügbar ist.

referenced_system_columns[]

string

Die Liste der Systemspalten, auf die in dieser benutzerdefinierten Spalte verwiesen wird. Beispiel: Die benutzerdefinierte Spalte „Summe der Impressionen und Klicks“ hat Referenzsystemspalten mit {"metrics.clicks", "metrics.impressions"}.

Kunde

Ein Kunde.

Felder
resource_name

string

Der Ressourcenname des Kunden. Namen von Kundenressourcen haben folgendes Format:

customers/{customer_id}

conversion_tracking_setting

ConversionTrackingSetting

Conversion-Tracking-Einstellung für einen Kunden.

account_type

AccountType

Engine-Kontotyp, z. B. Google Ads, Microsoft Advertising, Yahoo Japan, Baidu, Facebook, Engine-Track usw.

double_click_campaign_manager_setting

DoubleClickCampaignManagerSetting

DoubleClick Campaign Manager (DCM)-Einstellung für einen Kunden mit Verwaltungskonto.

account_status

AccountStatus

Kontostatus, z. B. „Aktiviert“, „Pausiert“, „Entfernt“ usw.

last_modified_time

string

Der Zeitpunkt der letzten Änderung an diesem Kunden. Das Datum und die Uhrzeit hat die Zeitzone des Kunden und ist im Format "JJJJ-MM-TT HH:mm:ss.ssssss".

engine_id

string

ID des Kontos im externen Engine-Konto.

status

CustomerStatus

Der Status des Kunden.

creation_time

string

Der Zeitstempel für den Zeitpunkt, zu dem dieser Kunde erstellt wurde. Der Zeitstempel hat die Zeitzone des Kunden und ist im Format "JJJJ-MM-TT HH:mm:ss.ssssss".

id

int64

Die ID des Kunden.

descriptive_name

string

Optionaler, nicht eindeutiger beschreibender Name des Kunden.

currency_code

string

Die Währung, in der das Konto geführt wird. Ein Teil der Währungscodes aus dem ISO 4217-Standard wird unterstützt.

time_zone

string

Die lokale Zeitzonen-ID des Kunden.

tracking_url_template

string

Die URL-Vorlage zum Erstellen einer Tracking-URL aus Parametern

final_url_suffix

string

Die URL-Vorlage zum Anhängen von Parametern an die finale URL

auto_tagging_enabled

bool

Gibt an, ob das automatische Tagging für den Kunden aktiviert ist.

manager

bool

Gibt an, ob der Kunde ein Manager ist.

CustomerAsset

Eine Verknüpfung zwischen einem Kunden und einem Asset.

Felder
resource_name

string

Der Ressourcenname des Kunden-Assets. Ressourcennamen „CustomerAsset“ haben folgendes Format:

customers/{customer_id}/customerAssets/{asset_id}~{field_type}

asset

string

Erforderlich. Das Asset, das mit dem Kunden verknüpft ist.

status

AssetLinkStatus

Status des Kunden-Assets.

CustomerAssetSet

CustomerAssetSet ist die Verknüpfung zwischen einem Kunden und einer Asset-Gruppe. Durch das Hinzufügen eines CustomerAssetSet wird eine Asset-Gruppe mit einem Kunden verknüpft.

Felder
resource_name

string

Der Ressourcenname der Kunden-Asset-Gruppe. Asset-Ressourcennamen von Asset-Gruppen haben folgendes Format:

customers/{customer_id}/customerAssetSets/{asset_set_id}

asset_set

string

Die Asset-Gruppe, die mit dem Kunden verknüpft ist.

customer

string

Der Kunde, mit dem diese Asset-Gruppe verknüpft ist.

status

AssetSetLinkStatus

Das ist der Status des Assets der Kunden-Asset-Gruppe. Schreibgeschützt.

CustomerClient

Eine Verknüpfung zwischen dem angegebenen Kunden und einem Kunden. „CustomerClients“ gibt es nur für Verwaltungskonten. Alle direkten und indirekten Kundenkunden sowie das Verwaltungskonto selbst sind enthalten.

Felder
resource_name

string

Der Ressourcenname des Kundenclients. Ressourcennamen von CustomerClient haben das Format customers/{customer_id}/customerClients/{client_customer_id}.

applied_labels[]

string

Die Ressourcennamen der Labels des anfragenden Kunden, die auf den Kundenkunden angewendet werden. Label-Ressourcennamen haben folgendes Format:

customers/{customer_id}/labels/{label_id}

status

CustomerStatus

Der Status des Kunden. Schreibgeschützt.

client_customer

string

Der Ressourcenname des Kunden/Kunden, der mit dem angegebenen Kunden verknüpft ist. Schreibgeschützt.

hidden

bool

Gibt an, ob es sich um ein ausgeblendetes Konto handelt.

Schreibgeschützt.

level

int64

Entfernung zwischen Kunde und Kunde. Für den Self-Link ist der Wert 0. Schreibgeschützt.

time_zone

string

Stringdarstellung der Zeitzone des Clients (Common Locale Data Repository, CLDR), z. B. America/Los_Angeles. Schreibgeschützt.

test_account

bool

Gibt an, ob der Kunde ein Testkonto ist. Schreibgeschützt.

manager

bool

Gibt an, ob der Kunde ein Manager ist. Schreibgeschützt.

descriptive_name

string

Beschreibender Name für den Kunden. Schreibgeschützt.

currency_code

string

Währungscode (z. B. „USD“, „EUR“) für den Kunden. Schreibgeschützt.

id

int64

Die ID des Kunden. Schreibgeschützt.

DoubleClickCampaignManagerSetting

DoubleClick Campaign Manager (DCM)-Einstellung für einen Kunden mit Verwaltungskonto.

Felder
advertiser_id

int64

ID des Campaign Manager-Werbetreibenden, der mit diesem Kunden verknüpft ist.

network_id

int64

ID des Campaign Manager-Netzwerks, das diesem Kunden zugeordnet ist.

time_zone

string

Zeitzone des Campaign Manager-Netzwerks, das diesem Kunden im IANA-Zeitzonendatenbank-Format zugeordnet ist, wie z. B. America/New_York.

DynamicSearchAdsSearchTermView

Ansicht mit Suchbegriffen für dynamische Suchanzeigen

Felder
resource_name

string

Der Ressourcenname der Ansicht mit den Suchbegriffen für dynamische Suchanzeigen. Die Ressourcennamen der Suchbegriffansicht für dynamische Suchanzeigen haben folgendes Format:

customers/{customer_id}/dynamicSearchAdsSearchTermViews/{ad_group_id}~{search_term_fingerprint}~{headline_fingerprint}~{landing_page_fingerprint}~{page_url_fingerprint}

landing_page

string

Die dynamisch ausgewählte Landingpage-URL der Impression.

Dieses Feld ist schreibgeschützt.

GenderView

Ansicht nach Geschlecht Die Ressource "gender_view" gibt den Status der effektiven Auslieferung an und nicht, welche Kriterien hinzugefügt wurden. Eine Anzeigengruppe ohne Geschlechtskriterien wird standardmäßig für alle Geschlechter geschaltet, sodass alle Geschlechter zusammen mit Statistiken in gender_view angezeigt werden.

Felder
resource_name

string

Der Ressourcenname der Ansicht „Geschlecht“. Ressourcennamen der Geschlechtsansicht haben folgendes Format:

customers/{customer_id}/genderViews/{ad_group_id}~{criterion_id}

GeoTargetConstant

Eine Konstante für die geografische Ausrichtung.

Felder
resource_name

string

Der Ressourcenname der Konstante für das geografische Ziel. Ressourcennamen der Konstante für geografische Ziele haben folgendes Format:

geoTargetConstants/{geo_target_constant_id}

status

GeoTargetConstantStatus

Status der Konstanten für das geografische Ziel.

id

int64

Die ID der Konstante für das geografische Ziel.

name

string

Englischer Name der Konstante für die geografische Ausrichtung.

country_code

string

Der Ländercode gemäß ISO-3166-1 Alpha-2, der dem Ziel zugeordnet ist.

target_type

string

Konstante als Zieltyp des Ziels für die geografische Ausrichtung.

canonical_name

string

Der voll qualifizierte Name, bestehend aus dem Namen des Ziels, dem Namen des übergeordneten Elements und des Landes.

parent_geo_target

string

Der Ressourcenname der übergeordneten Konstante für das geografische Ziel. Ressourcennamen der Konstante für geografische Ziele haben folgendes Format:

geoTargetConstants/{parent_geo_target_constant_id}

KeywordView

Eine Keyword-Ansicht

Felder
resource_name

string

Der Ressourcenname der Keyword-Ansicht. Ressourcennamen der Keyword-Ansicht haben folgendes Format:

customers/{customer_id}/keywordViews/{ad_group_id}~{criterion_id}

Label

Ein Label.

Felder
resource_name

string

Der Name der Ressource, Label-Ressourcennamen haben das Format customers/{customer_id}/labels/{label_id}.

status

LabelStatus

Status des Labels. Schreibgeschützt.

text_label

TextLabel

Eine Art von Label, das Text auf einem farbigen Hintergrund anzeigt.

id

int64

ID des Labels. Schreibgeschützt.

name

string

Der Name des Labels.

Dieses Feld ist erforderlich und sollte beim Erstellen eines neuen Labels nicht leer sein.

Die Länge der Zeichenfolge muss zwischen 1 und 80 Zeichen (einschließlich) liegen.

LanguageConstant

Eine Sprache.

Felder
resource_name

string

Der Ressourcenname der Sprachkonstante. Ressourcennamen für Sprachkonstanten haben folgendes Format:

languageConstants/{criterion_id}

id

int64

Die ID der Sprachkonstante.

code

string

Der Sprachcode, z. B. „en_US“, „en_AU“, „es“, „fr“ usw.

name

string

Der vollständige Name der Sprache auf Englisch, z. B. „Englisch (US)“ oder „Spanisch“.

targetable

bool

Gibt an, ob die Sprache für die Ausrichtung verfügbar ist.

ListingGroupFilterDimension

Eintragsdimensionen für den Filter für Asset-Eintragsgruppen.

Felder
Union-Feld dimension. Eine Dimension eines der folgenden Typen ist immer vorhanden. Für dimension ist nur einer der folgenden Werte zulässig:
product_bidding_category

ProductBiddingCategory

Gebotskategorie eines Produktangebots.

product_brand

ProductBrand

Die Marke eines Produktangebots.

product_channel

ProductChannel

Ort eines Produktangebots.

product_condition

ProductCondition

Zustand eines Produktangebots.

product_custom_attribute

ProductCustomAttribute

Benutzerdefiniertes Attribut eines Produktangebots.

product_item_id

ProductItemId

Artikel-ID eines Produktangebots.

product_type

ProductType

Der Typ eines Produktangebots.

ProductBiddingCategory

Ein Element einer Gebotskategorie auf einer bestimmten Ebene. Die Kategorien der obersten Ebene befinden sich auf Ebene 1, die untergeordneten Kategorien auf Ebene 2 und so weiter. Wir unterstützen derzeit bis zu fünf Ebenen. Der Nutzer muss einen Dimensionstyp angeben, der die Ebene der Kategorie angibt. Alle Fälle derselben Unterteilung müssen denselben Dimensionstyp (Kategorieebene) haben.

Felder
level

ListingGroupFilterBiddingCategoryLevel

Gibt die Ebene der Kategorie in der Taxonomie an.

id

int64

ID der Produktkategorie für Gebote.

Diese ID entspricht der ID der Google-Produktkategorie https://support.google.com/merchants/answer/6324436.

ProductBrand

Marke des Produkts.

Felder
value

string

Stringwert der Produktmarke.

ProductChannel

Ort eines Produktangebots.

Felder
channel

ListingGroupFilterProductChannel

Wert des Orts.

ProductCondition

Zustand eines Produktangebots.

Felder
condition

ListingGroupFilterProductCondition

Wert der Bedingung.

ProductCustomAttribute

Benutzerdefiniertes Attribut eines Produktangebots.

Felder
index

ListingGroupFilterCustomAttributeIndex

Gibt den Index des benutzerdefinierten Attributs an.

value

string

Stringwert des benutzerdefinierten Attributs für das Produkt.

ProductItemId

Artikel-ID eines Produktangebots.

Felder
value

string

Wert der ID.

ProductType

Der Typ eines Produktangebots.

Felder
level

ListingGroupFilterProductTypeLevel

Ebene des Typs.

value

string

Wert des Typs.

ListingGroupFilterDimensionPath

Der Pfad, der die Dimensionen definiert, mit denen ein Eintragsgruppenfilter definiert wird.

Felder
dimensions[]

ListingGroupFilterDimension

Der vollständige Pfad der Dimensionen über die Filterhierarchie für Eintragsgruppen (ohne den Stammknoten) zu diesem Filter für Eintragsgruppen.

LocationView

In einer Standortansicht wird die Leistung von Kampagnen anhand eines Standortkriteriums zusammengefasst.

Felder
resource_name

string

Der Ressourcenname der Standortansicht. Ressourcennamen der Standortansicht haben folgendes Format:

customers/{customer_id}/locationViews/{campaign_id}~{criterion_id}

ProductBiddingCategoryConstant

Eine Gebotskategorie.

Felder
resource_name

string

Der Ressourcenname der Produktkategorie für Gebote. Ressourcennamen für Produktkategorienamen haben folgendes Format:

productBiddingCategoryConstants/{country_code}~{level}~{id}

level

ProductBiddingCategoryLevel

Ebene der Produktkategorie für Gebote.

status

ProductBiddingCategoryStatus

Status der Produktkategorie für Gebote.

id

int64

ID der Produktkategorie für Gebote.

Diese ID entspricht der ID der Google-Produktkategorie https://support.google.com/merchants/answer/6324436.

country_code

string

Zweistelliger, großgeschriebener Ländercode der Produktkategorie für Gebote.

product_bidding_category_constant_parent

string

Ressourcenname der übergeordneten Produktkategorie für Gebote.

language_code

string

Der Sprachcode der Produktkategorie für Gebote.

localized_name

string

Zeigt den Wert der Gebotskategorie für das Produkt entsprechend der Sprache „language_code“ an.

ProductGroupView

Eine Produktgruppenansicht

Felder
resource_name

string

Der Ressourcenname der Produktgruppenansicht. Ressourcennamen für Produktgruppenansichten haben folgendes Format:

customers/{customer_id}/productGroupViews/{ad_group_id}~{criterion_id}

SearchAds360Field

Ein Feld oder eine Ressource (Artefakt), das bzw. die vom SearchAds360Service verwendet wird.

Felder
resource_name

string

Der Ressourcenname des Artefakts. Artefakt-Ressourcennamen haben folgendes Format:

SearchAds360Fields/{name}

category

SearchAds360FieldCategory

Die Kategorie des Artefakts.

selectable_with[]

string

Die Namen aller Ressourcen, Segmente und Messwerte, die mit dem beschriebenen Artefakt auswählbar sind.

attribute_resources[]

string

Die Namen aller Ressourcen, die mit dem beschriebenen Artefakt auswählbar sind. Felder aus diesen Ressourcen segmentieren Messwerte nicht, wenn sie in Suchanfragen enthalten sind.

Dieses Feld wird nur für Artefakte der Kategorie RESOURCE festgelegt.

metrics[]

string

Dieses Feld enthält die Namen aller Messwerte, die mit dem beschriebenen Artefakt auswählbar sind, wenn es in der FROM-Klausel verwendet wird. Sie wird nur für Artefakte der Kategorie RESOURCE festgelegt.

segments[]

string

In diesem Feld werden die Namen aller Artefakte aufgelistet, sei es ein Segment oder eine andere Ressource, die Messwerte segmentieren, wenn sie in Suchanfragen enthalten sind und wenn das beschriebene Artefakt in der FROM-Klausel verwendet wird. Sie wird nur für Artefakte der Kategorie RESOURCE festgelegt.

enum_values[]

string

Werte, die das Artefakt annehmen kann, wenn es ein Feld vom Typ ENUM ist.

Dieses Feld wird nur für Artefakte der Kategorie SEGMENT oder ATTRIBUTE festgelegt.

data_type

SearchAds360FieldDataType

Dieses Feld bestimmt die Operatoren, die mit dem Artefakt in WHERE-Klauseln verwendet werden können.

name

string

Der Name des Artefakts.

selectable

bool

Gibt an, ob das Artefakt in Suchabfragen in einer SELECT-Klausel verwendet werden kann.

filterable

bool

Gibt an, ob das Artefakt in Suchabfragen in einer WHERE-Klausel verwendet werden kann.

sortable

bool

Gibt an, ob das Artefakt in Suchabfragen in einer ORDER BY-Klausel verwendet werden kann.

type_url

string

Die URL des Proto, die den Datentyp des Artefakts beschreibt.

is_repeated

bool

Gibt an, ob das Feldartefakt wiederholt wird.

ShoppingPerformanceView

Shopping-Leistungsansicht. Stellt Statistiken zu Shopping-Kampagnen bereit, die auf mehreren Produktdimensionsebenen zusammengefasst sind. Werte für Produktdimensionen aus dem Merchant Center (z. B. Marke, Kategorie, benutzerdefinierte Attribute, Produktzustand und Produkttyp) spiegeln den Status jeder Dimension zu dem Zeitpunkt wider, zu dem das entsprechende Ereignis erfasst wurde.

Felder
resource_name

string

Der Ressourcenname der Shopping-Leistungsansicht. Ressourcennamen der Shopping-Leistungsansicht haben das folgende Format: customers/{customer_id}/shoppingPerformanceView

UserList

Eine Nutzerliste. Dies ist eine Liste von Nutzern, die ein Kunde ansprechen kann.

Felder
resource_name

string

Der Ressourcenname der Nutzerliste. Ressourcennamen von Nutzerlisten haben folgendes Format:

customers/{customer_id}/userLists/{user_list_id}

type

UserListType

Typ dieser Liste.

Dieses Feld ist schreibgeschützt.

id

int64

Die ID der Nutzerliste.

name

string

Der Name dieser Nutzerliste. Je nach „access_reason“ ist der Name der Nutzerliste möglicherweise nicht eindeutig (z. B. access_reason=SHARED).

Aufrufen

Ein Besuch.

Felder
resource_name

string

Der Ressourcenname des Besuchs. Besuchsressourcennamen haben folgendes Format:

customers/{customer_id}/visits/{ad_group_id}~{criterion_id}~{ds_visit_id}

id

int64

Die ID des Besuchs.

criterion_id

int64

Search Ads 360-Keyword-ID Ein Wert von 0 bedeutet, dass das Keyword keine Zuordnung hat.

merchant_id

int64

Die Search Ads 360-Inventarkonto-ID mit dem Produkt, auf das geklickt wurde. Diese ID wird in Search Ads 360 generiert, wenn Sie ein Inventarkonto in Search Ads 360 verknüpfen.

ad_id

int64

Ad ID. Der Wert 0 gibt an, dass die Anzeige nicht zugeordnet ist.

click_id

string

Ein eindeutiger String für jeden Besuch, der als Landingpage-URL-Parameter an die Landingpage übergeben wird.

visit_date_time

string

Der Zeitstempel des Besuchsereignisses. Der Zeitstempel hat die Zeitzone des Kunden und ist im Format "JJJJ-MM-TT HH:mm:ss.ssssss".

product_id

string

ID des Produkts, auf das geklickt wurde.

product_channel

ProductChannel

Der Vertriebskanal des Produkts, auf das geklickt wurde: online oder lokal.

product_language_code

string

Die Sprache (ISO-639-1), die für den Merchant Center-Feed festgelegt wurde, der Daten zum Produkt enthält.

product_store_id

string

Das Geschäft in der Anzeige für lokales Inventar, auf das geklickt wurde. Dieser sollte den Geschäfts-IDs entsprechen, die in Ihrem Feed mit lokal erhältlichen Produkten verwendet werden.

product_country_code

string

Das Land (ISO-3166-Format), das für den Inventarfeed registriert ist, auf dem das Produkt angeklickt wurde.

asset_id

int64

ID des Assets, mit dem während des Besuchsereignisses interagiert wurde.

asset_field_type

AssetFieldType

Asset-Feldtyp des Besuchsereignisses

WebpageView

Webseitenansicht.

Felder
resource_name

string

Der Ressourcenname der Webseitenansicht. Ressourcennamen für Webseitenaufrufe haben folgendes Format:

customers/{customer_id}/webpageViews/{ad_group_id}~{criterion_id}