Method: adEvents.ingest

Lädt eine Liste von AdEvent-Ressourcen in Google Analytics hoch.

Diese Funktion ist nur für Konten auf einer Zulassungsliste verfügbar.

HTTP-Anfrage

POST https://datamanager.googleapis.com/v1/adEvents:ingest

Die URL verwendet die Syntax der gRPC-Transcodierung.

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung 
{
  "adEvents": [
    {
      object (AdEvent)
    }
  ],
  "encryptionInfo": {
    object (EncryptionInfo)
  },
  "validateOnly": boolean
}
Felder
adEvents[]

object (AdEvent)

Erforderlich. Erforderlich (mindestens 1). Eine Liste mit Werbeereignissen.
encryptionInfo

object (EncryptionInfo)

Optional. Informationen zu Verschlüsselungsschlüsseln, die zum Verschlüsseln der Daten verwendet werden.
validateOnly

boolean

Optional. Wenn „true“, wird die Anfrage validiert, aber nicht ausgeführt.

Antworttext

Wenn der Vorgang erfolgreich ist, ist der Antworttext leer.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/datamanager

AdEvent

Ein Anzeigenereignis.

JSON-Darstellung 
{
  "advertiserId": string,
  "eventType": enum (EventType),
  "timestamp": string,
  "eventId": string,
  "userData": {
    object (UserData)
  },
  "deviceInfo": {
    object (DeviceInfo)
  },
  "mobileDeviceId": string,
  "campaignId": string,
  "campaignName": string,
  "adGroupId": string,
  "adId": string,
  "adHeight": integer,
  "adWidth": integer,
  "regionCode": string,
  "source": string,
  "medium": string,
  "attributionHint": enum (AttributionHint),
  "viewabilityInfo": {
    object (ViewabilityInfo)
  },

  // Union field event_subtype_oneof can be only one of the following:
  "eventSubtype": enum (EventSubtype),
  "eventSubtypeString": string
  // End of list of possible types for union field event_subtype_oneof.

  // Union field ad_type_oneof can be only one of the following:
  "adType": enum (AdType),
  "adTypeString": string
  // End of list of possible types for union field ad_type_oneof.

  // Union field ad_format_oneof can be only one of the following:
  "adFormat": enum (AdFormat),
  "adFormatString": string
  // End of list of possible types for union field ad_format_oneof.

  // Union field ad_placement_oneof can be only one of the following:
  "adPlacement": enum (AdPlacement),
  "adPlacementString": string
  // End of list of possible types for union field ad_placement_oneof.

  // Union field targeting_type_oneof can be only one of the following:
  "targetingType": enum (TargetingType),
  "targetingTypeString": string
  // End of list of possible types for union field targeting_type_oneof.

  // Union field platform_type_oneof can be only one of the following:
  "platformType": enum (PlatformType),
  "platformTypeString": string
  // End of list of possible types for union field platform_type_oneof.

  // Union field platform_oneof can be only one of the following:
  "platform": enum (Platform),
  "platformString": string
  // End of list of possible types for union field platform_oneof.
  "measurementAllowed": boolean
}
Felder
advertiserId

string

Erforderlich. Die ID des Werbetreibenden für das Anzeigenereignis.

Sie muss mit der ID übereinstimmen, die im Verknüpfungsprozess gesendet wurde.
eventType

enum (EventType)

Erforderlich. Der Typ des Ereignisses.
timestamp

string (Timestamp format)

Erforderlich. Zeit, zu der das Ereignis aufgetreten ist.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".
eventId

string

Optional. Eine ID, die vom Anrufer erstellt und verwaltet wird und dieses Ereignis eindeutig identifiziert.

Erforderlich, wenn Sie Anzeigenereignisse deduplizieren möchten, die in mehreren Anfragen enthalten sind. Andernfalls ist dieses Feld optional.
userData

object (UserData)

Optional. Mehrere von Nutzern bereitgestellte Daten, die den Nutzer darstellen, mit dem das Ereignis verknüpft ist.

Es ist möglich, mehrere Instanzen desselben Datentyps anzugeben, z.B. mehrere E-Mail-Adressen. Je mehr Daten angegeben werden, desto wahrscheinlicher ist es, dass eine Übereinstimmung gefunden wird.
deviceInfo

object (DeviceInfo)

Optional. Informationen zum Gerät, das zum Zeitpunkt des Anzeigenereignisses verwendet wurde.
mobileDeviceId

