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:
|
|
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:
|
|
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:
|
|
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:
|
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:
|
|
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.