Package google.ads.searchads360.v0.resources

Index

AccessibleBiddingStrategy

Stellt eine Ansicht der BiddingStrategies dar, die dem Kunden gehören und mit ihm geteilt werden.

Im Gegensatz zu „Gebotsstrategie“ enthält diese Ressource neben Strategien, die dem Kunden gehören, auch Strategien, die von Administratoren des Kunden verwaltet und mit diesem geteilt werden. Diese Ressource enthält keine Messwerte und nur einen Teil der BiddingStrategy-Attribute.

Felder
resource_name

string

Der Ressourcenname der barrierefreien Gebotsstrategie. Ressourcennamen für AccessibleBiddingStrategy 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

Der beschreibende Name des Kunden, zu dem die Gebotsstrategie gehört.

Union-Feld scheme. Das Gebotsschema.

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

maximize_conversion_value

MaximizeConversionValue

Eine automatisierte Gebotsstrategie, mit der Sie mit Ihrem Budget einen möglichst hohen Conversion-Wert für Ihre Kampagnen erzielen.

maximize_conversions

MaximizeConversions

Eine automatische Gebotsstrategie, mit der Sie mit Ihrem Budget möglichst viele Conversions für Ihre Kampagnen erzielen.

target_cpa

TargetCpa

Bei dieser Gebotsstrategie werden die Gebote so festgelegt, dass Sie mit Ihrem Ziel-CPA (Cost-per-Acquisition) möglichst viele Conversions erzielen.

target_impression_share

TargetImpressionShare

Eine Gebotsstrategie, die automatisch auf einen bestimmten Prozentsatz der Impressionen hin optimiert wird.

target_roas

TargetRoas

Eine Gebotsstrategie, mit der Sie den Umsatz maximieren und gleichzeitig einen bestimmten Ziel-ROAS (Return on Advertising Spend) erzielen.

target_spend

TargetSpend

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

MaximizeConversionValue

Eine automatisierte Gebotsstrategie, mit der Sie mit Ihrem Budget 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.

Conversions maximieren

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

Felder
target_cpa

int64

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

target_cpa_micros

int64

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

TargetCpa

Bei dieser automatischen Gebotsstrategie werden die Gebote so festgelegt, 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 an einer anderen ausgewählten Stelle ausgeliefert wird.

Felder
location

TargetImpressionShareLocation

Die Position der Ausrichtung auf der Suchergebnisseite.

location_fraction_micros

int64

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

cpc_bid_ceiling_micros

int64

Das höchste CPC-Gebot, das das automatische Gebotssystem festlegen 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 den Umsatz maximieren und gleichzeitig einen bestimmten Ziel-ROAS (Return on Advertising Spend) erzielen.

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 wurde eingestellt 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. Sie dient nur dazu, die Anzeige zu identifizieren. Er muss nicht eindeutig sein und hat keine Auswirkungen auf die ausgelieferte Anzeige. 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 zu einer 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 von Anzeigengruppen haben das 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, 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 Targeting-bezogene Funktionen.

labels[]

string

Die Ressourcennamen der Labels, die dieser Anzeigengruppe zugeordnet sind.

effective_labels[]

string

Die Ressourcennamen der effektiven Labels, die dieser Anzeigengruppe zugeordnet sind. Ein effektives Label ist ein Label, das dieser Anzeigengruppe übernommen oder direkt zugewiesen wurde.

engine_id

string

ID der Anzeigengruppe im externen Engine-Konto. Dieses Feld gilt nur für Konten, die nicht zu Google Ads gehören, z. B. Yahoo! Japan, Microsoft oder Baidu. Verwenden Sie für eine Google Ads-Entität stattdessen „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. Wenn dieses Feld festgelegt ist, 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. Wenn dieses Feld festgelegt ist, 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 finden Sie unter 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 Engine-Status der Anzeigengruppe.

AdGroupAd

Anzeige einer Anzeigengruppe

Felder
resource_name

string

Der Ressourcenname der Anzeige. Ressourcennamen von Anzeigen in Anzeigengruppen haben das 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 eine andere Entität als Search Ads 360 stattdessen „ad_group_ad.ad.id“.

engine_status

AdGroupAdEngineStatus

Zusätzlicher Status der Anzeige im externen Engine-Konto. 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

Eine Beziehung zwischen einer Anzeigengruppe und einem Label.

Felder
resource_name

string

Der Ressourcenname des Anzeigenlabels der Gruppe. Ressourcennamen des Labels einer Anzeigengruppe haben das 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.

owner_customer_id

int64

Die ID des Kunden, dem das Label gehört.

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 Assets der Anzeigengruppe.

AdGroupAssetSet

„AdGroupAssetSet“ ist die Verknüpfung zwischen einer Anzeigengruppe und einer Asset-Gruppe. Wenn Sie ein Asset-Set für Anzeigengruppen erstellen, wird es 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 dieses Asset-Set verknüpft ist.

