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