Önceki Search Ads 360 Reporting API kullanımdan kaldırıldı. Artık yeni Search Ads 360 Reporting API'yi kullanarak raporlarınızı oluşturabilirsiniz.
Search Ads 360 Conversion API'deki get ve getByCustomerId yöntemlerinin desteğinin 2025'in 3. çeyreğinde sonlandırılacağını unutmayın. Dönüşüm verilerine erişmeye devam etmek için yeni Search Ads 360 Reporting API'yi kullanarak dönüşüm kaynağını kullanarak bir rapor oluşturmanız gerekir. Daha fazla ayrıntıyı burada bulabilirsiniz.
Diğer Search Ads 360 Conversion API işlevleri desteklenmeye devam edecektir.
Özel Floodlight Değişkenleriyle İlgili Rapor Oluşturma
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Reklamverenler, dönüşüm verilerini raporlamak için özel Floodlight değişkenlerini
kullanıcının satın aldığı filmin türü, adı ve kullanıcı adı gibi
ürünün satın alındığı mağazanın durumu, kargo maliyetleri vs. Veriler yüklenebilir
reklamverenin sitesindeki bir Floodlight etiketine veya
Search Ads 360 API tarafından
ve verileri içeren raporları indirmek için API'yi kullanabilirsiniz.
Özel Floodlight hakkında daha fazla bilgi
değerleridir.
Metrik veya boyut
Reklamverenler, özel Floodlight değişkenlerini ayarlamanın bir parçası olarak Search Ads 360'ı
Her değişkenin raporlarda nasıl kullanılabileceğini gösteren kullanıcı arayüzü:
Metrik: Çoğu raporda Search Ads 360,
metrik olarak tanımlanan değişkenlerdir.
.
Örneğin, bir reklamveren gönderim maliyetlerini izlemek için bir özel Floodlight değişkeni kullanır.
Bir Search Ads 360 kullanıcısı bu değişkeni metrik olarak tanımlar ve değişkene
adGroup raporunda
Rapor kapsamındaki her reklam grubuyla ilişkili toplam kargo maliyetlerini görürsünüz.
conversion içinde
raporunda, Search Ads 360 birleştirilmiş veriler yerine her bir dönüşüm hakkında ham veriler sağlar.
Not: Özel metrikler şurada da görünebilir:
Floodlight raporlama sütunları.
Search Ads 360 kullanıcı arayüzünde, kullanıcılar Floodlight raporlama sütunlarına özel metrikler ekleyip
Floodlight raporlama sütunları hakkında bilgi edinin. Bu Floodlight sütunlarını da
Tıpkı diğer türden her reklam türüne ekleyebileceğiniz gibi
kaydedilen sütunu tıklayın.
Boyut: Boyut olarak tanımlanan değişkenler, segmentlere ayırma işlemi için kullanılabilir
çoğu raporda yer alır.
.
Örneğin, bir reklamveren mağaza adlarını izlemek için bir özel Floodlight değişkeni kullanır. Şu tarihten sonra:
Search Ads 360 kullanıcısı bu değişkeni bir boyut olarak tanımladığında, bir değeri segmentlere ayırmak için
adGroup raporu ve
Her mağazadan reklam grubundaki reklamlarla ilişkilendirilmiş satın alma işlemlerinin sayısını görmek.
conversion içinde
raporu, Search Ads 360 yalnızca tek tek dönüşümlerle ilgili ham veriler sağlar
birleştirilmiş veri. Bu nedenle, conversion raporuna özel bir boyut eklediğinizde,
boyut değerini görürsünüz. Önceki paragraftan itibaren verilen örnekten devam edersek,
bir conversion raporunu storeName özel boyutuna göre segmentlere ayırdığınızda
her bir satın alma işleminin gerçekleştiği mağazanın adı
Not: Search Ads 360 kullanıcıları bir
Floodlight raporlama sütununda
özel boyutları filtre olarak kullanabilir. Böylece, sütunda yalnızca
belirli bir boyut değeri kaydetti.
Bir rapor isteğine özel metrikler ekleme
Bir rapor isteğine özel metrikler eklemek için:
Ardından bir rapor isteğine şunları ekleyin:
Örneğin bir reklamveren shippingCost adlı bir özel metrik oluşturduysa
kargo maliyetini customMetricName rapora dahil edin:
{
"reportScope": {
"agencyId": "12300000000000456", // Replace with your ID
"advertiserId": "21700000000011523", // Replace with your ID
},
...
"columns": [
{
"customMetricName": "shippingCost",
"platformSource": "floodlight"
}
],
...
}
Bir raporu özel boyuta göre segmentlere ayırma
Bir raporu özel boyuta göre segmentlere ayırmak için:
Önceki kolay adını bilmeniz gerekir:
özel
Floodlight değişkeni Campaign Manager'da oluşturuldu.
Kolay ad, kurulum sırasında Search Ads 360 kullanıcı arayüzünde de görünür
özel boyutları ve metrikleri kullanabilirsiniz.
Raporun kapsamının belirli bir reklamveren olması gerekir
veya daha düşük olmasını sağlayın.
-
Her rapor isteği yalnızca bir özel boyut belirtebilir. Ancak
istek şunları içerebilir:
özel olmayan segmentler ekleyin.
.
Örneğin, bir raporu storeName özel boyutuna göre segmentlere ayırabilir ve
üç aylık dönem ve cihaza özel olmayan segmentlere göre gösterilir. Yalnızca satır sayısının iki kat daha fazla
katlanarak arttı.
Ardından bir rapor isteğine şunları ekleyin:
Örneğin, bir reklamveren storeName adlı bir özel boyut oluşturursa
Metrikleri mağaza adına göre segmentlere ayırmak için rapora storeName customDimensionName değerini ekleyin:
{
"reportScope": {
"agencyId": "20700000000000123", // Replace with your IDs
"advertiserId": "2170000012345" // Replace with your IDs
},
"reportType": "campaign",
"columns": [
{ "columnName": "campaignId" },
{ "columnName": "clicks" },
{ "columnName": "cost" },
{ "columnName": "dfaRevenue"},
{
"customDimensionName": "storeName",
"platformSource": "floodlight"
}
],
...
}
Aksi belirtilmediği sürece bu sayfanın içeriği Creative Commons Atıf 4.0 Lisansı altında ve kod örnekleri Apache 2.0 Lisansı altında lisanslanmıştır. Ayrıntılı bilgi için Google Developers Site Politikaları'na göz atın. Java, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2024-08-20 UTC.
[null,null,["Son güncelleme tarihi: 2024-08-20 UTC."],[[["\u003cp\u003eThe new Search Ads 360 Reporting API offers increased flexibility for creating custom reports and integrating data.\u003c/p\u003e\n"],["\u003cp\u003eCustom Floodlight variables allow advertisers to report unique conversion data like product details or shipping costs.\u003c/p\u003e\n"],["\u003cp\u003eCustom Floodlight variables can be defined as metrics (aggregated values) or dimensions (report segmentation).\u003c/p\u003e\n"],["\u003cp\u003eTo include custom metrics in reports, use the \u003ccode\u003ecustomMetricName\u003c/code\u003e and \u003ccode\u003eplatformSource: floodlight\u003c/code\u003e in your request.\u003c/p\u003e\n"],["\u003cp\u003eTo segment reports by a custom dimension, use the \u003ccode\u003ecustomDimensionName\u003c/code\u003e and \u003ccode\u003eplatformSource: floodlight\u003c/code\u003e while limiting to one custom dimension per request.\u003c/p\u003e\n"]]],["The new Search Ads 360 Reporting API allows building custom reports and integrating data into reporting applications. Advertisers can use custom Floodlight variables for unique conversion data. These variables can be defined as metrics (aggregated data) or dimensions (segmentation). To include custom metrics, specify the friendly name and set the platform source to \"floodlight\" in the report request. Similarly, segmenting by a custom dimension requires specifying its friendly name and \"floodlight\" as the platform source. Only one custom dimension is allowed per report request.\n"],null,["# Report on Custom Floodlight Variables\n\nThe new Search Ads 360 Reporting API is now available. The new API provides enhanced flexibility to build custom reports and integrate the data into your reporting applications and processes. Learn more about migrating to and using the [new Search Ads 360 Reporting\nAPI](https://developers.google.com/search-ads/reporting/overview).\n\n\nAdvertisers use **custom Floodlight variables** to report conversion data that is\nunique to their business needs, such as the genre of a movie that a user purchases, the name\nof the store from which an item is purchased, shipping costs, and so on. The data can be uploaded\nby a Floodlight tag on the advertiser's site or\n[by the Search Ads 360 API](/search-ads/v2/how-tos/conversions/custom-data),\nand you can use the API to download reports that contain the data.\n\n\n[Learn more](https://support.google.com/searchads/answer/4397154) about custom Floodlight\nvariables in Search Ads 360.\n\n### Metric or dimension\n\nAs part of setting up custom Floodlight variables, an advertiser uses the Search Ads 360\nUI to indicate how each variable can be used in reports:\n\n-\n **Metric** : In most reports, Search Ads 360 aggregates the values of\n variables that are defined as metrics. \n\n For example, an advertiser uses a custom Floodlight variable to track shipping costs.\n If a Search Ads 360 user defines this variable as a metric and you include the variable\n in an [`adGroup`](/search-ads/v2/report-types/adGroup) report,\n you'll see the total shipping costs associated with each ad group in the report's scope.\n\n\n In the [`conversion`](/search-ads/v2/report-types/conversion)\n report, Search Ads 360 provides raw data about individual conversions instead of aggregated data.\n\n Note: Custom metrics can also appear in\n [Floodlight reporting columns](https://support.google.com/searchads/answer/6024745). In the\n Search Ads 360 UI, users add custom metrics to Floodlight reporting columns and then include\n the Floodlight reporting columns in reports. You can also include these Floodlight columns\n in a report request, just as you can include any other type of\n [saved column](/search-ads/v2/how-tos/reporting/saved-columns).\n-\n **Dimension** : Variables that are defined as dimensions can be used to segment\n most reports. \n\n For example, an advertiser uses a custom Floodlight variable to track store names. After\n a Search Ads 360 user defines this variable as a dimension, you can use it to segment an\n [`adGroup`](/search-ads/v2/report-types/adGroup) report and\n see the number of purchases from each store that are attributed to ads in the ad group.\n\n\n In the [`conversion`](/search-ads/v2/report-types/conversion)\n report, Search Ads 360 provides raw data about individual conversions instead of\n aggregated data. So when you add a custom dimension to the `conversion` report,\n you'll see the dimension value. Continuing the example from the previous paragraph, if you\n segment a `conversion` report by the storeName custom dimension, you'll see\n the name of the store in which each specific purchase occurred.\n\n\n Note: When Search Ads 360 users define a\n [Floodlight reporting column](https://support.google.com/searchads/answer/6024721), they\n can use custom dimensions as a filter so the column reports only the conversions that\n recorded a specific dimension value.\n\n### Include custom metrics in a report request\n\nTo include custom metrics in a report request:\n\n-\n You'll need to know the **friendly** name that was\n specified when the\n [custom\n Floodlight variable was created in Campaign Manager](https://support.google.com/dcm/answer/2823222#customvar).\n The friendly name also appears in the Search Ads 360 UI when\n [setting up\n custom dimensions and metrics](https://support.google.com/searchads/answer/6024747#set-up).\n\n-\n The scope of the report needs to be a specific advertiser or lower.\n\nThen in a report request, include:\n\n-\n [`customMetricName`](/search-ads/v2/reference/reports#request.columns.customMetricName): Specifies the friendly name of the custom metric.\n\n The custom metric name is case sensitive.\n\n-\n [`platformSource`](/search-ads/v2/reference/reports#request.columns.platformSource): Always set this to **floodlight**.\n\n\nFor example if an advertiser created a custom metric named **shippingCost** ,\ninclude the shippingCost `customMetricName` in a report: \n\n```text\n{\n \"reportScope\": {\n \"agencyId\": \"12300000000000456\", // Replace with your ID\n \"advertiserId\": \"21700000000011523\", // Replace with your ID\n },\n ...\n \"columns\": [\n {\n \"customMetricName\": \"shippingCost\",\n \"platformSource\": \"floodlight\"\n }\n ],\n ...\n}\n \n```\n\n### Segment a report by a custom dimension\n\nTo segment a report by a custom dimension:\n\n-\n You'll need to know the **friendly** name that was\n specified when the [custom\n Floodlight variable was created in Campaign Manager](https://support.google.com/dcm/partners/answer/2823222#customvar).\n The friendly name also appears in the Search Ads 360 UI when setting up\n custom dimensions and metrics.\n\n- The scope of the report needs to be a specific advertiser\n or lower.\n\n- Each report request can only specify **one** custom dimension. But the\n request can include [additional non-custom segments](/search-ads/v2/how-tos/reporting/segmented-reports#multiple). \n\n For example, you can segment a report by the storeName custom dimension **and**\n by the quarter and device non-custom segments. Just be aware that the number of rows could\n increase exponentially with each additional segment.\n\nThen in a report request, include:\n\n-\n [`customDimensionName`](/search-ads/v2/reference/reports#request.columns.customDimensionName): Specifies the friendly name of the custom dimension.\n\n The custom dimension name is case sensitive.\n\n-\n [`platformSource`](/search-ads/v2/reference/reports#request.columns.platformSource): Always set this to **floodlight**.\n\n\nFor example if an advertiser created a custom dimension named **storeName** ,\ninclude the storeName `customDimensionName` in a report to segment metrics by store name: \n\n```text\n{\n \"reportScope\": {\n \"agencyId\": \"20700000000000123\", // Replace with your IDs\n \"advertiserId\": \"2170000012345\" // Replace with your IDs\n },\n \"reportType\": \"campaign\",\n\n \"columns\": [\n { \"columnName\": \"campaignId\" },\n { \"columnName\": \"clicks\" },\n { \"columnName\": \"cost\" },\n { \"columnName\": \"dfaRevenue\"},\n\n {\n \"customDimensionName\": \"storeName\",\n \"platformSource\": \"floodlight\"\n }\n ],\n ...\n}\n \n```"]]
