Asset

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

JSON-Darstellung
{
  "resourceName": string,
  "type": enum (AssetType),
  "finalUrls": [
    string
  ],
  "finalMobileUrls": [
    string
  ],
  "urlCustomParameters": [
    {
      object (CustomParameter)
    }
  ],
  "source": enum (AssetSource),
  "policySummary": {
    object (AssetPolicySummary)
  },
  "fieldTypePolicySummaries": [
    {
      object (AssetFieldTypePolicySummary)
    }
  ],
  "id": string,
  "name": string,
  "trackingUrlTemplate": string,
  "finalUrlSuffix": string,

  // Union field asset_data can be only one of the following:
  "youtubeVideoAsset": {
    object (YoutubeVideoAsset)
  },
  "mediaBundleAsset": {
    object (MediaBundleAsset)
  },
  "imageAsset": {
    object (ImageAsset)
  },
  "textAsset": {
    object (TextAsset)
  },
  "leadFormAsset": {
    object (LeadFormAsset)
  },
  "bookOnGoogleAsset": {
    object (BookOnGoogleAsset)
  },
  "promotionAsset": {
    object (PromotionAsset)
  },
  "calloutAsset": {
    object (CalloutAsset)
  },
  "structuredSnippetAsset": {
    object (StructuredSnippetAsset)
  },
  "sitelinkAsset": {
    object (SitelinkAsset)
  },
  "pageFeedAsset": {
    object (PageFeedAsset)
  },
  "dynamicEducationAsset": {
    object (DynamicEducationAsset)
  },
  "mobileAppAsset": {
    object (MobileAppAsset)
  },
  "hotelCalloutAsset": {
    object (HotelCalloutAsset)
  },
  "callAsset": {
    object (CallAsset)
  },
  "priceAsset": {
    object (PriceAsset)
  },
  "callToActionAsset": {
    object (CallToActionAsset)
  },
  "dynamicRealEstateAsset": {
    object (DynamicRealEstateAsset)
  },
  "dynamicCustomAsset": {
    object (DynamicCustomAsset)
  },
  "dynamicHotelsAndRentalsAsset": {
    object (DynamicHotelsAndRentalsAsset)
  },
  "dynamicFlightsAsset": {
    object (DynamicFlightsAsset)
  },
  "discoveryCarouselCardAsset": {
    object (DiscoveryCarouselCardAsset)
  },
  "dynamicTravelAsset": {
    object (DynamicTravelAsset)
  },
  "dynamicLocalAsset": {
    object (DynamicLocalAsset)
  },
  "dynamicJobsAsset": {
    object (DynamicJobsAsset)
  },
  "locationAsset": {
    object (LocationAsset)
  },
  "hotelPropertyAsset": {
    object (HotelPropertyAsset)
  }
  // End of list of possible types for union field asset_data.
}
Felder
resourceName

string

Nicht veränderbar. Der Ressourcenname des Assets. Namen von Asset-Ressourcen haben das folgende Format:

customers/{customerId}/assets/{asset_id}

type

enum (AssetType)

Nur Ausgabe Asset-Typ.

finalUrls[]

string

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

finalMobileUrls[]

string

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

urlCustomParameters[]

object (CustomParameter)

Eine Liste mit Zuordnungen, die zum Ersetzen von benutzerdefinierten URL-Parameter-Tags in „trackingUrlTemplate“, „finalUrls“ und/oder „finalMobileUrls“ verwendet werden.

source

enum (AssetSource)

Nur Ausgabe Quelle des Assets.

policySummary

object (AssetPolicySummary)

Nur Ausgabe Richtlinieninformationen zum Asset.

fieldTypePolicySummaries[]

object (AssetFieldTypePolicySummary)

Nur Ausgabe Richtlinieninformationen zum Asset für jeden FieldType.

id

string (int64 format)

Nur Ausgabe Die ID des Assets.

name

string

Optionaler Name des Assets.

trackingUrlTemplate

string

Die URL-Vorlage zum Erstellen einer Tracking-URL.

finalUrlSuffix

string

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

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

object (YoutubeVideoAsset)

Nicht veränderbar. Ein YouTube-Video-Asset.

mediaBundleAsset

object (MediaBundleAsset)

Nicht veränderbar. Ein Mediaset-Asset.

imageAsset

object (ImageAsset)

Nur Ausgabe Ein Bild-Asset.

textAsset

object (TextAsset)

Nicht veränderbar. Ein Text-Asset.

leadFormAsset

object (LeadFormAsset)

Ein Asset mit Lead-Formular

bookOnGoogleAsset

object (BookOnGoogleAsset)

Ein „Book on Google“-Asset.

promotionAsset

object (PromotionAsset)

Ein Angebots-Asset.

calloutAsset

object (CalloutAsset)

Ein Asset mit Zusatzinformationen

structuredSnippetAsset

object (StructuredSnippetAsset)

Ein Snippet-Asset.

pageFeedAsset

object (PageFeedAsset)

Ein Seitenfeed-Asset.

dynamicEducationAsset

object (DynamicEducationAsset)

Ein dynamisches Asset für Bildung.

mobileAppAsset

object (MobileAppAsset)

Ein Asset für eine mobile App

hotelCalloutAsset

object (HotelCalloutAsset)

Ein Asset mit Zusatzinformationen für Hotels

callAsset

object (CallAsset)

Ein Anruf-Asset

priceAsset

object (PriceAsset)

Ein Preis-Asset.

callToActionAsset

object (CallToActionAsset)

Nicht veränderbar. Ein Call-to-Action-Asset.

dynamicRealEstateAsset

object (DynamicRealEstateAsset)

Dynamisches Immobilien-Asset

dynamicCustomAsset

object (DynamicCustomAsset)

Dynamisches benutzerdefiniertes Asset

dynamicHotelsAndRentalsAsset

object (DynamicHotelsAndRentalsAsset)

Dynamisches Asset für Hotels und Mietobjekte.

dynamicFlightsAsset

object (DynamicFlightsAsset)

Ein Asset für dynamische Flüge.

dynamicTravelAsset

object (DynamicTravelAsset)

Ein dynamisches Asset für die Reisebranche.

dynamicLocalAsset

object (DynamicLocalAsset)

Ein dynamisches lokales Asset.

dynamicJobsAsset

object (DynamicJobsAsset)

Ein Asset für dynamische Stellenangebote.

locationAsset

object (LocationAsset)

Nur Ausgabe Ein Standort-Asset

hotelPropertyAsset

object (HotelPropertyAsset)

Nicht veränderbar. Ein Hotelunterkunfts-Asset.

AssetType

Aufzählung zur Beschreibung möglicher Asset-Typen

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt einen unbekannten Wert in dieser Version dar.
YOUTUBE_VIDEO YouTube-Video-Asset
MEDIA_BUNDLE Mediaset-Asset.
IMAGE Bild-Asset.
TEXT Text-Asset.
LEAD_FORM Asset mit Lead-Formular.
BOOK_ON_GOOGLE „Book on Google“-Asset.
PROMOTION Angebots-Asset.
CALLOUT Asset mit Zusatzinformationen
STRUCTURED_SNIPPET Snippet-Asset
PAGE_FEED Seitenfeed-Asset.
DYNAMIC_EDUCATION Dynamisches Asset für Bildung.
MOBILE_APP Asset für mobile App
HOTEL_CALLOUT Asset mit Zusatzinformationen für Hotels.
CALL Anruf-Asset.
PRICE Preis-Asset.
CALL_TO_ACTION Call-to-Action-Asset
DYNAMIC_REAL_ESTATE Dynamisches Immobilien-Asset.
DYNAMIC_CUSTOM Dynamisches benutzerdefiniertes Asset.
DYNAMIC_HOTELS_AND_RENTALS Dynamisches Asset für Hotels und Mietobjekte
DYNAMIC_FLIGHTS Dynamisches Asset für Flüge.
DYNAMIC_TRAVEL Dynamisches Asset für Reisen
DYNAMIC_LOCAL Dynamisches lokales Asset.
DYNAMIC_JOBS Asset für dynamische Stellenangebote.
LOCATION Standort-Asset.
HOTEL_PROPERTY Hotel-Property-Asset.

