Package google.ads.searchads360.v0.resources

Index

AccessibleBiddingStrategy

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

Im Gegensatz zur BiddingStrategy enthält diese Ressource neben den Strategien dieses Kunden auch Strategien, die den Kundenmanagern gehören und für diesen Kunden freigegeben sind. Diese Ressource stellt keine Messwerte, sondern nur einen begrenzten Teil der Bidding-Attribute bereit.

Felder
resource_name

string

Der Ressourcenname der zugänglichen Gebotsstrategie. AccessibleBiddingStrategy-Ressourcennamen haben das folgende 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

beschreibender Name des Kunden, dem die Gebotsstrategie gehört.

Union-Feld scheme. Das Gebotsschema.

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

maximize_conversion_value

MaximizeConversionValue

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

maximize_conversions

MaximizeConversions

Eine automatische Gebotsstrategie, mit der Sie im Rahmen Ihres Budgets möglichst viele Conversions mit Ihren Kampagnen erzielen.

target_cpa

TargetCpa

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

target_impression_share

TargetImpressionShare

Eine Gebotsstrategie, die automatisch für einen bestimmten Prozentsatz von Impressionen optimiert wird.

target_roas

TargetRoas

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

target_spend

TargetSpend

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

MaximizeConversionValue

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

Felder
target_roas

double

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

MaximizeConversions

Eine automatische Gebotsstrategie, mit der Sie im Rahmen Ihres Budgets möglichst viele Conversions mit Ihren 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

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

Felder
target_cpa_micros

int64

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

TargetImpressionShare

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

Felder
location

TargetImpressionShareLocation

Die Zielregion auf der Suchergebnisseite.

location_fraction_micros

int64

Der ausgewählte Anteil der Anzeigen, die in der Zielregion erscheinen sollen, in Mikroeinheiten. Beispiel: 1% entspricht 10.000.

cpc_bid_ceiling_micros

int64

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

TargetRoas

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

Felder
target_roas

double

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

TargetSpend

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

Felder
target_spend_micros
(deprecated)

int64

Das Ausgabenziel, unter dem die Klicks maximiert werden sollen. Eine TargetSpend-Gebotsfunktion versucht, den kleineren Wert oder den natürlichen Drosselungsbetrag auszugeben. Wenn nicht angegeben, wird das Budget als Ausgabenziel verwendet. Dieses Feld 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 das folgende 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. Er wird nur verwendet, um die Anzeige identifizieren zu können. Er muss nicht eindeutig sein und wirkt sich nicht auf die ausgelieferte Anzeige aus. Das Feld "Name" wird derzeit nur für DisplayUploadAd, ImageAd, ShoppingComparisonListingAd und VideoAd unterstützt.

Union-Feld ad_data. Für den Anzeigentyp relevante Details. 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.

AdGroup

Eine Anzeigengruppe.

Felder
resource_name

string

Der Ressourcenname der Anzeigengruppe. Ressourcennamen von Anzeigengruppen haben das folgende 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

Zeitstempel für die Erstellung dieser Anzeigengruppe Der Zeitstempel hat die Zeitzone des Kunden und ist im Format "JJJJ-MM-TT HH:mm:ss.ssssss".

targeting_setting

TargetingSetting

Einstellung für Funktionen im Zusammenhang mit der Ausrichtung.

labels[]

string

Die Ressourcennamen der Labels, die dieser Anzeigengruppe zugeordnet sind.

engine_id

string

ID der Anzeigengruppe 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.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 wurde, beginnt die Anzeigengruppe zu Beginn 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 wurde, endet die Anzeigengruppe am Ende des angegebenen Datums in der Zeitzone des Kunden. Dieses Feld ist nur für Microsoft Advertising- und Facebook-Gateway-Konten verfügbar.

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

language_code

string

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

last_modified_time

string

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

id

int64

Die ID der Anzeigengruppe.

name

string

Der Name der Anzeigengruppe.

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

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

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

cpc_bid_micros

int64

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

engine_status

AdGroupEngineStatus

Der Suchmaschinenstatus für die Anzeigengruppe.

AdGroupAd

Eine Anzeige in einer Anzeigengruppe.

Felder
resource_name

string

Der Ressourcenname der Anzeige. Ressourcennamen von Anzeigengruppen 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

Zeitstempel für die Erstellung dieser Anzeigegruppen (ad_group_ad) 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 Suchmaschinenkonto 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 Anzeige aus einer Anzeigengruppe und einem Label.

Felder
resource_name

string

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

ad_group_ad

string

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

label

string

Das Label, das der Anzeigengruppe zugewiesen ist.

AdGroupAsset

Eine Verknüpfung zwischen einer Anzeigengruppe und einem Asset

Felder
resource_name

string

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

Der Status des Anzeigengruppen-Assets.

AdGroupAssetSet

„Anzeigengruppe“ stellt die Verknüpfung zwischen einer Anzeigengruppe und einer Asset-Gruppe dar. Durch das Erstellen eines Anzeigengruppen-Asset-Sets wird eine Asset-Gruppe mit einer Anzeigengruppe verknüpft.

Felder
resource_name

string

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

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

ad_group

string

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

asset_set

string

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

status

AssetSetLinkStatus

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

AdGroupAudienceView

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

Felder
resource_name

string

Der Ressourcenname der Zielgruppenansicht der Anzeigengruppe. Ressourcennamen der Zielgruppenansicht für die Anzeigengruppe haben das folgende Format:

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

AdGroupBidModifier

Eine Gebotsanpassung auf Anzeigengruppenebene

Felder
resource_name

string

Der Ressourcenname der Anzeigengruppe für die Gebotsanpassung. Ressourcennamen von Anzeigengruppen-Gebotsanpassungen haben das folgende Format:

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

bid_modifier

double

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

