Dönüşüm raporlamayla ilgili temel bilgiler

Bu kılavuzda, Google Analytics Data API v1'deki dönüşüm raporlama işlevinin nasıl kullanılacağı açıklanmaktadır. Bu özellik, farklı ilişkilendirme modellerini destekleyen dönüşüm etkinliklerine odaklanan raporlar oluşturmanıza olanak tanır. Veri API'si ile oluşturulan dönüşüm raporları, Google Analytics kullanıcı arayüzünün Reklam > Dönüşümler bölümünde bulabileceğiniz ilişkilendirme raporlarına benzer. Daha fazla bilgi için Dönüşüm performans raporu başlıklı Yardım Merkezi makalesini inceleyin.

Dönüşüm raporlamanın amacı

Dönüşüm raporları, dönüşümleri belirli kampanyalar, kaynaklar ve aracılarla ilişkilendirerek pazarlama çalışmalarınızın etkinliğini analiz etmenize olanak tanır. Yalnızca etkinlikleri sayan standart etkinlik tabanlı raporların aksine, dönüşüm raporları, dönüşüme yol açan temas noktaları arasında krediyi dağıtmak için bir ilişkilendirme modeli uygular.

Dönüşümler ve etkinliğe dayalı raporlar

  • Etkinliğe Dayalı Raporlar: Etkinliklerin ham sayılarını sağlar (ör. eventCount) ve mülkünüzdeki genel etkinliği anlamak için yararlıdır.
  • Dönüşüm raporları: Dönüşüm olarak işaretlenen etkinliklere odaklanın. Belirli boyutları ve metrikleri (bkz. Dönüşüm Raporları Şeması) kullanır ve veriye dayalı veya son tıklama gibi modellere göre ilişkilendirilmiş verileri görmenize olanak tanır.

Dönüşüm raporlarını etkinleştirme

Dönüşüm raporu çalıştırmak için runReport yöntemini kullanın. Bir istek, bir veya daha fazla dönüşüm metriğini (örneğin, allConversionsByInteractionDate) sorguluyorsa ya da istek gövdesinde conversionSpec alanı doldurulmuşsa dönüşüm raporu olarak değerlendirilir.

conversionSpec nesnesi aşağıdaki alanları içerir:

  • conversionActions: Raporun içereceği dönüşüm işlemi kaynak adlarının listesi (ör. ["conversionActions/12345"]). Boşsa tüm dönüşümler dahil edilir. Geçerli dönüşüm işlemi kimlikleri, GetMetadata yönteminin yanıtındaki conversions listesinde yer alan conversion_action alanından alınabilir.
  • attributionModel: Kullanılacak ilişkilendirme modeli. Desteklenen değerler DATA_DRIVEN (varsayılan) ve LAST_CLICK'dir.

Dönüşüm raporu oluşturma

Veriye dayalı ilişkilendirme modelini kullanarak kampanyaya göre dönüşümleri gösteren bir dönüşüm raporu oluşturmak için runReport yönteminin kullanıldığı örnek bir istek aşağıda verilmiştir.

HTTP

API Gezgini'nde aç 
{
    "dateRanges": [
        {
            "startDate": "2026-04-01",
            "endDate": "2026-04-30"
        }
    ],
    "dimensions": [
        {
            "name": "campaignName"
        }
    ],
    "metrics": [
        {
            "name": "allConversionsByConversionDate"
        }
    ],
    "conversionSpec": {
        "conversionActions": [],
        "attributionModel": "DATA_DRIVEN"
    }
}

Örnek: Dönüşüm performansı raporunu yeniden oluşturma

Bu örnekte, önce bir mülk için kullanılabilir dönüşüm işlemlerinin nasıl alınacağı ve ardından bu işlemlerin, Google Analytics kullanıcı arayüzünde Reklam > Dönüşümler > Dönüşüm performansı bölümünde gösterilen Dönüşüm Performansı raporuna benzer bir rapor oluşturmak için nasıl kullanılacağı gösterilmektedir.

1. adım: Dönüşüm işlemlerini alın

Mülkünüz için geçerli dönüşüm işlemi kimliklerini bulmak üzere getMetadata yöntemini çağırın. Mülkünüz için oluşturulan dönüşüm işlemlerini görmek üzere (tüm mülkler için ortak olan alanları almak üzere 0 kullanmak yerine) GA mülk kimliğini belirttiğinizden emin olun.