string

Optional. Die Geräte-ID des Geräts, auf dem die Anzeige ausgeliefert wurde.
campaignId

string

Erforderlich. Die ID der zugehörigen Kampagne.
campaignName

string

Erforderlich. Der Name der zugehörigen Kampagne.
adGroupId

string

Optional. Die ID der zugehörigen Anzeigengruppe.
adId

string

Optional. Die ID der zugehörigen Anzeige in der Gruppe.
adHeight

integer

Optional. Die Höhe der Anzeige in Pixeln.
adWidth

integer

Optional. Die Breite der Anzeige in Pixeln.
regionCode

string

Erforderlich. Das Land und die Untergruppe gemäß ISO 3166-2.
source

string

Erforderlich. Die Plattformquelle der Anzeige, ähnlich der Google Analytics-Quelle.
medium

string

Erforderlich. Das Medium der Anzeige, ähnlich dem Google Analytics-Medium.
attributionHint

enum (AttributionHint)

Optional. Der vom Partner angenommene Attributionsstatus für dieses Anzeigenereignis.

Dies dient nur als Signal dafür, wie die Attribution aus Sicht des Partners abgelaufen ist, und erzwingt kein Endergebnis in endgültigen Berichten.
viewabilityInfo

object (ViewabilityInfo)

Erforderlich. Details zur Sichtbarkeit der ausgelieferten Anzeige.

Union-Feld event_subtype_oneof. Optional. Zusätzliche Klassifizierung des Anzeigenereignisses.

Es wird ein Rohstring akzeptiert, um andere Werte als die reinen Enums zu verarbeiten. Die Enumeration wird nach Möglichkeit bevorzugt. Für event_subtype_oneof ist nur einer der folgenden Werte zulässig:
eventSubtype

enum (EventSubtype)

Enum-Wert für den Untertyp des Ereignisses.
eventSubtypeString

string

Stringwert für den Ereignisuntertyp.

Union-Feld ad_type_oneof. Optional. Der Typ der ausgelieferten Anzeige.

Es wird ein Rohstring akzeptiert, um andere Werte als die reinen Enums zu verarbeiten. Die Enumeration wird nach Möglichkeit bevorzugt. Für ad_type_oneof ist nur einer der folgenden Werte zulässig:
adType

enum (AdType)

Enum-Wert für den Anzeigentyp.
adTypeString

string

Stringwert für den Anzeigentyp.

Union-Feld ad_format_oneof. Optional. Der Typ der ausgelieferten Anzeige.

Es wird ein Rohstring akzeptiert, um andere Werte als die reinen Enums zu verarbeiten. Die Enumeration wird nach Möglichkeit bevorzugt. Für ad_format_oneof ist nur einer der folgenden Werte zulässig:
adFormat

enum (AdFormat)

Enum-Wert für das Anzeigenformat.
adFormatString

string

Stringwert für das Anzeigenformat.

Union-Feld ad_placement_oneof. Optional. Das Placement der ausgelieferten Anzeige.

Es wird ein Rohstring akzeptiert, um andere Werte als die reinen Enums zu verarbeiten. Die Enumeration wird nach Möglichkeit bevorzugt. Für ad_placement_oneof ist nur einer der folgenden Werte zulässig:
adPlacement

enum (AdPlacement)

Enum-Wert für das Anzeigen-Placement.
adPlacementString

string

Stringwert für das Anzeigen-Placement.

Union-Feld targeting_type_oneof. Optional. Die Art des Targetings, die für die Auslieferung der Anzeige verwendet wurde.

Es wird ein Rohstring akzeptiert, um andere Werte als die reinen Enums zu verarbeiten. Die Enumeration wird nach Möglichkeit bevorzugt. Für targeting_type_oneof ist nur einer der folgenden Werte zulässig:
targetingType

enum (TargetingType)

Enum-Wert für den Targeting-Typ.
targetingTypeString

string

Stringwert für den Targeting-Typ.

Union-Feld platform_type_oneof. Optional. Der Typ der Plattform, auf der die Anzeige ausgeliefert wurde.

Es wird ein Rohstring akzeptiert, um andere Werte als die reinen Enums zu verarbeiten. Die Enumeration wird nach Möglichkeit bevorzugt. Für platform_type_oneof ist nur einer der folgenden Werte zulässig:
platformType

enum (PlatformType)

Enum-Wert für den Plattformtyp.
platformTypeString

string

