Die vorherige Search Ads 360 Reporting API wird eingestellt und am 30. Juni 2024 außer Betrieb genommen. Die Search Ads 360 Conversion API ist davon nicht betroffen und wird weiterhin unterstützt. Verwenden Sie bei jeder neuen Berichterstellung die neue Search Ads 360 Reporting API.

Ab April 2024 wird beim Anfordern eines Berichts der Fehler „Nicht unterstützte ApiVersion“ zurückgegeben. Weitere Informationen

Außerdem empfehlen wir Ihnen dringend, alle vorhandenen Search Ads 360-Implementierungen zur neuen API zu migrieren. Weitere Informationen finden Sie unter Erste Schritte und im Migrationsleitfaden zur neuen Search Ads 360 Reporting API.

Diese Seite wurde von der Cloud Translation API übersetzt.

Conversion

Die Conversion-Ressource verfügt über Methoden, mit denen Nutzer Floodlight-Conversions im Bulk erstellen, ändern und abrufen können.

Am Ende dieser Seite finden Sie eine Liste der Methoden für diese Ressource.

Ressourcendarstellungen

Eine Liste der Conversions.

{
  "kind": "doubleclicksearch#conversionList",
  "conversion": [
    {
      "agencyId": long,
      "advertiserId": long,
      "engineAccountId": long,
      "campaignId": long,
      "customerId": string,
      "adGroupId": long,
      "criterionId": long,
      "adId": long,
      "clickId": string,
      "dsConversionId": long,
      "conversionId": string,
      "state": string,
      "type": string,
      "revenueMicros": long,
      "currencyCode": string,
      "quantityMillis": long,
      "segmentationType": string,
      "segmentationId": long,
      "segmentationName": string,
      "conversionTimestamp": unsigned long,
      "conversionModifiedTimestamp": unsigned long,
      "floodlightOrderId": string,
      "customMetric": [
        {
          "name": string,
          "value": double
        }
      ],
      "customDimension": [
        {
          "name": string,
          "value": string
        }
      ],
      "countMillis": long,
      "attributionModel": string,
      "productGroupId": long,
      "inventoryAccountId": long,
      "productId": string,
      "productCountry": string,
      "productLanguage": string,
      "channel": string,
      "storeId": string,
      "deviceType": string,
      "adUserDataConsent": string
    }
  ]
}

