Conversion

Die Conversion-Ressource bietet Methoden, mit denen Nutzer Floodlight-Conversions im Bulk-Verfahren erstellen, ändern und abrufen können. 

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

Ressourcendarstellungen

Eine Liste von 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,
      "sessionAttributesEncoded": bytes
    }
  ]
}
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 Stellt die Einwilligung in die Einstellungen für die zentralen Plattformdienste (CPS) dar. Kein Standardwert. Zulässige Werte sind: GEWÄHRT: Der gewünschte Einwilligungsstatus ist „Gewähren“. Lies die CPS-Einstellungen aus den GTE-Einstellungen. DENIED: Der gewünschte Einwilligungsstatus ist „Ablehnen“ und die CPS-Liste ist leer.

Zulässige Werte sind:
  • „DENIED“
  • „GRANTED“
  • „UNKNOWN“
conversion[].advertiserId long DS-Werbetreibenden-ID.
conversion[].agencyId long DS-Agentur-ID.
conversion[].attributionModel string Nur für Werbetreibende verfügbar, die sich an den DoubleClick Search-Kundensupport gewandt haben.
conversion[].campaignId long DS: Kampagnen-ID.
conversion[].channel string Vertriebskanal für das Produkt. Zulässige Werte sind:
  • „local“: ein Ladengeschäft
  • „online“: ein Onlineshop
conversion[].clickId string DS-Klick-ID für die Conversion.
conversion[].conversionId string Bei Offline-Conversions wird diese ID von Werbetreibenden angegeben. Werbetreibende können eine beliebige ID angeben, die für sie sinnvoll ist. Für jede Conversion in einer Anfrage muss eine eindeutige ID angegeben werden. Die Kombination aus ID und Zeitstempel muss für alle Conversions des Werbetreibenden eindeutig sein.
Bei Online-Conversions kopiert DS die dsConversionId oder floodlightOrderId in diese Property, je nach Floodlight-Anweisungen des Werbetreibenden.
conversion[].conversionModifiedTimestamp unsigned long Zeitpunkt, zu dem die Conversion zuletzt geändert wurde, in Millisekunden seit der Epoche (UTC)
conversion[].conversionTimestamp unsigned long Die Uhrzeit, zu der die Conversion stattgefunden hat, in Epochenmillisekunden (UTC).
conversion[].countMillis long Nur für Werbetreibende verfügbar, die sich an den DoubleClick Search-Kundensupport gewandt haben.
conversion[].criterionId long Die ID des DS-Kriteriens (Keywords).
conversion[].currencyCode string Der Währungscode für den Conversion-Umsatz. Muss im alphabetischen ISO 4217-Format (3-Zeichen) angegeben werden. 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 Die Kundennummer der neuen Search Ads 360-Version. Es muss sich um ein Kundenkonto handeln. Wenn dieses Feld festgelegt ist, sollten alle anderen ID-Felder auf neue Search Ads 360-IDs festgelegt sein.
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 von DoubleClick Search für jede Conversion generiert wird.
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 einen ISO 3166-Code, um ein Land anzugeben.
conversion[].productGroupId long DS-Produktgruppen-ID.
conversion[].productId string Die Produkt-ID (Artikelnummer).
conversion[].productLanguage string Die Sprache, die für den Merchant Center-Feed registriert ist, der das Produkt enthält. Verwenden Sie einen ISO 639-Code, um eine Sprache anzugeben.
conversion[].quantityMillis long Die Menge dieser Conversion in Millis. Bearbeitbar
conversion[].revenueMicros long Der Umsatz aus dieser TRANSACTION-Conversion in Mikros (Wert multipliziert mit 1.000.000, keine Dezimalstellen). Wenn Sie beispielsweise einen Umsatzwert von „10“ angeben möchten, geben Sie „10000000“ (10 Millionen) in Ihre Anfrage ein. Bearbeitbar
conversion[].segmentationId long Die numerische Segmentierungskennung (z. B. die ID der DoubleClick Search-Floodlight-Aktivität).
conversion[].segmentationName string Die freundliche Segmentierungskennung (z. B. der Name der DoubleClick Search-Floodlight-Aktivität).
conversion[].segmentationType string Der Segmentierungstyp dieser Conversion (z. B. FLOODLIGHT).

Zulässige Werte:
  • „FLOODLIGHT“
conversion[].sessionAttributesEncoded bytes Die Sitzungsattribute für das Ereignis, dargestellt als base64-codierter JSON-String. Die Inhalte müssen von der von Google bereitgestellten Bibliothek generiert werden.
conversion[].state string Der Status der Conversion, also entweder ACTIVE oder REMOVED. Hinweis: Der Status „DELETED“ (Gelöscht) wird nicht mehr unterstützt.

Zulässige Werte sind:
  • „ACTIVE“
  • „DELETED“:  (veraltet)
  • „REMOVED“
 Bearbeitbar
conversion[].storeId string Die ID des lokalen Händlers, für den 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. Eine TRANSACTION-Conversion ist eine Aktion, die einen monetär quantifizierbaren Wert hat. Beispiele sind Anmeldungen für E-Mail-Listen (ACTION) und E-Commerce-Käufe (TRANSACTION).

Zulässige Werte sind:
  • „ACTION“
  • „TRANSACTION“
kind string Hiermit wird angegeben, dass es sich um eine ConversionList-Ressource handelt. Wert: der feste String doubleclicksearch#conversionList.

Methoden

get
Liefert eine Liste von Conversions aus einem DoubleClick Search-Engine-Konto zurück.
getByCustomerId
Eine Liste von Conversions wird mit einer neuen Search Ads 360-Kundennummer aus einem DoubleClick Search-Engine-Konto abgerufen.
insert
Fügt eine Reihe neuer Conversions in DoubleClick Search ein.
aktualisieren
Aktualisiert eine Gruppe von Conversions in DoubleClick Search.
updateAvailability
Aktualisiert die Verfügbarkeiten eines Batches von Floodlight-Aktivitäten in DoubleClick Search.