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 „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, zu 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 ein Wert 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 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 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

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 Position der Ausrichtung auf der Suchergebnisseite.

location_fraction_micros

int64

Der ausgewählte Anteil der Anzeigen, die an dem ausgewählten Standort ausgeliefert werden sollen, in Mikron. 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 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. 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 zu einer 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. 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 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 Suchmaschinenstatus für die Anzeigengruppe.

AdGroupAd

Eine 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, zu dem diese Anzeigengruppenanzeige 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.

effective_labels[]

string

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

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

AdGroupAdEffectiveLabel

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

Felder
resource_name

string

Der Ressourcenname des Labels für die Effektivität der Anzeigen in der Anzeigengruppe. Ressourcennamen des effektiven Labels einer Anzeigengruppe haben das Format: customers/{customer_id}/adGroupAdEffectiveLabels/{ad_group_id}~{ad_id}~{label_id}

ad_group_ad

string

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

label

string

Das effektive Label, das der Anzeige in der Anzeigengruppe zugewiesen ist

owner_customer_id

int64

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

AdGroupAdLabel

Beziehung zwischen einer Anzeige in 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 von Anzeigengruppen-Assets haben das 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

„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 des Asset-Sets der Anzeigengruppe. Ressourcennamen von Asset-Sets von Anzeigengruppen haben das 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 von Zielgruppenansichten für Anzeigengruppen haben das 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 der Anzeigengruppe für die Gebotsanpassung haben das 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 für die Anzeigengruppe.

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. Im Bericht „ad_group_criterion“ werden nur Kriterien zurückgegeben, 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: In UI-Berichten können zusätzliche Informationen enthalten sein, die sich darauf auswirken, ob ein Kriterium ausgeführt 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 sie für die Auslieferung der Anzeigen infrage kommen. 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.

effective_labels[]

string

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

position_estimates

PositionEstimates

Schätzungen für Gebote auf Grundlage von Kriterien 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 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_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.

AdGroupCriterionEffectiveLabel

Eine Beziehung zwischen einem Anzeigengruppenkriterium und einem wirkungsvollen Label. Ein effektives Label ist ein Label, das diesem Anzeigengruppenkriterium übernommen oder direkt zugewiesen wurde.

Felder
resource_name

string

Der Ressourcenname des Labels für das effektive Anzeigengruppenkriterium. Ressourcennamen des effektiven Labels für Anzeigengruppenkriterien haben folgendes Format: customers/{customer_id}/adGroupCriterionEffectiveLabels/{ad_group_id}~{criterion_id}~{label_id}

ad_group_criterion

string

Das Anzeigengruppenkriterium, dem das effektive Label zugeordnet ist.

label

string

Das effektive Label, das dem Gruppenkriterium zugewiesen ist.

owner_customer_id

int64

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

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

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

Felder
resource_name

string

Der Ressourcenname des Labels für die Effektivität der Anzeigengruppe. Anzeigengruppen-effektive Label-Ressourcennamen haben folgendes 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 Anzeigengruppen-Labels haben das 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 Ansicht nach Altersgruppe.

Felder
resource_name

string

Der Ressourcenname der Altersgruppenansicht. Ressourcennamen von Ansichten nach Altersgruppe haben das Format:

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

Asset

Ein Asset ist ein Teil einer Anzeige, der für mehrere Anzeigen verwendet werden kann. Es kann sich beispielsweise um ein Bild (ImageAsset) oder ein Video (YoutubeVideoAsset) 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 der möglichen endgültigen 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 Engine-Status eines Assets.

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. Mit AssetGroupAsset wird ein Asset mit der Asset-Gruppe verknüpft. Über „AssetGroupSignal“ wird einer Asset-Gruppe ein Signal zugeordnet.

Felder
resource_name

string

Der Ressourcenname der Asset-Gruppe. Ressourcennamen von 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. Die Mindestlänge muss 1 und die maximale Länge 128 betragen. Er muss innerhalb 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 der Asset-Gruppe. 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, das mit diesem Asset-Gruppen-Asset verknüpft wird.

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

Ausgelieferte Assets

AssetGroupListingGroupFilter

„AssetGroupListingGroupFilter“ steht für einen Filterknoten für Eintragsgruppen 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 Eintragsgruppenfilters.

type

ListingGroupFilterType

Typ eines Knotens für Eintragsgruppenfilter.

vertical

ListingGroupFilterVertical

Die Vertikale, die der aktuelle Knotenbaum 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. 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, mit denen dieser Eintragsgruppenfilter definiert wird.

