Package google.ads.searchads360.v0.resources

Index

AccessibleBiddingStrategy

Stellt eine Ansicht von BiddingStrategies dar, die dem Kunden gehören und für ihn freigegeben sind.

Im Gegensatz zu „BiddingStrategy“ enthält diese Ressource neben Strategien, die diesem Kunden gehören, auch Strategien, die den Administratoren des Kunden gehören und mit diesem Kunden geteilt werden. Diese Ressource enthält keine Messwerte und nur eine begrenzte Teilmenge der BiddingStrategy-Attribute.

Felder
resource_name

string

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

Der descriptive_name des Kunden, dem die Gebotsstrategie gehört.

Union-Feld scheme. Das Gebotsschema.

Es kann nur einer 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 in Ihren 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, bei der Gebote automatisch für einen ausgewählten Prozentsatz von Impressionen optimiert werden.

target_roas

TargetRoas

Eine Gebotsstrategie, mit der Sie den Umsatz maximieren und gleichzeitig einen bestimmten Ziel-ROAS (Return on Advertising Spend) erzielen 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 in Ihren 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 mit Ihrem Budget möglichst viele Conversions für Ihre Kampagnen erzielen.

Felder
target_cpa

int64

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

target_cpa_micros

int64

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

TargetCpa

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

Felder
target_cpa_micros

int64

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

TargetImpressionShare

Eine automatische Gebotsstrategie, bei der Gebote so festgelegt werden, dass ein bestimmter Prozentsatz von Suchanzeigen oben auf der ersten Seite (oder an einem anderen Zielort) ausgeliefert wird.

Felder
location

TargetImpressionShareLocation

Die Zielposition auf der Suchergebnisseite.

location_fraction_micros

int64

Der ausgewählte Anteil der Anzeigen, die am Zielstandort ausgeliefert werden sollen, in Mikros. Beispiel: 1% entspricht 10.000.

cpc_bid_ceiling_micros

int64

Das höchste CPC-Gebot, das vom System für die automatische Gebotseinstellung angegeben 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 den Umsatz maximieren und gleichzeitig einen bestimmten Ziel-ROAS (Return on Advertising Spend) erzielen können.

Felder
target_roas

double

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

TargetSpend

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

Felder
target_spend_micros
(deprecated)

int64

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

cpc_bid_ceiling_micros

int64

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

Eine Anzeige.

Felder
resource_name

string

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

final_app_urls[]

FinalAppUrl

Eine Liste der endgültigen App-URLs, die auf Mobilgeräten verwendet werden, wenn der Nutzer die jeweilige App installiert hat.

final_mobile_urls[]

string

Die Liste der möglichen endgültigen mobilen URLs nach allen domainübergreifenden Weiterleitungen für die Anzeige.

type

AdType

Der Typ der Anzeige.

synthetic_content_info

SyntheticContentInfo

Informationen zu synthetischen Inhalten für die Anzeige. Nur Anzeigen mit bestimmten Anzeigentypen können über das Feld synthetic_content_info aktualisiert werden.

Zulässige AdType-Werte: * HTML5_UPLOAD_AD * DYNAMIC_HTML5_AD * IMAGE_AD

id

int64

Die ID der Anzeige.

tracking_url_template

string

Die URL-Vorlage zum Erstellen einer Tracking-URL.

final_url_suffix

string

Das Suffix, das beim Erstellen einer finalen URL verwendet werden soll.

display_url

string

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

name

string

Der Name der Anzeige. Sie wird nur verwendet, um die Anzeige identifizieren zu können. Er muss nicht eindeutig sein und hat keinen Einfluss auf die bereitgestellte Anzeige.

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. Erweiterte Textanzeigen werden eingestellt. Verwenden Sie stattdessen SearchAds360ResponsiveSearchAd.

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

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 von dieser Anzeigengruppe übernommen oder ihr direkt zugewiesen wurde.

engine_id

string

Die ID der Anzeigengruppe im externen Suchmaschinenkonto. Dieses Feld gilt nur für ein Konto, das nicht zu Google Ads gehört, z. B. Yahoo! Japan, Microsoft oder Baidu. Verwenden Sie für eine Google Ads-Entität stattdessen „ad_group.id“.

start_date

string

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

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

end_date

string

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

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

language_code

string

Die Sprache der Anzeigen und Keywords in einer Anzeigengruppe. Dieses Feld ist nur für Microsoft Advertising-Konten verfügbar. Weitere Informationen: 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.

tracking_url_template

string

Die URL-Vorlage zum Erstellen einer Tracking-URL.

cpc_bid_micros

int64

Das maximale CPC-Gebot (Cost-per-Click). Dieses Feld wird verwendet, wenn die effektive Gebotsstrategie der Anzeigengruppe „Manueller CPC“ ist. Dieses Feld ist nicht anwendbar und wird ignoriert, wenn für die Kampagne der Anzeigengruppe eine Portfolio-Gebotsstrategie verwendet wird.

engine_status

AdGroupEngineStatus

Der Engine-Status für die Anzeigengruppe.

final_url_suffix

string

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

AdGroupAd

Eine Anzeige in einer Anzeigengruppe.

Felder
resource_name

string

Der Ressourcenname der Anzeige. Ressourcennamen von Anzeigengruppenanzeigen haben das folgende 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 ad_group_ad erstellt wurde. Das Datum und die Uhrzeit hat die Zeitzone des Kunden und ist im Format "JJJJ-MM-TT HH:mm:ss.ssssss".

labels[]

string

Die Ressourcennamen der Labels, die dieser Anzeigengruppenanzeige zugeordnet sind.

effective_labels[]

string

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

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 Suchmaschinenkonto. Mögliche Status (je nach Art des externen Kontos) sind "Aktiv", "berechtigt", "Überprüfung steht aus" usw.

last_modified_time

string

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

AdGroupAdEffectiveLabel

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

Felder
resource_name

string

Der Ressourcenname des effektiven Labels der Anzeigengruppenanzeige. Ressourcennamen für effektive Labels von Anzeigengruppenanzeigen haben das Format: customers/{owner_customer_id}/adGroupAdEffectiveLabels/{ad_group_id}~{ad_id}~{label_id}

ad_group_ad

string

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

label

string