AssetPolicySummary

Enthält Richtlinieninformationen zu einem Asset.

JSON-Darstellung
{
  "policyTopicEntries": [
    {
      object (PolicyTopicEntry)
    }
  ],
  "reviewStatus": enum (PolicyReviewStatus),
  "approvalStatus": enum (PolicyApprovalStatus)
}
Felder
policyTopicEntries[]

object (PolicyTopicEntry)

Nur Ausgabe Die Liste der Richtlinienergebnisse für dieses Asset.

reviewStatus

enum (PolicyReviewStatus)

Nur Ausgabe An welcher Stelle im Überprüfungsprozess befindet sich dieses Asset?

approvalStatus

enum (PolicyApprovalStatus)

Nur Ausgabe Der Gesamtgenehmigungsstatus dieses Assets, der auf Grundlage des Status der einzelnen Einträge für Richtlinienthemen berechnet wird.

AssetFieldTypePolicySummary

Enthält Richtlinieninformationen zu einem Asset im AssetFieldType-Kontext.

JSON-Darstellung
{
  "assetFieldType": enum (AssetFieldType),
  "assetSource": enum (AssetSource),
  "policySummaryInfo": {
    object (AssetPolicySummary)
  }
}
Felder
assetFieldType

enum (AssetFieldType)

Nur Ausgabe Feldtyp dieses Assets.

assetSource

enum (AssetSource)

Nur Ausgabe Quelle dieses Assets.

policySummaryInfo

object (AssetPolicySummary)

Nur Ausgabe Zusammenfassung der Richtlinien.

YoutubeVideoAsset

Ein YouTube-Asset.

JSON-Darstellung
{
  "youtubeVideoTitle": string,
  "youtubeVideoId": string
}
Felder
youtubeVideoTitle

string

Titel des YouTube-Videos.

youtubeVideoId

string

YouTube-Video-ID. Dies ist der String-Wert mit 11 Zeichen, der in der URL des YouTube-Videos verwendet wird.

MediaBundleAsset

Ein MediaBundle-Asset.

JSON-Darstellung
{
  "data": string
}
Felder
data

string (bytes format)

Asset-Daten des Mediasets (ZIP-Datei) Das Format der hochgeladenen ZIP-Datei hängt vom Anzeigenfeld ab, in dem sie verwendet wird. Weitere Informationen zum Format finden Sie in der Dokumentation zum Anzeigenfeld, in dem Sie das MediaBundleAsset verwenden möchten. Dieses Feld kann nur geändert werden.

Ein base64-codierter String.

ImageAsset

Ein Bild-Asset.

JSON-Darstellung
{
  "mimeType": enum (MimeType),
  "fullSize": {
    object (ImageDimension)
  },
  "data": string,
  "fileSize": string
}
Felder
mimeType

enum (MimeType)

Der MIME-Typ des Bild-Assets.

fullSize

object (ImageDimension)

Metadaten für dieses Bild in Originalgröße.

data

string (bytes format)

Die Rohdaten eines Bildes in Byte. Dieses Feld kann nur geändert werden.

Ein base64-codierter String.

fileSize

string (int64 format)

Dateigröße des Bild-Assets in Byte.

ImageDimension

Metadaten für ein Bild in einer bestimmten Größe, entweder im Original oder in der Größe angepasst

JSON-Darstellung
{
  "heightPixels": string,
  "widthPixels": string,
  "url": string
}
Felder
heightPixels

string (int64 format)

Höhe des Bilds.

widthPixels

string (int64 format)

Breite des Bilds.

url

string

Eine URL, über die das Bild mit dieser Höhe und Breite zurückgegeben wird.

TextAsset

Ein Text-Asset.

JSON-Darstellung
{
  "text": string
}
Felder
text

string

Textinhalt des Text-Assets.

LeadFormAsset

Ein Asset mit Lead-Formular

JSON-Darstellung
{
  "businessName": string,
  "callToActionType": enum (LeadFormCallToActionType),
  "callToActionDescription": string,
  "headline": string,
  "description": string,
  "privacyPolicyUrl": string,
  "fields": [
    {
      object (LeadFormField)
    }
  ],
  "customQuestionFields": [
    {
      object (LeadFormCustomQuestionField)
    }
  ],
  "deliveryMethods": [
    {
      object (LeadFormDeliveryMethod)
    }
  ],
  "postSubmitCallToActionType": enum (LeadFormPostSubmitCallToActionType),
  "desiredIntent": enum (LeadFormDesiredIntent),
  "postSubmitHeadline": string,
  "postSubmitDescription": string,
  "backgroundImageAsset": string,
  "customDisclosure": string
}
Felder
businessName

string

Erforderlich. Der Name des beworbenen Unternehmens.

callToActionType

enum (LeadFormCallToActionType)

Erforderlich. Vordefinierter Anzeigetext, der den Nutzer dazu anregt, das Formular zu maximieren.

callToActionDescription

string

Erforderlich. Text, der deutlich macht, was Nutzer erwarten, wenn sie das Formular maximieren.

headline

string

Erforderlich. Überschrift des erweiterten Formulars, um zu beschreiben, was mit dem Formular verlangt oder ermöglicht wird.

description

string

Erforderlich. Detaillierte Beschreibung des erweiterten Formulars, um zu beschreiben, was mit dem Formular verlangt oder ermöglicht wird.

privacyPolicyUrl

string

Erforderlich. Link zu einer Seite, in der erläutert wird, wie der Werbetreibende bzw. das Unternehmen mit den erhobenen Daten umgeht.

fields[]

object (LeadFormField)

Sortierte Liste der Eingabefelder. Sie können dieses Feld aktualisieren, indem Sie Fragen neu anordnen. Es ist jedoch nicht möglich, Fragen hinzuzufügen oder zu entfernen.

customQuestionFields[]

object (LeadFormCustomQuestionField)

Sortierte Liste benutzerdefinierter Fragefelder. Für dieses Feld sind maximal fünf Fragen zur Bestimmung der Lead-Qualität pro Formular zulässig.

deliveryMethods[]

object (LeadFormDeliveryMethod)

Konfigurierte Methoden für die Auslieferung von erfassten Lead-Daten an Werbetreibende. Es kann nur eine Methode vom Typ „WebhookDelivery“ konfiguriert werden.

postSubmitCallToActionType

enum (LeadFormPostSubmitCallToActionType)

Vordefinierter Anzeigetext, der die Nutzer zu einer Aktion anregt, nachdem das Formular gesendet wurde.

desiredIntent

enum (LeadFormDesiredIntent)

Ausgewählter Intent für das Lead-Formular, z. B. „Mehr Volumen“ oder „Qualifizierter“

postSubmitHeadline

string

Anzeigentitel, der nach dem Senden des Formulars angezeigt wird und beschreibt, wie der Werbetreibende mit dem Nutzer interagieren wird.

postSubmitDescription

string

Detaillierte Beschreibung, die nach dem Senden des Formulars angezeigt wird und beschreibt, wie der Werbetreibende mit dem Nutzer interagieren wird.

backgroundImageAsset

string

Asset-Ressourcenname des Hintergrundbilds. Die Bildabmessungen müssen genau 1.200 x 628 Pixel betragen.

customDisclosure

string

Benutzerdefinierte Offenlegung wird zusammen mit einem Haftungsausschluss von Google auf dem Lead-Formular angezeigt. Nur für bewilligte Kunden zugänglich.