Stringwert für den Plattformtyp.

Union-Feld platform_oneof. Optional. Weitere Details zur Plattform, auf der die Anzeige ausgeliefert wurde.

Es wird ein Rohstring akzeptiert, um andere Werte als die reinen Enums zu verarbeiten. Die Enumeration wird nach Möglichkeit bevorzugt. Für platform_oneof ist nur einer der folgenden Werte zulässig:
platform

enum (Platform)

Enum-Wert für die Plattform.
platformString

string

Stringwert für die Plattform.
measurementAllowed

boolean

Optional. Gibt an, ob die Zeile gemäß den anwendbaren Datenschutzgesetzen in der regionalen Gerichtsbarkeit für Analysezwecke verwendet werden darf.

EventType

Der Typ des Ereignisses.

Enums
EVENT_TYPE_UNSPECIFIED Nicht angegebener Ereignistyp.
EVENT_TYPE_VIEW Termin ansehen
EVENT_TYPE_CLICK Click-Event

EventSubtype

Zusätzliche Klassifizierung des Anzeigenereignisses.

Enums
EVENT_SUBTYPE_UNSPECIFIED Nicht angegebener Ereignisuntertyp.
EVENT_SUBTYPE_IMPRESSION Impressionsereignis.
EVENT_SUBTYPE_ENGAGED_VIEW Ereignis „Aktive Wiedergabe“.
EVENT_SUBTYPE_ONSITE_CLICK Onsite-Click-Event.
EVENT_SUBTYPE_OUTBOUND_CLICK Ereignis „Klicks auf externe Links“

AdType

Der Typ der ausgelieferten Anzeige.

Enums
AD_TYPE_UNSPECIFIED Nicht angegebener Anzeigentyp.
AD_TYPE_DISPLAY Displayanzeige.
AD_TYPE_TEXT Textanzeige aus.
AD_TYPE_IMAGE Bildanzeige
AD_TYPE_RICH_MEDIA Rich Media-Anzeige
AD_TYPE_HTML HTML-Anzeige
AD_TYPE_AUDIO Audioanzeige.
AD_TYPE_VIDEO Videoanzeige

AdFormat

Das Format der ausgelieferten Anzeige.

Enums
AD_FORMAT_UNSPECIFIED Nicht angegebenes Anzeigenformat.
AD_FORMAT_AR AR-Anzeige
AD_FORMAT_AUDIO Audioanzeige.
AD_FORMAT_BANNER Banneranzeige
AD_FORMAT_BUMPER Bumper-Anzeige
AD_FORMAT_COLLECTION Anzeige aus Sammlung
AD_FORMAT_IMAGE Bildanzeige
AD_FORMAT_INTERACTIVE Interaktive Anzeige.
AD_FORMAT_INTERSTITIAL Interstitial-Anzeige
AD_FORMAT_IN_FEED In-Feed-Anzeige
AD_FORMAT_IN_STREAM In-Stream-Videoanzeige
AD_FORMAT_IN_STREAM_SKIPPABLE Überspringbare In-Stream-Anzeige
AD_FORMAT_IN_STREAM_NON_SKIPPABLE Nicht überspringbare In-Stream-Anzeige
AD_FORMAT_NATIVE Native Anzeige
AD_FORMAT_SHORTS YouTube Shorts-Anzeige.
AD_FORMAT_STORY Story-Anzeige
AD_FORMAT_SPONSORED Gesponserte Anzeige.
AD_FORMAT_VIDEO Videoanzeige

AdPlacement

Das Placement der ausgelieferten Anzeige.

Enums
AD_PLACEMENT_UNSPECIFIED Nicht angegebene Anzeigenplatzierung
AD_PLACEMENT_DISCOVER Placement ermitteln
AD_PLACEMENT_FEED Feed-Platzierung
AD_PLACEMENT_HEADER Platzierung des Headers.
AD_PLACEMENT_HOME Platzierung auf der Startseite.
AD_PLACEMENT_IN_CONTENT In-Content-Placement
AD_PLACEMENT_PROMOTED Gesponserte Platzierung.
AD_PLACEMENT_STORY Platzierung von Geschichten.

TargetingType

Die Art des Targetings, die für die Auslieferung der Anzeige verwendet wurde.