asset_set

string

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

status

AssetSetLinkStatus

Der Status des Asset-Sets der Anzeigengruppe. Schreibgeschützt.

AdGroupAudienceView

Eine Zielgruppenansicht für Anzeigengruppen. Enthält Leistungsdaten aus Interessen und Remarketing-Listen für Displaynetzwerk- und YouTube-Anzeigen sowie Remarketing-Listen für Suchanzeigen (RLSA), die auf Zielgruppenebene zusammengefasst sind.

Felder
resource_name

string

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

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

AdGroupBidModifier

Stellt eine Gebotsanpassung für Anzeigengruppen dar.

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 Anzeigengruppen. 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 von Anzeigengruppen-Kriterien 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. Auf der Benutzeroberfläche wird für jede Altersgruppe „Aktiviert“ angezeigt, da die Anzeigen für diese Zielgruppen ausgeliefert werden können.Der Status von „AdGroupCriterion“ ist jedoch „entfernt“, da kein einzuschließendes 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 Engine-Konto. Dieses Feld gilt nur für Nicht-Google Ads-Konten, z. B. Yahoo! Japan, Microsoft oder Baidu. Verwenden Sie für Google Ads-Entitäten stattdessen „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 ausgerichtet (false) oder ausgeschlossen (true) 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 Engine-Status für das Kriterium für Anzeigengruppen.

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 eine 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 Gebote auf Grundlage von Kriterien 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

Eine Beziehung zwischen einem Anzeigengruppenkriterium und einem Label.

Felder
resource_name

string

Der Ressourcenname des Labels der Anzeigengruppe, das die Kriterien erfüllt. Ressourcennamen von Anzeigengruppen-Kriterienlabels haben folgendes 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.

owner_customer_id

int64

Die ID des Kunden, dem das Label gehört.

AdGroupEffectiveLabel

Beziehung zwischen einer Anzeigengruppe und einem effektiven Label. Ein effektives Label ist ein Label, das dieser Anzeigengruppe übernommen oder direkt zugewiesen wurde.

Felder
resource_name

string

Der Ressourcenname des für die Anzeigengruppe geltenden Labels. Ressourcennamen des effektiven Labels einer Anzeigengruppe haben das Format customers/{customer_id}/adGroupEffectiveLabels/{ad_group_id}~{label_id}.

ad_group

string

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

label

string

Das gültige Label, das der Anzeigengruppe zugewiesen ist.

owner_customer_id

int64

Die ID des Kunden, der das effektive Label besitzt.

AdGroupLabel

Eine 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.

owner_customer_id

int64

Die ID des Kunden, dem das Label gehört.

AgeRangeView

Eine Altersgruppe.

Felder
resource_name

string

Der Ressourcenname der Ansicht für Altersgruppen. Ressourcennamen von Ansichten nach Altersgruppe haben das 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, die es verwendet.

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 eine mobile App.

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. Mit AssetGroupSignal können Sie einer Asset-Gruppe ein Signal zuordnen.

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. Name der Asset-Gruppe. Erforderlich. Die Mindestlänge muss 1 und die maximale Länge 128 betragen. Er muss in einer Kampagne eindeutig sein.

final_urls[]

string

Eine Liste der endgültigen URLs nach allen domainübergreifenden Weiterleitungen. Bei Performance Max-Kampagnen können die URLs standardmäßig erweitert werden, sofern Sie die Funktion nicht deaktivieren.

final_mobile_urls[]

string

Eine Liste der endgültigen 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

Die Gesamtleistung der Anzeige für diese Asset-Gruppe.

AssetGroupAsset

„AssetGroupAsset“ ist die Verknüpfung zwischen einem Asset und einer Asset-Gruppe. Wenn Sie ein AssetGroupAsset hinzufügen, wird ein Asset mit einer Asset-Gruppe verknüpft.

Felder
resource_name

string

Der Ressourcenname des Asset-Gruppen-Assets. Der Name der Asset-Ressource einer Asset-Gruppe hat folgendes Format:

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

asset_group

string

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

asset

string

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

field_type

AssetFieldType

Die Beschreibung des Placements des Assets innerhalb der Asset-Gruppe. Beispiel: HEADLINE, YOUTUBE_VIDEO usw.

status

AssetLinkStatus

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

AssetGroupAssetCombinationData

Daten zu Asset-Kombinationen in Asset-Gruppen

Felder
asset_combination_served_assets[]

AssetUsage

Bereitgestellte Assets.

AssetGroupListingGroupFilter

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

Felder
resource_name

string

Der Ressourcenname des Filters für Asset-Eintragsgruppen. 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 Eintragsgruppenfilters.

type

ListingGroupFilterType

Typ eines Knotens für Eintragsgruppenfilter.

vertical

