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.