AssetGroupSignal

„AssetGroupSignal“ steht für ein Signal in einer Asset-Gruppe. Anhand eines Signals wird in der Performance Max-Kampagne festgelegt, bei wem die Conversion-Wahrscheinlichkeit am höchsten ist. Bei Performance Max-Kampagnen wird das Signal verwendet, um nach neuen Nutzern zu suchen, die eine ähnliche oder stärkere Kaufabsicht haben, und so Conversions in Such-, Display- und Videokampagnen sowie anderen Kampagnentypen 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. Ressourcennamen der Asset-Gruppen-Top-Kombinationsansicht haben das 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. 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 des Asset-Sets. Ressourcennamen von Asset-Sets 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-Set-Assets. Asset-Ressourcennamen von Asset-Sets 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. Dabei erstellen Sie anhand mehrerer Segmentattribute wie detaillierten demografischen Merkmalen und gemeinsamen Interessen Zielgruppen, die Teilen Ihrer Zielgruppensegmente 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. Die Mindestlänge muss 1 und die maximale Länge 255 Zeichen betragen.

description

string

Beschreibung dieser Zielgruppe.

BiddingStrategy

Eine Gebotsstrategie.

Felder
resource_name

string

Der Ressourcenname der Gebotsstrategie. Ressourcennamen für Bidding-Strategien 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 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 ausliefern, kann dieses Feld nicht festgelegt werden. Bei allen Strategien eines Kunden, der Anzeigen bedient, wird implizit die Währung des Kunden verwendet, der den Dienst bereitstellt. 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 von der Gebotsstrategie verwendete Währung (dreistelliger ISO 4217-Code).

Bei Gebotsstrategien für Kunden mit 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 eine 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 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_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. Das Erstellen einer neuen Gebotsstrategie mit diesem Feld oder das Verknüpfen von Gebotsstrategien mit diesem Feld mit einer Kampagne ist nicht möglich. Mutationen zu Strategien, für die dieses Schema bereits vorhanden ist, 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 Status der Optimierung der Anzeigenbereitstellung der Kampagne.

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 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 Werbenetzwerkeinstellungen für die Kampagne.

dynamic_search_ads_setting

DynamicSearchAdsSetting

Einstellung zum Steuern von dynamischen Suchanzeigen.

shopping_setting

ShoppingSetting

Die Einstellung zum Steuern von Shopping-Kampagnen.

geo_target_type_setting

GeoTargetTypeSetting

Die Einstellung für das geografische Targeting 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 wurde.

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“, einer Lesezugriffsdatenansicht der uneingeschränkten Attribute der verknüpften Portfolio-Gebotsstrategie, die durch „bidding_strategy“ gekennzeichnet ist. Leeres Feld, 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 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, bei denen „MULTI_CHANNEL“ als „AdvertisingChannelType“ und „APP_CAMPAIGN“ oder „APP_CAMPAIGN_FOR_ENGAGEMENT“ als „AdvertisingChannelSubType“ verwendet wird.

optimization_goal_setting

OptimizationGoalSetting

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

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 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 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 „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

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 zum Anhängen von Suchparametern an Landingpages, 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. Ist sie aktiviert (false), erfolgt die Ausrichtung auf die gesamte Domain. 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 in der Kampagne verwendet wird.

manual_cpa

ManualCpa

Standardmäßige Gebotsstrategie vom Typ „Manueller CPA“. 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 klickbasierte Gebote, bei denen Nutzer pro Klick bezahlen

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

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

Die standardmäßige Gebotsstrategie „Ziel-ROAS“ (Return on Advertising Spend) maximiert automatisch den Umsatz und gleicht gleichzeitig den durchschnittlichen Ziel-ROAS aus.

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

Standard-Gebotsstrategie vom Typ „Prozentualer CPC“, bei der Gebote einen Bruchteil des angegebenen Preises für ein bestimmtes Produkt oder eine bestimmte Dienstleistung darstellen.

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. „en“.

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 Netzwerkeinstellungen 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

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, 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 es sich um jeden String handeln, der im Google Merchant Center für das Feedlabel verwendet wird.

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 erforderlich. Die Werte können zwischen 0 und 2 liegen (jeweils einschließlich). Dieses Feld ist für smarte Shopping-Kampagnen optional. Wenn es festgelegt ist, muss es jedoch den Wert 3 haben.

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

Das 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-Sets 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

Der Status des Assets 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 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 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 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 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 ENABLED oder ENTFERNT.

