Önceki Search Ads 360 Reporting API, 30 Haziran 2024'te kullanımdan kaldırılacak ve tamamen devre dışı bırakılacak. Search Ads 360 Conversion API'nin bu durumdan etkilenmediğini ve desteklenmeye devam edeceğini unutmayın. Tüm yeni raporlama geliştirmelerinde yeni Search Ads 360 Reporting API kullanılmalıdır.

Nisan 2024'ten itibaren, rapor istenirken desteklenmeyen birApiVersion hatası döndürülecektir. Ayrıntılı bilgiye buradan ulaşabilirsiniz.

Ayrıca, mevcut Search Ads 360 uygulamalarınızı yeni API'ye taşımanızı da önemle tavsiye ederiz. Daha fazla bilgi için yeni Search Ads 360 Reporting API Başlangıç ve Taşıma Rehberi'ne bakı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 ilişkin yöntemlerin listesi için bu sayfanın sonuna bakın.

Kaynak temsilleri

Dönüşüm 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 şunlardır: GRANTED: İstenen izin durumu, izin vermektir. GTE ayarlarından CPS tercihlerini okuyun. DENIED: İstenen izin durumu "reddet"tir; CPS listesi boş.
`conversion[].advertiserId`	`long`	DS reklamveren kimliği.
`conversion[].agencyId`	`long`	DS ajans kimliği.
`conversion[].attributionModel`	`string`	Reklamverenler tarafından yalnızca DoubleClick Search müşteri desteğiyle iletişime geçildikten sonra 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`": Bir çevrimiçi mağaza
`conversion[].clickId`	`string`	Dönüşümün 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 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üşümler için DS, reklamverenin Floodlight talimatlarına bağlı olarak `dsConversionId` veya `floodlightOrderId` değerini bu mülke kopyalar.
`conversion[].conversionModifiedTimestamp`	`unsigned long`	Milisaniye cinsinden UTC zaman diliminde, dönüşümün en son değiştirildiği zaman.
`conversion[].conversionTimestamp`	`unsigned long`	Milisaniye cinsinden dönem (UTC) olarak, dönüşümün gerçekleştiği saat.
`conversion[].countMillis`	`long`	Reklamverenler tarafından yalnızca DoubleClick Search müşteri desteğiyle iletişime geçildikten sonra 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`	Bir rapordaki verileri filtrelemek için kullanılabilecek, dönüşüme ilişkin özel boyutlar.
`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'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`	Bu dönüşümün milisaniye cinsinden miktarı.	yazılabilir
`conversion[].revenueMicros`	`long`	Bu `TRANSACTION` dönüşümünün mikro cinsinden gelir miktarı (değerin 1000000 ile çarpımı, ondalık değer yoktur). Örneğin, "10" gelir değerini belirtmek için isteğinize "10000000" (10 milyon) değerini girin.	yazılabilir
`conversion[].segmentationId`	`long`	Sayısal segmentasyon tanımlayıcısı (örneğin, DoubleClick Search Floodlight etkinlik kimliği).
`conversion[].segmentationName`	`string`	Kolay 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ü, yani `ACTION` veya `TRANSACTION`. `ACTION` dönüşümü, kullanıcının maddi olarak ölçülebilir bir değeri olmayan işlemidir. `TRANSACTION` dönüşümü ise parasal olarak ölçülebilir bir değeri olan bir işlemdir. Örnek olarak, e-posta listesi kayıtları (`ACTION`) ile e-ticaret satın alma işlemleri (`TRANSACTION`) verilebilir. Kabul edilebilir değerler şunlardır: "`ACTION`" "`TRANSACTION`"
`kind`	`string`	Bunu bir ConversionList kaynağı olarak tanımlar. Değer: `doubleclicksearch#conversionList` sabit dizesi.

Yöntemler

al: Bir DoubleClick Search motor hesabından dönüşüm listesi alır.
getByCustomerId: Yeni bir Search Ads 360 müşteri kimliği kullanarak DoubleClick Search motor hesabından dönüşüm listesi alır.
ekle: Yeni dönüşüm gruplarını DoubleClick Search'e ekler.
güncelle: DoubleClick Search'te bir dönüşüm grubunu günceller.
updateAvailability: DoubleClick Search'teki bir grup Floodlight etkinliğinin kullanılabilirliğini günceller.