ListingGroupFilterVertical

Die Vertikale, die der aktuelle Knotenbaum darstellt. Alle Knoten im selben Baum müssen derselben Branche angehören.

case_value

ListingGroupFilterDimension

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

parent_listing_group_filter

string

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

path

ListingGroupFilterDimensionPath

Der Pfad der Dimensionen, die diesen Filter für Eintragsgruppen definieren.

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 Ressourcenname des Asset-Gruppensignals hat folgendes 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 für die Performance Max-Kampagne verwendet werden soll.

AssetGroupTopCombinationView

Eine Übersicht zur Verwendung der Kombination aus Anzeigen- und Asset-Gruppen in Anzeigengruppen.

Felder
resource_name

string

Der Ressourcenname der Ansicht mit den Top-Kombinationen 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 von Assets, die gemeinsam ausgeliefert wurden.

AssetSet

Eine Asset-Gruppe, die eine Sammlung von Assets darstellt. Verwende „AssetSetAsset“, um ein Asset mit der Asset-Gruppe zu verknüpfen.

Felder
id

int64

Die ID der Asset-Gruppe.

resource_name

string

Der Ressourcenname des Asset-Sets. 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. Wenn du ein Asset-Set-Asset hinzufügst, wird ein Asset mit einem Asset-Set verknüpft.

Felder
resource_name

string

Der Ressourcenname des Asset-Set-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 Asset-Set-Assets. 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. Zielgruppennamen 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 von der Gebotsstrategie verwendete Währung (dreistelliger ISO 4217-Code).

Für Gebotsstrategien in Verwaltungskunden kann diese Währung beim Erstellen festgelegt werden. Standardmäßig wird die Währung des Verwaltungskunden verwendet. Bei ausliefernden Kunden kann dieses Feld nicht festgelegt werden. Für alle Strategien in einem ausliefernden Kunden wird implizit die Währung des ausliefernden 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. Für die Kundenbetreuung ist dies der currency_code des Kunden.

Messwerte zur Gebotsstrategie werden in dieser Währung erfasst.

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

Eine Gebotsstrategie, bei der Gebote für Klicks erhöht werden, die mit höherer Wahrscheinlichkeit zu einer Conversion führen, und für Klicks gesenkt werden, bei denen dies weniger wahrscheinlich ist.

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 mit Ihrem Budget möglichst viele Conversions für Ihre Kampagnen erzielen.

target_cpa

TargetCpa

Bei dieser Gebotsstrategie werden die Gebote so festgelegt, dass Sie mit Ihrem Ziel-CPA (Cost-per-Acquisition) möglichst viele Conversions erzielen.

target_impression_share

TargetImpressionShare

Eine Gebotsstrategie, die automatisch auf einen bestimmten Prozentsatz der Impressionen hin optimiert wird.

target_outrank_share

TargetOutrankShare

Eine Gebotsstrategie, bei der Gebote basierend auf dem Zielanteil 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. Mutationen zu Strategien, für die dieses Schema bereits vorhanden ist, sind zulässig.

target_roas

TargetRoas

Eine Gebotsstrategie, mit der Sie den Umsatz maximieren und gleichzeitig einen bestimmten Ziel-ROAS (Return on Advertising Spend) erzielen.

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. Ressourcennamen von Kampagnen haben das 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 Status der Optimierung der Anzeigenbereitstellung der Kampagne.

advertising_channel_type

AdvertisingChannelType

Das primäre Bereitstellungsziel für Anzeigen innerhalb der Kampagne. Die Targeting-Optionen 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 Verfeinerung für 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 mit Ausrichtung auf das Ad Exchange-Netzwerk verfügbar ist.

network_settings

NetworkSettings

Die Netzwerkeinstellungen für die Kampagne.

dynamic_search_ads_setting

DynamicSearchAdsSetting

Die Einstellung für dynamische Suchanzeigen.

shopping_setting

ShoppingSetting

Einstellung zur Steuerung von Shopping-Kampagnen

geo_target_type_setting

GeoTargetTypeSetting

Die Einstellung für die geografische Ausrichtung von Anzeigen.

effective_labels[]

string

Die Ressourcennamen der effektiven Labels, die dieser Kampagne zugeordnet sind. Ein effektives Label ist ein Label, das dieser Kampagne übernommen oder direkt zugewiesen ist.

labels[]

string

Die Ressourcennamen der Labels, die dieser Kampagne zugeordnet sind.

bidding_strategy_type

BiddingStrategyType

Der Typ der Gebotsstrategie.