Yanıtta, kullanılabilir dönüşüm işlemlerinin yer aldığı bir conversions listesi bulunur:

{
  ...

  "conversions": [
    {
      "conversionAction": "conversionActions/12345",
      "displayName": "purchase"
    },
    {
      "conversionAction": "conversionActions/67890",
      "displayName": "sign_up"
    }
  ]
}

2. adım: Raporu çalıştırın

runReport yöntemini çağırın. Raporunuzu filtrelemek için 1. adımda bulunan dönüşüm işlemi kimliklerini kullanın veya tüm dönüşümler hakkında rapor oluşturmak için conversionActions boş bırakın. Bu istek, reklam tıklamalarını, reklam maliyetini, tıklama başına reklam maliyetini, tüm dönüşümler başına reklam maliyetini, reklam gösterimlerini, reklam harcamalarından elde edilen geliri, toplam geliri ve tüm dönüşümleri varsayılan kanal grubuna göre göstererek bir Dönüşüm Performansı kullanıcı arayüzü raporu oluşturur.

HTTP

API Gezgini'nde aç 
{
    "dateRanges": [
        {
            "startDate": "2026-04-01",
            "endDate": "2026-04-30"
        }
    ],
    "dimensions": [
        {
            "name": "defaultChannelGroup"
        }
    ],
    "metrics": [
        {
            "name": "allConversionsByInteractionDate"
        },
        {
            "name": "advertiserAdCost"
        },
        {
            "name": "advertiserAdCostPerAllConversionsByInteractionDate"
        },
        {
            "name": "advertiserAdImpressions"
        },
        {
            "name": "advertiserAdClicks"
        },
        {
            "name": "advertiserAdCostPerClick"
        },
        {
            "name": "totalRevenueByInteractionDate"
        },
        {
            "name": "returnOnAdSpendByInteractionDate"
        }
    ],
    "conversionSpec": {
        "conversionActions": [
            "conversionActions/12345"
        ],
        "attributionModel": "DATA_DRIVEN"
    }
}

Bu isteğe ilişkin örnek yanıt aşağıda verilmiştir:

{
  "dimensionHeaders": [
    {
      "name": "defaultChannelGroup"
    }
  ],
  "metricHeaders": [
    {
      "name": "allConversionsByInteractionDate",
      "type": "TYPE_FLOAT"
    },
    {
      "name": "advertiserAdCost",
      "type": "TYPE_CURRENCY"
    },
    {
      "name": "advertiserAdCostPerAllConversionsByInteractionDate",
      "type": "TYPE_CURRENCY"
    },
    {
      "name": "advertiserAdImpressions",
      "type": "TYPE_INTEGER"
    },
    {
      "name": "advertiserAdClicks",
      "type": "TYPE_INTEGER"
    },
    {
      "name": "advertiserAdCostPerClick",
      "type": "TYPE_CURRENCY"
    },
    {
      "name": "totalRevenueByInteractionDate",
      "type": "TYPE_CURRENCY"
    },
    {
      "name": "returnOnAdSpendByInteractionDate",
      "type": "TYPE_FLOAT"
    }
  ],
  "rows": [
    {
      "dimensionValues": [
        {
          "value": "Paid Search"
        }
      ],
      "metricValues": [
        {
          "value": "75.2"
        },
        {
          "value": "500"
        },
        {
          "value": "6.65"
        },
        {
          "value": "10000"
        },
        {
          "value": "500"
        },
        {
          "value": "1"
        },
        {
          "value": "1500"
        },
        {
          "value": "3"
        }
      ]
    }
  ],
  "rowCount": 1,
  "metadata": {
    "schemaRestrictionResponse": {},
    "currencyCode": "USD",
    "timeZone": "America/Los_Angeles",
    "section": "SECTION_ADVERTISING"
  },
  "kind": "analyticsData#runReport"
}

Yanıtın dönüşüm raporu olarak değerlendirildiğini doğrulamak için yanıttaki metadata.section alanının SECTION_ADVERTISING olarak ayarlandığını kontrol edebilirsiniz.

Dönüşüm raporları için kullanılabilen boyutların ve metriklerin tam listesi için Dönüşüm Raporları Şeması'na bakın.