Conversion

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

Listę metod dotyczących tego zasobu znajdziesz na końcu tej strony.

Prezentacje 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,
      "sessionAttributesEncoded": bytes
    }
  ]
}
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 wykorzystywanie podstawowych usług platformowych (CPS) podaną w ustawieniach. Brak wartości domyślnej. Akceptowane wartości: GRANTED (Przyznano): pożądany stan zgody to „Przyznano”. Odczytywanie ustawień CPS z ustawień GTE. DENIED (Odmowa): użytkownik chce odmówić zgody; lista CPS jest pusta.

Akceptowane wartości:
  • „DENIED”
  • „GRANTED”
  • „UNKNOWN”
conversion[].advertiserId long Identyfikator reklamodawcy w DS.
conversion[].agencyId long Identyfikator agencji DS.
conversion[].attributionModel string Dostępna dla reklamodawców tylko po skontaktowaniu się z zespołem obsługi klienta DoubleClick Search.
conversion[].campaignId long Identyfikator kampanii DS.
conversion[].channel string Kanał sprzedaży produktu. Akceptowane wartości:
  • „local”: sklep stacjonarny
  • „online”: sklep internetowy
conversion[].clickId string Identyfikator kliknięcia DS odpowiadający konwersji.
conversion[].conversionId string W przypadku konwersji offline reklamodawcy podają ten identyfikator. Reklamodawcy mogą podać dowolny identyfikator, który uznają za odpowiedni. Każda konwersja w żądaniu musi mieć unikalny identyfikator, a połączenie identyfikatora i sygnatury czasowej musi być niepowtarzalne w śród wszystkich konwersji u reklamodawcy.
W przypadku konwersji online DS kopiuje do tej usługi tag dsConversionId lub floodlightOrderId w zależności od instrukcji Floodlight podanych przez reklamodawcę.
conversion[].conversionModifiedTimestamp unsigned long Czas ostatniej modyfikacji konwersji w milisekundach UTC.
conversion[].conversionTimestamp unsigned long Czas wystąpienia konwersji w milisekundach epoki UTC.
conversion[].countMillis long Dostępna dla reklamodawców tylko po skontaktowaniu się z zespołem obsługi klienta DoubleClick Search.
conversion[].criterionId long Identyfikator kryterium (słowa kluczowego) DS.
conversion[].currencyCode string Kod waluty przychodów z konwersji. Powinna być w formacie alfabetycznym ISO 4217 (3 znaki). zapisywalny
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 dotyczące konwersji.
conversion[].customMetric[].name string Nazwa danych niestandardowych.
conversion[].customMetric[].value double Wartość liczbowa danych niestandardowych.
conversion[].customerId string Identyfikator klienta nowej wersji Search Ads 360. Musi to być konto klienta. Gdy to pole jest ustawione, wszystkie pozostałe pola identyfikatorów powinny zawierać nowe identyfikatory Search Ads 360.
conversion[].deviceType string Typ urządzenia, na którym doszło do konwersji.

Akceptowane wartości:
  • „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ę dla danej konwersji.
conversion[].inventoryAccountId long Identyfikator generowany i używany przez DS do jednoznacznej identyfikacji konta asortymentu zawierającego produkt.
conversion[].productCountry string Kraj zarejestrowany na potrzeby pliku danych Merchant Center zawierającego produkt. Aby określić kraj, użyj kodu ISO 3166.
conversion[].productGroupId long Identyfikator grupy produktów DS.
conversion[].productId string Identyfikator produktu (SKU).
conversion[].productLanguage string Język zarejestrowany na potrzeby pliku danych Merchant Center zawierającego produkt. Aby określić język, użyj kodu ISO 639.
conversion[].quantityMillis long Liczba konwersji w milisekundach. zapisywalny
conversion[].revenueMicros long Wartość przychodu z tej konwersji TRANSACTION w mikrosekundach (wartość pomnożona przez 1 000 000, bez miejsc po przecinku). Jeśli np. chcesz podać wartość przychodów „10”, w prośbie wpisz „10000000” (10 mln). zapisywalny
conversion[].segmentationId long Liczbowy identyfikator segmentacji (np. identyfikator aktywności Floodlight w DoubleClick Search).
conversion[].segmentationName string Przyjazny identyfikator segmentacji (np. nazwa aktywności Floodlight w DoubleClick Search).
conversion[].segmentationType string Typ podziału na segmenty tej konwersji (np. FLOODLIGHT).

Akceptowane wartości:
  • „FLOODLIGHT”
conversion[].sessionAttributesEncoded bytes Atrybuty sesji zdarzenia, reprezentowane jako ciąg tekstowy JSON zakodowany w formacie Base64. Treści powinny być generowane przez bibliotekę udostępnioną przez Google.
conversion[].state string Stan konwersji: ACTIVE lub REMOVED. Uwaga: stan DELETED (usunięty) został wycofany.

Akceptowane wartości:
  • „ACTIVE”
  • „DELETED”:  (wycofane)
  • „REMOVED”
 zapisywalny
conversion[].storeId string Identyfikator lokalnego sklepu, w którym produkt był reklamowany. Ma zastosowanie tylko wtedy, gdy kanał ma wartość „local”.
conversion[].type string Typ konwersji: ACTION lub TRANSACTION. Konwersja ACTION to działanie użytkownika, które nie ma wartości, którą można wyrazić w formie pieniężnej, a konwersja TRANSACTION to działanie, które ma wartość, którą można wyrazić w formie pieniężnej. Przykłady: zapisywanie się na listę e-mailową (ACTION) i zakupy e-commerce (TRANSACTION).

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

Metody

get
Pobiera listę konwersji z konta wyszukiwarki DoubleClick.
getByCustomerId
Pobiera listę konwersji z konta wyszukiwarki DoubleClick za pomocą nowego identyfikatora klienta Search Ads 360.
insert
Wkleja do DoubleClick Search partię nowych konwersji.
update
Zaktualizuje zbiorczy raport o konwersjach w DoubleClick Search.
updateAvailability
Aktualizuje dostępność zbioru aktywności Floodlight w DoubleClick Search.