Dönüşümlerle ilgili ham etkinlik verileri.
Bu rapor yalnızca asenkron istek (yani Reports.request() yöntemi) ile döndürülebilir.
Etkinlikler belirli tarihlerde gerçekleştiği için bu rapor için istekte timeRange belirtilmelidir. Aşağıdakilerden birini belirtebilirsiniz:
- startDate ve endDate.
- changedMetricsSinceTimestamp (changedAttributesSinceTimestamp etkinlikler için geçerli değildir).
Alıntı isteğinde bulunma
Normal bir Reports.request() istek gövdesi gönderin ancak "reportType": "conversion" değerini belirtin.
{
...
"reportType": "conversion",
"columns": [
{
"columnName":string ,
"headerText":string ,
"startDate":string ,
"endDate":string
}
],
"filters": [
{
"column": {
"columnName":string ,
},
...
},
...
],
...
}
Raporda döndürülmesini veya filtrelenmesini istediğiniz her sütun için aşağıdaki tabloda listelenen columnName değerini belirtin.
İsteğe bağlı olarak headerText, startDate ve endDate özelliklerini de belirtebilirsiniz.
Bazı sütunların filtrelenemediğini unutmayın. Aşağıdaki tabloda "Filtrelenebilir" sütununa bakın.
columnName | Açıklama | Davranış | Tür | Filtrelenebilir |
|---|---|---|---|---|
status |
Dönüşümün durumu: Active veya Removed. |
özellik | Status |
Evet |
deviceSegment |
Dönüşümün ilişkilendirildiği cihaz segmenti: Desktop, Mobile, Tablet veya Other. |
özellik | Device segment |
Evet |
floodlightGroup |
Floodlight grubu adı. | özellik | String |
Evet |
floodlightGroupConversionType |
Bu gruptaki Floodlight etkinlikleri tarafından oluşturulan dönüşümlerin türü: Action veya Transaction. |
özellik | Conversion type |
Evet |
floodlightGroupId |
DS Floodlight grubu kimliği. | özellik | ID |
Evet |
floodlightGroupTag |
Floodlight grubu etiketi. | özellik | String |
Evet |
floodlightActivity |
Floodlight etkinliği adı. | özellik | String |
Evet |
floodlightActivityId |
DS Floodlight etkinlik kimliği. | özellik | ID |
Evet |
floodlightActivityTag |
Floodlight etkinlik etiketi. | özellik | String |
Evet |
agency |
Ajans adı. | özellik | String |
Evet |
agencyId |
DS ajans kimliği. | özellik | ID |
Evet |
advertiser |
Reklamveren adı. | özellik | String |
Evet |
advertiserId |
DS reklamveren kimliği. | özellik | ID |
Evet |
account |
Arama motoru hesabı adı. | özellik | String |
Evet |
accountId |
DS arama motoru hesap kimliği. | özellik | ID |
Evet |
accountEngineId |
Harici arama motoru hesabındaki hesabın kimliği. | özellik | String |
Evet |
accountType |
Motor hesabı türü: Google AdWords, Bing Ads, Yahoo Japan Listing Ads, Yahoo Search Marketing, Yahoo Gemini, Baidu veya Comparison Shopping. |
özellik | Engine type |
Evet |
campaign |
Kampanya adı. | özellik | String |
Evet |
campaignId |
DS kampanya kimliği. | özellik | ID |
Evet |
campaignStatus |
Bu öğeyi içeren kampanyanın durumu. | özellik | Status |
Evet |
adGroup |
Reklam grubu adı. | özellik | String |
Evet |
adGroupId |
DS reklam grubu kimliği. | özellik | ID |
Evet |
adGroupStatus |
Bu öğeyi içeren reklam grubunun durumu. | özellik | Status |
Evet |
keywordId |
DS anahtar kelime kimliği. 0 değeri, anahtar kelimenin ilişkilendirilmediğini gösterir. | özellik | ID |
Evet |
keywordMatchType |
Anahtar kelime eşleme türü: Broad, Exact, Phrase veya Content. |
özellik | Match type |
Evet |
keywordText |
Anahtar kelime metni. | özellik | String |
Evet |
productTargetId |
DS ürün hedefi kimliği. | özellik | ID |
Evet |
productGroupId |
Bu dönüşümle ilişkili ürün grubu kimliği. Yalnızca Alışveriş kampanyalarından gelen dönüşümlerin ürün grubu kimlikleri vardır. Ürün grubu kodları birleştirme için kullanılmamalıdır. | özellik | ID |
Evet |
ad |
Reklam adı. | özellik | String |
Evet |
adId |
DS reklam kimliği. 0 değeri, reklamın ilişkilendirilmediğini gösterir. | özellik | ID |
Evet |
isUnattributedAd |
Bu satırdaki metriklerin belirli bir reklamla ilişkilendirilip ilişkilendirilemediğini belirtir. Örneğin, desteklenmeyen bir biçime veya hatalı bir tıklama sunucusu URL'sine sahip bir reklam, DS'nin metrikleri bir reklamla ilişkilendirmesini engelleyebilir. | özellik | Boolean |
Evet |
inventoryAccountId |
Dönüşümle ilişkili ürünü içeren DS envanter hesabı kimliği. DS, DS'de bir envanter hesabı bağladığınızda bu kimliği oluşturur. | özellik | ID |
Evet |
productId |
Bu dönüşümle ilişkili ürünün kimliği. | özellik | String |
Evet |
productCountry |
Bu dönüşümle ilişkili ürünü içeren envanter feed'i için kaydedilen ülke (ISO 3166 biçiminde). | özellik | String |
Evet |
productLanguage |
Bu dönüşümle ilişkili ürünün dili (ISO 639-1). | özellik | String |
Evet |
productStoreId |
Dönüşümle ilişkili yerel envanter reklamındaki mağaza. Bu değer, yerel ürünler feed'inizde kullanılan mağaza kimlikleriyle eşleşmelidir. | özellik | String |
Evet |
productChannel |
Dönüşümle ilişkili ürünün satış kanalı: Online veya Local. |
özellik | Product channel |
Evet |
conversionId |
Search Ads 360'ın her dönüşüm için oluşturduğu kimlik. | özellik | ID |
Evet |
advertiserConversionId |
Çevrimdışı dönüşümler için bu, reklamverenler tarafından sağlanan bir kimliktir. Reklamverenler böyle bir kimlik belirtmezse Search Ads 360 bir kimlik oluşturur. Online dönüşümler için bu, reklamverenin Floodlight talimatlarına bağlı olarak conversionId sütununa veya floodlightOrderId sütununa eşittir. | özellik | String |
Evet |
conversionType |
Dönüşümün türü: Action veya Transaction. |
özellik | Conversion type |
Evet |
conversionRevenue |
Dönüşümden elde edilen toplam dolar tutarı. | özellik | Money |
Evet |
conversionQuantity |
qty parametresi tarafından belirlenen, dönüşüm tarafından kaydedilen öğelerin miktarı. Parametreyi dinamik olarak doldurmaktan (dönüşümde satılan öğe sayısı gibi) reklamveren sorumludur. Aksi takdirde varsayılan olarak 1 olur. | özellik | Number |
Evet |
conversionDate |
Dönüşümün gerçekleştiği tarih (Campaign Manager ağ saat dilimine göre). Bu tarih, dönüşüm metriği toplama işlemi için kullanılır. Örneğin, DS 1 Mayıs'a ait işlemleri toplarken conversionDate değeri 1 Mayıs olan tüm işlem dönüşümlerini sayar. |
özellik | Date |
Evet |
conversionTimestamp |
Dönüşümün gerçekleştiği UTC zaman damgası. | özellik | Timestamp |
Evet |
conversionLastModifiedTimestamp |
Dönüşümün en son değişikliğinin UTC zaman damgası. | özellik | Timestamp |
Evet |
conversionAttributionType |
Dönüşümün ilişkilendirildiği öğe: Visit veya Keyword+Ad. |
özellik | Conversion attribution type |
Evet |
conversionVisitId |
Dönüşümün ilişkilendirildiği DS ziyareti kimliği. | özellik | ID |
Evet |
conversionVisitTimestamp |
Dönüşümün ilişkilendirildiği ziyaretin UTC zaman damgası. | özellik | Timestamp |
Evet |
conversionVisitExternalClickId |
Dönüşümün ilişkilendirildiği ziyaret için açılış sayfasına gclid URL parametresi olarak iletilen benzersiz bir dize. Yalnızca dönüşüm API entegrasyonu veya Google Analytics entegrasyonu olan reklamverenler için etkindir. | özellik | String |
Evet |
conversionSearchTerm |
Dönüşümle sonuçlanan arama terimi. | özellik | String |
Evet |
floodlightOriginalRevenue |
Floodlight para birimi talimatında yapılan değişikliklerden önce Floodlight etkinliğiyle ilişkili orijinal, değiştirilmemiş gelir (mevcut raporun para biriminde). | özellik | Money |
Evet |
floodlightEventRequestString |
Dönüşümün Floodlight istek dizesi. | özellik | String |
Evet |
floodlightReferrer |
Dönüşümün Floodlight yönlendiren web sitesi. | özellik | String |
Evet |
floodlightOrderId |
Dönüşüm için reklamveren tarafından sağlanan Floodlight sipariş kimliği. | özellik | String |
Evet |
feedItemId |
Bu dönüşümle ilişkili feed öğesi satırının kimliği. | özellik | ID |
Evet |
feedId |
Bu dönüşümle ilişkili feed tablosunun kimliği. | özellik | ID |
Evet |
feedType |
Bu dönüşümle ilişkili feed türü. | özellik | Feed type |
Evet |