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 modelleri desteğiyle dönüşüm etkinliklerine odaklanan raporlar oluşturmanıza olanak tanır. Data API 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 Yardım Merkezi makalesini inceleyin.

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

Dönüşüm raporlama, dönüşümleri belirli kampanyalar, kaynaklar ve aracılarla ilişkilendirerek pazarlama çalışmalarınızın etki düzeyini analiz etmenizi sağlar. Yalnızca etkinlikleri sayan standart etkinlik tabanlı raporların aksine dönüşüm raporlama, dönüşümle sonuçlanan temas noktaları arasında kredi 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ı (ör. eventCount) sağlar ve mülkünüzdeki genel etkinliği anlamak için kullanışlıdır.
• Dönüşüm raporları: Dönüşüm olarak işaretlenen etkinliklere odaklanın. Bu raporlar belirli boyutları ve metrikleri kullanır (Dönüşüm Raporları Şeması'na bakın) 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 veya daha fazla dönüşüm metriğini (ör. allConversionsByInteractionDate) sorgulayan ya da istek içeriğinde conversionSpec alanının doldurulduğu istekler dönüşüm raporlama olarak değerlendirilir.

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

• conversionActions: Rapora dahil edilecek dönüşüm işlemi kaynak adlarının listesi (ör. ["conversionActions/12345"]). Boş bırakılırsa tüm dönüşümler dahil edilir. Geçerli dönüşüm işlemi kimlikleri, GetMetadata yönteminin yanıtındaki conversions listesinde bulunan 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 dönüşümleri kampanya adına göre gösteren bir dönüşüm raporu oluşturmak için runReport yöntemini kullanan örnek bir istek aşağıda verilmiştir.

{
    "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, 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 Reklamcılık > 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 alma

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 istiyorsanız GA mülk kimliğini belirttiğinizden emin olun (tüm mülklerde ortak olan alanları almak için 0 kullanmak yerine).

Yanıtta, kullanılabilir dönüşüm işlemlerini içeren 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üşümlerle ilgili rapor oluşturmak için conversionActions alanını 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ü raporunu yeniden oluşturur.

{
    "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 istek için örnek bir 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ıttaki metadata.section alanının SECTION_ADVERTISING olarak ayarlandığını kontrol ederek yanıtın dönüşüm raporlama olarak değerlendirildiğini doğrulayabilirsiniz.

Dönüşüm raporları için kullanılabilen boyut ve metriklerin tam listesini Dönüşüm Raporları Şeması'nda bulabilirsiniz.