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`	Angeforderte Conversions.
`conversion[].adGroupId`	`long`	DS-Anzeigengruppen-ID.
`conversion[].adId`	`long`	DS-Anzeigen-ID
`conversion[].adUserDataConsent`	`string`	Stellt die Einwilligung für die Einstellungen der Hauptdienste für die Plattformdienste (CPS) in den Einstellungen dar. Kein Standardwert. Zulässige Werte: GRANTED: Der gewünschte Einwilligungsstatus ist „Grant“. Lesen Sie die CPS-Einstellungen in den GTE-Einstellungen. DENIED: Der gewünschte Einwilligungsstatus lautet „Ablehnen“. 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 sind: „`local`“: ein Ladengeschäft „`online`“: Onlineshop
`conversion[].clickId`	`string`	DS-Klick-ID für die Conversion.
`conversion[].conversionId`	`string`	Für Offline-Conversions geben Werbetreibende diese ID an. Werbetreibende können eine beliebige ID angeben, die für sie aussagekräftig ist. Für jede Conversion in einer Anfrage muss eine eindeutige ID angegeben werden. Außerdem muss die Kombination aus ID und Zeitstempel unter allen Conversions innerhalb des Werbetreibenden eindeutig sein. Bei Online-Conversions kopiert DS `dsConversionId` oder `floodlightOrderId` abhängig von den Floodlight-Anweisungen des Werbetreibenden in diese Property.
`conversion[].conversionModifiedTimestamp`	`unsigned long`	Der Zeitpunkt, zu dem die Conversion zuletzt geändert wurde, in Millis (UTC) der Epoche.
`conversion[].conversionTimestamp`	`unsigned long`	Der Zeitpunkt, zu dem die Umwandlung stattgefunden hat, in Millis (UTC) der Epoche.
`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`	Benutzerdefinierter Dimensionswert.
`conversion[].customMetric[]`	`list`	Benutzerdefinierte Messwerte für die Conversion.
`conversion[].customMetric[].name`	`string`	Name des benutzerdefinierten Messwerts.
`conversion[].customMetric[].value`	`double`	Benutzerdefinierter Messwert – numerischer Wert
`conversion[].customerId`	`string`	Neue Search Ads 360-Kundennummer. Es muss sich um ein Kundenkonto handeln. 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: "`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, der das Produkt enthält. 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, der das Produkt enthält. Verwenden Sie zur Festlegung der Sprache einen ISO 639-Code.
`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 den Umsatzwert „10“ festzulegen, geben Sie in Ihrer Anfrage „10000000“ (10 Millionen) ein.	Bearbeitbar
`conversion[].segmentationId`	`long`	Die numerische Segmentierungs-ID, z. B. die ID der Floodlight-Aktivität in DoubleClick Search
`conversion[].segmentationName`	`string`	Die nutzerfreundliche Segmentierungs-ID, z. B. der Name der Floodlight-Aktivität in DoubleClick Search
`conversion[].segmentationType`	`string`	Segmentierungstyp dieser Conversion (z. B. `FLOODLIGHT`). Zulässige Werte sind: "`FLOODLIGHT`"
`conversion[].state`	`string`	Der Status der Conversion, also entweder `ACTIVE` oder `REMOVED`. Hinweis: Der Status DELETED wurde eingestellt. Zulässige Werte sind: "`ACTIVE`" "`DELETED`": (Eingestellt) "`REMOVED`"	Bearbeitbar
`conversion[].storeId`	`string`	Die ID des lokalen Geschäfts, für das das Produkt beworben wurde. Gilt nur, wenn der Kanal „`local`“ ist.
`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 mit einem monetär quantifizierbaren Wert ist. Beispiele sind Anmeldungen für E-Mail-Listen (`ACTION`) im Vergleich zu E-Commerce-Käufen (`TRANSACTION`). Zulässige Werte sind: "`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 mithilfe einer neuen Search Ads 360-Kundennummer eine Liste der Conversions aus einem DoubleClick Search-Engine-Konto ab.
insert: Ein Batch neuer Conversions wird in DoubleClick Search eingefügt.
Update: Aktualisiert einen Batch von Conversions in DoubleClick Search.
updateAvailability: Aktualisiert die Verfügbarkeit einer Reihe von Floodlight-Aktivitäten in DoubleClick Search.