Conversion

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

Bu kaynağa yönelik yöntem listesi için bu sayfanın sonuna bakın.

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
    }
  ]
}
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) tercihleri için izni temsil eder. Varsayılan değer yok. Kabul edilebilir değerler: GRANTED (İZİN VERİLDİ): İstenen izin durumu, verildi. GTE ayarlarından CPS tercihlerini okuyun. REDDEDİLDİ: İstenen izin durumu "reddetmek" şeklindedir. CPS listesi boş.
conversion[].advertiserId long DS reklamveren kimliği.
conversion[].agencyId long DS ajans kimliği.
conversion[].attributionModel string Reklamverenlerin yalnızca DoubleClick Search müşteri desteğiyle iletişim kurmalarının ardından kullanılabilir.
conversion[].campaignId long DS kampanya kimliği.
conversion[].channel string Ürünün satış kanalı. Kabul edilebilir değerler şunlardır:
  • "local": fiziksel mağaza
  • "online": online mağaza
conversion[].clickId string Dönüşümün DS tıklama kimliği.
conversion[].conversionId string Reklamverenler, çevrimdışı dönüşümler için bu kimliği sağlar. Reklamverenler kendileri için anlamlı olan herhangi bir kimliği belirtebilir. Bir istekteki her dönüşüm benzersiz bir kimlik belirtmelidir ve kimlik ile zaman damgası kombinasyonu, reklamveren içindeki tüm dönüşümler arasında benzersiz olmalıdır.
Online dönüşümlerde DS, reklamverenin Floodlight talimatlarına bağlı olarak dsConversionId veya floodlightOrderId değerlerini bu mülke kopyalar.
conversion[].conversionModifiedTimestamp unsigned long Dönüşümün en son değiştirildiği zaman (milisaniye cinsinden UTC saat diliminde).
conversion[].conversionTimestamp unsigned long Dönüşümün gerçekleştiği saat (milisaniye cinsinden UTC saat diliminde).
conversion[].countMillis long Reklamverenlerin yalnızca DoubleClick Search müşteri desteğiyle iletişim kurmalarının ardından kullanılabilir.
conversion[].criterionId long DS ölçüt (anahtar kelime) kimliği.
conversion[].currencyCode string Dönüşüm gelirinin para birimi kodu. ISO 4217 alfabetik (3 karakterli) biçiminde olmalıdır. yazılabilir
conversion[].customDimension[] list Dönüşümle ilgili özel boyutlar. Bu boyutlar, bir 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üşümle ilgili ö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'ün her dönüşüm için oluşturduğu kimlik.
conversion[].engineAccountId long DS motor hesabı 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 bir şekilde tanımlamak için oluşturduğu ve kullandığı kimlik.
conversion[].productCountry string Ürünü içeren Merchant Center feed'inin kayıtlı olduğu ü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 dildir. Dil belirtmek için ISO 639 kodu kullanın.
conversion[].quantityMillis long Bu dönüşümün miktarı (milisaniye cinsinden). yazılabilir
conversion[].revenueMicros long Bu TRANSACTION dönüşümünün mikro cinsinden gelir tutarı (değerin ondalık sayı 1000000 ile çarpılmasıyla elde edilen değer). Örneğin, gelir değerini "10" olarak belirtmek için "10000000" girin (10 milyon) olarak değiştirmesi gerekir. yazılabilir
conversion[].segmentationId long Sayısal segmentasyon tanımlayıcısı (örneğin, DoubleClick Search Floodlight etkinlik kimliği).
conversion[].segmentationName string Uygun segmentasyon tanımlayıcısı (örneğin, DoubleClick Search Floodlight etkinlik adı).
conversion[].segmentationType string Bu dönüşümün segmentasyon türü (örneğin, FLOODLIGHT).

Kabul edilebilir değerler şunlardır:
  • "FLOODLIGHT"
conversion[].state string Dönüşümün durumu (ACTIVE veya REMOVED). Not: DELETED durumu kullanımdan kaldırıldı.

Kabul edilen değerler şunlardır:
  • "ACTIVE"
  • "DELETED":  (Kullanımdan kaldırıldı)
  • "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 değeri olmayan bir işlemidir. TRANSACTION dönüşümü ise parasal olarak ölçülebilir bir değeri olan bir işlemdir. E-posta listesi kayıtları (ACTION) ve e-ticaret satın alma işlemleri (TRANSACTION) örnek olarak verilebilir.

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

Yöntemler

al
Bir DoubleClick Search motor hesabından gelen dönüşümlerin listesini alır.
getByCustomerId
Yeni bir Search Ads 360 müşteri kimliğini kullanarak bir DoubleClick Search arama motoru hesabından dönüşüm listesini alır.
ekle
Yeni dönüşümleri DoubleClick Search'e ekler.
güncelle
DoubleClick Search'teki bir dönüşüm grubunu günceller.
updateAvailability
DoubleClick Search'te bir grup Floodlight etkinliği grubunun kullanılabilirlik durumunu günceller.