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:
|
|
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:
|
|
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:
|
|
conversion[].state |
string |
Der Status der Conversion, also entweder ACTIVE oder REMOVED . Hinweis: Der Status DELETED wurde eingestellt.
Zulässige Werte sind:
|
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:
|
|
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.