Union-Feld criterion. Das Kriterium dieser Gebotsanpassung auf Anzeigengruppenebene

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

device

DeviceInfo

Ein Gerätekriterium.

AdGroupCriterion

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

Felder
resource_name

string

Der Ressourcenname des Anzeigengruppenkriteriums. Ressourcennamen für Anzeigengruppenkriterien haben das folgende 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: UI-Berichte können zusätzliche Informationen enthalten, die beeinflussen, 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 die Anzeigen für sie ausgeliefert werden können. In "adwords.status" wird jedoch "entfernt" angezeigt, da kein positives Kriterium hinzugefügt wurde.

quality_info

QualityInfo

Informationen zur Qualität des Kriteriums.

type

CriterionType

Der Typ des Kriteriums.

labels[]

string

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

position_estimates

PositionEstimates

Schätzungen für Kriteriumsgebote an verschiedenen Positionen.

final_urls[]

string

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

engine_id

string

ID des Anzeigengruppenkriteriums im externen Suchmaschinenkonto Dieses Feld 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 für das Targeting verwendet (false) oder ausgeschlossen werden soll (true).

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

bid_modifier

double

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

cpc_bid_micros

int64

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

effective_cpc_bid_micros

int64

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

engine_status

AdGroupCriterionEngineStatus

Der Suchmaschinenstatus für das Anzeigengruppenkriterium.

final_url_suffix

string

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

tracking_url_template

string

Die URL-Vorlage zum Erstellen einer Tracking-URL.

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

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

keyword

KeywordInfo

Keyword

listing_group

ListingGroupInfo

Eintragsgruppe.

age_range

AgeRangeInfo

Altersgruppe.

gender

GenderInfo

Gender.

user_list

UserListInfo

Nutzerliste.

webpage

WebpageInfo

Webseite

location

LocationInfo

Standort.

PositionEstimates

Schätzungen für Kriteriumsgebote an verschiedenen Positionen.

Felder
top_of_page_cpc_micros

int64

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

QualityInfo

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

Felder
quality_score

int32

Der Qualitätsfaktor.

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

AdGroupCriterionLabel

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 Kriteriumslabels für Anzeigengruppen haben das folgende Format: customers/{customer_id}/adGroupCriterionLabels/{ad_group_id}~{criterion_id}~{label_id}

ad_group_criterion

string

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

label

string

Das Label, das dem Gruppenkriterium zugewiesen ist.

AdGroupLabel

Eine Beziehung zwischen einer Anzeigengruppe und einem Label.

Felder
resource_name

string

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

ad_group

string

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

label

string

Das Label, das der Anzeigengruppe zugewiesen ist.

AgeRangeView

Eine Ansicht für die Altersgruppe

Felder
resource_name

string

Der Ressourcenname der Altersbereichsansicht. Ressourcennamen für die Altersbereichsansicht haben das folgende Format:

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

Asset

Das Asset ist ein Teil einer Anzeige, der von mehreren Anzeigen gemeinsam verwendet werden kann. Das kann ein Bild (Bild-Asset), ein Video (YouTubeVideoAsset) usw. sein. Assets sind unveränderlich und können nicht entfernt werden. Wenn ein Asset nicht mehr ausgeliefert werden soll, müssen Sie es aus dem Element entfernen, in dem es verwendet wird.

Felder
resource_name

string

Der Ressourcenname des Assets. Namen von Asset-Ressourcen haben das folgende Format:

customers/{customer_id}/assets/{asset_id}

type

AssetType

Asset-Typ.

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

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

Asset mit einheitlichen Seitenfeed

mobile_app_asset

MobileAppAsset

Ein Asset für eine mobile App

call_asset

UnifiedCallAsset

Ein Asset für einheitliche Anrufe

call_to_action_asset

CallToActionAsset

Ein Call-to-Action-Asset.

location_asset

UnifiedLocationAsset

Ein einheitliches Standort-Asset.

AssetGroup

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

Felder
resource_name

string

Der Ressourcenname der Asset-Gruppe. Ressourcennamen von Asset-Gruppen haben das folgende 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 für jede Kampagne eindeutig sein.

final_urls[]

string

Eine Liste der finalen URLs nach allen domainübergreifenden Weiterleitungen. Bei Performance Max-Kampagnen sind die URLs standardmäßig für die Ausweitung zulässig, sofern dies nicht deaktiviert wurde.

final_mobile_urls[]

string

Eine Liste der finalen mobilen URLs nach allen domainübergreifenden Weiterleitungen. Bei Performance Max-Kampagnen sind die URLs standardmäßig für die Ausweitung zulässig, sofern dies nicht deaktiviert wurde.

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

Anzeigeneffektivität dieser Asset-Gruppe insgesamt.

AssetGroupAsset

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

Felder
resource_name

string

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

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

asset_group

string

Die Asset-Gruppe, mit der das Asset der Asset-Gruppe verknüpft wird.

asset

string

Das Asset, mit dem das Asset der Asset-Gruppe verknüpft wird.

field_type

AssetFieldType

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

status

AssetLinkStatus

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

AssetGroupAssetCombinationData

Asset-Gruppe: Kombinationsdaten

Felder
asset_combination_served_assets[]

AssetUsage

Ausgelieferte Assets.

AssetGroupListingGroupFilter

„AssetGroupListingGroupFilter“ steht für einen Baumknoten zum Auflisten von Gruppenfiltern in einer Asset-Gruppe.

Felder
resource_name

string

Der Ressourcenname des Filter für Asset-Eintragsgruppen in der Asset-Gruppe. Der Ressourcenname des Asset-Eintragsgruppen-Filters für Asset-Gruppen hat das folgende Format:

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

asset_group

string

Die Asset-Gruppe, zu der dieser Asset-Gruppenfilter gehört.

id

int64

Die ID des ListGroupFilters.

type

ListingGroupFilterType