LeadFormCallToActionType

Aufzählung, die den Typ der Call-to-Action-Wortgruppen in einem Lead-Formular beschreibt.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt einen unbekannten Wert in dieser Version dar.
LEARN_MORE Weitere Informationen.
GET_QUOTE Angebot einholen.
APPLY_NOW Jetzt beantragen.
SIGN_UP Registrieren.
CONTACT_US Dann kontaktieren Sie uns.
SUBSCRIBE Abonnieren.
DOWNLOAD Herunterladen.
BOOK_NOW Jetzt buchen.
GET_OFFER Zum Angebot.
REGISTER Registrieren.
GET_INFO Weitere Informationen
REQUEST_DEMO Fordern Sie eine Demo an.
JOIN_NOW Jetzt anmelden.
GET_STARTED So funktionierts

LeadFormField

Eine Eingabefeldinstanz innerhalb eines Formulars.

JSON-Darstellung
{
  "inputType": enum (LeadFormFieldUserInputType),

  // Union field answers can be only one of the following:
  "singleChoiceAnswers": {
    object (LeadFormSingleChoiceAnswers)
  },
  "hasLocationAnswer": boolean
  // End of list of possible types for union field answers.
}
Felder
inputType

enum (LeadFormFieldUserInputType)

Beschreibt den Eingabetyp. Dabei kann es sich um einen vordefinierten Typ wie „Vollständiger Name“ oder eine vorab geprüfte Frage wie „Welche Art von Fahrzeug haben Sie?“ handeln.

Union-Feld answers. Definiert die Antwortkonfiguration, die für dieses Formularfeld akzeptiert wird. Wenn oneof nicht festgelegt ist, ist dies eine Freitextantwort. Für answers ist nur einer der folgenden Werte zulässig:
singleChoiceAnswers

object (LeadFormSingleChoiceAnswers)

Antwortkonfiguration für eine Frage mit Einzelauswahl. Kann nur für vorab überprüfte Fragefelder festgelegt werden. Es sind mindestens 2 Antworten erforderlich, maximal 12.

hasLocationAnswer

boolean

Antwortkonfiguration für die Frage zum Standort. Ist dies der Fall, werden Standortdaten auf Kampagnen- oder Kontoebene (Bundesland, Stadt, Name des Unternehmens usw.) auf dem Lead-Formular gerendert. Ab Version 13.1 kann hasLocationAnswer nur für die Frage „Was ist Ihr bevorzugter Autohändler?“ festgelegt werden, wenn Standort-Assets auf Kampagnen- oder Kontoebene eingerichtet sind.

LeadFormSingleChoiceAnswers

Definiert mögliche Antworten für eine Frage mit einer Auswahlmöglichkeit. Diese wird in der Regel in einer Drop-down-Liste mit einer Auswahlmöglichkeit dargestellt.

JSON-Darstellung
{
  "answers": [
    string
  ]
}
Felder
answers[]

string

Liste mit Auswahlmöglichkeiten für ein einzelnes Fragefeld. Die Reihenfolge der Einträge definiert die Reihenfolge der UI. Es sind mindestens 2 Antworten erforderlich, maximal 12.

LeadFormCustomQuestionField

Eine Instanz eines benutzerdefinierten Eingabefelds für eine Frage innerhalb eines Formulars.

JSON-Darstellung
{
  "customQuestionText": string,

  // Union field answers can be only one of the following:
  "singleChoiceAnswers": {
    object (LeadFormSingleChoiceAnswers)
  },
  "hasLocationAnswer": boolean
  // End of list of possible types for union field answers.
}
Felder
customQuestionText

string

Den genauen Text im benutzerdefinierten Fragefeld, z. B. „Welche Art von Fahrzeug haben Sie?“.

Union-Feld answers. Definiert die Antwortkonfiguration, die für dieses Formularfeld akzeptiert wird. Wenn oneof nicht festgelegt ist, ist dies eine Freitextantwort. Für answers ist nur einer der folgenden Werte zulässig:
singleChoiceAnswers

object (LeadFormSingleChoiceAnswers)

Antwortkonfiguration für eine Frage mit Einzelauswahl. Es sind mindestens zwei und höchstens zwölf Antworten zulässig.

hasLocationAnswer

boolean

Antwortkonfiguration für die Frage zum Standort. Ist dies der Fall, werden Standortdaten auf Kampagnen- oder Kontoebene (Bundesland, Stadt, Name des Unternehmens usw.) auf dem Lead-Formular gerendert. Ab Version 13.1 kann hasLocationAnswer nur für die Frage „Was ist Ihr bevorzugter Autohändler?“ festgelegt werden, wenn Standort-Assets auf Kampagnen- oder Kontoebene eingerichtet sind.

LeadFormDeliveryMethod

Konfiguration, wie Leads an den Werbetreibenden ausgeliefert werden

JSON-Darstellung
{

  // Union field delivery_details can be only one of the following:
  "webhook": {
    object (WebhookDelivery)
  }
  // End of list of possible types for union field delivery_details.
}
Felder
Union-Feld delivery_details. Verschiedene Untertypen der Auslieferung. Für delivery_details ist nur einer der folgenden Werte zulässig:
webhook

object (WebhookDelivery)

Webhook-Bereitstellungsmethode.

WebhookDelivery

Google benachrichtigt Werbetreibende über Leads, indem sie HTTP-Aufrufe an einen von ihnen angegebenen Endpunkt sendet. Die Anfragen enthalten JSON-Daten, die mit einem Schema übereinstimmen, das von Google als Teil der Dokumentation zu Anzeigen mit Formular veröffentlicht wird.

JSON-Darstellung
{
  "advertiserWebhookUrl": string,
  "googleSecret": string,
  "payloadSchemaVersion": string
}
Felder
advertiserWebhookUrl

string

Vom Werbetreibenden angegebene Webhook-URL, an die der Lead gesendet werden soll.

googleSecret

string

Anti-Spoofing-Secret, das vom Werbetreibenden als Teil der Webhook-Nutzlast festgelegt wurde.

payloadSchemaVersion

string (int64 format)

Die Schemaversion, die diese Bereitstellungsinstanz verwenden wird.

LeadFormPostSubmitCallToActionType

Aufzählung, die die Art der nach dem Senden angezeigten Call-to-Action-Wortgruppen für ein Lead-Formular beschreibt

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt einen unbekannten Wert in dieser Version dar.
VISIT_SITE Zur Website.
DOWNLOAD Herunterladen.
LEARN_MORE Weitere Informationen.
SHOP_NOW Jetzt Angebote sichern.

LeadFormDesiredIntent

Aufzählung, die die ausgewählte Absichtsebene der generierten Leads beschreibt.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt einen unbekannten Wert in dieser Version dar.
LOW_INTENT Sie können mehr Leads mit potenziell geringerer Qualität generieren.
HIGH_INTENT Erzielen Sie qualifiziertere Leads.

BookOnGoogleAsset

Dieser Typ hat keine Felder.

Ein Book on Google-Asset. Wird verwendet, um den Nutzer zur Buchung über Google weiterzuleiten. Book on Google ändert die Weiterleitungs-URL so, dass die Buchung direkt über Google erfolgt.

PromotionAsset

Ein Angebots-Asset.

JSON-Darstellung
{
  "promotionTarget": string,
  "discountModifier": enum (PromotionExtensionDiscountModifier),
  "redemptionStartDate": string,
  "redemptionEndDate": string,
  "occasion": enum (PromotionExtensionOccasion),
  "languageCode": string,
  "startDate": string,
  "endDate": string,
  "adScheduleTargets": [
    {
      object (AdScheduleInfo)
    }
  ],

  // Union field discount_type can be only one of the following:
  "percentOff": string,
  "moneyAmountOff": {
    object (Money)
  }
  // End of list of possible types for union field discount_type.

  // Union field promotion_trigger can be only one of the following:
  "promotionCode": string,
  "ordersOverAmount": {
    object (Money)
  }
  // End of list of possible types for union field promotion_trigger.
}
Felder
promotionTarget