Property-Name	Wert	Beschreibung	Hinweise
`conversion[]`	`list`	Die angeforderten Conversions.
`conversion[].adGroupId`	`long`	DS-Anzeigengruppen-ID.
`conversion[].adId`	`long`	DS-Anzeigen-ID.
`conversion[].adUserDataConsent`	`string`	Einwilligung für die Einstellungen der wichtigsten Plattformdienste (CPS). Kein Standardwert. Zulässige Werte: GRANTED: Der gewünschte Einwilligungsstatus ist „Erteilt“. Die CPS-Einstellungen in den GTE-Einstellungen lesen. VERWEIGERT: Der gewünschte Einwilligungsstatus ist „Abgelehnt“. Die CPS-Liste ist leer.
`conversion[].advertiserId`	`long`	DS-Werbetreibenden-ID.
`conversion[].agencyId`	`long`	DS-Agentur-ID.
`conversion[].attributionModel`	`string`	Nur für Werbetreibende verfügbar, nachdem sie sich an den DoubleClick Search-Kundensupport gewendet haben.
`conversion[].campaignId`	`long`	DS-Kampagnen-ID.
`conversion[].channel`	`string`	Vertriebskanal für das Produkt. Zulässige Werte: „`local`“: ein Ladengeschäft „`online`“: ein Onlineshop
`conversion[].clickId`	`string`	DS-Klick-ID für die Conversion.
`conversion[].conversionId`	`string`	Bei Offline-Conversions geben Werbetreibende diese ID an. Werbetreibende können eine beliebige ID angeben, die für sie von Bedeutung ist. Für jede Conversion in einer Anfrage muss eine eindeutige ID angegeben werden, und die Kombination aus ID und Zeitstempel muss unter allen Conversions des Werbetreibenden eindeutig sein. Bei Online-Conversions kopiert DS abhängig von den Floodlight-Anweisungen des Werbetreibenden `dsConversionId` oder `floodlightOrderId` in diese Property.
`conversion[].conversionModifiedTimestamp`	`unsigned long`	Zeitpunkt, zu dem die Conversion zuletzt geändert wurde, in Millisekunden der Epoche (UTC).
`conversion[].conversionTimestamp`	`unsigned long`	Der Zeitpunkt, zu dem die Umwandlung stattgefunden hat, in Millisekunden der Epoche (UTC).
`conversion[].countMillis`	`long`	Nur für Werbetreibende verfügbar, nachdem sie sich an den DoubleClick Search-Kundensupport gewendet haben.
`conversion[].criterionId`	`long`	ID des DS-Kriteriums (Keyword).
`conversion[].currencyCode`	`string`	Der Währungscode für den Umsatz der Conversion. Sollte im alphabetischen ISO 4217-Format (3-Zeichen) vorliegen.	Bearbeitbar
`conversion[].customDimension[]`	`list`	Benutzerdefinierte Dimensionen für die Conversion, mit denen Daten in einem Bericht gefiltert werden können.
`conversion[].customDimension[].name`	`string`	Name der benutzerdefinierten Dimension.
`conversion[].customDimension[].value`	`string`	Wert der benutzerdefinierten Dimension.
`conversion[].customMetric[]`	`list`	Benutzerdefinierte Messwerte für die Conversion.
`conversion[].customMetric[].name`	`string`	Name des benutzerdefinierten Messwerts.
`conversion[].customMetric[].value`	`double`	Numerischer Wert des benutzerdefinierten Messwerts.
`conversion[].customerId`	`string`	Neue Search Ads 360-Kundennummer. Muss ein Kundenkonto sein. Wenn dieses Feld festgelegt ist, sollten alle anderen ID-Felder auf neue Search Ads 360-IDs festgelegt werden.
`conversion[].deviceType`	`string`	Die Art des Geräts, auf dem die Conversion erfolgt ist Zulässige Werte sind: <ph type="x-smartling-placeholder"> </ph> „`DESKTOP`“ „`HIGH_END_MOBILE`“ „`OTHER_DEVICE`“ „`TABLET`“
`conversion[].dsConversionId`	`long`	ID, die DoubleClick Search für jede Conversion generiert.
`conversion[].engineAccountId`	`long`	DS-Engine-Konto-ID.
`conversion[].floodlightOrderId`	`string`	Die ID des Floodlight-Auftrags, der vom Werbetreibenden für die Conversion bereitgestellt wurde.
`conversion[].inventoryAccountId`	`long`	ID, die von DS generiert und verwendet wird, um das Inventarkonto, das das Produkt enthält, eindeutig zu identifizieren.
`conversion[].productCountry`	`string`	Das Land, das für den Merchant Center-Feed registriert ist, in dem das Produkt enthalten ist. Verwenden Sie zur Angabe eines Landes einen ISO 3166-Code.
`conversion[].productGroupId`	`long`	DS-Produktgruppen-ID.
`conversion[].productId`	`string`	Die Produkt-ID (SKU).
`conversion[].productLanguage`	`string`	Die Sprache, die für den Merchant Center-Feed registriert ist, in dem das Produkt enthalten ist. Verwenden Sie einen ISO-639-Code, um eine Sprache anzugeben.
`conversion[].quantityMillis`	`long`	Die Menge dieser Conversion in Millisekunden.	Bearbeitbar
`conversion[].revenueMicros`	`long`	Der Umsatzbetrag dieser `TRANSACTION`-Conversion in Mikros (Wert multipliziert mit 1.000.000, keine Dezimalzahl). Um beispielsweise einen Umsatzwert von „10“ anzugeben, Geben Sie „10000000“ ein (10 Millionen) in Ihrer Anfrage.	Bearbeitbar
`conversion[].segmentationId`	`long`	Die numerische Segmentierungs-ID, z. B. die ID der DoubleClick Search-Floodlight-Aktivität
`conversion[].segmentationName`	`string`	Die nutzerfreundliche Segmentierungs-ID, z. B. der Name der DoubleClick Search-Floodlight-Aktivität.
`conversion[].segmentationType`	`string`	Der Segmentierungstyp dieser Conversion, z. B. `FLOODLIGHT`. Zulässige Werte sind: <ph type="x-smartling-placeholder"> </ph> „`FLOODLIGHT`“
`conversion[].state`	`string`	Der Status der Conversion, also entweder `ACTIVE` oder `REMOVED`. Hinweis: Der Status DELETED ist veraltet. Zulässige Werte sind: <ph type="x-smartling-placeholder"> </ph> „`ACTIVE`“ "`DELETED`": (eingestellt) „`REMOVED`“	Bearbeitbar
`conversion[].storeId`	`string`	Die ID des lokalen Geschäfts, in dem das Produkt beworben wurde. Gilt nur für den Kanal „`local`“.
`conversion[].type`	`string`	Der Typ der Conversion, also entweder `ACTION` oder `TRANSACTION`. Eine `ACTION`-Conversion ist eine Aktion des Nutzers, die keinen monetär quantifizierbaren Wert hat, während eine `TRANSACTION`-Conversion eine Aktion ist, die einen monetär quantifizierbaren Wert hat. Beispiele: Registrierungen für E-Mail-Listen (`ACTION`) im Vergleich zu E-Commerce-Käufen (`TRANSACTION`). Zulässige Werte sind: <ph type="x-smartling-placeholder"> </ph> „`ACTION`“ „`TRANSACTION`“
`kind`	`string`	Kennzeichnet dies als ConversionList-Ressource. Wert: der feste String `doubleclicksearch#conversionList`.

Methoden

get: Ruft eine Liste der Conversions aus einem DoubleClick Search-Engine-Konto ab.
getByCustomerId: Ruft eine Liste der Conversions aus einem DoubleClick Search-Engine-Konto mit einer neuen Search Ads 360-Kundennummer ab.
insert: Fügt einen Batch neuer Conversions in DoubleClick Search ein.
Update: Aktualisiert einen Batch von Conversions in DoubleClick Search.
updateAvailability: Aktualisiert die Verfügbarkeit eines Batches von Floodlight-Aktivitäten in DoubleClick Search