Typ eines Knotens für eine Eintragsgruppe.

vertical

ListingGroupFilterVertical

Die vertikale, die der aktuelle Knotenbaum darstellt. Alle Knoten in derselben Baumstruktur müssen zur selben Branche gehören.

case_value

ListingGroupFilterDimension

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

parent_listing_group_filter

string

Ressourcenname der Untergruppe der übergeordneten Eintragsgruppe. Nullwert 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. Ist ein Signal vorhanden, weiß die Performance Max-Kampagne, 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 anderen Kampagnentypen zu erzielen.

Felder
resource_name

string

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

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

asset_group

string

Die Asset-Gruppe, zu der das 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 bei der Performance Max-Kampagne verwendet werden soll.

AssetGroupTopCombinationView

Eine Übersicht über die Verwendung einer Kombination aus Anzeigen-Assets auf Anzeigengruppenebene.

Felder
resource_name

string

Der Ressourcenname der Ansicht mit der obersten Kombination der Asset-Gruppe. Ressourcennamen der Asset-Gruppe-Top-Kombinationsansicht haben das Format „customers/{customer_id}/assetGroupTopCombinationViews/{asset_group_id}~{asset_combination_category}“.

asset_group_top_combinations[]

AssetGroupAssetCombinationData

Die leistungsstärksten Asset-Kombinationen, die zusammen ausgeliefert wurden.

AssetSet

Eine Asset-Gruppe, die eine Sammlung von Assets repräsentiert. Verwenden Sie „AssetSetAsset“, um ein Asset mit der Asset-Gruppe zu verknüpfen.

Felder
id

int64

Die ID der Asset-Gruppe.

resource_name

string

Der Ressourcenname der Asset-Gruppe. Ressourcennamen der Asset-Gruppe haben das folgende Format:

customers/{customer_id}/assetSets/{asset_set_id}

AssetSetAsset

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

Felder
resource_name

string

Der Ressourcenname des Assets der Asset-Gruppe. Asset-Ressourcennamen der Asset-Gruppe haben das folgende Format:

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

asset_set

string

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

asset

string

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

status

AssetSetAssetStatus

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

Zielgruppe

„Zielgruppe“ ist eine effektive Ausrichtungsoption, bei der sich verschiedene Segmentattribute wie detaillierte demografische Merkmale und gemeinsame Interessen überschneiden lassen. So lassen sich Zielgruppen erstellen, die bestimmten Bereichen Ihrer Zielsegmente entsprechen.

Felder
resource_name

string

Der Ressourcenname der Zielgruppe. Zielgruppennamen haben das Format:

customers/{customer_id}/audiences/{audience_id}

id

int64

ID der Zielgruppe.

name

string

Erforderlich. Name der Zielgruppe. Sie 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 einer Gebotsstrategie haben das folgende 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 beim Erstellen festgelegt werden. Als Standardeinstellung wird die Währung des Verwaltungskontos verwendet. Dieses Feld kann für ausliefernde Kunden nicht festgelegt werden. Alle Strategien in einem liefernden Kunden verwenden implizit die Währung des liefernden Kunden. In allen Fällen gibt das Feld „effective_currency_code“ die Währung zurück, die von der Strategie verwendet wird.

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

Für Gebotsstrategien in Verwaltungskonten ist dies die Währung, die der Werbetreibende beim Erstellen der Strategie festgelegt hat. Im Falle von Kundenbetreuung ist dies der Währungscode des Kunden.

Messwerte für Gebotsstrategien 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 eines festgelegt werden. Für scheme ist nur einer der folgenden Werte zulässig:

enhanced_cpc

EnhancedCpc

Eine Gebotsstrategie, bei der die Gebote für Klicks, die mit höherer Wahrscheinlichkeit zu einer Conversion führen, erhöht und die Gebote für Klicks senkt, für die sie weniger wahrscheinlich sind.

maximize_conversion_value

MaximizeConversionValue

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

maximize_conversions

MaximizeConversions

Eine automatische Gebotsstrategie, mit der Sie im Rahmen Ihres Budgets möglichst viele Conversions mit Ihren Kampagnen erzielen.

target_cpa

TargetCpa

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

target_impression_share

TargetImpressionShare

Eine Gebotsstrategie, die automatisch für einen bestimmten Prozentsatz von Impressionen 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 sollte. Die Verwendung dieses Feldes wurde eingestellt. Das Erstellen einer neuen Gebotsstrategie mit diesem Feld oder das Anhängen von Gebotsstrategien mit diesem Feld zu einer Kampagne schlägt fehl. Änderungen an Strategien, die dieses Schema bereits enthalten, 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. Ressourcennamen von Kampagnen haben das folgende Format:

customers/{customer_id}/campaigns/{campaign_id}

status

CampaignStatus

Der Status der Kampagne.

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

serving_status

CampaignServingStatus

Der Status der Anzeigenbereitstellung der Kampagne.

bidding_strategy_system_status

BiddingStrategySystemStatus

Der Systemstatus der Gebotsstrategie der Kampagne.

ad_serving_optimization_status

AdServingOptimizationStatus

Der Optimierungsstatus der Kampagne für die Anzeigenbereitstellung.

advertising_channel_type

AdvertisingChannelType

Das primäre Bereitstellungsziel für Anzeigen innerhalb der Kampagne. Die Ausrichtungsoptionen können unter network_settings verfeinert 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

Optionaler Suchfilter 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 zum Ersetzen von Tags für benutzerdefinierte Parameter in einem tracking_url_template-, final_urls- oder mobile_final_urls-Element verwendet werden.

real_time_bidding_setting

RealTimeBiddingSetting

Einstellungen für Echtzeitgebote; Funktion nur für Kampagnen verfügbar, die auf das Ad Exchange-Werbenetzwerk ausgerichtet sind

network_settings

