Conversion

Dönüşüm kaynağında, kullanıcıların Floodlight dönüşümlerini toplu olarak oluşturmasına, değiştirmesine ve almasına olanak tanıyan yöntemler bulunur. 

Bu kaynak için yöntemlerin listesi bu sayfanın sonuna verilmiştir.

Kaynak temsilleri

Dönüşümlerin listesi.

{
  "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
    }
  ]
}
Mülk adı Değer Açıklama Notlar
conversion[] list İstenen dönüşümler.
conversion[].adGroupId long DS reklam grubu kimliği.
conversion[].adId long DS reklam kimliği.
conversion[].adUserDataConsent string Ayarlardaki temel platform hizmetleri (CPS) tercihlerine izin verilmesini ifade eder. Varsayılan değer yok. Kabul edilen değerler şunlardır: GRANTED: İstenen izin durumu, iznin verilmesidir. GTE ayarlarından CPS tercihlerini okuyun. REDDEDİLDİ: İstenen izin durumu, iznin reddedilmesidir; CPS listesi boştur.

Kabul edilen değerler şunlardır:
  • "DENIED"
  • "GRANTED"
  • "UNKNOWN"
conversion[].advertiserId long DS reklamveren kimliği.
conversion[].agencyId long DS ajans kimliği.
conversion[].attributionModel string Yalnızca DoubleClick Search müşteri desteğiyle iletişime geçtikten sonra reklamverenler tarafından kullanılabilir.
conversion[].campaignId long DS kampanya kimliği.
conversion[].channel string Ürünün satış kanalı. Kabul edilen değerler şunlardır:
  • "local": fiziksel mağaza
  • "online": online mağaza
conversion[].clickId string Dönüşüm için DS tıklama kimliği.
conversion[].conversionId string Çevrimdışı dönüşümler için reklamverenler bu kimliği sağlar. Reklamverenler, kendileri için anlamlı olan herhangi bir kimliği belirtebilir. Bir istekteki her dönüşüm için benzersiz bir kimlik belirtilmelidir. Ayrıca, kimlik ve zaman damgası kombinasyonu, reklamveren içindeki tüm dönüşümler arasında benzersiz olmalıdır.
DS, internetteki dönüşümler için reklamverenin Floodlight talimatlarına bağlı olarak dsConversionId veya floodlightOrderId öğesini bu mülke kopyalar.
conversion[].conversionModifiedTimestamp unsigned long Dönüşümün son değiştirildiği zaman (milisaniye cinsinden, UTC).
conversion[].conversionTimestamp unsigned long Dönüşümün gerçekleştiği zaman (UTC sıfır zaman diliminde milisaniye cinsinden).
conversion[].countMillis long Yalnızca DoubleClick Search müşteri desteğiyle iletişime geçtikten sonra reklamverenler tarafından kullanılabilir.
conversion[].criterionId long DS ölçütü (anahtar kelime) kimliği.
conversion[].currencyCode string Dönüşümün gelirinin para birimi kodu. ISO 4217 alfabetik (3 karakterli) biçiminde olmalıdır. yazılabilir
conversion[].customDimension[] list Dönüşüm için özel boyutlar. Rapordaki verileri filtrelemek için kullanılabilir.
conversion[].customDimension[].name string Özel boyut adı.
conversion[].customDimension[].value string Özel boyut değeri.
conversion[].customMetric[] list Dönüşüm için özel metrikler.
conversion[].customMetric[].name string Özel metrik adı.
conversion[].customMetric[].value double Özel metrik sayısal değeri.
conversion[].customerId string Yeni Search Ads 360 müşteri kimliği. Müşteri hesabı olmalıdır. Bu alan ayarlandığında diğer tüm kimlik alanları yeni Search Ads 360 kimliklerine ayarlanmalıdır.
conversion[].deviceType string Dönüşümün gerçekleştiği cihazın türü.