Eine Gebotsstrategie kann entweder durch Festlegen des Gebotsschemas erstellt werden, um eine Standard-Gebotsstrategie zu erstellen, oder durch das Feld bidding_strategy, um eine Portfolio-Gebotsstrategie zu erstellen.

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. Strategieattribute ohne Einschränkungen sind für alle Kunden verfügbar, mit denen die Strategie geteilt wird. Sie werden aus der Ressource „AccessibleBiddingStrategy“ gelesen. Im Gegensatz dazu sind eingeschränkte Attribute nur für den Inhaber der Strategie und seine Manager verfügbar. Eingeschränkt verfügbare Attribute können nur aus der BiddingStrategy-Ressource gelesen werden.

frequency_caps[]

FrequencyCapEntry

Eine Liste, mit der festgelegt wird, wie oft die Anzeigen dieser Kampagne für jeden Nutzer ausgeliefert werden.

selective_optimization

SelectiveOptimization

Einstellung für die selektive Optimierung dieser Kampagne, einschließlich einer Reihe von Conversion-Aktionen, auf die diese 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, einschließlich einer Reihe von Typen von Optimierungszielvorhaben.

tracking_setting

TrackingSetting

Einstellungen auf Kampagnenebene für Tracking-Informationen.

engine_id

string

ID der Kampagne im externen Engine-Konto. Dieses Feld gilt nur für Konten, die nicht zu Google Ads gehören, z. B. Yahoo! Japan, Microsoft oder Baidu. Verwenden Sie für eine Google Ads-Entität stattdessen „campaign.id“.

excluded_parent_asset_field_types[]

AssetFieldType

Die Asset-Feldtypen, die von dieser Kampagne ausgeschlossen werden sollen. Asset-Verknüpfungen mit diesen Feldtypen werden von dieser Kampagne nicht von der übergeordneten Ebene übernommen.

create_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“. „create_time“ wird in Version 1 eingestellt. Verwenden Sie stattdessen „creation_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

Der Ressourcenname des Kampagnenbudgets 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, das an Landingpages angehängt wird, die mit parallelem Tracking ausgeliefert werden.

url_expansion_opt_out

bool

Gibt an, ob die URL-Erweiterung auf gezieltere URLs deaktiviert ist. Wenn die Option deaktiviert ist (wahr), werden nur die finalen URLs in der Asset-Gruppe oder die URLs aus den Google Merchant Center- oder Geschäftsdatenfeeds des Werbetreibenden als Ziel verwendet. Wenn die Option aktiviert ist (false), wird die gesamte Domain als Ausrichtung verwendet. Dieses Feld kann nur für Performance Max-Kampagnen festgelegt werden. Der Standardwert ist „false“.

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

Muss entweder eine Portfolio-Gebotsstrategie (über den BiddingStrategy-Dienst erstellt) oder eine Standard-Gebotsstrategie sein, die in die Kampagne eingebettet ist. Für campaign_bidding_strategy ist nur einer der folgenden Werte zulässig:

bidding_strategy

string

Der Ressourcenname der Portfolio-Gebotsstrategie, die für die Kampagne verwendet wird.

manual_cpa

ManualCpa

Manuelle CPA-Standardstrategie. Gebotsstrategie vom Typ „Manuelle Gebotseinstellung“, mit der Werbetreibende das Gebot pro vom Werbetreibenden angegebener Aktion festlegen können. Nur für Kampagnen für lokale Dienstleistungen unterstützt.

manual_cpc

ManualCpc

Standardmäßige Gebotsstrategie vom Typ „Manueller CPC“. Manuelle, auf Klicks basierende Gebote, bei denen der Nutzer pro Klick bezahlt.

manual_cpm

ManualCpm

Standardmäßige Gebotsstrategie „Manueller CPM“. Manuelle impressionbasierte Gebote, bei denen der Nutzer pro 1.000 Impressionen bezahlt.

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 Standard-Gebotsstrategie „Conversion-Wert maximieren“ legt Gebote automatisch so fest, dass Sie mit Ihrem Budget einen möglichst hohen Umsatz erzielen.

target_cpa

TargetCpa

Standard-Gebotsstrategie vom Typ „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 an Impressionen erzielt 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

Standard-Gebotsstrategie für Ausgabenziel, 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, mit der der Cost-per-1000-Impressions automatisch optimiert wird.

DynamicSearchAdsSetting

Die Einstellung für dynamische Suchanzeigen.

Felder
domain_name

string

Erforderlich. Der Internetdomainname, den diese Einstellung darstellt, z. B. „google.com“ oder „www.google.com“.

language_code

string

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

use_supplied_urls_only

bool

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

GeoTargetTypeSetting

Stellt eine Reihe von Einstellungen für das geografische Targeting von Anzeigen dar.

Felder
positive_geo_target_type

PositiveGeoTargetType

Die Einstellung, die für das positive geografische Targeting in dieser Kampagne verwendet wird.

negative_geo_target_type

NegativeGeoTargetType

Die Einstellung, die für das auszuschließende geografische Targeting in dieser Kampagne verwendet wird.

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 mit dem Placement-Kriterium angegeben.