NetworkSettings

Die Einstellungen für Werbenetzwerke für die Kampagne

dynamic_search_ads_setting

DynamicSearchAdsSetting

Einstellung zur Steuerung dynamischer Suchanzeigen.

shopping_setting

ShoppingSetting

Die Einstellung zur Steuerung von Shopping-Kampagnen.

geo_target_type_setting

GeoTargetTypeSetting

Die Einstellung für die geografische Ausrichtung von Anzeigen.

labels[]

string

Die Ressourcennamen der Labels, die mit dieser Kampagne verknüpft sind.

bidding_strategy_type

BiddingStrategyType

Der Typ der Gebotsstrategie.

Wenn Sie eine Gebotsstrategie erstellen möchten, legen Sie entweder das Gebotsschema zum Erstellen einer Standard-Gebotsstrategie oder das Feld bidding_strategy fest, um eine Portfolio-Gebotsstrategie zu erstellen.

Dieses Feld ist schreibgeschützt.

accessible_bidding_strategy

string

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

frequency_caps[]

FrequencyCapEntry

Eine Liste, mit der eingeschränkt wird, wie oft die Anzeigen dieser Kampagne für einzelne Nutzer ausgeliefert werden.

selective_optimization

SelectiveOptimization

Die selektive Optimierungseinstellung für diese Kampagne mit einer Reihe von Conversion-Aktionen, auf die hin die Kampagne optimiert werden soll. Diese Funktion gilt nur für App-Kampagnen mit MULTI_CHANNEL als AdvertisingChannelType und APP_CAMPAIGN oder APP_CAMPAIGN_FOR_ENGAGEMENT als AdvertisingChannelSubType.

optimization_goal_setting

OptimizationGoalSetting

Einstellung für Optimierungsziel für diese Kampagne, die verschiedene Arten von Optimierungszieltypen umfasst.

tracking_setting

TrackingSetting

Einstellungen für Tracking-Informationen auf Kampagnenebene

engine_id

string

ID der Kampagne 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 „campaign.id“.

excluded_parent_asset_field_types[]

AssetFieldType

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

create_time

string

Der Zeitstempel für den Zeitpunkt, zu dem dieser Kampagne erstellt wurde. Der Zeitstempel wird in der Zeitzone des Kunden angegeben und hat das Format "jjjj-MM-tt HH:mm:ss". create_time wird in v1 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

Das Budget der Kampagne.

start_date

string

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

end_date

string

Die letzte Tag der Kampagne in der Zeitzone des Kunden im Format JJJJ-MM-TT. Beim Erstellen wird der Standardwert 2037-12-30 verwendet, 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 bereitgestellt werden.

url_expansion_opt_out

bool

Stellt die Deaktivierung der URL-Erweiterung für spezifischere URLs dar. Ist sie deaktiviert (wahr), erfolgt das Targeting nur auf die finalen URLs in der Asset-Gruppe oder die URLs, die im Google Merchant Center- oder Geschäftsdatenfeed des Werbetreibenden angegeben sind. Bei Aktivierung („false“) wird die gesamte Domain für das Targeting verwendet. Dieses Feld kann nur für Performance Max-Kampagnen festgelegt werden, bei denen der Standardwert „false“ ist.

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

Es muss sich entweder um ein (über den BiddingStrategy-Dienst erstelltes) Portfolio oder um einen Standard handeln, das in die Kampagne eingebettet ist. Für campaign_bidding_strategy ist nur einer der folgenden Werte zulässig:

bidding_strategy

string

Von der Kampagne verwendete Portfolio-Strategie.

manual_cpa

ManualCpa

Standardmäßige Gebotsstrategie „Manueller CPA“. Dies ist eine manuelle Gebotsstrategie, bei der der Werbetreibende das Gebot für jede vom Werbetreibenden angegebene Aktion festlegen kann. Sie wird nur für Kampagnen für lokale Dienstleistungen unterstützt.

manual_cpc

ManualCpc

Standard-Gebotsstrategie mit manuellen CPC-Geboten. Manuelle klickbasierte Gebote, bei denen Nutzer pro Klick bezahlen

manual_cpm

ManualCpm

Manuelle CPM-Standardgebotsstrategie. Manuelle, auf Impressionen basierende Gebote, bei denen der Nutzer pro 1.000 Impressionen bezahlt

maximize_conversions

MaximizeConversions

Dies ist die standardmäßige Gebotsstrategie, bei der die Anzahl der Conversions automatisch maximiert wird, ohne Ihr Budget zu überschreiten.

maximize_conversion_value

MaximizeConversionValue

Standardmäßige Gebotsstrategie „Conversion-Wert maximieren“, bei der Gebote automatisch so festgelegt werden, dass Sie mit Ihrem Budget einen möglichst hohen Umsatz erzielen

target_cpa

TargetCpa

Standardmäßige Ziel-CPA-Gebotsstrategie, 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 der Impressionen erreicht wird.

target_roas

TargetRoas

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

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-CPC-Gebotsstrategie, bei der die Gebote für einen Artikel oder eine Dienstleistung einen Bruchteil des beworbenen Preises darstellen

target_cpm

TargetCpm

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

DynamicSearchAdsSetting

Einstellung zur Steuerung dynamischer Suchanzeigen.

Felder
domain_name

string

Erforderlich. Der Name der Internetdomain, für die diese Einstellung steht, 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

Eine Sammlung von Einstellungen, die sich auf die geografische Ausrichtung von Anzeigen beziehen.

Felder
positive_geo_target_type

PositiveGeoTargetType

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

negative_geo_target_type

NegativeGeoTargetType

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

NetworkSettings

Die Einstellungen für Werbenetzwerke für die Kampagne

Felder
target_search_network

bool

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

target_content_network

bool

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

target_partner_search_network

bool