asset_id

int64

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

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 Inhaber der Conversion-Aktion ist, 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

Gibt an, ob diese Conversion-Aktion in den Messwert „Conversions“ einbezogen werden 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, 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 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 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 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 Conversion-Variablen. 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 für diesen 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

Ob der Kunde erweiterte Conversions für Leads aktiviert hat. 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 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. 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. Wird festgelegt, wenn der Kunde kontoübergreifendes Conversion-Tracking aktiviert, und überschreibt „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

"True", wenn die benutzerdefinierte Spalte in der Abfrage von SearchAds360Service.Search und SearchAds360Service.SearchStream verwendet werden kann.

referenced_system_columns[]

string

Liste der referenzierten Systemspalten dieser benutzerdefinierten Spalte. Beispielsweise enthält die benutzerdefinierte Spalte „Summe der Impressionen und Klicks“ Systemspalten mit {"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 endgültige 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 des Kunden-Asset-Sets. 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 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. Für den Self-Link ist der Wert 0. Schreibgeschützt.

time_zone

string

CLDR-Stringdarstellung (Common Locale Data Repository) der Zeitzone des Clients, 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

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

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, das mit diesem Kunden verknüpft ist, im Format der IANA-Zeitzonendatenbank, z. B. „America/New_York“.

DynamicSearchAdsSearchTermView

Eine Suchbegriffsansicht für dynamische Suchanzeigen.

Felder
resource_name

string

Der Ressourcenname der Suchbegriffsdatenansicht 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

Eine Ansicht nach Geschlecht. Die Ressource „gender_view“ gibt den effektiven Auslieferungsstatus an, nicht die hinzugefügten Kriterien. 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 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 Konstante für das geografische Ziel.

name

string

Englischer Name der geografischen Zielkonstante.

country_code

string

Der Ländercode gemäß ISO-3166-1 Alpha-2, 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 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 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, Labelressourcennamen haben das Format: customers/{customer_id}/labels/{label_id}

status

LabelStatus

Status des Labels. Schreibgeschützt.

text_label

TextLabel

Ein Labeltyp, bei dem Text auf einem farbigen Hintergrund angezeigt wird.

id

int64

Die 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 (USA)“ 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

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

Art des 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 des Orts.

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

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 der Standortansicht haben folgendes Format:

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

ProductBiddingCategoryConstant

Eine Produkt-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 Gebotskategorie des Produkts.

id

int64

ID der Gebotskategorie des Produkts.

Diese ID entspricht der ID der Google-Produktkategorie 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 Kategorie für Produktkategorie-Gebote.

localized_name

string

Der Wert der Produktgebotskategorie, der gemäß language_code lokalisiert ist.

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 von 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 ausgewählt werden können. 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

Dieses Feld enthält die Namen aller Messwerte, die mit dem beschriebenen Artefakt auswählbar sind, 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 mit 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

In diesem Feld werden die Operatoren festgelegt, 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 Suchabfragen in einer WHERE-Klausel 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 Proto, die den Datentyp des Artefakts beschreibt.

is_repeated

bool

Gibt an, ob sich das Feld-Artefakt wiederholt.

ShoppingPerformanceView

Shopping-Leistungsansicht Hier finden Sie Statistiken zu Shopping-Kampagnen, die auf mehreren Ebenen der Produktdimension 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

Der Typ dieser Liste.

Dieses Feld ist schreibgeschützt.

id

int64

ID der Nutzerliste.

name

string

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

UserLocationView

Eine Ansicht des Nutzerstandorts.

Die Ansicht „Nutzerort“ enthält alle Messwerte, die auf Länderebene zusammengefasst sind, eine Zeile pro Land. Hier werden Messwerte am tatsächlichen physischen Standort des Nutzers nach Standort mit oder ohne Ausrichtung erfasst. Wenn andere Segmentfelder verwendet werden, kann es mehr als eine Zeile pro Land geben.

Felder
resource_name

string

Der Ressourcenname der Nutzerstandortansicht. Ressourcennamen von „UserLocation“-Ansicht haben das Format:

customers/{customer_id}/userLocationViews/{country_criterion_id}~{targeting_location}

country_criterion_id

int64

Kriteriums-ID für das Land.

targeting_location

bool

Gibt an, ob die Ausrichtung auf Standorte erfolgt ist.

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 Der Wert 0 gibt an, dass das Keyword 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 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

Die 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 für Webseitenaufrufe haben folgendes Format:

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