string

Erforderlich. Eine freie Beschreibung dessen, worauf das Angebot abzielt.

discountModifier

enum (PromotionExtensionDiscountModifier)

Ein Modifikator für die Qualifizierung des Rabatts.

redemptionStartDate

string

Das Startdatum, an dem das Angebot eingelöst werden kann, im Format JJJJ-MM-TT.

redemptionEndDate

string

Das letzte Datum, an dem das Angebot eingelöst werden kann, im Format JJJJ-MM-TT.

occasion

enum (PromotionExtensionOccasion)

Der Anlass, für den die Werbeaktion bestimmt war. Wenn ein Anlass festgelegt wurde, muss das Einlösungsfenster in den Zeitraum fallen, der dem Anlass zugeordnet ist.

languageCode

string

Die Sprache der Werbeaktion. Wird als Sprach-Tag BCP 47 dargestellt.

startDate

string

Das Startdatum, an dem dieses Asset wirksam ist und ausgeliefert werden kann, im Format jjjj-MM-tt.

endDate

string

Letztes Datum im Format JJJJ-MM-TT, an dem dieses Asset wirksam ist und noch ausgeliefert wird.

adScheduleTargets[]

object (AdScheduleInfo)

Liste der nicht überlappenden Zeitpläne, in denen alle Zeitintervalle angegeben sind, für die das Asset ausgeliefert werden kann. Pro Tag sind maximal 6 Zeitpläne möglich, insgesamt 42.

Union-Feld discount_type. Rabatttyp, kann Rabatt in Prozent oder Betrag sein. discount_type kann nur einer der folgenden Werte sein:
percentOff

string (int64 format)

Rabatt in Prozent in der Werbeaktion. 1.000.000 = 100%. Entweder dies oder „moneyAmountOff“ ist erforderlich.

moneyAmountOff

object (Money)

Rabattbetrag für den Rabatt im Angebot. Entweder das oder der Prozentsatz ist erforderlich.

Union-Feld promotion_trigger. Trigger für Werbeaktionen. Kann per Aktionscode oder Sonderfall auf Grundlage eines zulässigen Bestellbetrags erfolgen. Für promotion_trigger ist nur einer der folgenden Werte zulässig:
promotionCode

string

Ein Code, den der Nutzer verwenden muss, um das Angebot in Anspruch zu nehmen.

ordersOverAmount

object (Money)

Der Betrag, der insgesamt für die Bestellung des Nutzers erforderlich ist, damit das Angebot genutzt werden kann.

CalloutAsset

Ein Asset mit Zusatzinformationen

JSON-Darstellung
{
  "calloutText": string,
  "startDate": string,
  "endDate": string,
  "adScheduleTargets": [
    {
      object (AdScheduleInfo)
    }
  ]
}
Felder
calloutText

string

Erforderlich. Der Text der Erweiterung mit Zusatzinformationen. Die Länge der Zeichenfolge muss zwischen 1 und 25 Zeichen (einschließlich) liegen.

startDate

string

Das Startdatum, an dem dieses Asset wirksam ist und ausgeliefert werden kann, im Format jjjj-MM-tt.

endDate

string

Letztes Datum im Format JJJJ-MM-TT, an dem dieses Asset wirksam ist und noch ausgeliefert wird.

adScheduleTargets[]

object (AdScheduleInfo)

Liste der nicht überlappenden Zeitpläne, in denen alle Zeitintervalle angegeben sind, für die das Asset ausgeliefert werden kann. Pro Tag sind maximal 6 Zeitpläne möglich, insgesamt 42.

StructuredSnippetAsset

Ein Snippet-Asset

JSON-Darstellung
{
  "header": string,
  "values": [
    string
  ]
}
Felder
header

string

Erforderlich. Der Header des Snippets. Dieser String sollte einer der vordefinierten Werte unter https://developers.google.com/google-ads/api/reference/data/structured-snippet-headers sein.

values[]

string

Erforderlich. Die Werte im Snippet Die Größe dieser Sammlung sollte zwischen 3 und 10 (einschließlich) liegen. Die Länge jedes Werts muss zwischen 1 und 25 Zeichen liegen.

SitelinkAsset

Ein Sitelink-Asset.

JSON-Darstellung
{
  "linkText": string,
  "description1": string,
  "description2": string,
  "startDate": string,
  "endDate": string,
  "adScheduleTargets": [
    {
      object (AdScheduleInfo)
    }
  ]
}
Felder
description1

string

Die erste Zeile der Textzeile für den Sitelink. Wenn dieser Wert festgelegt wird, sollte die Länge zwischen 1 und 35 (einschließlich) betragen und description2 muss auch festgelegt werden.

description2

string

Zweite Zeile der Textzeile für den Sitelink. Wenn dieser Wert festgelegt wird, sollte die Länge zwischen 1 und 35 (einschließlich) betragen und description1 muss auch festgelegt werden.

startDate

string

Das Startdatum, an dem dieses Asset wirksam ist und ausgeliefert werden kann, im Format jjjj-MM-tt.

endDate

string

Letztes Datum im Format JJJJ-MM-TT, an dem dieses Asset wirksam ist und noch ausgeliefert wird.

adScheduleTargets[]

object (AdScheduleInfo)

Liste der nicht überlappenden Zeitpläne, in denen alle Zeitintervalle angegeben sind, für die das Asset ausgeliefert werden kann. Pro Tag sind maximal 6 Zeitpläne möglich, insgesamt 42.

PageFeedAsset

Ein Seitenfeed-Asset

JSON-Darstellung
{
  "pageUrl": string,
  "labels": [
    string
  ]
}
Felder
pageUrl

string

Erforderlich. Die Webseite, auf die Werbetreibende ihre Anzeigen ausrichten möchten.

labels[]

string

Labels zum Gruppieren der Seiten-URLs.

DynamicEducationAsset

Ein dynamisches Asset für Bildung.

JSON-Darstellung
{
  "programId": string,
  "locationId": string,
  "programName": string,
  "subject": string,
  "programDescription": string,
  "schoolName": string,
  "address": string,
  "contextualKeywords": [
    string
  ],
  "androidAppLink": string,
  "similarProgramIds": [
    string
  ],
  "iosAppLink": string,
  "iosAppStoreId": string,
  "thumbnailImageUrl": string,
  "imageUrl": string
}
Felder
programId

string

Erforderlich. Programm-ID. Diese kann eine beliebige Folge aus Buchstaben und Ziffern sein, eindeutig sein und den Werten des Remarketing-Tags entsprechen. Erforderlich.

locationId

string

Standort-ID, die aus einer beliebigen Folge von Buchstaben und Ziffern bestehen und eindeutig sein muss.

programName

string

Erforderlich. Programmname, z. B. Krankenpflege. Erforderlich.

subject

string

Studienthema, z. B. Gesundheit.

programDescription

string

Programmbeschreibung, z. B. Krankenpflegezertifizierung.

schoolName

string

Name der Schule, z. B. Mountain View School of Nursing.

address

string

Die Adresse der Schule, die in einem der folgenden Formate angegeben werden kann. (1) Stadt, Bundesland, Code, Land, z. B. Mountain View, CA, USA. (2) Vollständige Adresse, zum Beispiel 123 Boulevard St, Mountain View, CA 94043, USA. (3) Breiten- und Längengrad im DDD-Format, z. B. 41.40338, 2.17403

contextualKeywords[]

string