Gibt an, ob Anzeigen im Google-Partnernetzwerk ausgeliefert werden. Diese Funktion ist nur für ausgewählte Google-Partnerkonten verfügbar.

OptimizationGoalSetting

Einstellung für Optimierungsziel für diese Kampagne, die verschiedene Arten von Optimierungszieltypen umfasst.

Felder
optimization_goal_types[]

OptimizationGoalType

Die Liste der Typen von Optimierungszielvorhaben.

SelectiveOptimization

Die selektive Optimierungseinstellung für diese Kampagne mit einer Reihe von Conversion-Aktionen, auf die hin die Kampagne optimiert werden soll. Diese Funktion gilt nur für App-Kampagnen mit MULTI_CHANNEL als AdvertisingChannelType und APP_CAMPAIGN oder APP_CAMPAIGN_FOR_ENGAGEMENT als AdvertisingChannelSubType.

Felder
conversion_actions[]

string

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

ShoppingSetting

Die Einstellung für Shopping-Kampagnen. Definiert die Produkte, für die mit 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 entweder „feed_label“ oder „sales_country“ festgelegt werden. Wenn es anstelle von „sales_country“ verwendet wird, akzeptiert das Feld „feed_label“ Ländercodes im selben Format, z. B. „XX“. Ansonsten kann es sich um einen beliebigen String handeln, der im Google Merchant Center für ein Feedlabel verwendet wird.

use_vehicle_inventory

bool

Gibt an, ob ein Targeting auf Fahrzeugeintragsinventar erfolgen soll.

merchant_id

int64

ID des Merchant Center-Kontos. Dieses Feld ist für Erstellungsvorgänge erforderlich. Dieses Feld ist für Shopping-Kampagnen unveränderlich.

sales_country

string

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

campaign_priority

int32

Priorität der Kampagne. Kampagnen mit numerisch höheren Prioritäten haben Vorrang vor Kampagnen mit niedrigerer Priorität. Dieses Feld ist für Shopping-Kampagnen mit Werten zwischen 0 und 2 (einschließlich) erforderlich. Dieses Feld ist bei smarten Shopping-Kampagnen optional, muss aber den Wert 3 haben, falls festgelegt.

enable_local

bool

Ob lokal erhältliche Produkte einbezogen werden sollen

TrackingSetting

Einstellungen für Tracking-Informationen auf Kampagnenebene

Felder
tracking_url

string

Die für das dynamische Tracking verwendete URL.

CampaignAsset

Verknüpfung zwischen einer Kampagne und einem Asset

Felder
resource_name

string

Der Ressourcenname des Kampagnen-Assets. Ressourcennamen von Kampagnen-Assets haben das folgende Format:

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

status

AssetLinkStatus

Der 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“ stellt die Verknüpfung zwischen einer Kampagne und einer Asset-Gruppe dar. Durch das Hinzufügen eines CampaignAssetSet wird eine Asset-Gruppe mit einer Kampagne verknüpft.

Felder
resource_name

string

Der Ressourcenname der Asset-Gruppe der Kampagne. Asset-Ressourcennamen der Asset-Gruppe haben das folgende Format:

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

campaign

string

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

asset_set

string

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

status

AssetSetLinkStatus

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

CampaignAudienceView

Die Zielgruppenansicht einer Kampagne. Enthält Leistungsdaten aus Interessen und Remarketing-Listen für Anzeigen im Displaynetzwerk und YouTube sowie Remarketing-Listen für Suchanzeigen, aggregiert nach Kampagnen- und Zielgruppenkriterium. Diese Ansicht enthält nur Zielgruppen, die auf Kampagnenebene zugeordnet wurden.

Felder
resource_name

string

Der Ressourcenname der Zielgruppenansicht der Kampagne. Ressourcennamen für die Zielgruppenansicht der Kampagne haben das folgende Format:

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

CampaignBudget

Ein Kampagnenbudget

Felder
resource_name

string

Der Ressourcenname des Kampagnenbudgets. Ressourcennamen für das Kampagnenbudget haben das folgende 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 für Kampagnenkriterien haben das folgende Format:

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

display_name

string

Der Anzeigename des Kriteriums.

Dieses Feld wird für Mutationen ignoriert.

type

CriterionType

Der Typ des Kriteriums.

status

CampaignCriterionStatus

Der Status des Kriteriums.

last_modified_time

string

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

criterion_id

int64

Die ID des Kriteriums.

Dieses Feld wird während der Mutation ignoriert.

bid_modifier

float

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

negative

bool

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

Union-Feld criterion. Das Kampagnenkriterium

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

keyword

KeywordInfo

Keyword

location

LocationInfo

Standort.

device

DeviceInfo

Gerät.

age_range

AgeRangeInfo

Altersgruppe.

gender

GenderInfo

Gender.

user_list

UserListInfo

Nutzerliste.

language

LanguageInfo

Sprache

webpage

WebpageInfo

Webseite

location_group

LocationGroupInfo

Standortgruppe

CampaignLabel

Stellt eine Beziehung zwischen einer Kampagne und einem Label dar.

Felder
resource_name

string

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

campaign

string

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

label

string

Das der Kampagne zugewiesene Label.

CartDataSalesView

Ansicht „Verkauf von Warenkorbdaten“.

Felder
resource_name

string

Der Ressourcenname der Ansicht „Verkauf von Warenkorbdaten“. Ressourcennamen von Warenkorbdaten-Verkaufsdaten haben das folgende Format: customers/{customer_id}/cartDataSalesView

Conversion

Eine Conversion.

Felder
resource_name

string

Der Ressourcenname der Conversion. Namen von Conversion-Ressourcen haben das folgende 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 Ads360-Inventarkonto-ID mit dem Produkt, auf das geklickt wurde. SearchID360 generiert diese ID, wenn Sie ein Inventarkonto in SearchAds360 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 Ads360-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

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