Enums
TARGETING_TYPE_UNSPECIFIED Nicht angegebener Ausrichtungstyp.
TARGETING_TYPE_AUDIENCE Ausrichtung auf Zielgruppen
TARGETING_TYPE_CONTEXTUAL Kontext-Targeting
TARGETING_TYPE_DEMOGRAPHIC Demografisches Targeting
TARGETING_TYPE_DEVICE Geräte-Targeting
TARGETING_TYPE_GEO Geografisches Targeting
TARGETING_TYPE_INTEREST Targeting auf Interessengebiete
TARGETING_TYPE_PURCHASE_INTENT Ausrichtung auf Kaufabsicht
TARGETING_TYPE_REMARKETING Remarketing-Targeting

PlatformType

Der Typ der Plattform, auf der die Anzeige ausgeliefert wurde.

Enums
PLATFORM_TYPE_UNSPECIFIED Nicht angegebener Plattformtyp.
PLATFORM_TYPE_MOBILE Mobile Plattform
PLATFORM_TYPE_DESKTOP Desktop-Plattform
PLATFORM_TYPE_CTV CTV-Plattform.
PLATFORM_TYPE_PHONE Smartphone-Plattform
PLATFORM_TYPE_TABLET Tablet-Plattform

Plattform

Weitere Details zur Plattform, auf der die Anzeige ausgeliefert wurde.

Enums
PLATFORM_UNSPECIFIED Nicht angegebene Plattform.
PLATFORM_IOS iOS-Plattform
PLATFORM_ANDROID Android-Plattform
PLATFORM_WEB Webplattform

AttributionHint

Der vom Partner angenommene Attributionsstatus für dieses Anzeigenereignis.

Enums
ATTRIBUTION_HINT_UNSPECIFIED Unbekannter Attributionsstatus.
ATTRIBUTION_HINT_CONVERTED Status „Konvertiert“
ATTRIBUTION_HINT_NOT_CONVERTED Status „Nicht konvertiert“.

ViewabilityInfo

Details zur Sichtbarkeit der ausgelieferten Anzeige.

JSON-Darstellung 
{
  "viewType": enum (ViewType),
  "viewablePercent": integer,
  "viewableDuration": string,
  "mediaSkippable": boolean,
  "mediaQuartile": enum (MediaQuartile),
  "mediaDuration": string,
  "mediaVolumePercent": integer,
  "playbackDuration": string
}
Felder
viewType

enum (ViewType)

Erforderlich. Der Typ des Ereignisses.
viewablePercent

integer

Optional. Der numerische Prozentsatz (0–100) der sichtbaren Pixel.
viewableDuration

string (Duration format)

Optional. Die Zeit, in der die Anzeige sichtbar war.

Die Dauer in Sekunden mit bis zu neun Nachkommastellen und am Ende mit „s“. Beispiel: "3.5s".
mediaSkippable

boolean

Optional. Gibt an, ob die Anzeigenmedien überspringbar waren.
mediaQuartile

enum (MediaQuartile)

Optional. Die Menge der Medien, die als separate Quartile wiedergegeben wurden.
mediaDuration

string (Duration format)

Optional. Die Dauer der Anzeigenmedien.

Die Dauer in Sekunden mit bis zu neun Nachkommastellen und am Ende mit „s“. Beispiel: "3.5s".
mediaVolumePercent

integer

Optional. Der numerische Prozentsatz (0–100) der Lautstärke der Medienwiedergabe.
playbackDuration

string (Duration format)

Optional. Die Dauer der Wiedergabe der Anzeigenmedien, unabhängig davon, ob sie sichtbar waren.

Die Dauer in Sekunden mit bis zu neun Nachkommastellen und am Ende mit „s“. Beispiel: "3.5s".

ViewType

Der Typ des Ereignisses.

Enums
VIEW_TYPE_UNSPECIFIED Nicht angegebener Ansichtstyp.
VIEW_TYPE_MRC_VIEWED MRC-Ansicht
VIEW_TYPE_MRC_RENDERED MRC-Rendering.

MediaQuartile

Die Menge der Medien, die als separate Quartile wiedergegeben wurden.

Enums
MEDIA_QUARTILE_UNSPECIFIED Nicht angegebenes Media-Quartil.
MEDIA_QUARTILE_START Start.
MEDIA_QUARTILE_FIRST_QUARTILE Erstes Quartil.
MEDIA_QUARTILE_MIDPOINT Mittelpunkt.
MEDIA_QUARTILE_THIRD_QUARTILE Drittes Quartil.
MEDIA_QUARTILE_COMPLETE Abgeschlossen