Kontextbezogene Keywords, z. B. „Krankenpflegezertifizierung“, „Gesundheit“ oder „Mountain View“

similarProgramIds[]

string

Ähnliche Kursnummern.

iosAppStoreId

string (int64 format)

iOS App Store-ID Hiermit wird vor Verwendung eines Deeplinks geprüft, ob der Nutzer die App auf seinem Gerät installiert hat. Wenn dieses Feld festgelegt ist, muss auch das Feld „iosAppLink“ vorhanden sein.

thumbnailImageUrl

string

URL des Thumbnail-Bilds, z. B. http://www.example.com/thumbnail.png Das Thumbnail wird nicht als Bild-Asset hochgeladen.

imageUrl

string

Bild-URL, z. B. http://www.example.com/image.png Das Bild wird nicht als Bild-Asset hochgeladen.

MobileAppAsset

Ein Asset für eine App.

JSON-Darstellung
{
  "appId": string,
  "appStore": enum (MobileAppVendor),
  "linkText": string,
  "startDate": string,
  "endDate": string
}
Felder
appId

string

Erforderlich. Ein String, der eine mobile App eindeutig identifiziert. Es sollte nur die native ID der Plattform enthalten, z. B. „com.android.ebay“ für Android oder „12345689“ für iOS.

appStore

enum (MobileAppVendor)

Erforderlich. Der App-Shop, über den diese App vertrieben wird.

startDate

string

Das Startdatum, an dem dieses Asset wirksam ist und ausgeliefert werden kann, im Format jjjj-MM-tt.

endDate

string

Letztes Datum im Format JJJJ-MM-TT, an dem dieses Asset wirksam ist und noch ausgeliefert wird.

HotelCalloutAsset

Ein Asset, das für eine Erweiterung mit Zusatzinformationen für Hotels steht.

JSON-Darstellung
{
  "text": string,
  "languageCode": string
}
Felder
text

string

Erforderlich. Der Text des Assets mit Zusatzinformationen für Hotels. Die Länge der Zeichenfolge muss zwischen 1 und 25 Zeichen (einschließlich) liegen.

languageCode

string

Erforderlich. Die Sprache der Zusatzinformationen für Hotels. Wird als Sprach-Tag BCP 47 dargestellt.

CallAsset

Ein Anruf-Asset

JSON-Darstellung
{
  "countryCode": string,
  "phoneNumber": string,
  "callConversionReportingState": enum (CallConversionReportingState),
  "callConversionAction": string,
  "adScheduleTargets": [
    {
      object (AdScheduleInfo)
    }
  ]
}
Felder
countryCode

string

Erforderlich. Der aus zwei Buchstaben bestehende Ländercode der Telefonnummer. Beispiele: „US“, „us“.

phoneNumber

string

Erforderlich. Die unformatierte Telefonnummer des Werbetreibenden. Beispiele: „1234567890“, „(123)456-7890“

callConversionReportingState

enum (CallConversionReportingState)

Gibt an, ob für dieses Anruf-Asset eine eigene Einstellung für Anruf-Conversions verwendet, die Einstellung auf Kontoebene verwendet oder die Anruf-Conversion deaktiviert werden soll.

callConversionAction

string

Die Conversion-Aktion, der eine Anruf-Conversion zugeordnet werden soll. Wenn die Richtlinie nicht konfiguriert ist, wird die standardmäßige Conversion-Aktion verwendet. Dieses Feld ist nur wirksam, wenn „callConversionReportingState“ auf USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION festgelegt ist.

adScheduleTargets[]

object (AdScheduleInfo)

Liste der nicht überlappenden Zeitpläne, in denen alle Zeitintervalle angegeben sind, für die das Asset ausgeliefert werden kann. Pro Tag sind maximal 6 Zeitpläne möglich, insgesamt 42.

PriceAsset

Ein Asset, das eine Liste von Preisangeboten darstellt.

JSON-Darstellung
{
  "type": enum (PriceExtensionType),
  "priceQualifier": enum (PriceExtensionPriceQualifier),
  "languageCode": string,
  "priceOfferings": [
    {
      object (PriceOffering)
    }
  ]
}
Felder
type

enum (PriceExtensionType)

Erforderlich. Der Typ des Preis-Assets.

priceQualifier

enum (PriceExtensionPriceQualifier)

Der Preiskennzeichner des Preis-Assets.

languageCode

string

Erforderlich. Die Sprache des Preis-Assets. Wird als Sprach-Tag BCP 47 dargestellt.

priceOfferings[]

object (PriceOffering)

Die Angebote des Preis-Assets. Die Größe dieser Sammlung sollte zwischen 3 und 8 (einschließlich) liegen.

PriceOffering

Ein einzelnes Preisangebot in einem Preis-Asset.

JSON-Darstellung
{
  "header": string,
  "description": string,
  "price": {
    object (Money)
  },
  "unit": enum (PriceExtensionPriceUnit),
  "finalUrl": string,
  "finalMobileUrl": string
}
Felder
header

string

Erforderlich. Der Titel des Preisangebots. Die Länge der Zeichenfolge muss zwischen 1 und 25 Zeichen (einschließlich) liegen.

description

string

Erforderlich. Die Beschreibung des Preisangebots. Die Länge der Zeichenfolge muss zwischen 1 und 25 Zeichen (einschließlich) liegen.

price

object (Money)

Erforderlich. Der Preiswert des Angebots.

unit

enum (PriceExtensionPriceUnit)

Die Preiseinheit des Angebots.

finalUrl

string

Erforderlich. Die finale URL nach allen domainübergreifenden Weiterleitungen.

finalMobileUrl

string

Die finale mobile URL nach allen domainübergreifenden Weiterleitungen.

CallToActionAsset

Ein Call-to-Action-Asset.

JSON-Darstellung
{
  "callToAction": enum (CallToActionType)
}
Felder
callToAction

enum (CallToActionType)

Call-to-Action

DynamicRealEstateAsset

Dynamisches Immobilien-Asset

JSON-Darstellung
{
  "listingId": string,
  "listingName": string,
  "cityName": string,
  "description": string,
  "address": string,
  "price": string,
  "imageUrl": string,
  "propertyType": string,
  "listingType": string,
  "contextualKeywords": [
    string
  ],
  "formattedPrice": string,
  "androidAppLink": string,
  "iosAppLink": string,
  "iosAppStoreId": string,
  "similarListingIds": [
    string
  ]
}
Felder
listingId

string

Erforderlich. Eintrags-ID. Diese kann eine beliebige Folge aus Buchstaben und Ziffern sein, eindeutig sein und den Werten des Remarketing-Tags entsprechen. Erforderlich.

listingName

string

Erforderlich. Name des Eintrags, z. B. Boulevard Bungalow. Erforderlich.

cityName

string

Ortsname, z. B. Mountain View, Kalifornien.

description

string

Beschreibung, z. B. 3 Betten, 2 Bäder, 140 m2

address

string

Adresse, die in einem der folgenden Formate angegeben werden kann. (1) Stadt, Bundesland, Code, Land, z. B. Mountain View, CA, USA. (2) Vollständige Adresse, zum Beispiel 123 Boulevard St, Mountain View, CA 94043, USA. (3) Breiten- und Längengrad im DDD-Format, z. B. 41.40338, 2.17403

price

string

Preis, der aus einer Zahl gefolgt vom alphabetischen Währungscode gemäß ISO-4217-Standard besteht. Verwenden Sie „.“ als Dezimalzeichen, z. B. 200,000.00 EUR.

imageUrl

string

Bild-URL, z. B. http://www.example.com/image.png Das Bild wird nicht als Bild-Asset hochgeladen.

propertyType

string

Immobilienart, z. B. Haus.

listingType

string

Angebotstyp, z. B. „Zum Verkauf“.

contextualKeywords[]