asset_field_type

AssetFieldType

Asset-Feldtyp des Conversion-Ereignisses.

ConversionAction

Eine Conversion-Aktion.

Felder
resource_name

string

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

customers/{customer_id}/conversionActions/{conversion_action_id}

creation_time

string

Zeitstempel der Erstellung der Floodlight-Aktivität im ISO 8601-Format.

status

ConversionActionStatus

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

type

ConversionActionType

Der Typ dieser Conversion-Aktion.

category

ConversionActionCategory

Die Kategorie der für diese Conversion-Aktion erfassten Conversions.

value_settings

ValueSettings

Einstellungen in Bezug auf den Wert für Conversion-Ereignisse, die mit dieser Conversion-Aktion verknüpft sind.

attribution_model_settings

AttributionModelSettings

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

floodlight_settings

FloodlightSettings

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

id

int64

ID der Conversion-Aktion.

name

string

Der Name der Conversion-Aktion.

Dieses Feld ist erforderlich und darf nicht leer sein, wenn neue Conversion-Aktionen erstellt werden.

primary_for_goal

bool

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

owner_customer

string

Der Ressourcenname des Inhabers der Conversion-Aktion 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 liegen dürfen.

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 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, mit dem eine Floodlight-Aktivität bei der Berichterstellung für Conversions identifiziert wird.

activity_id

int64

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

ValueSettings

Einstellungen in Bezug auf den Wert für Conversion-Ereignisse, die mit dieser Conversion-Aktion verknüpft sind.

Felder
default_value

double

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

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 die Conversion-Aktion immer der Standardwert verwendet wird.

always_use_default_value

bool

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

ConversionCustomVariable

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

Felder
resource_name

string

Der Ressourcenname der benutzerdefinierten Conversion-Variable. Ressourcennamen von benutzerdefinierten Conversion-Variablen haben das folgende Format:

customers/{customer_id}/conversionCustomVariables/{conversion_custom_variable_id}

id

int64

Die ID der benutzerdefinierten Conversion-Variable.

name

string

Erforderlich. Name der benutzerdefinierten Conversion-Variable. Der Name muss eindeutig sein. Der Name darf maximal 100 Zeichen lang sein. Vor und nach der Adresse dürfen keine zusätzlichen Leerzeichen stehen.

tag

string

Erforderlich. Das Tag der benutzerdefinierten Conversion-Variable. Das Tag muss eindeutig sein und aus einem „u“-Zeichen bestehen, auf das eine Zahl kleiner als 100 folgt. Beispiel: „u4“.

status

ConversionCustomVariableStatus

Der Status der benutzerdefinierten Conversion-Variable zum Erfassen von Conversion-Ereignissen.

owner_customer

string

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

family

ConversionCustomVariableFamily

Familie der benutzerdefinierten Conversion-Variable

cardinality

ConversionCustomVariableCardinality

Kardinalität der benutzerdefinierten Conversion-Variable.

floodlight_conversion_custom_variable_info

FloodlightConversionCustomVariableInfo

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

custom_column_ids[]

int64

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

FloodlightConversionCustomVariableInfo

Informationen zu benutzerdefinierten Variablen für Search Ads 360-Floodlight-Conversions.

Felder
floodlight_variable_type

FloodlightVariableType

In Search Ads 360 definierter Floodlight-Variablentyp

floodlight_variable_data_type

FloodlightVariableDataType

In Search Ads 360 definierter Floodlight-Variablen-Datentyp

ConversionTrackingSetting

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

Felder
accepted_customer_data_terms

bool

Gibt an, ob der Kunde die Nutzungsbedingungen für Kundendaten akzeptiert hat. Wenn Sie kontoübergreifendes Conversion-Tracking verwenden, wird dieser Wert vom Kontoverwalter ü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. Er gibt an, ob der Kunde Conversion-Tracking verwendet und wer der Inhaber des Conversion-Trackings dieses Kunden ist. Wenn dieser Kunde kontoübergreifendes Conversion-Tracking verwendet, unterscheidet sich der zurückgegebene Wert je nach login-customer-id der Anfrage.

enhanced_conversions_for_leads_enabled

bool

Gibt an, ob der Kunde erweiterte Conversions für Leads aktiviert hat. Wenn Sie kontoübergreifendes Conversion-Tracking verwenden, wird dieser Wert vom Kontoverwalter übernommen. Dieses Feld ist schreibgeschützt.

google_ads_conversion_customer

string

Der Ressourcenname des Kunden, in dem 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 (dies ist beispielsweise bei „conversion_tracking_status“). Dieses Feld ist schreibgeschützt.

google_ads_cross_account_conversion_tracking_id

int64

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

cross_account_conversion_tracking_id

int64

Die Conversion-Tracking-ID des Verwaltungskontos des Kunden. Sie wird festgelegt, wenn für den Kunden kontoübergreifendes Conversion-Tracking aktiviert ist, und überschreibt „conversion_tracking_id“.

CustomColumn

Eine benutzerdefinierte Spalte. Weitere Informationen finden Sie in der benutzerdefinierten Search Ads 360-Spalte unter https://support.google.com/sa360/answer/9633916.

Felder
resource_name

string

Der Ressourcenname der benutzerdefinierten Spalte. Ressourcennamen von benutzerdefinierten Spalten haben das folgende Format:

customers/{customer_id}/customColumns/{custom_column_id}

id

int64

ID der benutzerdefinierten Spalte.

name

string

Benutzerdefinierter Name der benutzerdefinierten Spalte.

description

string

Benutzerdefinierte Beschreibung der benutzerdefinierten Spalte.

value_type

CustomColumnValueType

Der Typ des Ergebniswerts der benutzerdefinierten Spalte.

references_attributes

bool

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

references_metrics

bool

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

queryable

bool

