Önceki Search Ads 360 Reporting API kullanımdan kaldırıldı. Artık raporlarınızı yeni Search Ads 360 Reporting API'yi kullanarak oluşturabilirsiniz.

Search Ads 360 Conversion API'nin bu durumdan etkilenmediğini ve desteklenmeye devam edeceğini unutmayın.

Bu sayfa, Cloud Translation API ile çevrilmiştir.

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.