target_partner_search_network

bool

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

OptimizationGoalSetting

Einstellung für das Optimierungsziel dieser Kampagne, einschließlich einer Reihe von Optimierungszieltypen.

Felder
optimization_goal_types[]

OptimizationGoalType

Die Liste der Arten von Optimierungszielen.

SelectiveOptimization

Einstellung für die selektive Optimierung dieser Kampagne, einschließlich einer Reihe von Conversion-Aktionen, auf die diese Kampagne optimiert werden soll. Diese Funktion gilt nur für App-Kampagnen, bei denen „MULTI_CHANNEL“ als „AdvertisingChannelType“ und „APP_CAMPAIGN“ oder „APP_CAMPAIGN_FOR_ENGAGEMENT“ als „AdvertisingChannelSubType“ verwendet wird.

Felder
conversion_actions[]

string

Die ausgewählten Ressourcennamen für Conversion-Aktionen zur Optimierung dieser Kampagne.

ShoppingSetting

Die Einstellung für Shopping-Kampagnen. Hier wird festgelegt, für welche Produkte in der Kampagne geworben werden kann und 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 eines der beiden Felder „feed_label“ oder „sales_country“ festgelegt werden. Wenn das Feld „feed_label“ anstelle von „sales_country“ verwendet wird, sind Ländercodes im selben Format zulässig, z. B. „XX“. Andernfalls kann ein beliebiger String für das Feedlabel im Google Merchant Center verwendet werden.

use_vehicle_inventory

bool

Ob das Targeting auf Inventar von Fahrzeugeinträgen 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

Absatzland der Produkte, die in die Kampagne aufgenommen werden sollen.

campaign_priority

int32

Priorität der Kampagne. Kampagnen mit einer höheren Priorität haben Vorrang vor Kampagnen mit einer niedrigeren 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 lokale Produkte eingeschlossen werden sollen.

TrackingSetting

Einstellungen auf Kampagnenebene für Tracking-Informationen.

Felder
tracking_url

string

Die URL, die für dynamisches Tracking verwendet wird.

CampaignAsset

Eine Verknüpfung zwischen einer Kampagne und einem Asset.

Felder
resource_name

string

Der Ressourcenname des Kampagnen-Assets. Ressourcennamen von „CampaignAsset“ haben das 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

„CampaignAssetSet“ ist die Verknüpfung zwischen einer Kampagne und einer Asset-Gruppe. Wenn Sie eine Asset-Gruppe der Kampagne hinzufügen, wird sie 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 dieses Asset-Set verknüpft ist.

asset_set

string

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

status

AssetSetLinkStatus

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

CampaignAudienceView

Eine Zielgruppenübersicht für Kampagnen. Enthält Leistungsdaten aus Interessen und Remarketing-Listen für Anzeigen im Displaynetzwerk und im YouTube-Werbenetzwerk sowie Remarketing-Listen für Suchanzeigen (RLSA), die nach Kampagnen- und Zielgruppenkriterien zusammengefasst sind. Diese Ansicht enthält nur Zielgruppen, die auf Kampagnenebene verknüpft sind.

Felder
resource_name

string

Der Ressourcenname der Zielgruppenübersicht der Kampagne. Ressourcennamen von Kampagnen-Zielgruppenansichten haben das Format:

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

CampaignBudget

Kampagnenbudget

Felder
resource_name

string

Der Ressourcenname des Kampagnenbudgets. Ressourcennamen für Kampagnenbudgets haben das 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. Ressourcennamen von Kampagnenkriterien haben das 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 ausgerichtet (false) oder ausgeschlossen (true) werden soll.

Union-Feld criterion. Das Kampagnenkriterium.

Es muss genau eine 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

CampaignEffectiveLabel

Stellt eine Beziehung zwischen einer Kampagne und einem effektiven Label dar. Ein effektives Label ist ein Label, das dieser Kampagne übernommen oder direkt zugewiesen wurde.

Felder
resource_name

string

Der Name der Ressource, Ressourcennamen von „CampaignEffectiveLabel“ haben das Format: customers/{customer_id}/campaignEffectiveLabels/{campaign_id}~{label_id}

campaign

string

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

label

string

Das der Kampagne zugewiesene effektive Label.

owner_customer_id

int64

Die ID des Kunden, dem das effektive Label gehört.

CampaignLabel

Stellt eine Beziehung zwischen einer Kampagne und einem Label dar.

Felder
resource_name

string

Der Name der Ressource, Ressourcennamen von Kampagnenlabels haben das 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.

owner_customer_id

int64

Die ID des Kunden, dem das Label gehört.

CartDataSalesView

Verkaufsansicht für Warenkorbdaten

Felder
resource_name

string

Der Ressourcenname der Verkaufsdatenansicht für Warenkorbdaten. Ressourcennamen von Verkaufsansichten mit Warenkorbdaten haben das 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 von 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 für den Wert von Conversion-Ereignissen, die mit dieser Conversion-Aktion verknüpft sind.