Das effektive Label, das der Anzeigengruppenanzeige zugewiesen ist.

owner_customer_id

int64

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

AdGroupAdLabel

Eine Beziehung zwischen einer Anzeige in einer Anzeigengruppe und einem Label.

Felder
resource_name

string

Der Ressourcenname des Anzeigenlabels der Gruppe. Ressourcennamen von Anzeigenlabels der Anzeigengruppe haben das Format customers/{owner_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 AdGroupAsset 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-Sammlung. Wenn Sie ein AdGroupAssetSet erstellen, wird eine Asset-Sammlung mit einer Anzeigengruppe verknüpft.

Felder
resource_name

string

Der Ressourcenname der Asset-Sammlung der Anzeigengruppe. Ressourcennamen von Asset-Sammlungen für Anzeigengruppen haben das folgende Format:

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

ad_group

string

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

asset_set

string

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

status

AssetSetLinkStatus

Der Status der Anzeigengruppen-Asset-Sammlung. Schreibgeschützt.

AdGroupAudienceView

Eine Ansicht der Zielgruppen der Anzeigengruppe. Enthält Leistungsdaten aus Interessen- und Remarketing-Listen für Anzeigen im Displaynetzwerk und YouTube-Netzwerk sowie Remarketing-Listen für Suchanzeigen (RLSA), die auf Zielgruppenebene zusammengefasst werden.

Felder
resource_name

string

Der Ressourcenname der Ansicht „Anzeigengruppenzielgruppe“. Ressourcennamen von Zielgruppenansichten für Anzeigengruppen haben das Format:

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

AdGroupBidModifier

Stellt eine Gebotsanpassung für die Anzeigengruppe 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. Verwenden Sie 0, um einen Gerätetyp zu deaktivieren.

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

Ab V5 bei Erstellungsvorgängen erforderlich. Für criterion ist nur einer der folgenden Werte zulässig:

device

DeviceInfo

Ein Gerätekriterium.

AdGroupCriterion

Ein Kriterium für Anzeigengruppen. Im Bericht „Anzeigengruppenkriterien“ werden nur Kriterien zurückgegeben, die der Anzeigengruppe explizit hinzugefügt wurden.

Felder
resource_name

string

Der Ressourcenname des Anzeigengruppenkriteriums. Ressourcennamen von 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. 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. In der Benutzeroberfläche wird jede Altersgruppe als „Aktiviert“ angezeigt, da Nutzer in diesen Altersgruppen die Anzeigen sehen können. Bei AdGroupCriterion.status wird jedoch „Entfernt“ angezeigt, da kein einzuschließendes Kriterium hinzugefügt wurde.

quality_info

QualityInfo

Informationen zur Qualität des Kriteriums.

type

CriterionType

Der Typ des Kriteriums.

labels[]

string

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

effective_labels[]

string

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

position_estimates

PositionEstimates

Schätzungen für Gebote für Kriterien an verschiedenen Positionen.

final_urls[]

string

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

final_mobile_urls[]

string

Die Liste der möglichen endgültigen mobilen URLs nach allen domainübergreifenden Weiterleitungen.

url_custom_parameters[]

CustomParameter

Die Liste der Zuordnungen, die zum Ersetzen von benutzerdefinierten Parameter-Tags in einem tracking_url_template, final_urls oder mobile_final_urls verwendet werden.

engine_id

string

ID des Anzeigengruppenkriteriums im externen Suchmaschinenkonto. Dieses Feld gilt nur für ein Konto, das nicht von Google Ads stammt, 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 die Anzeigengruppe.

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.

Genau eines muss 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 für 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 Qualitätsinformationen zu Anzeigengruppenkriterien.

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 effektiven Label. Ein effektives Label ist ein Label, das von diesem Anzeigengruppenkriterium übernommen oder ihm direkt zugewiesen wurde.

Felder
resource_name

string

Der Ressourcenname des effektiven Labels des Anzeigengruppenkriteriums. Ressourcennamen von effektiven Labels für Anzeigengruppenkriterien haben das Format: customers/{owner_customer_id}/adGroupCriterionEffectiveLabels/{ad_group_id}~{criterion_id}~{label_id}

ad_group_criterion

string

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

label

string

Das effektive Label, das dem Kriterium der Anzeigengruppe zugewiesen ist.

owner_customer_id

int64

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

AdGroupCriterionLabel

Eine Beziehung zwischen einem Kriterium der Anzeigengruppe 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/{owner_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 effektiven Label. Ein effektives Label ist ein Label, das von dieser Anzeigengruppe übernommen oder ihr direkt zugewiesen wurde.

Felder
resource_name

string

Der Ressourcenname des effektiven Labels der Anzeigengruppe. Ressourcennamen für effektive Labels von Anzeigengruppen haben das Format customers/{owner_customer_id}/adGroupEffectiveLabels/{ad_group_id}~{label_id}.

ad_group

string

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

label

string

Das effektive Label, das der Anzeigengruppe zugewiesen ist.

owner_customer_id

int64

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

AdGroupLabel

Eine Beziehung zwischen einer Anzeigengruppe und einem Label.

Felder
resource_name

string

Der Ressourcenname des Labels der Anzeigengruppe. Ressourcennamen von Anzeigengruppenlabels haben das Format customers/{owner_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 mit Altersgruppen.

Stellt die Ansicht der Leistungsmesswerte eines Kunden (z. B. Impressionen und Klicks) dar, die nach Altersgruppe zusammengefasst werden. Alle Statistiken werden auf Anzeigengruppenebene zusammengefasst.

Hinweis: Sie können Messwerte zwar mit age_range_view nach Altersgruppe und mit gender_view nach Geschlecht segmentieren, die Search Ads 360 API unterstützt jedoch nicht die gleichzeitige Segmentierung von Messwerten nach Altersgruppe und Geschlecht in einer einzelnen Abfrage. Die Analyse der Leistung für beide Dimensionen zusammen wird in der Search Ads 360 API nicht unterstützt.

Felder
resource_name

string

Der Ressourcenname der Ansicht für Altersgruppen. Ressourcennamen für Ansichten für Altersgruppen haben das folgende Format:

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

Asset

Ein Asset ist Teil einer Anzeige, das für mehrere Anzeigen verwendet werden kann. Das kann ein Bild (ImageAsset) oder ein Video (YoutubeVideoAsset) sein. Assets sind unveränderlich und können nicht entfernt werden. Wenn Sie verhindern möchten, dass ein Asset ausgeliefert wird, entfernen Sie es aus der Entität, in der es verwendet wird.

Felder
resource_name

string

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

final_mobile_urls[]

string

Eine Liste der möglichen endgültigen mobilen URLs nach allen domainübergreifenden Weiterleitungen.

url_custom_parameters[]

CustomParameter

Eine Liste der Zuordnungen, die zum Ersetzen von benutzerdefinierten Parameter-Tags für URLs in „tracking_url_template“, „final_urls“ und/oder „final_mobile_urls“ verwendet werden.

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

synthetic_content_info

SyntheticContentInfo

Informationen zu synthetischen Inhalten für das Asset. Nur Assets mit bestimmten Asset-Typen können über das Feld synthetic_content_info aktualisiert werden.

Zulässige AssetType-Werte: * IMAGE * MEDIA_BUNDLE * YOUTUBE_VIDEO

id

int64

Die ID des Inhalts.

name

string

Optionaler Name des Assets.

tracking_url_template

string

Die URL-Vorlage zum Erstellen einer Tracking-URL.

final_url_suffix

string

URL-Vorlage zum Anhängen von Parametern an Landingpage-URLs, die mit parallelem Tracking ausgeliefert werden.

engine_status

AssetEngineStatus

Der Engine-Status 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 vereinheitlichtes Asset mit Zusatzinformationen.

page_feed_asset

UnifiedPageFeedAsset

Ein vereinheitlichtes Seitenfeed-Asset.

mobile_app_asset

MobileAppAsset

Ein App-Asset.

call_asset

UnifiedCallAsset

Einheitliches Anruf-Asset

call_to_action_asset

CallToActionAsset

Ein Call-to-Action-Asset.

location_asset

UnifiedLocationAsset

Ein vereinheitlichtes Standort-Asset.

AssetGroup

Eine Asset-Gruppe. Mit „AssetGroupAsset“ wird ein Asset mit der Asset-Gruppe verknüpft. Mit AssetGroupSignal wird ein Signal einer Asset-Gruppe zugeordnet.

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. Sie muss mindestens 1 und darf maximal 128 Zeichen lang sein. Sie muss innerhalb einer Kampagne eindeutig sein.

final_urls[]

string

Eine Liste der endgültigen URLs nach allen domainübergreifenden Weiterleitungen. Bei Performance Max-Kampagnen sind die URLs standardmäßig für die Erweiterung vorgesehen, sofern die Funktion nicht deaktiviert wird.

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 Erweiterung vorgesehen, sofern die Funktion nicht deaktiviert wird.

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

Gesamte Anzeigeneffektivität dieser Asset-Gruppe.

AssetGroupAsset

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

Felder
resource_name

string

Der Ressourcenname des Asset-Gruppen-Assets. Der Ressourcenname eines Assets in einer Asset-Gruppe hat das folgende Format:

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

asset_group

string

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

asset

string

Das Asset, mit dem dieses Asset in der Asset-Gruppe verknüpft ist.

field_type

AssetFieldType

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

status

AssetLinkStatus

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

AssetGroupAssetCombinationData

Daten zu Asset-Kombinationen für Asset-Gruppen

Felder
asset_combination_served_assets[]

AssetUsage

Bereitgestellte Assets.

AssetGroupListingGroupFilter

AssetGroupListingGroupFilter stellt einen Knoten im Filterbaum für Eintragsgruppen in einer Asset-Gruppe dar.

Felder
resource_name

string

Der Ressourcenname des Filters für Asset-Gruppen-Eintragsgruppen. Der Ressourcenname für Filter für Asset-Eintragsgruppen hat das folgende 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 ListingGroupFilter.

type

ListingGroupFilterType

Typ eines Filterknotens für eine Eintragsgruppe.

vertical

ListingGroupFilterVertical

Die vertikale Achse, die der aktuelle Knotenbaum darstellt. Alle Knoten im selben Baum müssen zur selben Branche gehören.

case_value

ListingGroupFilterDimension

Dimensionswert, mit dem diese Eintragsgruppe ihre übergeordnete Gruppe verfeinert. Für die Stammgruppe nicht definiert.

parent_listing_group_filter

string

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

path

ListingGroupFilterDimensionPath

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

AssetGroupSignal

AssetGroupSignal stellt ein Signal in einer Asset-Gruppe dar. Mithilfe eines Signals geben Sie in Performance Max-Kampagnen an, 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 Signals der Asset-Gruppe. Der Ressourcenname für das Asset-Gruppensignal hat das folgende Format:

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

asset_group

string

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

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

AudienceInfo

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

AssetGroupTopCombinationView

Hier sehen Sie die am häufigsten verwendeten Kombinationen von Assets in Asset-Gruppen.

Felder
resource_name

string

Der Ressourcenname der Ansicht mit den Top-Kombinationen der Asset-Gruppe. Ressourcennamen von AssetGroup Top Combination-Ansichten 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 zusammen ausgeliefert wurden.

AssetSet

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

Felder
id

int64

Die ID der Asset-Sammlung.

resource_name

string

Der Ressourcenname der Asset-Sammlung. Ressourcennamen von Asset-Sammlungen haben das folgende Format:

customers/{customer_id}/assetSets/{asset_set_id}

AssetSetAsset

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

Felder
resource_name

string

Der Ressourcenname des Asset-Sammlung-Assets. Ressourcennamen für Assets in Asset-Sammlungen haben das folgende Format:

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

asset_set

string

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

asset

string

Das Asset, mit dem dieses Asset in der Asset-Sammlung verknüpft ist.

status

AssetSetAssetStatus

Der Status des Assets in der Asset-Sammlung. Schreibgeschützt.

Zielgruppe

Zielgruppen sind eine effektive Ausrichtungsoption. Dabei erstellen Sie anhand mehrerer Segmentattribute wie detaillierten demografischen Merkmalen und gemeinsamen Interessen sogenannte „Identitäten“, die Teilen Ihrer Zielgruppensegmente entsprechen.

Felder
resource_name

string

Der Ressourcenname der Zielgruppe. Zielgruppen haben das folgende 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. Sie muss mindestens 1 und darf höchstens 255 Zeichen lang sein.

description

string

Beschreibung dieser Zielgruppe.

BiddingStrategy

Eine Gebotsstrategie.

Felder
resource_name

string

Der Ressourcenname der Gebotsstrategie. Ressourcennamen für Gebotsstrategien 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 Währung, die von der Gebotsstrategie verwendet wird (dreistelliger ISO 4217-Code).

Bei Gebotsstrategien in Verwaltungskonten kann diese Währung bei der Erstellung festgelegt werden. Standardmäßig wird die Währung des Verwaltungskontos verwendet. Für ausliefernde Kunden kann dieses Feld nicht festgelegt werden. Bei allen Strategien eines ausliefernden Kunden wird implizit die Währung des ausliefernden Kunden verwendet. In allen Fällen wird im Feld „effective_currency_code“ die Währung zurückgegeben, 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 Währung, die von der Gebotsstrategie verwendet wird (dreistelliger ISO 4217-Code).

Bei Gebotsstrategien in Verwaltungskonten ist dies die Währung, die vom Werbetreibenden beim Erstellen der Strategie festgelegt wurde. Für die Bereitstellung für Kunden ist dies der currency_code des Kunden.

Messwerte zur Gebotsstrategie werden in dieser Währung angegeben.

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

enhanced_cpc

EnhancedCpc

Bei dieser Gebotsstrategie werden Gebote für Klicks erhöht, die mit höherer Wahrscheinlichkeit zu einer Conversion führen, und für Klicks gesenkt, 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 in Ihren 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, bei der Gebote automatisch für einen ausgewählten Prozentsatz von Impressionen optimiert werden.

target_outrank_share

TargetOutrankShare

Eine Gebotsstrategie, bei der Gebote basierend auf dem Zielanteil von Auktionen festgelegt werden, in denen der Werbetreibende einen bestimmten Mitbewerber übertreffen sollte. Die Verwendung dieses Feldes wurde eingestellt. Das Erstellen einer neuen Gebotsstrategie mit diesem Feld oder das Zuordnen von Gebotsstrategien mit diesem Feld zu einer Kampagne schlägt fehl. Änderungen an Strategien, in denen dieses Schema bereits vorhanden ist, sind zulässig.

target_roas

TargetRoas

Eine Gebotsstrategie, mit der Sie den Umsatz maximieren und gleichzeitig einen bestimmten Ziel-ROAS (Return on Advertising Spend) erzielen 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 Format:

customers/{customer_id}/campaigns/{campaign_id}

status

CampaignStatus

Der Status der Kampagne.

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

serving_status

CampaignServingStatus

Der Status der Anzeigenbereitstellung der Kampagne.

bidding_strategy_system_status

BiddingStrategySystemStatus

Der Systemstatus der Gebotsstrategie der Kampagne.

ad_serving_optimization_status

AdServingOptimizationStatus

Der Status der Optimierung der Anzeigenbereitstellung der Kampagne.

advertising_channel_type

AdvertisingChannelType

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

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

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

advertising_channel_sub_type

AdvertisingChannelSubType

Optionale Verfeinerung für advertising_channel_type: Muss ein gültiger Untertyp des übergeordneten Kanal-Typs sein.

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

url_custom_parameters[]

CustomParameter

Die Liste der Zuordnungen, die zum Ersetzen von benutzerdefinierten Parameter-Tags in einem tracking_url_template, final_urls oder mobile_final_urls verwendet werden.

real_time_bidding_setting

RealTimeBiddingSetting

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

network_settings

NetworkSettings

Die Netzwerkeinstellungen für die Kampagne.

dynamic_search_ads_setting

DynamicSearchAdsSetting

Die Einstellung zum Steuern dynamischer 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 von dieser Kampagne übernommen oder ihr 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

Der Ressourcenname von AccessibleBiddingStrategy, einer schreibgeschützten Ansicht der uneingeschränkten Attribute der angehängten Portfolio-Gebotsstrategie, die durch „bidding_strategy“ identifiziert wird. Leer, wenn für die Kampagne keine Portfoliostrategie verwendet wird. Attribute für uneingeschränkte Strategien sind für alle Kunden verfügbar, 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 Kunden verfügbar, dem die Strategie gehört, und für seine Administratoren. Eingeschränkte Attribute können nur aus der BiddingStrategy-Ressource gelesen werden.

frequency_caps[]

FrequencyCapEntry

Eine Liste, mit der begrenzt wird, wie oft jeder Nutzer die Anzeigen dieser Kampagne sieht.

selective_optimization

SelectiveOptimization

Einstellung für die selektive Optimierung für diese Kampagne, die eine Reihe von Conversion-Aktionen enthält, für 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 des Optimierungszielvorhabens für diese Kampagne, einschließlich einer Reihe von Optimierungszielvorhabentypen.

tracking_setting

TrackingSetting

Einstellungen auf Kampagnenebene für Tracking-Informationen

engine_id

string

ID der Kampagne im externen Suchmaschinenkonto. Dieses Feld gilt nur für Konten, die nicht Google Ads-Konten sind, 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 nicht von der oberen Ebene an diese Kampagne weitergegeben.

create_time

string

Der Zeitstempel für den Zeitpunkt, zu dem dieser Kampagne erstellt wurde. Der Zeitstempel hat die Zeitzone des Kunden und ist im Format „JJJJ-MM-TT HH:mm:ss“. „create_time“ wird in Version 1 eingestellt. Verwenden Sie stattdessen „creation_time“.

creation_time

string

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

last_modified_time

string

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

feed_types[]

AssetSetType

Die Arten von Feeds, die dieser Kampagne direkt zugeordnet sind.

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. Beim Erstellen wird standardmäßig 2037-12-30 festgelegt. Das bedeutet, dass die Kampagne unbegrenzt läuft. 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 Abfrageparametern 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 sie deaktiviert ist („true“), werden nur die finalen URLs in der Asset-Gruppe oder die URLs, die in den Google Merchant Center- oder Geschäftsdaten-Feeds des Werbetreibenden angegeben sind, als Zielvorhaben verwendet. Wenn die Option aktiviert ist („false“), wird die gesamte Domain als Ziel verwendet. Dieses Feld kann nur für Performance Max-Kampagnen festgelegt werden. Der Standardwert ist „false“.

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

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

bidding_strategy

string

Der Ressourcenname der von der Kampagne verwendeten Portfolio-Gebotsstrategie.

manual_cpa

ManualCpa

Standardmäßige manuelle Gebotsstrategie „CPA“. Manuelle Gebotseinstellung, mit der Werbetreibende das Gebot pro vom Werbetreibenden angegebener Aktion festlegen können. Wird nur für Google Lokale Dienstleistungen-Kampagnen unterstützt.

manual_cpc

ManualCpc

Standardmäßige Gebotsstrategie „Manuelle CPC-Gebote“ Manuelle klickbasierte Gebote, bei denen der Nutzer pro Klick bezahlt.

manual_cpm

ManualCpm

Standardmäßige manuelle CPM-Gebotsstrategie. Manuelle gebotsbasierte Gebote, bei denen der Nutzer pro 1.000 Impressionen bezahlt.

maximize_conversions

MaximizeConversions

Standard-Gebotsstrategie „Conversions maximieren“, mit der die Anzahl der Conversions automatisch maximiert wird, ohne dass Ihr Budget überschritten wird.

maximize_conversion_value

MaximizeConversionValue

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

Standard-Gebotsstrategie „Ziel-CPA“, bei der die 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

Standard-Gebotsstrategie „Ziel-ROAS“, mit der der Umsatz automatisch maximiert wird, während gleichzeitig ein bestimmter Ziel-ROAS (Return on Advertising Spend) erzielt wird.

target_spend

TargetSpend

Standard-Gebotsstrategie „Ausgabenziel“, bei der Ihre Gebote automatisch so festgelegt werden, dass Sie mit Ihrem Budget möglichst viele Klicks erzielen.

percent_cpc

PercentCpc

Standard-Gebotsstrategie „Prozentualer CPC“, bei der Gebote ein Bruchteil des beworbenen Preises für ein bestimmtes Produkt oder eine bestimmte Dienstleistung sind.

target_cpm

TargetCpm

Eine Gebotsstrategie, mit der die Kosten pro tausend Impressionen automatisch optimiert werden.

DynamicSearchAdsSetting

Die Einstellung zum Steuern dynamischer Suchanzeigen.

Felder
domain_name

string

Erforderlich. Der Internetdomainname, den diese Einstellung repräsentiert, 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 in der Kampagne ausschließlich vom Werbetreibenden bereitgestellte URLs verwendet werden.

GeoTargetTypeSetting

Stellt eine Sammlung 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 geografische Targeting mit Ausschluss in dieser Kampagne verwendet wird.

NetworkSettings

Die Netzwerkeinstellungen für die Kampagne.

Felder
target_search_network

bool

Gibt an, ob Anzeigen auf Websites im Google Suchnetzwerk-Partnernetzwerk 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 mit dem Placement-Kriterium angegeben.

target_partner_search_network

bool

Gibt an, ob Anzeigen im Partnernetzwerk ausgeliefert werden. Diese Funktion ist nur für ausgewählte Partnerkonten verfügbar. Sofern Sie nicht dazu aufgefordert wurden, dieses Feld zu verwenden, trifft es wahrscheinlich nicht auf Ihr Konto zu. Damit wird nicht gesteuert, ob Anzeigen im Google-Suchnetzwerk ausgeliefert werden. Verwenden Sie stattdessen target_search_network.

OptimizationGoalSetting

Einstellung des Optimierungszielvorhabens für diese Kampagne, einschließlich einer Reihe von Optimierungszielvorhabentypen.

Felder
optimization_goal_types[]

OptimizationGoalType

Die Liste der Optimierungszieltypen.

SelectiveOptimization

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

Felder
conversion_actions[]

string

Die ausgewählte Gruppe von Ressourcennamen für Conversion-Aktionen zur Optimierung dieser Kampagne.

ShoppingSetting

Die Einstellung für Shopping-Kampagnen. Definiert die Menge der Produkte, für die 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. Gültige Feedlabels dürfen maximal 20 Zeichen lang sein und Großbuchstaben, Zahlen, Bindestriche und Unterstriche enthalten. Wenn Sie zuvor das eingestellte sales_country im Format des zweistelligen Ländercodes (XX) verwendet haben, sollte stattdessen das Feld feed_label verwendet werden. Weitere Informationen finden Sie im Hilfeartikel Feed-Label.

use_vehicle_inventory

bool

Gibt an, ob das Targeting auf Inventar für Fahrzeugangebote 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 niedrigeren Prioritäten. Dieses Feld ist für Shopping-Kampagnen erforderlich. Die Werte müssen zwischen 0 und 2 liegen (jeweils einschließlich). Dieses Feld ist für smarte Shopping-Kampagnen optional, muss aber bei Festlegung gleich 3 sein.

enable_local

bool

Gibt an, ob lokal erhältliche Produkte einbezogen werden sollen.

TrackingSetting

Einstellungen auf Kampagnenebene für Tracking-Informationen

Felder
tracking_url

string

Die URL, die für das dynamische 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 folgende Format:

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

status

AssetLinkStatus

Status des Kampagnen-Assets.

campaign

string

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

asset

string

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

CampaignAssetSet

CampaignAssetSet ist die Verknüpfung zwischen einer Kampagne und einer Asset-Sammlung. Wenn Sie eine CampaignAssetSet hinzufügen, wird eine Asset-Sammlung mit einer Kampagne verknüpft.

Felder
resource_name

string

Der Ressourcenname der Asset-Sammlung der Kampagne. Ressourcennamen für Assets in Asset-Sammlungen haben das folgende Format:

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

campaign

string

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

asset_set

string

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

status

AssetSetLinkStatus

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

CampaignAudienceView

Eine Kampagnenzielgruppenansicht. Enthält Leistungsdaten aus Interessen- und Remarketing-Listen für Anzeigen im Displaynetzwerk und im YouTube-Netzwerk sowie Remarketing-Listen für Suchanzeigen, die nach Kampagne und Zielgruppenkriterium zusammengefasst sind. Diese Ansicht enthält nur Zielgruppen, die auf Kampagnenebene verknüpft sind.

Felder
resource_name

string

Der Ressourcenname der Zielgruppenansicht der Kampagne. Ressourcennamen von Kampagnenzielgruppen-Ansichten haben das Format:

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

CampaignBudget

Ein Kampagnenbudget.

Felder
resource_name

string

Der Ressourcenname des Kampagnenbudgets. Ressourcennamen von Kampagnenbudgets 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 durchschnittliche Tagesbetrag, der für die Kampagne ausgegeben werden soll. Dieses Feld wird verwendet, wenn das CampaignBudget period auf DAILY festgelegt ist. Das ist der Standardwert.

Der Betrag wird in Mikros in der Landeswährung des Kontos angegeben. Eine Million Mikros entspricht einer Währungseinheit. Die tatsächlichen monatlichen Ausgaben sind auf das 30,4-Fache dieses Tagesbetrags begrenzt.

Dieses Feld schließt sich gegenseitig mit „total_amount_micros“ aus. Es sollte nur „amount_micros“ oder „total_amount_micros“ festgelegt werden.

CampaignCriterion

Ein Kampagnenkriterium.

Felder
resource_name

string

Der Ressourcenname des Kampagnenkriteriums. Ressourcennamen von 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 ausgerichtet (false) oder ausgeschlossen (true) werden soll.

Union-Feld criterion. Das Kampagnenkriterium.

Genau eines muss 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 von dieser Kampagne übernommen oder ihr direkt zugewiesen wurde.

Felder
resource_name

string

Der Name der Ressource. Ressourcennamen von CampaignEffectivelabel haben das Format: customers/{owner_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/{owner_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

Umsatzansicht für Warenkorbdaten

Enthält Informationen zu den gekauften Produkten, wenn Conversions mit Warenkorbdaten implementiert sind. Leistungsmesswerte wie Umsatz, Bruttogewinn, Lead- und Cross-Selling-Messwerte usw. sowie Merchant Center-Attribute wie Marke und Kategorie sind für Produkte verfügbar, die in einem Inventarfeed definiert und infolge von Google-Anzeigen verkauft werden. Bei Käufen, die Klicks auf Shopping-Anzeigen zugeordnet werden, können Dimensionen der angeklickten und der verkauften Produkte zusammen angezeigt werden.

Felder
resource_name

string

Der Ressourcenname der Ansicht „Umsatz mit Warenkorbdaten“. Ressourcennamen von Ansichten für Warenkorbdaten haben das 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 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 REMOVED.

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 von 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 Conversions, die für diese Conversion-Aktion erfasst werden.

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 „false“ ist, ist die Conversion-Aktion für alle Kampagnen nicht gebotsfähig, unabhängig vom Conversion-Zielvorhaben des Kunden oder der Kampagne. Bei benutzerdefinierten Conversion-Zielvorhaben wird „primary_for_goal“ jedoch nicht berücksichtigt. Wenn für eine Kampagne also ein benutzerdefiniertes Conversion-Zielvorhaben mit einer Conversion-Aktion konfiguriert ist, für die „primary_for_goal“ = „false“ gilt, ist diese Conversion-Aktion trotzdem gebotsfähig. Wenn nicht festgelegt, ist „primary_for_goal“ standardmäßig „true“. In V9 kann „primary_for_goal“ nach der Erstellung nur über 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 liegen dürfen.

app_id

string

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

AttributionModelSettings

Einstellungen für das Attributionsmodell dieser Conversion-Aktion.

Felder
attribution_model

AttributionModel

Der Attributionsmodelltyp dieser Conversion-Aktion.

data_driven_model_status

DataDrivenModelStatus

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

FloodlightSettings

Einstellungen für eine Floodlight-Conversion-Aktion.

Felder
activity_group_tag

string

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

activity_tag

string

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

activity_id

int64

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

ValueSettings

Einstellungen für den Wert von Conversion-Ereignissen, die mit dieser Conversion-Aktion verknüpft sind.

Felder
default_value

double

Der Wert, der verwendet werden soll, 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 immer der Standardwert verwendet werden soll.

default_currency_code

string

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

always_use_default_value

bool

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

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-Variablen. Ressourcennamen für benutzerdefinierte Conversion-Variablen haben das folgende 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-Variable. Der Name muss eindeutig sein. Der Name darf maximal 100 Zeichen lang sein. Vor und nach dem Text dürfen keine zusätzlichen Leerzeichen stehen.

tag

string

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

status

ConversionCustomVariableStatus

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

owner_customer

string

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

family

ConversionCustomVariableFamily

Familie der benutzerdefinierten Conversion-Variable.

cardinality

ConversionCustomVariableCardinality

Kardinalität der benutzerdefinierten Conversion-Variable.

floodlight_conversion_custom_variable_info

FloodlightConversionCustomVariableInfo

Felder für benutzerdefinierte Variablen für Floodlight-Conversions 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 Variablen für Floodlight-Conversions in Search Ads 360.

Felder
floodlight_variable_type

FloodlightVariableType

In Search Ads 360 definierter Floodlight-Variablentyp.

floodlight_variable_data_type

FloodlightVariableDataType

Datentyp der Floodlight-Variable, der in Search Ads 360 definiert ist.

ConversionTrackingSetting

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

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 Verwaltungskonto übernommen. Dieses Feld ist schreibgeschützt. Weitere Informationen finden Sie unter https://support.google.com/adspolicy/answer/7475709.

conversion_tracking_status

ConversionTrackingStatus

Status des Conversion-Trackings. Hier sehen Sie, 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

Gibt an, 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, für den Conversions erstellt und verwaltet werden. Dieses Feld ist schreibgeschützt.

conversion_tracking_id

int64

Die für dieses Konto verwendete Conversion-Tracking-ID. Diese ID gibt nicht an, ob der Kunde Conversion-Tracking verwendet (das wird durch conversion_tracking_status angegeben). Dieses Feld ist schreibgeschützt.

google_ads_cross_account_conversion_tracking_id

int64

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

cross_account_conversion_tracking_id

int64

Die Conversion-Tracking-ID des Verwaltungskontos des Kunden. Dieser Wert wird festgelegt, wenn der Kunde das kontoübergreifende Conversion-Tracking aktiviert hat. Er überschreibt „conversion_tracking_id“.

CustomColumn

Eine benutzerdefinierte Spalte. Weitere 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 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

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

references_metrics

bool

„Wahr“, wenn in der benutzerdefinierten Spalte auf einen oder mehrere Messwerte verwiesen wird.

queryable

bool

„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: Eine benutzerdefinierte Spalte „Summe aus Impressionen und Klicks“ verweist auf die Systemspalten {„metrics.clicks“, „metrics.impressions“}.

render_type

CustomColumnRenderType

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

Kunde

Ein Kunde

Felder
resource_name

string

Der Ressourcenname des Kunden. Kundenressourcennamen 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-Einstellung (DCM) für einen Manager-Kunden.

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

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

manager_id

int64

Die Kundennummer des Verwaltungskontos. Der Wert 0 gibt an, dass der Kunde kein SA360-Verwaltungskonto hat.

manager_descriptive_name

string

Der aussagekräftige Name des Managers.

sub_manager_id

int64

Die Kundennummer des untergeordneten Verwaltungskontos. Der Wert 0 gibt an, dass der Kunde kein untergeordnetes SA360-Verwaltungskonto hat.

sub_manager_descriptive_name

string

Der beschreibende Name des untergeordneten Verwaltungskontos.

associate_manager_id

int64

Die Kundennummer des Partner-Verwaltungskontos. Der Wert 0 gibt an, dass der Kunde keinen SA360-Partner-Verwaltungskonto hat.

associate_manager_descriptive_name

string

Der aussagekräftige Name des Partner-Verwaltungskontos.

account_level

AccountLevelType

Die Kontoebene des Kunden: Verwaltungskonto, untergeordnetes Verwaltungskonto, Partner-Verwaltungskonto oder Dienstkonto.

id

int64

Die ID des Kunden.

descriptive_name

string

Optionaler, nicht eindeutiger beschreibender Name des Kunden.

currency_code

string

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

time_zone

string

Die lokale Zeitzonen-ID des Kunden.

tracking_url_template

string

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

final_url_suffix

string

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

auto_tagging_enabled

bool

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

manager

bool

Gibt an, ob der Kunde ein Manager ist.

CustomerAsset

Eine Verknüpfung zwischen einem Kunden und einem Asset.

Felder
resource_name

string

Der Ressourcenname des Kunden-Assets. CustomerAsset-Ressourcennamen 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-Sammlung. Wenn Sie ein CustomerAssetSet hinzufügen, wird eine Asset-Sammlung mit einem Kunden verknüpft.

Felder
resource_name

string

Der Ressourcenname der Kunden-Asset-Sammlung. Ressourcennamen für Assets in Asset-Sammlungen haben das folgende Format:

customers/{customer_id}/customerAssetSets/{asset_set_id}

asset_set

string

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

customer

string

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

status

AssetSetLinkStatus

Der Status des Assets in der Asset-Sammlung des Kunden. Schreibgeschützt.

CustomerClient

Eine Verknüpfung zwischen dem angegebenen Kunden und einem Kunden des Kunden. CustomerClients sind nur für Managerkonten verfügbar. Alle direkten und indirekten Kunden des Kundenkontos sowie das Verwaltungskonto selbst sind enthalten.

Felder
resource_name

string

Der Ressourcenname des Kundenclients. Ressourcennamen für „CustomerClient“ haben das Format customers/{customer_id}/customerClients/{client_customer_id}.

applied_labels[]

string

Die Ressourcennamen der Labels, die dem anfragenden Kunden gehören und auf den Clientkunden angewendet werden. Labelressourcennamen haben das Format:

customers/{customer_id}/labels/{label_id}

status

CustomerStatus

Der Status des Kunden des Mandanten. Schreibgeschützt.

client_customer

string

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

hidden

bool

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

Schreibgeschützt.

level

int64

Entfernung zwischen dem angegebenen Kunden und dem Client. Bei einem Self-Link ist der Wert für die Ebene 0. Schreibgeschützt.

time_zone

string

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

test_account

bool

Gibt an, ob es sich beim Client um ein Testkonto handelt. Schreibgeschützt.

manager

bool

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

descriptive_name

string

Aussagekräftiger Name für den Client. Schreibgeschützt.

currency_code

string

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

id

int64

Die ID des Kunden des Kunden. Schreibgeschützt.

DoubleClickCampaignManagerSetting

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

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

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

DynamicSearchAdsSearchTermView

Ansicht mit Suchbegriffen für dynamische Suchanzeigen

Felder
resource_name

string

Der Ressourcenname der Ansicht „Suchbegriffe für dynamische Suchanzeigen“. Ressourcennamen von Ansichten für Suchbegriffe 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 Ressource für die Geschlechtsansicht. Stellt die nach Geschlecht zusammengefassten Leistungsmesswerte eines Kunden dar. Alle Statistiken werden auf Anzeigengruppenebene zusammengefasst.

Hinweis: Sie können Messwerte zwar mit age_range_view nach Altersgruppe und mit gender_view nach Geschlecht segmentieren, die Search Ads 360 API unterstützt jedoch nicht die gleichzeitige Segmentierung von Messwerten nach Altersgruppe und Geschlecht in einer einzelnen Abfrage. Die Analyse der Leistung für beide Dimensionen zusammen wird in der Search Ads 360 API nicht unterstützt.

Felder
resource_name

string

Der Ressourcenname der Ansicht für das Geschlecht. Ressourcennamen von Geschlechtsansichten 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 das folgende Format:

geoTargetConstants/{geo_target_constant_id}

status

GeoTargetConstantStatus

Status der geografischen Zielkonstante.

id

int64

Die ID der geografischen Zielkonstante.

name

string

Englischer Name der geografischen Zielkonstante.

country_code

string

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

target_type

string

Zieltyp der geografischen Zielkonstante.

canonical_name

string

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

parent_geo_target

string

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

geoTargetConstants/{parent_geo_target_constant_id}

KeywordView

Eine Keyword-Ansicht.

Felder
resource_name

string

Der Ressourcenname der Keyword-Ansicht. Ressourcennamen von Keyword-Ansichten 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/{owner_customer_id}/labels/{label_id}.

status

LabelStatus

Status des Labels. Schreibgeschützt.

text_label

TextLabel

Eine Art von Label, auf 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 das folgende Format:

languageConstants/{criterion_id}

id

int64

Die ID der Sprachkonstante.

code

string

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

name

string

Der vollständige Name der Sprache auf Englisch, z. B. „English (US)“, „Spanish“ usw.

targetable

bool

Gibt an, ob die Sprache für das Targeting verwendet werden kann.

ListingGroupFilterDimension

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

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

ProductBiddingCategory

Gebotskategorie eines Produktangebots.

product_brand

ProductBrand

Marke eines Produktangebots.

product_channel

ProductChannel

Lokalität 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. 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 das Niveau 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 für „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

Lokalität 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 Produktattributs.

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, der die Dimensionen definiert, die einen Filter für eine Eintragsgruppe definieren.

Felder
dimensions[]

ListingGroupFilterDimension

Der vollständige Pfad der Dimensionen durch die Hierarchie der Filter für die Eintragsgruppe (ohne den Root-Knoten) zu diesem Filter für die Eintragsgruppe.

LocationView

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

Felder
resource_name

string

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

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

ProductBiddingCategoryConstant

Eine Gebotskategorie für Produkte.

Felder
resource_name

string

Der Ressourcenname der Gebotskategorie für das Produkt. Ressourcennamen für Gebotskategorien für Produkte haben das folgende 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 für „google_product_category“ [Google_Produktkategorie], die in diesem Artikel beschrieben wird: https://support.google.com/merchants/answer/6324436.

country_code

string

Zweistelliger Ländercode in Großbuchstaben für die Gebotskategorie des Produkts.

product_bidding_category_constant_parent

string

Ressourcenname der übergeordneten Gebotskategorie für Produkte.

language_code

string

Sprachcode der Gebotskategorie des Produkts.

localized_name

string

Anzeigewert der Gebotskategorie des Produkts, lokalisiert gemäß language_code.

ProductGroupView

Eine Ansicht für Produktgruppen.

Felder
resource_name

string

Der Ressourcenname der Ansicht für Produktgruppen. Ressourcennamen von Produktgruppen-Ansichten haben das Format:

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

SearchAds360Field

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

Felder
resource_name

string

Der Ressourcenname des Artefakts. Ressourcennamen für Artefakte 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 ausgewählt werden können.

attribute_resources[]

string

Die Namen aller Ressourcen, die mit dem beschriebenen Artefakt ausgewählt werden können. Felder aus diesen Ressourcen segmentieren Messwerte nicht, wenn sie in Suchanfragen enthalten sind.

Dieses Feld wird nur für Artefakte festgelegt, deren Kategorie RESOURCE ist.

metrics[]

string

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

segments[]

string

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

enum_values[]

string

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

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

data_type

SearchAds360FieldDataType

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

name

string

Der Name des Artefakts.

selectable

bool

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

filterable

bool

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

sortable

bool

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

type_url

string

Die URL des Protokolls, das den Datentyp des Artefakts beschreibt.

is_repeated

bool

Gibt an, ob das Feldartefakt wiederholt wird.

ShoppingPerformanceView

Ansicht „Shoppingleistung“

Bietet Statistiken für Shopping-Kampagnen und Performance Max-Kampagnen, die auf verschiedenen Ebenen der Produktdimension zusammengefasst werden. Die Werte für Produktdimensionen aus dem Merchant Center, z. B. Marke, Kategorie, benutzerdefinierte Attribute, Produktzustand und Produkttyp, spiegeln den Zustand der jeweiligen Dimension zum Zeitpunkt der Aufzeichnung des entsprechenden Ereignisses wider.

Die Anzahl der Impressionen und Klicks, für die shopping_performance_view Statistiken zurückgibt, kann sich von der in Kampagnenberichten unterscheiden. shopping_performance_view zeigt Impressionen und Klicks auf Produkte in Anzeigen, während in Kampagnenberichten Impressionen und Klicks auf die Anzeigen selbst zu sehen sind. Je nach Format kann eine Anzeige null bis mehrere Produkte enthalten. Die Zahlen stimmen daher möglicherweise nicht überein.

Auf der Search Ads 360-Benutzeroberfläche können Sie Impressionen und Klicks von Produkten abfragen, die in Anzeigen erscheinen. Wählen Sie dazu im Berichtseditor eine Spalte aus „Produktattribute“ aus. Wenn Sie beispielsweise die Spalte „Marke“ auswählen, entspricht das der Auswahl von segments.product_brand.

Felder
resource_name

string

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

UserList

Eine Nutzerliste. Dies ist eine Liste von Nutzern, auf die ein Kunde ausgerichtet werden kann. Der eindeutige Schlüssel einer Nutzerliste besteht aus den folgenden Feldern: id. name muss auch für Nutzerlisten, die einem bestimmten Kunden gehören, eindeutig sein, außer in einigen Fällen, in denen access_reason auf SHARED festgelegt ist. Ein Verstoß gegen die Einschränkung für eindeutige Namen führt zum Fehler UserListError.INVALID_NAME.

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

ID der Nutzerliste.

name

string

Name dieser Nutzerliste. Eindeutig pro Nutzerliste, außer in einigen Fällen, in denen für eine Nutzerliste mit demselben Namen access_reason auf SHARED festgelegt ist.

UserLocationView

Eine Ansicht des Nutzerstandorts.

Die Ansicht „Nutzerstandort“ enthält alle Messwerte, die auf Länderebene zusammengefasst sind. Jedes Land wird in einer eigenen Zeile dargestellt. Hier werden Messwerte am tatsächlichen Standort des Nutzers angegeben. Die Werte beziehen sich auf Standorte, die im Targeting enthalten oder nicht enthalten sind. Wenn andere Segmentfelder verwendet werden, erhalten Sie möglicherweise mehr als eine Zeile pro Land.

Felder
resource_name

string

Der Ressourcenname der Ansicht für Nutzerstandorte. Ressourcennamen von UserLocation-Ansichten 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 der Standort als Zielvorhaben festgelegt wurde.

Aufrufen

Ein Besuch.

Felder
resource_name

string

Der Ressourcenname des Besuchs. Besuchsressourcennamen 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 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

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

asset_field_type

AssetFieldType

Asset-Feldtyp des Besuchsereignisses.

WebpageView

Eine Seitenansicht.

Felder
resource_name

string

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

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