string

Kontextbezogene Keywords, z. B. „Verkauf“ oder „Häuser kaufen“

formattedPrice

string

Formatierter Preis, der beliebige Zeichen enthalten kann. Wenn festgelegt, wird dieses Attribut anstelle von „price“ verwendet, z. B. „Ab 200.000,00 €“.

iosAppStoreId

string (int64 format)

iOS App Store-ID Hiermit wird vor Verwendung eines Deeplinks geprüft, ob der Nutzer die App auf seinem Gerät installiert hat. Wenn dieses Feld festgelegt ist, muss auch das Feld „iosAppLink“ vorhanden sein.

similarListingIds[]

string

Ähnliche Angebots-IDs.

DynamicCustomAsset

Dynamisches benutzerdefiniertes Asset

JSON-Darstellung
{
  "id": string,
  "id2": string,
  "itemTitle": string,
  "itemSubtitle": string,
  "itemDescription": string,
  "itemAddress": string,
  "itemCategory": string,
  "price": string,
  "salePrice": string,
  "formattedPrice": string,
  "formattedSalePrice": string,
  "imageUrl": string,
  "contextualKeywords": [
    string
  ],
  "androidAppLink": string,
  "iosAppLink": string,
  "iosAppStoreId": string,
  "similarIds": [
    string
  ]
}
Felder
id

string

Erforderlich. Die ID kann aus einer beliebigen Folge aus Buchstaben und Ziffern bestehen, eindeutig sein und den Werten des Remarketing-Tags (z. B. sedan) entsprechen. Erforderlich.

id2

string

ID2, die aus einer beliebigen Folge von Buchstaben und Ziffern bestehen kann, z. B. rot. Die ID-Sequenz (ID + ID2) muss eindeutig sein.

itemTitle

string

Erforderlich. Artikeltitel, z. B. „Midsize-Limousine“. Erforderlich.

itemSubtitle

string

Unterüberschrift des Artikels, z. B. „Bei Ihrem Mountain View-Händler“.

itemDescription

string

Artikelbeschreibung, z. B. Bestseller in der Mittelklasse.

itemAddress

string

Artikeladresse, die in einem der folgenden Formate angegeben werden kann. (1) Stadt, Bundesland, Code, Land, z. B. Mountain View, CA, USA. (2) Vollständige Adresse, zum Beispiel 123 Boulevard St, Mountain View, CA 94043, USA. (3) Breiten- und Längengrad im DDD-Format, z. B. 41.40338, 2.17403

itemCategory

string

Artikelkategorie, zum Beispiel Limousinen.

price

string

Preis, der aus einer Zahl gefolgt vom alphabetischen Währungscode gemäß ISO-4217-Standard besteht. Verwenden Sie „.“ als Dezimalzeichen, z. B. 20.000.00 EUR.

salePrice

string

Sonderangebotspreis, bestehend aus einer Zahl gefolgt vom alphabetischen Währungscode gemäß ISO-4217-Norm. Verwenden Sie „.“ als Dezimalzeichen, z. B. 15.000.00 EUR. Der Wert muss kleiner als das Feld „Preis“ sein.

formattedPrice

string

Formatierter Preis, der beliebige Zeichen enthalten kann. Wenn festgelegt, wird dieses Attribut anstelle von „price“ verwendet, z. B. „Ab 20.000 €“.

formattedSalePrice

string

Formatierter Sonderangebotspreis, der beliebige Zeichen enthalten kann. Wenn dieses Attribut festgelegt ist, wird es anstelle von 'Sonderangebotspreis' [sale price] verwendet, z. B. „Im Angebot für 15.000,00 €“.

imageUrl

string

Bild-URL, z. B. http://www.example.com/image.png Das Bild wird nicht als Bild-Asset hochgeladen.

contextualKeywords[]

string

Kontextbezogene Keywords, z. B. „Limousinen“, „4‐türige Limousinen“

iosAppStoreId

string (int64 format)

iOS App Store-ID Hiermit wird vor Verwendung eines Deeplinks geprüft, ob der Nutzer die App auf seinem Gerät installiert hat. Wenn dieses Feld festgelegt ist, muss auch das Feld „iosAppLink“ vorhanden sein.

similarIds[]

string

Ähnliche IDs.

DynamicHotelsAndRentalsAsset

Dynamisches Asset für Hotels und Mietobjekte.

JSON-Darstellung
{
  "propertyId": string,
  "propertyName": string,
  "imageUrl": string,
  "destinationName": string,
  "description": string,
  "price": string,
  "salePrice": string,
  "starRating": string,
  "category": string,
  "contextualKeywords": [
    string
  ],
  "address": string,
  "androidAppLink": string,
  "iosAppLink": string,
  "iosAppStoreId": string,
  "formattedPrice": string,
  "formattedSalePrice": string,
  "similarPropertyIds": [
    string
  ]
}
Felder
propertyId

string

Erforderlich. Die Property-ID kann eine beliebige Folge aus Buchstaben und Ziffern sein, eindeutig sein und den Werten des Remarketing-Tags entsprechen. Erforderlich.

propertyName

string

Erforderlich. Name der Unterkunft, z. B. „Mountain View Hotel“. Erforderlich.

imageUrl

string

Bild-URL, z. B. http://www.example.com/image.png Das Bild wird nicht als Bild-Asset hochgeladen.

destinationName

string

Zielname, z. B. Innenstadt von Mountain View.

description

string

Beschreibung, zum Beispiel „In der Nähe des Flughafens Berlin“.

price

string

Preis, der aus einer Zahl gefolgt vom alphabetischen Währungscode gemäß ISO-4217-Standard besteht. Verwenden Sie „.“ als Dezimalzeichen, z. B. 100.00 EUR.

salePrice

string

ISO 4217-Standard. Verwenden Sie „.“ als Dezimalzeichen, z. B. 80.00 EUR. Der Wert muss kleiner als das Feld „Preis“ sein.

starRating

string (int64 format)

Bewertung Muss eine Zahl zwischen 1 und 5 sein (jeweils einschließlich).

category

string

Kategorie, z. B. Hotelsuite.

contextualKeywords[]

string

Kontextbezogene Keywords, z. B. „Hotels in Hamburg“ oder „Hotels in Hamburg“

address

string

Adresse, die in einem der folgenden Formate angegeben werden kann. (1) Stadt, Bundesland, Code, Land, z. B. Mountain View, CA, USA. (2) Vollständige Adresse, zum Beispiel 123 Boulevard St, Mountain View, CA 94043, USA. (3) Breiten- und Längengrad im DDD-Format, z. B. 41.40338, 2.17403

iosAppStoreId

string (int64 format)

iOS App Store-ID Hiermit wird vor Verwendung eines Deeplinks geprüft, ob der Nutzer die App auf seinem Gerät installiert hat. Wenn dieses Feld festgelegt ist, muss auch das Feld „iosAppLink“ vorhanden sein.

formattedPrice

string

Formatierter Preis, der beliebige Zeichen enthalten kann. Wenn festgelegt, wird dieses Attribut anstelle von „price“ verwendet, z. B. „Ab 100 €“.

formattedSalePrice

string

Formatierter Sonderangebotspreis, der beliebige Zeichen enthalten kann. Wenn dieses Attribut festgelegt ist, wird es anstelle von „Sonderangebotspreis“ verwendet, z. B. „Im Angebot für 80 €“.

similarPropertyIds[]

string

Ähnliche Property-IDs.

DynamicFlightsAsset

Ein Asset für dynamische Flüge.

JSON-Darstellung
{
  "destinationId": string,
  "originId": string,
  "flightDescription": string,
  "imageUrl": string,
  "destinationName": string,
  "originName": string,
  "flightPrice": string,
  "flightSalePrice": string,
  "formattedPrice": string,
  "formattedSalePrice": string,
  "androidAppLink": string,
  "iosAppLink": string,
  "iosAppStoreId": string,
  "similarDestinationIds": [
    string
  ],
  "customMapping": string
}
Felder
destinationId