attribution_model_settings

AttributionModelSettings

Einstellungen für das Attributionsmodell dieser Conversion-Aktion.

floodlight_settings

FloodlightSettings

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

id

int64

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 Bit „primary_for_goal“ einer Conversion-Aktion auf „false“ gesetzt ist, können für die Conversion-Aktion keine Gebote für alle Kampagnen abgegeben werden, unabhängig vom Conversion-Zielvorhaben des Kunden oder des Kampagnen-Conversion-Zielvorhabens. Bei benutzerdefinierten Conversion-Zielvorhaben wird „primary_for_goal“ jedoch nicht berücksichtigt. Wenn für eine Kampagne ein benutzerdefiniertes Conversion-Zielvorhaben mit der Conversion-Aktion „primary_for_goal = false“ konfiguriert ist, kann für diese Conversion-Aktion weiterhin geboten werden. Wenn „primary_for_goal“ nicht festgelegt ist, ist der Standardwert „true“. In Version 9 kann „primary_for_goal“ erst nach der Erstellung durch einen „update“-Vorgang auf „false“ gesetzt werden, da es nicht als optional deklariert ist.

owner_customer

string

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

include_in_client_account_conversions_metric

bool

Gibt an, ob diese Conversion-Aktion in den Messwert „client_account_conversions“ einbezogen werden soll.

include_in_conversions_metric

bool

Legt fest, ob diese Conversion-Aktion im Messwert „Conversions“ enthalten sein soll.

click_through_lookback_window_days

int64

Die maximale Anzahl von Tagen, die zwischen einer Interaktion (z. B. einem Klick) und einem Conversion-Ereignis verstreichen darf.

app_id

string

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

AttributionModelSettings

Einstellungen für das Attributionsmodell dieser Conversion-Aktion.

Felder
attribution_model

AttributionModel

Der Attributionsmodelltyp dieser Conversion-Aktion.

data_driven_model_status

DataDrivenModelStatus

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

FloodlightSettings

Einstellungen für eine Floodlight-Conversion-Aktion.

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 für den Wert von Conversion-Ereignissen, 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, nicht zulässigen oder fehlenden Wert gesendet werden oder wenn für diese Conversion-Aktion festgelegt ist, dass immer der Standardwert verwendet werden soll.

default_currency_code

string

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

always_use_default_value

bool

Hier legen Sie fest, ob der Standardwert und der Standardwährungscode anstelle des Werts und des Währungscodes verwendet werden, die in Conversion-Ereignissen für diese Conversion-Aktion angegeben sind.

ConversionCustomVariable

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

Felder
resource_name

string

Der Ressourcenname der benutzerdefinierten Conversion-Variablen. Ressourcennamen für benutzerdefinierte 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 dem Bindestrich dürfen keine Leerzeichen stehen.

tag

string

Erforderlich. Das Tag der benutzerdefinierten Variablen für Conversions. Das Tag muss eindeutig sein und aus dem Buchstaben „u“ gefolgt von einer Zahl bestehen, die kleiner oder gleich 100 ist. Beispiel: „u4“.

status

ConversionCustomVariableStatus

Der Status der benutzerdefinierten Conversion-Variablen für die Ansammlung 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 Datentyp für Floodlight-Variablen.

ConversionTrackingSetting

Eine Sammlung von kundenweiten Einstellungen für das Conversion-Tracking in Search Ads 360.

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, hängt der zurückgegebene Wert vom login-customer-id der Anfrage ab.

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, in dessen Konto Conversions erstellt und verwaltet werden. Dieses Feld ist schreibgeschützt.

conversion_tracking_id

int64

Die Conversion-Tracking-ID, die für dieses Konto verwendet wird. Diese ID gibt nicht an, ob der Kunde Conversion-Tracking verwendet (das ist bei „conversion_tracking_status“ der Fall). Dieses Feld ist schreibgeschützt.

google_ads_cross_account_conversion_tracking_id

int64

Die Conversion-Tracking-ID des Verwaltungskontos des Kunden. Diese Variable wird festgelegt, wenn das Conversion-Tracking für den Kunden aktiviert ist. Sie ü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. Dieser Wert wird festgelegt, wenn das kontoübergreifende Conversion-Tracking aktiviert ist. Er überschreibt die conversion_tracking_id.

CustomColumn

Eine benutzerdefinierte Spalte. Informationen zu benutzerdefinierten Spalten in Search Ads 360 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

„Wahr“, wenn sich die benutzerdefinierte Spalte auf ein oder mehrere Attribute bezieht.

references_metrics

bool

„Wahr“, wenn sich die benutzerdefinierte Spalte auf einen oder mehrere Messwerte bezieht.

queryable

bool