Kabul edilen değerler şunlardır:
  • "DESKTOP"
  • "HIGH_END_MOBILE"
  • "OTHER_DEVICE"
  • "TABLET"
conversion[].dsConversionId long DoubleClick Search'in her dönüşüm için oluşturduğu kimlik.
conversion[].engineAccountId long DS arama motoru hesap kimliği.
conversion[].floodlightOrderId string Dönüşüm için reklamveren tarafından sağlanan Floodlight sipariş kimliği.
conversion[].inventoryAccountId long DS'nin, ürünü içeren envanter hesabını benzersiz şekilde tanımlamak için oluşturduğu ve kullandığı kimlik.
conversion[].productCountry string Ürünü içeren Merchant Center feed'i için kaydedilen ülke. Ülke belirtmek için ISO 3166 kodu kullanın.
conversion[].productGroupId long DS ürün grubu kimliği.
conversion[].productId string Ürün kimliği (SKU).
conversion[].productLanguage string Ürünü içeren Merchant Center feed'i için kaydedilen dil. Dil belirtmek için ISO 639 kodu kullanın.
conversion[].quantityMillis long Milisaniye cinsinden bu dönüşümün miktarı. yazılabilir
conversion[].revenueMicros long Bu TRANSACTION dönüşümünün gelir tutarı, mikro cinsinden (değer 1000000 ile çarpılır, ondalık basamak olmaz). Örneğin, "10" gelir değerini belirtmek için isteğinize "10000000" (10 milyon) yazın. yazılabilir
conversion[].segmentationId long Sayısal segmentasyon tanımlayıcısı (örneğin, DoubleClick Search Floodlight etkinlik kimliği).
conversion[].segmentationName string Kullanıcı dostu segmentasyon tanımlayıcısı (örneğin, DoubleClick Arama Floodlight etkinliği adı).
conversion[].segmentationType string Bu dönüşümün segmentasyon türü (örneğin, FLOODLIGHT).

Kabul edilen değerler:
  • "FLOODLIGHT"
conversion[].sessionAttributesEncoded bytes Etkinliğin oturum özellikleri (base64 kodlamalı bir JSON dizesi olarak temsil edilir). İçerik, Google tarafından sağlanan kitaplıkla oluşturulmalıdır.
conversion[].state string Dönüşümün durumu (ACTIVE veya REMOVED). Not: DELETED durumu için destek sonlandırılmıştır.

Kabul edilen değerler şunlardır:
  • "ACTIVE"
  • "DELETED":  (Desteklenmiyor)
  • "REMOVED"
 yazılabilir
conversion[].storeId string Ürünün reklamının yapıldığı yerel mağazanın kimliği. Yalnızca kanal "local" olduğunda geçerlidir.
conversion[].type string Dönüşümün türü (ACTION veya TRANSACTION). ACTION dönüşümü, kullanıcının parasal olarak ölçülebilir bir değeri olmayan bir işlemidir. TRANSACTION dönüşümü ise parasal olarak ölçülebilir bir değeri olan bir işlemdir. Örnekler arasında e-posta listesi kayıtları (ACTION) ve e-ticaret satın alma işlemleri (TRANSACTION) yer alır.

Kabul edilen değerler şunlardır:
  • "ACTION"
  • "TRANSACTION"
kind string Bu öğeyi bir ConversionList kaynağı olarak tanımlar. Değer: doubleclicksearch#conversionList sabit dizesi.

Yöntemler

get
Bir DoubleClick Search arama motoru hesabından dönüşümlerin listesini alır.
getByCustomerId
Yeni bir Search Ads 360 müşteri kimliği kullanarak DoubleClick Search arama motoru hesabından dönüşümlerin listesini alır.
insert
DoubleClick Search'e yeni dönüşümler içeren bir grup ekler.
güncelle
DoubleClick Search'te bir grup dönüşümü günceller.
updateAvailability
DoubleClick Search'ta bir grup Floodlight etkinliğinin müsaitlik durumunu günceller.