30 czerwca 2024 r. wycofamy poprzednią wersję Search Ads 360 Reporting API. Pamiętaj, że nie dotyczy to interfejsu Search Ads 360 Conversion API, który nadal będzie obsługiwany. Podczas programowania raportów w nowej wersji Search Ads 360 należy używać nowego interfejsu Search Ads 360 Reporting API.

Od kwietnia 2024 r. po wysłaniu żądania raportu będzie zwracany błąd nieobsługiwanej wersji ApiVersion. Więcej informacji znajdziesz tutaj.

Zdecydowanie zalecamy też przeniesienie wszystkich istniejących implementacji Search Ads 360 do nowego interfejsu API. Więcej informacji znajdziesz w artykułach Wprowadzenie i Przewodnik po migracji do nowego interfejsu Search Ads 360 Reporting API.

Ta strona została przetłumaczona przez Cloud Translation API.

Conversion

Zasób konwersji ma metody, które pozwalają użytkownikom zbiorczo tworzyć, modyfikować i pobierać konwersje Floodlight.

Listę metod stosowanych w przypadku 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`	Żądane konwersje.
`conversion[].adGroupId`	`long`	Identyfikator grupy reklam w DS.
`conversion[].adId`	`long`	Identyfikator reklamy w DS.
`conversion[].adUserDataConsent`	`string`	Reprezentuje preferencje dotyczące zgody na przetwarzanie danych w podstawowych usługach platformy (CPS) w ustawieniach. Brak wartości domyślnej. Akceptowane wartości: GRANTED: pożądany stan zgody użytkownika to „Przyznanie”. Odczyt preferencji CPS z ustawień GTE. DENIED: pożądany stan zgody to „Odrzucenie”, a 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 dopiero po skontaktowaniu się z obsługą klienta DoubleClick Search.
`conversion[].campaignId`	`long`	Identyfikator kampanii w 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 ma dla nich znaczenie. 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 parametr `dsConversionId` lub `floodlightOrderId` w zależności od instrukcji Floodlight reklamodawcy.
`conversion[].conversionModifiedTimestamp`	`unsigned long`	Czas ostatniej modyfikacji konwersji podany w milisekundach epoki UTC.
`conversion[].conversionTimestamp`	`unsigned long`	Czas dokonania konwersji podany w milisekundach epoki UTC.
`conversion[].countMillis`	`long`	Dostępne dla reklamodawców dopiero po skontaktowaniu się z obsługą klienta DoubleClick Search.
`conversion[].criterionId`	`long`	Identyfikator kryterium (słowa kluczowego) DS.
`conversion[].currencyCode`	`string`	Kod waluty przychodów z konwersji. Nazwa powinna być w formacie alfabetycznym ISO 4217 (3 znaki).	z możliwością zapisu
`conversion[].customDimension[]`	`list`	Niestandardowe wymiary na potrzeby konwersji, które mogą służyć 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`	Nowy identyfikator klienta Search Ads 360. Musi to być konto klienta. Gdy to pole jest skonfigurowane, we wszystkich pozostałych polach identyfikatorów należy ustawić 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ę na potrzeby konwersji.
`conversion[].inventoryAccountId`	`long`	Identyfikator generowany i używany przez DS do jednoznacznego identyfikowania konta zasobów reklamowych zawierającego produkt.
`conversion[].productCountry`	`string`	Kraj zarejestrowany w pliku danych Merchant Center zawierającym produkt. Wskaż kraj za pomocą 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. Określ język za pomocą kodu ISO 639.
`conversion[].quantityMillis`	`long`	Ilość tej konwersji podana w milisekundach.	z możliwością zapisu
`conversion[].revenueMicros`	`long`	Kwota przychodów z tej konwersji typu `TRANSACTION` wyrażona w mikro (wartość pomnożona przez 1 000 000, bez cyfr po przecinku). Aby np. określić wartość przychodów równą „10”, wpisz w żądaniu „10000000” (10 milionów).	z możliwością zapisu
`conversion[].segmentationId`	`long`	Liczbowy identyfikator podziału na segmenty (np. identyfikator aktywności Floodlight w usłudze DoubleClick Search).
`conversion[].segmentationName`	`string`	Identyfikator prostego podziału na segmenty (np. nazwa aktywności Floodlight w DoubleClick Search).
`conversion[].segmentationType`	`string`	Typ podziału tej konwersji na segmenty (np. `FLOODLIGHT`). Akceptowane wartości: "`FLOODLIGHT`"
`conversion[].state`	`string`	Stan konwersji, czyli `ACTIVE` lub `REMOVED`. Uwaga: stan DELETED nie jest już używany. Akceptowane wartości: "`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 `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ładami są subskrypcje list e-mailowych (`ACTION`) i zakupy e-commerce (`TRANSACTION`). Akceptowane wartości: "`ACTION`" "`TRANSACTION`"
`kind`	`string`	Określa 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 Search za pomocą nowego identyfikatora klienta Search Ads 360.
wstaw: Wstawia grupę nowych konwersji do DoubleClick Search.
aktualizacja: Aktualizuje grupę konwersji w usłudze DoubleClick Search.
updateAvailability: Aktualizuje dostępność grupy aktywności Floodlight w usłudze DoubleClick Search.