„Wahr“, wenn die benutzerdefinierte Spalte in der Abfrage von SearchAds360Service.Search und SearchAds360Service.SearchStream verwendet werden kann.

referenced_system_columns[]

string

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

render_type

CustomColumnRenderType

Gibt an, wie der Ergebniswert der benutzerdefinierten Spalte interpretiert werden soll.

Kunde

Ein Kunde

Felder
resource_name

string

Der Ressourcenname des Kunden. Ressourcennamen von Kunden haben das 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

DCM-Einstellung (DoubleClick Campaign Manager) für einen Verwaltungskunden.

account_status

AccountStatus

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

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 für „CustomerAsset“ haben das 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. Wenn du ein CustomerAssetSet hinzufügst, wird ein Asset-Set mit einem Kunden verknüpft.

Felder
resource_name

string

Der Ressourcenname des Kunden-Asset-Sets. Asset-Ressourcennamen von Asset-Sets haben folgendes Format:

customers/{customer_id}/customerAssetSets/{asset_set_id}

asset_set

string

Der Asset-Satz, der mit dem Kunden verknüpft ist.

customer

string

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

status

AssetSetLinkStatus

Der Status des Asset-Sets des Kunden. Schreibgeschützt.

CustomerClient

Eine Verknüpfung zwischen dem jeweiligen Kunden und einem Kundenkonto. Kundenkunden gibt es nur für Kunden mit Verwaltungszugriff. Alle direkten und indirekten Kundenkunden sowie das Verwaltungskonto selbst sind enthalten.

Felder
resource_name

string

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

applied_labels[]

string

Die Ressourcennamen der Labels, deren Inhaber der anfragende Kunde ist und die auf den Kunden des Kunden angewendet werden. Labelressourcennamen haben das Format:

customers/{customer_id}/labels/{label_id}

status

CustomerStatus

Der Status des Kunden. Schreibgeschützt.

client_customer

string

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

hidden

bool

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

Schreibgeschützt.

level

int64

Entfernung zwischen dem Kunden und dem Kunden. Bei einem Verweis auf sich selbst ist der Ebenenwert 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 es sich bei dem Kunden um ein Testkonto handelt. 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

Die ID des Campaign Manager-Netzwerks, das mit diesem Kunden verknüpft ist.

time_zone

string

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

DynamicSearchAdsSearchTermView

Eine Suchbegriffsansicht für dynamische Suchanzeigen.

Felder
resource_name

string

Der Ressourcenname der Suchbegriffsdatenansicht für dynamische Suchanzeigen. Ressourcennamen von Suchbegriffsansichten für dynamische Suchanzeigen haben das 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

Eine Ansicht nach Geschlecht. Die Ressource „gender_view“ gibt den effektiven Auslieferungsstatus an, nicht die hinzugefügten Kriterien. Anzeigen in einer Anzeigengruppe ohne Geschlechterkriterien werden standardmäßig allen Geschlechtern präsentiert. Daher werden alle Geschlechter in „gender_view“ mit Statistiken aufgeführt.

Felder
resource_name

string

Der Ressourcenname der Geschlechterübersicht. Ressourcennamen von Geschlechteransichten haben das Format:

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

GeoTargetConstant

Eine geografische Zielkonstante.

Felder
resource_name

string

Der Ressourcenname der geografischen Zielkonstante. Ressourcennamen für geografische Zielkonstanten haben folgendes Format:

geoTargetConstants/{geo_target_constant_id}

status

GeoTargetConstantStatus

Status der geografischen Zielkonstante.

id

int64

Die ID der geografischen Zielkonstante.

name

string

Englischer Name der geografischen Zielkonstante.

country_code

string

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

target_type

string

Zieltyp der geografischen Zielkonstante.

canonical_name

string

Der vollständige qualifizierte englische Name, bestehend aus dem Namen des Ziels und dem Namen des übergeordneten Elements und des Landes.

parent_geo_target

string

Der Ressourcenname der übergeordneten geografischen Zielkonstante. Ressourcennamen für geografische Zielkonstanten haben folgendes Format:

geoTargetConstants/{parent_geo_target_constant_id}

KeywordView

Eine Keyword-Ansicht.

Felder
resource_name

string

Der Ressourcenname der Keyword-Ansicht. Ressourcennamen von Keyword-Anzeigen haben das 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

Ob die Sprache für das Targeting verwendet werden kann.

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

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. Kategorien der obersten Ebene befinden sich auf Ebene 1, ihre untergeordneten Kategorien auf Ebene 2 usw. Derzeit werden bis zu fünf Ebenen unterstützt. 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 Gebotskategorie des Produkts.

Diese ID entspricht der ID „google_product_category“ [Google_Produktkategorie], die in diesem Artikel beschrieben wird: 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 der Ortschaft.

ProductCondition

Zustand eines Produktangebots.