Dieser Wert ist „True“, wenn die benutzerdefinierte Spalte in der Abfrage von „SearchAds360Service.Search“ und „SearchAds360Service.SearchStream“ verwendet werden kann.

referenced_system_columns[]

string

Die Liste der referenzierten Systemspalten dieser benutzerdefinierten Spalte. Beispiel: Die benutzerdefinierte Spalte „Summe von Impressionen und Klicks“ verweist auf Systemspalten von {"metrics.clicks", "metrics.impressions"}.

Kunde

Kunde

Felder
resource_name

string

Der Ressourcenname des Kunden. Ressourcennamen von Kunden haben das folgende Format:

customers/{customer_id}

conversion_tracking_setting

ConversionTrackingSetting

Conversion-Tracking-Einstellung für einen Kunden.

account_type

AccountType

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

double_click_campaign_manager_setting

DoubleClickCampaignManagerSetting

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

account_status

AccountStatus

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

last_modified_time

string

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

engine_id

string

ID des Kontos im externen Engine-Konto.

status

CustomerStatus

Der Status des Kunden.

creation_time

string

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

id

int64

Die ID des Kunden.

descriptive_name

string

Optionaler, nicht eindeutiger beschreibender Name des Kunden.

currency_code

string

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

time_zone

string

Die lokale Zeitzonen-ID des Kunden.

tracking_url_template

string

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

final_url_suffix

string

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

auto_tagging_enabled

bool

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

manager

bool

Gibt an, ob der Kunde ein Manager ist.

CustomerAsset

Eine Verknüpfung zwischen einem Nutzer und einem Asset.

Felder
resource_name

string

Der Ressourcenname des Kunden-Assets. Ressourcennamen vom Typ „CustomerAsset“ haben das folgende Format:

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

asset

string

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

status

AssetLinkStatus

Status des Kunden-Assets.

CustomerAssetSet

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

Felder
resource_name

string

Der Ressourcenname der Kunden-Asset-Gruppe. Asset-Ressourcennamen der Asset-Gruppe haben das folgende Format:

customers/{customer_id}/customerAssetSets/{asset_set_id}

asset_set

string

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

customer

string

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

status

AssetSetLinkStatus

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

CustomerClient

Eine Verknüpfung zwischen der angegebenen und einem Kunden. CustomerKunden gibt es nur für Kunden mit Verwaltungskonto. Alle direkten und indirekten Kunden sowie der Manager selbst sind eingeschlossen.

Felder
resource_name

string

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

applied_labels[]

string

Die Ressourcennamen der Labels des anfragenden Kunden, die auf den Kundenkunden angewendet werden. Ressourcennamen von Labels haben das folgende Format:

customers/{customer_id}/labels/{label_id}

status

CustomerStatus

Der Status des Kunden. Schreibgeschützt.

client_customer

string

Der Ressourcenname des Kunden und 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 Kunde und Kunde. Bei einem Self-Link ist der Stufenwert 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 der Kunde ein Testkonto ist. Schreibgeschützt.

manager

bool

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

descriptive_name

string

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

currency_code

string

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

id

int64

Die ID des Kunden. Schreibgeschützt.

DoubleClickCampaignManagerSetting

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

Felder
advertiser_id

int64

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

network_id

int64

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

time_zone

string

Zeitzone des mit diesem Kunden verknüpften Campaign Manager-Netzwerks im Format der IANA-Zeitzonendatenbank, z. B. America/New_York.

DynamicSearchAdsSearchTermView

Eine Ansicht für Suchbegriffe in dynamischen Suchanzeigen.

Felder
resource_name

string

Der Ressourcenname der Ansicht mit Suchbegriffen für dynamische Suchanzeigen. Ressourcennamen von Suchbegriffen für dynamische Suchanzeigen haben das folgende 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 geschlechtsspezifische Ansicht. Die Ressource „gender_view“ gibt den Status der aktiven Auslieferung an und nicht, welche Kriterien hinzugefügt wurden. Bei Anzeigengruppen ohne Geschlechtskriterien werden standardmäßig alle Geschlechter berücksichtigt, sodass alle Geschlechter unter gender_view mit Statistiken erscheinen.

Felder
resource_name

string

Der Ressourcenname der Geschlechtsansicht. Ressourcennamen der Geschlechtsansicht haben das folgende Format:

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

GeoTargetConstant

Eine Konstante für die geografische Ausrichtung.

Felder
resource_name

string

Der Ressourcenname der Konstante für die geografische Ausrichtung. Namen von konstanten Ressourcen für die geografische Ausrichtung haben das folgende Format:

geoTargetConstants/{geo_target_constant_id}

status

GeoTargetConstantStatus

Status der geografischen Ausrichtung konstant.

id

int64

ID der Konstante für die geografische Ausrichtung

name

string

Englischer Name für die geografische Ausrichtungskonstante

country_code

string

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

target_type

string

Konstanter Zieltyp für die geografische Ausrichtung

canonical_name

string

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

parent_geo_target

string

Der Ressourcenname der übergeordneten Konstante für das geografische Targeting. Namen von konstanten Ressourcen für die geografische Ausrichtung haben das folgende Format:

geoTargetConstants/{parent_geo_target_constant_id}

KeywordView

Eine Keyword-Ansicht.

Felder
resource_name

string

Der Ressourcenname der Keyword-Ansicht. Ressourcennamen der Keyword-Ansicht haben das folgende Format:

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

Label

Ein Label.

Felder
resource_name

string

Der Name der Ressource, Ressourcennamen von Labels haben das folgende Format: customers/{customer_id}/labels/{label_id}

status

LabelStatus

Der Status des Labels. Schreibgeschützt.

text_label

TextLabel

Ein Labeltyp, der Text vor 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 von Sprachkonstanten haben das folgende 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 in Englisch, z. B. „Englisch (US)“ oder „Spanisch“.

