Conversion

Zasób konwersji ma metody, które umożliwiają użytkownikom zbiorcze tworzenie, modyfikowanie i pobieranie konwersji Floodlight.

Listę metod dla tego zasobu znajdziesz na końcu tej strony.

Reprezentacje zasobów

Lista konwersji.

{
  "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
    }
  ]
}
Nazwa usługi Wartość Opis Uwagi
conversion[] list Konwersje, których dotyczy żądanie.
conversion[].adGroupId long Identyfikator grupy reklam DS.
conversion[].adId long Identyfikator reklamy DS.
conversion[].adUserDataConsent string Reprezentuje zgodę na preferencje dotyczące usług podstawowych (CPS) w ustawieniach. Brak wartości domyślnej. Akceptowane wartości: GRANTED, wymagany stan zgody to „Udzielenie”. Przeczytaj preferencje dotyczące CPS z ustawień GTE. ODRZUCONO: pożądany stan zgody to „Odmowa”. Lista CPS jest pusta.
conversion[].advertiserId long Identyfikator reklamodawcy DS.
conversion[].agencyId long Identyfikator agencji w DS.
conversion[].attributionModel string Dostępne dla reklamodawców tylko po skontaktowaniu się z obsługą klienta DoubleClick Search.
conversion[].campaignId long Identyfikator kampanii DS.
conversion[].channel string Kanał sprzedaży produktu. Akceptowane wartości to:
  • „local”: sklep stacjonarny
  • „online”: sklep internetowy
conversion[].clickId string Identyfikator kliknięcia w DS dla konwersji.
conversion[].conversionId string W przypadku konwersji offline reklamodawca podaje ten identyfikator. Reklamodawcy mogą podać dowolny identyfikator, który będzie dla nich odpowiedni. Każda konwersja w żądaniu musi mieć unikalny identyfikator, a kombinacja identyfikatora i sygnatury czasowej musi być niepowtarzalna wśród wszystkich konwersji u reklamodawcy.
W przypadku konwersji online DS kopiuje do tej usługi właściwość dsConversionId lub floodlightOrderId w zależności od instrukcji Floodlight reklamodawcy.
conversion[].conversionModifiedTimestamp unsigned long Czas ostatniej modyfikacji konwersji wyrażony w milisekundach czasu UTC.
conversion[].conversionTimestamp unsigned long Godzina dokonania konwersji podana w milisekundach epoki UTC.
conversion[].countMillis long Dostępne dla reklamodawców tylko po skontaktowaniu się z obsługą klienta DoubleClick Search.
conversion[].criterionId long Identyfikator kryterium (słowa kluczowego) w DS.
conversion[].currencyCode string Kod waluty przychodów z konwersji. Musi być w formacie alfabetycznym ISO 4217 (3 znaki). z możliwością zapisu
conversion[].customDimension[] list Wymiary niestandardowe konwersji, których można używać do filtrowania danych w raporcie.
conversion[].customDimension[].name string Nazwa wymiaru niestandardowego.
conversion[].customDimension[].value string Wartość wymiaru niestandardowego.
conversion[].customMetric[] list Dane niestandardowe konwersji.
conversion[].customMetric[].name string Nazwa danych niestandardowych.
conversion[].customMetric[].value double Niestandardowa wartość liczbowa danych.
conversion[].customerId string Nowy identyfikator klienta Search Ads 360. Musi to być konto klienta. Gdy to pole jest skonfigurowane, we wszystkich innych polach identyfikatorów powinny być ustawione nowe identyfikatory Search Ads 360.
conversion[].deviceType string Typ urządzenia, na którym doszło do konwersji.

Akceptowane wartości to:
  • „DESKTOP”
  • „HIGH_END_MOBILE”
  • „OTHER_DEVICE”
  • „TABLET”
conversion[].dsConversionId long Identyfikator generowany przez DoubleClick Search dla każdej konwersji.
conversion[].engineAccountId long Identyfikator konta wyszukiwarki DS.
conversion[].floodlightOrderId string Identyfikator zamówienia Floodlight podany przez reklamodawcę na potrzeby konwersji.
conversion[].inventoryAccountId long Identyfikator generowany i używany przez DS do jednoznacznego identyfikowania konta asortymentowego zawierającego produkt.
conversion[].productCountry string Kraj zarejestrowany w pliku danych Merchant Center zawierającym produkt. Aby określić kraj, użyj kodu ISO 3166.
conversion[].productGroupId long Identyfikator grupy produktów w DS.
conversion[].productId string Identyfikator produktu (SKU).
conversion[].productLanguage string Język zarejestrowany w pliku danych Merchant Center zawierającym produkt. Aby określić język, użyj kodu ISO 639.
conversion[].quantityMillis long Liczba tej konwersji w milisekundach. z możliwością zapisu
conversion[].revenueMicros long Kwota przychodów z tej konwersji typu TRANSACTION w mikro (wartość pomnożona przez 1000000, bez cyfr po przecinku). Aby np. określić wartość przychodów na „10” wpisz „10000000” (10 milionów) w Twojej prośbie. z możliwością zapisu
conversion[].segmentationId long Numeryczny identyfikator podziału na segmenty (np. identyfikator aktywności Floodlight DoubleClick Search).
conversion[].segmentationName string Identyfikator łatwego podziału na segmenty (np. nazwa aktywności Floodlight DoubleClick Search).
conversion[].segmentationType string Typ segmentacji tej konwersji (np. FLOODLIGHT).

Akceptowane wartości:
  • „FLOODLIGHT”
conversion[].state string Stan konwersji, czyli ACTIVE lub REMOVED. Uwaga: stan DELETED jest wycofany.

Akceptowane wartości to:
  • „ACTIVE”
  • "DELETED":  (wycofano)
  • „REMOVED”
 z możliwością zapisu
conversion[].storeId string Identyfikator lokalnego sklepu, w którym reklamowany jest produkt. Ma zastosowanie tylko wtedy, gdy kanał to „local”.
conversion[].type string Typ konwersji, czyli ACTION lub TRANSACTION. Konwersja typu ACTION to działanie użytkownika, które nie ma wymiernej wartości pieniężnej, a konwersja TRANSACTION to działanie, które ma mierzalną wartość pieniężną. Przykłady to rejestracje na liście e-mailowej (ACTION) i zakupy e-commerce (TRANSACTION).

Akceptowane wartości:
    .
  • „ACTION”
  • „TRANSACTION”
kind string Identyfikuje wartość jako zasób ConversionList. Wartość: ustalony ciąg znaków doubleclicksearch#conversionList.

Metody

pobierz
Pobiera listę konwersji z konta wyszukiwarki DoubleClick Search.
getByCustomerId
Pobiera listę konwersji z konta wyszukiwarki DoubleClick za pomocą nowego identyfikatora klienta Search Ads 360.
wstaw
Wstawia grupę nowych konwersji do DoubleClick Search.
zaktualizuj
Aktualizuje grupę konwersji w usłudze DoubleClick Search.
updateAvailability
Aktualizuje dostępność grupy aktywności Floodlight w Search Ads 360.