string

Erforderlich. Die Ziel-ID kann aus einer beliebigen Folge von Buchstaben und Ziffern bestehen, eindeutig sein und den Werten des Remarketing-Tags entsprechen. Erforderlich.

originId

string

Abreiseort-ID, die aus einer beliebigen Folge aus Buchstaben und Ziffern bestehen kann. Die ID-Sequenz (Ziel-ID + Abflug-ID) muss eindeutig sein.

flightDescription

string

Erforderlich. Flugbeschreibung, z. B. „Buchen Sie Ihr Ticket“. Erforderlich.

imageUrl

string

Bild-URL, z. B. http://www.example.com/image.png Das Bild wird nicht als Bild-Asset hochgeladen.

destinationName

string

Name des Ziels, z. B. Paris

originName

string

Name des Abreiseorts, z. B. London.

flightPrice

string

Flugpreis, der aus einer Zahl gefolgt vom alphabetischen Währungscode gemäß ISO-4217-Standard besteht. Verwenden Sie „.“ als Dezimalzeichen, z. B. 100.00 EUR.

flightSalePrice

string

Sonderangebotspreis für Flug, bestehend aus einer Zahl gefolgt vom alphabetischen Währungscode gemäß ISO-4217-Standard. Verwenden Sie „.“ als Dezimalzeichen, z. B. 80.00 EUR. Muss kleiner als das Feld „flightPrice“ sein.

formattedPrice

string

Formatierter Preis, der beliebige Zeichen enthalten kann. Wenn festgelegt, wird dieses Attribut anstelle von „price“ verwendet, z. B. „Ab 100 €“.

formattedSalePrice

string

Formatierter Sonderangebotspreis, der beliebige Zeichen enthalten kann. Wenn dieses Attribut festgelegt ist, wird es anstelle von „Sonderangebotspreis“ verwendet, z. B. „Im Angebot für 80 €“.

iosAppStoreId

string (int64 format)

iOS App Store-ID Hiermit wird vor Verwendung eines Deeplinks geprüft, ob der Nutzer die App auf seinem Gerät installiert hat. Wenn dieses Feld festgelegt ist, muss auch das Feld „iosAppLink“ vorhanden sein.

similarDestinationIds[]

string

Ähnliche Ziel-IDs, z. B. PAR,LON.

customMapping

string