Felder
condition

ListingGroupFilterProductCondition

Wert der Bedingung.

ProductCustomAttribute

Benutzerdefiniertes Attribut eines Produktangebots.

Felder
index

ListingGroupFilterCustomAttributeIndex

Der Index des benutzerdefinierten Attributs.

value

string

Stringwert des benutzerdefinierten Attributs für das Produkt.

ProductItemId

Artikel-ID eines Produktangebots.

Felder
value

string

Wert der ID.

ProductType

Art des Produktangebots.

Felder
level

ListingGroupFilterProductTypeLevel

Ebene des Typs.

value

string

Wert des Typs.

ListingGroupFilterDimensionPath

Der Pfad, der die Dimensionen definiert, die einen Eintragsgruppenfilter definieren.

Felder
dimensions[]

ListingGroupFilterDimension

Der vollständige Pfad der Dimensionen durch die Eintragsgruppenfilterhierarchie (ohne den Stammknoten) zu diesem Eintragsgruppenfilter.

LocationView

In einer Standortansicht wird die Leistung von Kampagnen nach einem Standortkriterium zusammengefasst.

Felder
resource_name

string

Der Ressourcenname der Standortansicht. Ressourcennamen von Standortansichten haben das Format:

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

ProductBiddingCategoryConstant

Eine Gebotskategorie.

Felder
resource_name

string

Der Ressourcenname der Kategorie für Produktgebote. Ressourcennamen für Produktgebotene haben das Format:

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

level

ProductBiddingCategoryLevel

Ebene der Gebotskategorie des Produkts.

status

ProductBiddingCategoryStatus

Status der Produktkategorie für Gebote.

id

int64

ID der Produktkategorie für Gebote.

Diese ID entspricht der ID „google_product_category“, die in diesem Artikel beschrieben wird: https://support.google.com/merchants/answer/6324436.

country_code

string

Ländercode mit zwei Großbuchstaben der Gebotskategorie des Produkts.

product_bidding_category_constant_parent

string

Ressourcenname der übergeordneten Produktkategorie für Gebote.

language_code

string

Sprachcode der Gebotskategorie des Produkts.

localized_name

string

Der Wert der Gebotskategorie des Produkts, lokalisiert gemäß language_code.

ProductGroupView

Eine Produktgruppenansicht.

Felder
resource_name

string

Der Ressourcenname der Produktgruppenansicht. Ressourcennamen von Produktgruppen-Ansichten haben das 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. Namen von Artefaktressourcen 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 ausgewählt werden können.

attribute_resources[]

string

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

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

metrics[]

string

In diesem Feld sind die Namen aller Messwerte aufgeführt, die mit dem beschriebenen Artefakt ausgewählt werden können, wenn es in der FROM-Klausel verwendet wird. Es wird nur für Artefakte mit der Kategorie „RESOURCE“ festgelegt.

segments[]

string

In diesem Feld sind die Namen aller Artefakte aufgeführt, also Segmente oder andere Ressourcen, die Segmentmesswerte enthalten, wenn sie in Suchanfragen enthalten sind und das beschriebene Artefakt in der FROM-Klausel verwendet wird. Es wird nur für Artefakte festgelegt, deren Kategorie RESOURCE ist.

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 einer SELECT-Klausel in Suchanfragen verwendet werden kann.

filterable

bool

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

sortable

bool

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

type_url

string

Die URL des Prototyps, der den Datentyp des Artefakts beschreibt.

is_repeated

bool

Gibt an, ob sich das Feld-Artefakt wiederholt.

ShoppingPerformanceView

Shopping-Leistungsansicht Statistiken zu Shopping-Kampagnen, die auf mehreren Produktdimensionsebenen zusammengefasst sind Die Werte der Produktdimensionen aus dem Merchant Center, z. B. Marke, Kategorie, benutzerdefinierte Attribute, Produktzustand und Produkttyp, spiegeln den Status der einzelnen Dimensionen zum Datum und zur Uhrzeit wider, zu dem das entsprechende Ereignis erfasst wurde.

Felder
resource_name

string

Der Ressourcenname der Shopping-Leistungsdatenansicht. Ressourcennamen von Shopping-Leistungsansichten haben das Format customers/{customer_id}/shoppingPerformanceView.

UserList

Eine Nutzerliste. Dies ist eine Liste der Nutzer, auf die ein Kunde seine Anzeigen ausrichten kann.

Felder
resource_name

string

Der Ressourcenname der Nutzerliste. Ressourcennamen für 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

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

Aufrufen

Ein Besuch.

Felder
resource_name

string

Der Ressourcenname des Besuchs. Namen von Besucherressourcen haben das 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

Eine Webseitenansicht.

Felder
resource_name

string

Der Ressourcenname der Webseitenansicht. Ressourcennamen von Webseitenansichten haben das Format:

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