targetable

bool

Gibt an, ob die Sprache zur Ausrichtung verwendet werden kann.

ListingGroupFilterDimension

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

Felder
Union-Feld dimension. Dimensionen eines der folgenden Typen sind 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

Typ eines Produktangebots.

ProductBiddingCategory

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

Felder
level

ListingGroupFilterBiddingCategoryLevel

Gibt die Ebene der Kategorie in der Taxonomie an.

id

int64

Die ID der Gebotskategorie für ein Produkt.

Diese ID entspricht der ID „google_product_category“ aus diesem Artikel: https://support.google.com/merchants/answer/6324436

ProductBrand

Marke des Produkts.

Felder
value

string

Stringwert der Produktmarke.

ProductChannel

Ort eines Produktangebots

Felder
channel

ListingGroupFilterProductChannel

Wert des Orts.

ProductCondition

Zustand eines Produktangebots

Felder
condition

ListingGroupFilterProductCondition

Wert der Bedingung.

ProductCustomAttribute

Benutzerdefiniertes Attribut eines Produktangebots.

Felder
index

ListingGroupFilterCustomAttributeIndex

Gibt den Index des benutzerdefinierten Attributs an.

value

string

Stringwert des benutzerdefinierten Attributs des Produkts.

ProductItemId

Artikel-ID eines Produktangebots

Felder
value

string

Wert der ID.

ProductType

Typ eines Produktangebots.

Felder
level

ListingGroupFilterProductTypeLevel

Ebene des Typs.

value

string

Wert des Typs.

ListingGroupFilterDimensionPath

Der Pfad, mit dem Dimensionen definiert werden, mit denen ein Eintragsgruppenfilter definiert wird.

Felder
dimensions[]

ListingGroupFilterDimension

Der vollständige Pfad der Dimensionen über die Hierarchie der Eintragsgruppen (ohne Stammknoten) zu diesem Eintragsgruppenfilter.

LocationView

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

Felder
resource_name

string

Der Ressourcenname der Standortansicht. Ressourcennamen der Standortansicht haben das folgende Format:

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

ProductBiddingCategoryConstant

Eine produktbezogene Gebotskategorie.

Felder
resource_name

string

Der Ressourcenname der Produktkategorie. Ressourcennamen von Kategorien für Produktgebote haben das folgende Format:

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

level

ProductBiddingCategoryLevel

Ebene der Produktkategorie.

status

ProductBiddingCategoryStatus

Status der Gebotskategorie für ein Produkt.

id

int64

Die ID der Gebotskategorie für ein Produkt.

Diese ID entspricht der ID „google_product_category“ aus diesem Artikel: https://support.google.com/merchants/answer/6324436.

country_code

string

Zweistelliger Ländercode in Großbuchstaben der Gebotskategorie für ein Produkt.

product_bidding_category_constant_parent

string

Ressourcenname der übergeordneten Gebotskategorie für Produkte.

language_code

string

Sprachcode der Gebotskategorie für Produkte.

localized_name

string

Zeigt den Wert der Produktkategorie für das Produkt in der entsprechenden Sprache gemäß dem Sprachcode an.

ProductGroupView

Eine Produktgruppenansicht

Felder
resource_name

string

Der Ressourcenname der Produktgruppenansicht. Ressourcennamen für die Produktgruppenansicht haben das folgende Format:

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

SearchAds360Field

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

Felder
resource_name

string

Der Ressourcenname des Artefakts. Namen von Artefaktressourcen haben das folgende Format:

SearchAds360Fields/{name}

category

SearchAds360FieldCategory

Die Kategorie des Artefakts.

selectable_with[]

string

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

attribute_resources[]

string

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

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

metrics[]

string

In diesem Feld werden die Namen aller Messwerte aufgelistet, die mit dem beschriebenen Artefakt auswählbar sind, wenn es in der FROM-Klausel verwendet wird. Er wird nur für Artefakte der Kategorie RESOURCE festgelegt.

segments[]

string

In diesem Feld werden die Namen aller Artefakte aufgeführt, unabhängig davon, ob es sich um ein Segment oder eine andere Ressource handelt, die Segmentmesswerte, wenn sie in Suchanfragen enthalten sind, und wann das beschriebene Artefakt in der FROM-Klausel verwendet wird. Er wird nur für Artefakte der Kategorie RESOURCE festgelegt.

enum_values[]

string

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

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

data_type

SearchAds360FieldDataType

In diesem Feld werden die Operatoren bestimmt, 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 einer ORDER BY-Klausel in Suchanfragen verwendet werden kann.

type_url

string

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

is_repeated

bool

Gibt an, ob das Feldartefakt wiederholt wird.

ShoppingPerformanceView

Shopping-Leistungsansicht. Enthält Statistiken zu Shopping-Kampagnen, die auf mehreren Produktdimensionsebenen zusammengefasst sind. Werte von Produktdimensionen aus dem Merchant Center (z. B. Marke, Kategorie, benutzerdefinierte Attribute, Produktzustand und Produkttyp) spiegeln den Status jeder Dimension zum Zeitpunkt der Erfassung des entsprechenden Ereignisses an dem entsprechenden Datum wider.

Felder
resource_name

string

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

UserList

Eine Nutzerliste. Dies ist eine Liste von Nutzern, auf die ein Kunde ein Targeting vornehmen kann.

Felder
resource_name

string

Der Ressourcenname der Nutzerliste. Ressourcennamen von Nutzerlisten haben das folgende Format:

customers/{customer_id}/userLists/{user_list_id}

type

UserListType

Der 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. „access_reason=SHARED“).

Aufrufen

Ein Besuch.

Felder
resource_name

string

Der Ressourcenname des Besuchs. Namen von Besuchsressourcen haben das folgende 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 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 für Webseitenaufrufe haben das folgende Format:

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