Ein benutzerdefiniertes Feld, das mehrere Schlüssel zu Werten enthalten kann, getrennt durch Trennzeichen („,“, „|“ und ":"), im Format „: , , ... , | : , ... , | ... | : , ... ,“, z. B. WLAN: die meisten | Luftfahrzeug: 320, 77W | Flüge: 320, 77W | Flüge: 42 | 77W | Flüge: 42 | 77W | Flüge: 42 |:{/10:

DiscoveryCarouselCardAsset

Ein Asset für die Discovery-Karussell-Karte

JSON-Darstellung
{
  "marketingImageAsset": string,
  "squareMarketingImageAsset": string,
  "portraitMarketingImageAsset": string,
  "headline": string,
  "callToActionText": string
}
Felder
marketingImageAsset

string

Asset-Ressourcenname des verknüpften 1,91:1-Marketingbilds. Dieses Asset und/oder ein quadratisches Marketingbild-Asset ist erforderlich.

squareMarketingImageAsset

string

Name der Asset-Ressource des zugehörigen quadratischen Marketingbilds. Dieses Asset und/oder ein Marketingbild-Asset ist erforderlich.

portraitMarketingImageAsset

string

Asset-Ressourcenname des zugehörigen Marketingbilds im Hochformat im 4:5-Format.

headline

string

Erforderlich. Überschrift der Karussellkarte.

callToActionText

string

Call-to-Action-Text.

DynamicTravelAsset

Ein dynamisches Asset für die Reisebranche.

JSON-Darstellung
{
  "destinationId": string,
  "originId": string,
  "title": string,
  "destinationName": string,
  "destinationAddress": string,
  "originName": string,
  "price": string,
  "salePrice": string,
  "formattedPrice": string,
  "formattedSalePrice": string,
  "category": string,
  "contextualKeywords": [
    string
  ],
  "similarDestinationIds": [
    string
  ],
  "imageUrl": string,
  "androidAppLink": string,
  "iosAppLink": string,
  "iosAppStoreId": string
}
Felder
destinationId

string

Erforderlich. Die Ziel-ID kann aus einer beliebigen Folge von Buchstaben und Ziffern bestehen, eindeutig sein und den Werten des Remarketing-Tags entsprechen. Erforderlich.

originId

string

Abreiseort-ID, die aus einer beliebigen Folge aus Buchstaben und Ziffern bestehen kann. Die ID-Sequenz (Ziel-ID + Abflug-ID) muss eindeutig sein.

title

string

Erforderlich. Titel, z. B. „Zugticket buchen“. Erforderlich.

destinationName

string

Name des Ziels, z. B. Paris

destinationAddress

string

Zieladresse, die in einem der folgenden Formate angegeben werden kann. (1) Stadt, Bundesland, Code, Land, z. B. Mountain View, CA, USA. (2) Vollständige Adresse, zum Beispiel 123 Boulevard St, Mountain View, CA 94043, USA. (3) Breiten- und Längengrad im DDD-Format, z. B. 41.40338, 2.17403.

originName

string

Name des Abreiseorts, z. B. London.

price

string

Preis, der eine Zahl gefolgt vom alphabetischen Währungscode gemäß ISO-4217-Standard sein kann. Verwenden Sie „.“ als Dezimalzeichen, z. B. 100.00 EUR.

salePrice

string

Sonderangebotspreis, der aus einer Zahl gefolgt vom alphabetischen Währungscode gemäß ISO 4217-Standard besteht. Verwenden Sie „.“ als Dezimalzeichen, z. B. 80.00 EUR. Der Wert muss kleiner als das Feld „Preis“ sein.

formattedPrice

string

Formatierter Preis, der beliebige Zeichen enthalten kann. Wenn festgelegt, wird dieses Attribut anstelle von „price“ verwendet, z. B. „Ab 100 €“.

formattedSalePrice

string

Formatierter Sonderangebotspreis, der beliebige Zeichen enthalten kann. Wenn dieses Attribut festgelegt ist, wird es anstelle von „Sonderangebotspreis“ verwendet, z. B. „Im Angebot für 80 €“.

category

string

Kategorie, zum Beispiel Express

contextualKeywords[]

string

Kontextbezogene Keywords, z. B. „Pariser Züge“

similarDestinationIds[]

string

Ähnliche Ziel-IDs, z. B. „Hamburg“.

imageUrl

string

Bild-URL, z. B. http://www.example.com/image.png Das Bild wird nicht als Bild-Asset hochgeladen.

iosAppStoreId

string (int64 format)

iOS App Store-ID Hiermit wird vor Verwendung eines Deeplinks geprüft, ob der Nutzer die App auf seinem Gerät installiert hat. Wenn dieses Feld festgelegt ist, muss auch das Feld „iosAppLink“ vorhanden sein.

DynamicLocalAsset

Ein dynamisches lokales Asset.

JSON-Darstellung
{
  "dealId": string,
  "dealName": string,
  "subtitle": string,
  "description": string,
  "price": string,
  "salePrice": string,
  "imageUrl": string,
  "address": string,
  "category": string,
  "contextualKeywords": [
    string
  ],
  "formattedPrice": string,
  "formattedSalePrice": string,
  "androidAppLink": string,
  "similarDealIds": [
    string
  ],
  "iosAppLink": string,
  "iosAppStoreId": string
}
Felder
dealId

string

Erforderlich. Deal-ID, die aus einer beliebigen Folge aus Buchstaben und Ziffern bestehen kann, eindeutig sein und den Werten des Remarketing-Tags entsprechen muss. Erforderlich.

dealName

string

Erforderlich. Name des Angebots, z. B. „50% Rabatt bei „Mustermarkt“ Erforderlich.

subtitle

string

Untertitel, zum Beispiel „Lebensmittel“.

description

string

Beschreibung, z. B. „Einsparungen bei Ihrer wöchentlichen Rechnung“.

price

string

Preis, der eine Zahl gefolgt vom alphabetischen Währungscode gemäß ISO-4217-Standard sein kann. Verwenden Sie „.“ als Dezimalzeichen, z. B. 100.00 EUR.

salePrice

string

Sonderangebotspreis, bestehend aus einer Zahl gefolgt vom alphabetischen Währungscode gemäß ISO-4217-Norm. Verwenden Sie „.“ als Dezimalzeichen, z. B. 80.00 EUR. Der Wert muss kleiner als das Feld „Preis“ sein.

imageUrl

string

Bild-URL, z. B. http://www.example.com/image.png Das Bild wird nicht als Bild-Asset hochgeladen.

address

string

Adresse, die in einem der folgenden Formate angegeben werden kann. (1) Stadt, Bundesland, Code, Land, z. B. Mountain View, CA, USA. (2) Vollständige Adresse, zum Beispiel 123 Boulevard St, Mountain View, CA 94043, USA. (3) Breiten- und Längengrad im DDD-Format, z. B. 41.40338, 2.17403.

category

string

Kategorie, zum Beispiel Lebensmittel.

contextualKeywords[]

string

Kontextbezogene Keywords, z. B. „Lebensmittelgutscheine sparen“

formattedPrice

string

Formatierter Preis, der beliebige Zeichen enthalten kann. Wenn festgelegt, wird dieses Attribut anstelle von „price“ verwendet, z. B. „Ab 100 €“.

formattedSalePrice

string

Formatierter Sonderangebotspreis, der beliebige Zeichen enthalten kann. Wenn dieses Attribut festgelegt ist, wird es anstelle von „Sonderangebotspreis“ verwendet, z. B. „Im Angebot für 80 €“.

similarDealIds[]

string

Ähnliche Deal-IDs, z. B. 1275.

iosAppStoreId

string (int64 format)

iOS App Store-ID Hiermit wird vor Verwendung eines Deeplinks geprüft, ob der Nutzer die App auf seinem Gerät installiert hat. Wenn dieses Feld festgelegt ist, muss auch das Feld „iosAppLink“ vorhanden sein.

DynamicJobsAsset

Ein Asset für dynamische Stellenangebote.

JSON-Darstellung
{
  "jobId": string,
  "locationId": string,
  "jobTitle": string,
  "jobSubtitle": string,
  "description": string,
  "imageUrl": string,
  "jobCategory": string,
  "contextualKeywords": [
    string
  ],
  "address": string,
  "salary": string,
  "androidAppLink": string,
  "similarJobIds": [
    string
  ],
  "iosAppLink": string,
  "iosAppStoreId": string
}
Felder
jobId

string

Erforderlich. Stellen-ID. Diese kann eine beliebige Folge aus Buchstaben und Ziffern sein, eindeutig sein und den Werten des Remarketing-Tags entsprechen. Erforderlich.

locationId

string

Standort-ID, die aus einer beliebigen Folge von Buchstaben und Ziffern bestehen kann. Die ID-Sequenz (Job-ID + Standort-ID) muss eindeutig sein.

jobTitle

string

Erforderlich. Position, zum Beispiel Softwareentwickler. Erforderlich.

jobSubtitle

string

Unterüberschrift der Stelle, z. B. Stufe II.

description

string

Beschreibung, z. B. „Wenden Sie Ihre technischen Fähigkeiten an.“

imageUrl

string

Bild-URL, z. B. http://www.example.com/image.png Das Bild wird nicht als Bild-Asset hochgeladen.

jobCategory

string

Jobkategorie, z. B. „Technisch“.

contextualKeywords[]

string

Kontextbezogene Schlüsselwörter, z. B. „Softwareentwickler Job“.

address

string

Adresse, die in einem der folgenden Formate angegeben werden kann. (1) Stadt, Bundesland, Code, Land, z. B. Mountain View, CA, USA. (2) Vollständige Adresse, zum Beispiel 123 Boulevard St, Mountain View, CA 94043, USA. (3) Breiten- und Längengrad im DDD-Format, z. B. 41.40338, 2.17403.

salary

string

Gehalt zum Beispiel 100.000 €.

similarJobIds[]

string

Ähnliche Job-IDs, z. B. 1275.

iosAppStoreId

string (int64 format)

iOS App Store-ID Hiermit wird vor Verwendung eines Deeplinks geprüft, ob der Nutzer die App auf seinem Gerät installiert hat. Wenn dieses Feld festgelegt ist, muss auch das Feld „iosAppLink“ vorhanden sein.

LocationAsset

Ein Standort-Asset

JSON-Darstellung
{
  "placeId": string,
  "businessProfileLocations": [
    {
      object (BusinessProfileLocation)
    }
  ],
  "locationOwnershipType": enum (LocationOwnershipType)
}
Felder
placeId

string

Mit einer Orts-ID wird ein Ort in der Google Places-Datenbank und in Google Maps eindeutig identifiziert. Dieses Feld ist für eine bestimmte Kundennummer und einen Asset-Typ eindeutig. Weitere Informationen zur Orts-ID finden Sie unter https://developers.google.com/places/web-service/place-id.

businessProfileLocations[]

object (BusinessProfileLocation)

Die Liste der Standorte des Kunden. Dieser Parameter wird nur zurückgegeben, wenn das Standort-Asset mit dem Unternehmensprofil-Konto synchronisiert wird. Es ist möglich, dass mehrere Google Unternehmensprofil-Einträge im selben Konto auf dieselbe Orts-ID verweisen.

locationOwnershipType

enum (LocationOwnershipType)

Die Art der Inhaberschaft für den Standort. Wenn der Typ BUSINESS_OWNER ist, wird er als Standorterweiterung bereitgestellt. Beim Typ „AFFILIATE“ wird er als Affiliate-Standort bereitgestellt.

BusinessProfileLocation

Die Standortdaten des Unternehmensprofils wurden aus dem verknüpften Unternehmensprofil-Konto synchronisiert.

JSON-Darstellung
{
  "labels": [
    string
  ],
  "storeCode": string,
  "listingId": string
}
Felder
labels[]

string

Der Werbetreibende hat ein Label für den Standort im Unternehmensprofil-Konto angegeben. Diese Daten werden mit dem Unternehmensprofil-Konto synchronisiert.

storeCode

string

Geschäftscode des Unternehmensprofils dieses Standorts. Diese Daten werden mit dem Unternehmensprofil-Konto synchronisiert.

listingId

string (int64 format)

Eintrags-ID dieses Unternehmensprofil-Standorts. Diese Angaben werden über das verknüpfte Unternehmensprofil-Konto synchronisiert.

HotelPropertyAsset

Ein Hotelunterkunfts-Asset.

JSON-Darstellung
{
  "placeId": string,
  "hotelAddress": string,
  "hotelName": string
}
Felder
placeId

string

Mit einer Orts-ID wird ein Ort in der Google Places-Datenbank und in Google Maps eindeutig identifiziert. Weitere Informationen finden Sie unter https://developers.google.com/places/web-service/place-id.

hotelAddress

string

Die Adresse des Hotels. Schreibgeschützt.

hotelName

string

Name des Hotels. Schreibgeschützt.