Uygulama Dönüşümü İzleme ve Yeniden Pazarlama - İstek/Yanıt Özellikleri

Uygulama Kullanıcı Aracısı

Spam ile mücadele etmeye yönelik daha kapsamlı çalışmalarımızın bir parçası olarak, bir uygulama kullanıcısı adına bir analiz/reklam ürünü tarafından gönderilen User-Agent başlığı için standartlaştırılmış bir spesifikasyon geliştirdik. Uygulama kullanıcı aracısı, aşağıdaki spesifikasyona uymak için yerel koddan türetilebilir:

name version (os_and_version; locale; device; build; Proxy)

Bu alanların tanımı aşağıdaki gibidir:

Kullanıcı aracısı bileşenleri
name

Analytics/Ads ürününün adı. (Google AdMob)

Kullanıcı aracısı istemci tarafında oluşturulursa name yerine istemci uygulamasının paket kimliğinin kullanılması gerektiğini unutmayın.

Android
// Specified by API consumer.
iOS
// Specified by API consumer.
version

Analiz/reklam ürününün sürümü. (7.10.1)

Android
// Specified by API consumer.
iOS
// Specified by API consumer.
os_and_version

Uygulamanın üzerinde çalıştığı işletim sistemi ve işletim sistemi sürümü. (Android 6.0 )

Android
String osAndVersion =
    "Android " + Build.VERSION.RELEASE;
iOS
UIDevice *uid =
  [UIDevice currentDevice];
NSString *osAndVersion =
  [NSString
    stringWithFormat:@"%@ %@",
    [uid systemName],
    [uid systemVersion]];
locale

Cihaz için IETF yerel ayar etiketi. İki harfli dil ve ülke kodu, alt çizgiyle ayrılır. (en_US)

Android
String locale = Locale.getDefault();
iOS
NSString *locale =
  [[NSLocale currentLocale]
    localeIdentifier]
device

Analiz/reklam ürünü çalıştıran fiziksel cihazın adı. (iPhone9,1)

Android
String device = Build.MODEL;
iOS
@import Darwin.sys.sysctl;

NSString *device(void) {
  size_t bufferSize = 64;
  NSMutableData *buffer =
    [[NSMutableData alloc]
      initWithLength:bufferSize];
  int status =
    sysctlbyname("hw.machine",
      buffer.mutableBytes,
      &bufferSize, NULL, 0);
  if (status != 0) {
    return nil;
  }
  return [[NSString alloc]
    initWithCString:buffer.mutableBytes
    encoding:NSUTF8StringEncoding];
}
build

"Build/" ve ardından işletim sisteminin derleme numarası. (Build/13D15)

Android
String build = "Build/" + Build.ID;
iOS
@import Darwin.sys.sysctl;

NSString *build(void) {
  size_t bufferSize = 64;
  NSMutableData *buffer =
    [[NSMutableData alloc]
      initWithLength:bufferSize];
  int status =
    sysctlbyname("kern.osversion",
      buffer.mutableBytes,
      &bufferSize, NULL, 0);
  if (status != 0) {
    return nil;
  }
  return [[NSString alloc]
    initWithCString:buffer.mutableBytes
    encoding:NSUTF8StringEncoding];
}

Uygulama kullanıcı aracısı sunucu tarafında oluşturulurken uygulama kullanıcı aracısının sonuna yalnızca ; Proxy ekleyin. Uygulama User-Agent'ı tamamen istemci tarafında oluşturulmuşsa ; Proxy öğesini hariç tutun. Bu nedenle, bir uygulamanın kullanıcı aracısı şu şekilde olabilir:

  • Android: AdMob/7.10.1 (Android 6.0; en_US; SM-G900F; Build/MMB29M; Proxy)
  • iOS: AdMob/7.10.1 (iOS 10.0.2; en_US; iPhone9,1; Build/13D15; Proxy)

Dönüşüm İzleme İsteği Kılavuzu

Dönüşüm izleme isteklerinin amacı, Google Ads'i bir dönüşüm olarak izlenmesi ve/veya yeniden pazarlama listesini doldurmak için kullanılması gereken bir uygulama etkinliği hakkında bilgilendirmek ve etkinlikten önce gelen tıklamaları açıklayan meta verileri almaktır.

Tüm API çağrıları www.googleadservices.com alanına yapılır. Dönüşüm istekleri, aşağıdaki yolda HTTPS üzerinden gönderilen POST isteklerdir: 

/pagead/conversion/app/version
burada version, dönüşüm izleme API'sinin amaçlanan sürümüdür.

Standart bir uygulama dönüşümü isteği, App Conversion API v1.1 için aşağıdaki parametreleri içerir.

Dönüşüm İzleme İsteği
dev_token

Zorunlu

Konum: Sorgu

API tüketicisine verilen benzersiz ve statik geliştirici jetonu.

Z_eErE4DkvcKjDM1OVE4c4
link_id

Zorunlu

Konum: Sorgu

API tüketicisinin geliştirici jetonunu belirli bir uygulamaya bağlayan bağlantı tanımlayıcısı.

31FF8D67E5BB5DD5029DCC2734C2F884
app_event_type

Zorunlu

Konum: Sorgu

Gerçekleşen uygulama etkinliğinin adı. Bu alan bir numaralandırmadır ve yalnızca aşağıdaki değerleri kabul eder:

 • first_open
 • session_start
 • in_app_purchase
 • view_item_list
 • view_item
 • view_search_results
 • add_to_cart
 • ecommerce_purchase
 • custom

Yüklemeleri ilişkilendirmek için her zaman first_open etkinliği, oturumları yeniden ilişkilendirmek için her zaman session_start etkinliği gönderilmelidir. Yerel uygulama mağazası üzerinden yapılan satın alma işlemleri için in_app_purchase, diğer tüm satın alma işlemleri için ecommerce_purchase kullanın.
app_event_name

Belirli koşullarda gereklidir.

Konum: Sorgu

app_event_type alanında kabul edilmeyen özel uygulama etkinliklerinin adı. Bu alan, 1 ila 64 Unicode karakteri (UTF-8 kodlaması kullanılarak) içermelidir. Bu alan, app_event_type özel ise zorunludur.

level_achieved
Level Achieved

Bu alan, app_event_type için ayrılmış değerlerden hiçbirini içermemelidir. Ayrılmış bir etkinlik adı kullanılırsa API, APP_EVENT_NAME_RESERVED_VALUE hatası döndürür.
app_event_data

İsteğe bağlı

Konum: Gövde

Diğer tüm zengin etkinlik verilerini, anahtarları değerlerle eşleyen basit bir JSON nesnesi olarak iletin. Kabul edilebilir değerler dize ve dize dizisidir.

{"level": 5, "attempts": 20}
odm_info

iOS'te Entegre Dönüşüm Ölçümü kullanılırken gereklidir

Konum: Sorgu

Google Cihaz Üzerinde Ölçüm (ODM): Etkinlik Verileri SDK'sından iOS uygulaması yükleme veya yeniden yükleme sırasında yakalanan info sorgu parametresinin değeri. Bu alan, iOS uygulama kampanyaları için Entegre Dönüşüm Ölçümü'nü etkinleştirir.

XYZr_AB8C-_zGtKjUhqtzPLeQ8lbJB5dADVR0tpZ9f-28sN5qN9GTZ_FztjL0OL
FzgxUJDhZr8w6lwGxAwPcxSwR5orjWepZiVP7sRRoCiaHerR-1TP17eJKtazgeSg
_CVEs13LllDTfrhVM8uWISqlg8dXobsLzmj8C7WrOlktHA5P_E23
id_type

Zorunlu

rdid alanında iletilen tanımlayıcının türü.

Android

advertisingid
 
appsetid

iOS

idfa
 
idfv
rdid

Zorunlu

Konum: Sorgu

Ham cihaz kimliğini temsil eden geçerli bir UUID dizesi.

f10e1de2-e237-4f50-b6aa-843c45cc63d6

Uygulama şeffaflığı takibi izni verilmeyen bir kullanıcıya ait cihaz kimliği gibi durumlarda cihaz kimliği eksikse bu kimliği sıfır olarak ayarlayın.

00000000-0000-0000-0000-000000000000
ctry_c

Zorunlu

Konum: Sorgu

Dönüşümün gerçekleştiği ülkeyi belirtmek için kullanılan iki harfli ISO ülke kodu.

Bu alan, iOS ve Android'de kullanıcı düzeyinde olmayan uygulama dönüşümü ölçümünün etkinleştirilmesi için gereklidir.

US, IN
eea

Belirli koşullarda zorunlu

Konum: Sorgu

AEA kapsamı.

0: AB tüzükleri bu kullanıcı ve dönüşüm için geçerli değildir.

1: AB tüzükleri bu kullanıcı ve dönüşüm için geçerlidir. Örneğin, bir kullanıcı AEA'da bulunuyorsa geçerli AB tüzükleri kapsamındadır. 

*Required to be sent when the value is known.
ad_personalization

Belirli koşullarda zorunlu

Konum: Sorgu

Kişiselleştirilmiş reklamlarla ilgili işaretler

0: Son kullanıcı, reklam kişiselleştirme iznini reddetti

1: Son kullanıcı, reklam kişiselleştirme izni verdi 

*Required to be sent when the value is known.
ad_user_data

Belirli koşullarda zorunlu

Konum: Sorgu

Kullanıcı verilerinin reklam amacıyla kullanılmasına yönelik izin işareti

0: Kullanıcı, kullanıcı düzeyindeki verilerin reklam amacıyla Google'a iletilmesine izin vermedi.

1: Kullanıcı, kullanıcı düzeyindeki verilerin reklam amacıyla Google'a iletilmesine izin verdi. 

*Required to be sent when the value is known.
lat

Zorunlu

Konum: Sorgu

Cihazın reklam izlemeyi sınırla durumu.

  • 0: Kullanıcı, reklam izlemeyi sınırlamayı seçmemiştir.
  • 1: Kullanıcı, reklam izlemeyi sınırlamayı seçmiştir.
app_version

Zorunlu

Konum: Sorgu

Uygulamanın mevcut sürümü. Bu, aşağıdaki gibi standartlaştırılmalıdır.

Android

packageManager.getPackageInfo(packageName(),
  PackageManager.GET_META_DATA).versionName

iOS

[[[NSBundle mainBundle] infoDictionary]
  objectForKey:@"CFBundleShortVersionString"]
 
1.2.4
os_version

Zorunlu

Konum: Sorgu

Uygulamanın barındırıldığı işletim sisteminin mevcut sürümü. Bu, aşağıdaki gibi standartlaştırılmalıdır.

Android

android.os.Build.VERSION.RELEASE

iOS

[[UIDevice currentDevice] systemVersion]
sdk_version

Zorunlu

Konum: Sorgu

Etkinliği ölçen SDK'nın sürümü. Bu özellik temel olarak hata ayıklama için kullanıldığından, SDK sürümlerinizle yayınlandığı şekliyle yayınlanan sürümü yansıtmalıdır. Uygulama SDK kullanmıyorsa lütfen app_version ile aynı değeri iletin. 

1.9.5r6
timestamp

Zorunlu

Konum: Sorgu

Dönüşüm etkinliğinin gerçekleştiği UNIX zaman damgası (mikrosaniye hassasiyetinde saniye cinsinden).

1432681913.123456
fot

Zorunlu

Konum: Sorgu

Tüm sonraki oturumlar ve yükleme sonrası etkinlikler için mikrosaniye hassasiyetinde, saniye cinsinden ilgili first_open UNIX zaman damgası.

1432681913.123456
value

İsteğe bağlı

Konum: Sorgu

Etkinliğin maddi değeri (varsa). Bu değer her zaman, değerin tam sayı ve kesirli kısmını ayırmak için ondalık nokta kullanılarak makine tarafından okunabilir bir kayan nokta değeri olarak biçimlendirilmelidir.

1.99
currency_code

Belirli koşullarda gereklidir.

Konum: Sorgu

value parametresi için ISO 4217 para birimi kodu. Bu alan, value parametresi sağlanmışsa ve boş değilse zorunludur.

USD
gclid

Belirli koşullarda gereklidir.

Konum: Sorgu

Uygulamayı açan bir derin bağlantı URL'sindeki gclid sorgu parametresinin değeri.

Cj0KEQjw0dy4BRCuuL_e5M
market_referrer_gclid

Belirli koşullarda gereklidir.

Konum: Sorgu

gclid sorgu parametresinin değeri, Play Install Referrer API aracılığıyla install_referrer değerinden alınan bir derin bağlantı URL'sinden alınır.

BX3QojHp4mY5MrJtFM_d1u
gclid_only_request

Belirli koşullarda gereklidir.

Konum: Sorgu

rdid (advertisingid) not kullanılabilir olduğunda veya tüm zeroes ve gclid ya da market_referrer_gclid mevcut olduğunda gclid tabanlı ilişkilendirme için tanımlayıcı.

1
gbraid

Belirli koşullarda gereklidir.

Konum: Sorgu

Uygulamayı açan derin bağlantı URL'si üzerinden gönderilen son görülme gbraid değeri. Bunun, uygulamada gerçekleşen gelecekteki dönüşümlerle birlikte gönderilebilmesi için uygulamada önbelleğe alınması gerektiğini unutmayın.

ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
app_open_source

Belirli koşullarda gereklidir.

Konum: Sorgu

Reklam tıklaması derin bağlantısını veya organik uygulama oturumlarını tanımlamak için kullanılan değer.

ad_click or organic
User-Agent

Zorunlu

Konum: Başlık

Önceki bölümde tanımlandığı şekilde uygulama kullanıcı aracısı.

AdMob/7.10.1 (Android 6.0; en_US; SM-G900F; Build/MMB29M)
X-Forwarded-For

Zorunlu

Konum: Başlık

Etkinliğin ölçüldüğü cihazın genel IPv4 veya IPv6 adresi.

216.58.194.174

Tüm istekler HTTPS üzerinden gönderilmelidir. HTTP üzerinden alınan ping'ler reddedilir.

İstek gövdesi boşsa (app_event_data yükünde zengin etkinlik verisi iletilmediği durumlarda) sunucumuz, isteğinizde Content-Length: 0 üstbilgisini açıkça ayarlamanızı gerektirir.

Etkinlik verilerini kodlama

app_event_data gövde parametresi için lütfen temel veri türlerinde aşağıdaki kuralları kullanın:

  • Float

    • Uygulama yerelleştirmesinden bağımsız olarak ondalık ayırıcı olarak nokta karakterini kullanma
    • Parasal değerleri göstermek için iki basamaklı ondalık duyarlılık kullanın. Örneğin, 2,99
    • Üstel gösterim kullanmayın (ör.2E+9).
    • Rakam gruplarını ayırmak için virgül karakteri kullanmayın. Örneğin: 1.000.000
    • Geçerli örnekler:
      • -0.5
      • 2.99
      • 1000000.123

  • Integer

    • Yalnızca ondalık basamak içermeyen tam sayı değerleri gönderin.
    • Rakam gruplarını ayırmak için virgül karakteri kullanmayın (ör. 1.000.000).
    • Geçerli örnekler:
      • 1000
      • -11
      • 0

  • Tarih

    • Tarih biçimi: yyyy-aa-gg
      • yyyy = yıl (dört basamaklı), ör. 2016
      • mm = iki haneli ay (ör. Eylül için 09)
      • dd = iki basamaklı gün (ör.ayın 23. günü için 23)
    • Her zaman yukarıda belirtilen basamak sayısını gönderin.Örneğin, ayın 5. günü için gg değerini gönderiyorsanız 05 değerini gönderin.
    • Geçerli örnekler:
      • "2016-09-23"
      • "1990-12-31"

  • Zaman damgası

    • Zaman biçimi: Mikrosaniye hassasiyetinde UTC saat diliminde tanımlanan saniye cinsinden Unix/Epoch zaman damgası
    • Geçerli örnekler:
      • 1478713087 for Wed, 09 Nov 2016 17:38:07 GMT
      • 1073513982.123000 for Wed, 07 Jan 2004 22:19:42.123 GMT

  • Diziler

    • Yalnızca temel değer dizileri (dizeler, sayılar ve boole değerleri) gönderin.
    • Geçerli örnekler:
      • [123, 456, 789]
      • ["abc"]

Örnek İstekler

Entegre Dönüşüm Ölçümü için Cihaz Üzerinde Ölçüm: Etkinlik Verileri SDK'sı ile ilk açılış isteğine örnek:

POST /pagead/conversion/app/1.1
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=first_open
       &odm_info=abcdEfadGdaf
       &rdid=0F7AB11F-DA50-498E-B225-21AC1977A85D
       &id_type=idfv
       &eea=0
       &ad_personalization=1
       &ad_user_data=1
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
Host: www.googleadservices.com
User-Agent: MyAnalyticsCompany/1.0.0 (iOS 10.0.2; en_US; iPhone9,1; Build/13D15; Proxy)
X-Forwarded-For: 216.58.194.174
Content-Type: application/json; charset=utf-8

Cihaz üzerinde ölçüm: Entegre dönüşüm ölçümü için etkinlik verileri SDK'sı olmadan yapılan bir ilk açılış isteği örneği:

POST /pagead/conversion/app/1.1
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=first_open
       &rdid=0F7AB11F-DA50-498E-B225-21AC1977A85D
       &id_type=idfv
       &eea=0
       &ad_personalization=1
       &ad_user_data=1
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
Host: www.googleadservices.com
User-Agent: MyAnalyticsCompany/1.0.0 (iOS 10.0.2; en_US; iPhone9,1; Build/13D15; Proxy)
X-Forwarded-For: 216.58.194.174
Content-Type: application/json; charset=utf-8

Entegre dönüşüm ölçümü için cihaz üzerinde ölçüm: etkinlik verileri SDK'sının kullanıldığı bir yükleme sonrası istek örneği:

POST /pagead/conversion/app/1.1
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=first_open
       &odm_info=abcdEfadGdaf
       &rdid=0F7AB11F-DA50-498E-B225-21AC1977A85D
       &id_type=idfv
       &eea=0
       &ad_personalization=1
       &ad_user_data=1
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &&fot=1432681913.123456
Host: www.googleadservices.com
User-Agent: MyAnalyticsCompany/1.0.0 (iOS 10.0.2; en_US; iPhone9,1; Build/13D15; Proxy)
X-Forwarded-For: 216.58.194.174
Content-Type: application/json; charset=utf-8

Cihaz Üzerinde Ölçüm: Etkinlik Verileri SDK'sı olmadan ilk açılış isteğine örnek:

POST /pagead/conversion/app/1.1
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=first_open
       &rdid=0F7AB11F-DA50-498E-B225-21AC1977A85D
       &id_type=idfv
       &eea=0
       &ad_personalization=1
       &ad_user_data=1
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
Host: www.googleadservices.com
User-Agent: MyAnalyticsCompany/1.0.0 (iOS 10.0.2; en_US; iPhone9,1; Build/13D15; Proxy)
X-Forwarded-For: 216.58.194.174
Content-Type: application/json; charset=utf-8

ACAPI v1.1 için Android'de deterministik olmayan bir dönüşümle ilgili ilk açılış isteği örneği:

POST /pagead/conversion/app/1.1
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=first_open
       &rdid=0F7AB11F-DA50-498E-B225-21AC1977A85D
       &id_type=appsetid
       &eea=0
       &ad_personalization=1
       &ad_user_data=1
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &ctry_c=IN
Host: www.googleadservices.com
User-Agent: MyAnalyticsCompany/1.0.0 (android 11; en-GB; RMX2040; Build/_; Proxy)
X-Forwarded-For: 216.58.194.174
Content-Type: application/json; charset=utf-8

Özel olmayan bir etkinlik türü ve gelir bilgileri içeren geçerli bir dönüşüm izleme isteği örneği:

POST /pagead/conversion/app/1.1
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=in_app_purchase
       &rdid=0F7AB11F-DA50-498E-B225-21AC1977A85D
       &id_type=idfa
       &eea=0
       &ad_personalization=1
       &ad_user_data=1
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &value=1.99
       &currency_code=USD
       &market_referrer_gclid=BX3QojHp4mY5MrJtFM_d1u
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &gclid_only_request=0
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
Host: www.googleadservices.com
User-Agent: MyAnalyticsCompany/1.0.0 (iOS 10.0.2; en_US; iPhone9,1; Build/13D15; Proxy)
X-Forwarded-For: 216.58.194.174
Content-Type: application/json; charset=utf-8
 
{"app_event_data":{"item_id":["Crayons","Markers"]}}

Özel olmayan bir etkinlik türü ve rdid (advertisingid) kullanılamayan gelir bilgileri içeren geçerli bir dönüşüm izleme isteği örneği:

POST /pagead/conversion/app/1.1
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=in_app_purchase
       &rdid=00000000-0000-0000-0000-000000000000
       &id_type=advertisingid
       &eea=0
       &ad_personalization=1
       &ad_user_data=1
       &lat=1
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &value=1.99
       &currency_code=USD
       &market_referrer_gclid=BX3QojHp4mY5MrJtFM_d1u
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &gclid_only_request=1
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
Host: www.googleadservices.com
User-Agent: MyAnalyticsCompany/1.0.0 (iOS 10.0.2; en_US; Android,1; Build/13D15; Proxy)
X-Forwarded-For: 216.58.194.174
Content-Type: application/json; charset=utf-8
 
{"app_event_data":{"item_id":["Crayons","Markers"]}}

Geçerli bir oturum başlatma isteği örneği:

POST /pagead/conversion/app/1.1
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=session_start
       &rdid=0F7AB11F-DA50-498E-B225-21AC1977A85D
       &id_type=idfa
       &eea=0
       &ad_personalization=1
       &ad_user_data=1
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
Host: www.googleadservices.com
User-Agent: MyAnalyticsCompany/1.0.0 (iOS 10.0.2; en_US; iPhone9,1; Build/13D15; Proxy)
X-Forwarded-For: 216.58.194.174
Content-Type: application/json; charset=utf-8

Derin bağlantıdan başlayan bir oturum için geçerli bir oturum başlatma yeniden ilişkilendirme isteği örneği: example://product/123?gclid=Cj0KEQjw0dy4BRCuuL_e5M

POST /pagead/conversion/app/1.1
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=session_start
       &rdid=0F7AB11F-DA50-498E-B225-21AC1977A85D
       &id_type=idfa
       &eea=0
       &ad_personalization=1
       &ad_user_data=1
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
Host: www.googleadservices.com
User-Agent: MyAnalyticsCompany/1.0.0 (iOS 10.0.2; en_US; iPhone9,1; Build/13D15; Proxy)
X-Forwarded-For: 216.58.194.174
Content-Type: application/json; charset=utf-8

Reklam kullanıcı verileri izni verilmiş ve reklam kişiselleştirme reddedilmiş bir AEA kullanıcısı için geçerli bir dönüşüm izleme isteği örneği:

POST /pagead/conversion/app/1.1
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=in_app_purchase
       &rdid=0F7AB11F-DA50-498E-B225-21AC1977A85D
       &id_type=idfa
       &eea=1
       &ad_personalization=0
       &ad_user_data=1
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &value=1.99
       &currency_code=USD
Host: www.googleadservices.com
User-Agent: MyAnalyticsCompany/1.0.0 (iOS 10.0.2; en_US; iPhone9,1; Build/13D15; Proxy)
X-Forwarded-For: 216.58.194.174
Content-Type: application/json; charset=utf-8

Dönüşüm İzleme Yanıt Kılavuzu

Dönüşüm izleme yanıtı aşağıdaki biçimdedir:

{
  "ad_events": [<ad event objects>],
  "errors": [<error strings>],
  "attributed": true|false
}

Hem ad_events hem de errors dizileri boş olabilir.

Hataların makine tarafından okunabilir hata kodları (ör. invalid_timestamp) olmasını bekliyoruz.

Hata Kodları

  • invalid_timestamp: İstekte geçerli bir zaman damgası yoktu.

  • eea_missing_or_invalid: İstekte "eea" alanı ayarlanmamış veya geçersiz.

  • ad_user_data_missing: "ad_user_data" istek alanı ayarlanmadı. Kapsam dahilindeki tüm TPA istekleri için "ad_user_data" alanı zorunludur.

  • ad_user_data_invalid: "ad_user_data" istek değeri geçersizdi. Kapsam dahilindeki tüm TPA istekleri için "ad_user_data" alanı zorunludur.

  • ad_personalization_missing_or_invalid: İstekte "ad_personalization" alanı ayarlanmamış veya geçersizdi. Kapsam dahilindeki tüm TPA istekleri için "ad_personalization" alanı zorunludur.

Reklam etkinlikleri, uygulama ilişkilendirmesinin temel nesneleridir ve aşağıdaki özellikleri içerir.

Kullanıcı iznine bağlı yanıt davranışı ile ilgili önemli notlar:
Dönüşümde reklam kullanıcı verileri izni varsa ve kullanıcının Google kullanıcı ayarlarında çapraz kullanım izni varsa Google Ads, tüm CPS'lerinde tek bir son tıklama ile yanıt verir. Kullanıcı, Google kullanıcı ayarlarında çapraz kullanım izni vermediyse Google Ads, CPS başına birden fazla son tıklama ile yanıt verir.

Dönüşüm, kullanıcının seçtiği çapraz kullanım izninde belirli CPS'leri içeriyorsa ancak diğerlerini içermiyorsa Google Ads, çapraz kullanım izni verilen CPS'lerde tek bir son tıklama ile yanıt verir. Çapraz kullanım izni verilmeyen CPS'lerde ise CPS başına birden fazla son tıklama ile yanıt verir.

Dönüşüm İzleme Yanıtı
ad_event_id

Her zaman mevcut

dize

ad_event_id, reklam etkinlikleri için benzersiz bir tanımlayıcı görevi görür. Ağlar arası ilişkilendirme isteğinde yeniden kullanılır ve hata ayıklama amacıyla kaydedilmesi/saklanması gerekir.

Q2owS0VRancwZHk0QlJDdXVMX2U1TQ
conversion_metric

Her zaman mevcut

dize

İlişkilendirme için kullanılan dönüşüm metriği. Başlangıçta bir dönüşüm metriği desteklenecektir.

conversion
timestamp

Her zaman mevcut

sayı

Reklam etkinliğinin gerçekleştiği UNIX zaman damgası (mikrosaniye hassasiyetinde saniye cinsinden). Bu değer, son tıklamayla ilişkilendirme için kullanılmalıdır.

1432681913.123456
campaign_type

Her zaman mevcut

dize

Bu alan, reklam etkinliğini oluşturan kampanya türünü tanımlar. Olası değerler şunlardır:

ACI
ACE
ACPRE
Search
Display
Video
Shopping
Hotel
Performance_Max
Other

ACI, yüklemelere yönelik uygulama kampanyası anlamına gelir. ACE, etkileşime yönelik uygulama kampanyalarının kısaltmasıdır.
campaign_id

Her zaman mevcut

sayı

Reklam etkinliğini oluşturan kampanyanın sayısal kampanya kimliği. Bu değerin benzersiz olduğu garanti edilir.

123456789
campaign_name

Her zaman mevcut

dize

Reklam etkinliğini oluşturan kampanyanın reklamveren tarafından tanımlanan kampanya adı. Bu değerin benzersiz olduğu garanti edilmez.

Occasional Gamers (Video)
ad_type

Her zaman mevcut

dize

Reklam etkinliğiyle sonuçlanan reklamın türü. Bu değer, çeşitli envanter türlerini aşağıdaki gibi ayırt etmek için kullanılabilir.

Uygulama Tanıtımı 
ClickToDownload
 Uygulama Etkileşimi 
AppDeepLink
 Uygulama Etkileşimi - Yükleme ve Devam Etme Akışı 
AppDeepLinkContinue
 Diğer değerler için genel 
Unknown
external_customer_id

Her zaman mevcut

sayı

Reklam etkinliğini oluşturan kampanyanın sahibi olan reklamverenin reklamveren kimliği. Bu değer, Google Ads hesaplarını ayırt etmek için kullanılabilir.

123456789
location

Her zaman mevcut

sayı

Reklam etkinliğinin coğrafi konumuna ait yer kodu. Konum kodlarını yorumlamak için Google Ads API referansına bakın.
network_type

Her zaman mevcut

dize

Bu alan, reklam etkinliğinin gerçekleştiği Google Ads reklamcılık ağını tanımlar. Olası değerler şunlardır.

Search
Display
YouTube
GoogleTv
cross-network
network_subtype

campaign_type, ACI veya ACE olduğunda ve network_type, Display olduğunda null olur.

dize

Bu alan, reklam etkinliğinin gerçekleştiği Google Ads reklamcılık ağının "alt türünü" tanımlar. Olası değerler, birincil ağ türüne göre değişir.

Normal Google Arama 
GoogleSearch
 Google Arama Ağı iş ortakları 
SearchPartners

Görüntülü Reklam Ağı

Mobil Web Yayıncıları 
mGDN
 Uygulama Yayıncıları 
Google AdMob

YouTube

YouTube videoları ağı 
YouTubeVideos
 YouTube Arama Ağı 
YouTubeSearch
 Video İş Ortakları 
VideoPartners

GoogleTv

GoogleTV Videos ağı 
GoogleTvVideos

ağlar arası

Maksimum Performans ağlar arası 
cross-network
video_id

Yalnızca network_type YouTube olduğunda ve campaign_type değilse ACI ve ACE olduğunda sağlanır.

dize

Reklam etkinliğiyle ilişkili YouTube video kimliği.

dQw4w9WgXcQ
keyword

Yalnızca network_type Search olduğunda ve campaign_type değilse ACI ve ACE olduğunda sağlanır.

dize

Reklam etkinliğiyle ilişkili arama ağı anahtar kelimesi.

+food +delivery
match_type

Yalnızca network_type Search olduğunda ve campaign_type değilse ACI ve ACE olduğunda sağlanır.

dize

Arama anahtar kelimelerinin eşleme türü.

Tam 
e
 Sıralı eşleme 
p
 Geniş 
b
placement

Yalnızca network_type Display olduğunda ve campaign_type değilse ACI ve ACE olduğunda sağlanır.

dize

Reklam etkinliğiyle ilişkilendirilen yerleşim.

mobileapp::1-343200656
ad_group_id

Yalnızca campaign_type Performance_Max olmadığında sağlanır.

sayı

Reklam etkinliğiyle oluşturulan reklam grubunun sayısal kimliği. Bu değerin benzersiz olduğu garanti edilir.

Bu alan, derin bağlantı ilişkilendirmesi gibi deterministik olarak ilişkilendirilen (is_deterministic true) gbraid ile ilişkilendirilmiş reklam etkinlikleri için sağlanmaz.

123456789
ad_group_name

Yalnızca campaign_type, ACI, ACE veya ACPRE olduğunda sağlanır.

dize

Reklam etkinliğini oluşturan reklam grubunun reklamveren tarafından tanımlanan reklam grubu adı. Bu değerin benzersiz olduğu garanti edilmez.

Bu alan, derin bağlantı ilişkilendirmesi gibi deterministik olarak ilişkilendirilen (is_deterministic true) gbraid ile ilişkilendirilmiş reklam etkinlikleri için sağlanmaz.

My App AdGroup
asset_group_id

Yalnızca campaign_type Performance_Max olduğunda sağlanır.

sayı

Reklam etkinliğini oluşturan öğe grubunun sayısal kimliği. Bu değer benzersizdir.

123456789
creative_id

Yalnızca campaign_type, ACI, ACE, ACPRE veya Performance_Max olmadığında sağlanır.

sayı

Reklam etkinliğini oluşturan reklam öğesi reklam biriminin sayısal kimliği. Bu değerin benzersiz olduğu garanti edilir.

123456789
interaction_type

Bu alan her zaman etkileşim olur.

dize
is_deterministic

İlişkilendirme yönteminin deterministik olup olmadığını gösterir.

Boole

true, false
device_model

Reklam etkinliğini oluşturan cihaz modeli.

Dize

sm-s936w, sm-3936w
os_version

Reklam etkinliğini oluşturan ana işletim sistemi sürümü.

Dize

14, 12
country

Reklam etkinliğini oluşturan iki harfli ülke kodu.

Dize

CA, US
city

Reklam etkinliğinin gerçekleştiği şehir.

Dize

san jose, london
region

Reklam etkinliğinin gerçekleştiği eyalet veya il.

Dize

california, british columbia

Örnek Yanıtlar

Belirleyici dönüşümle ilgili bir yanıta örnek:

{
  "ad_events": [{
    "ad_event_id": "Q2owS0VRancwZHk0QlJDdXVMX2U1TQ",
    "conversion_metric": "conversion",
    "interaction_type": "engagement",
    "campaign_type": "ACI",
    "campaign_id": 123456789,
    "campaign_name": "My App Campaign",
    "network_type": null,
    "network_subtype": null,
    "ad_group_id": 123456789,
    "ad_group_name": "My App AdGroup",
    "asset_group_id": null,
    "is_deterministic": true,
    "timestamp": 1234567.898765
  }],
  "errors": [],
  "attributed": true
}

iOS'te deterministik olmayan bir dönüşüm için yanıt örneği:

{
  "ad_events": [{
    "ad_event_id": "Q2owS0VRancwZHk0QlJDdXVMX2U1TQ",
    "conversion_metric": "conversion",
    "interaction_type": "engagement",
    "campaign_type": "ACI",
    "campaign_id": 123456789,
    "campaign_name": "My App Campaign",
    "network_type": null,
    "network_subtype": null,
    "ad_group_id": 123456789,
    "ad_group_name": "My App AdGroup",
    "asset_group_id": null,
    "is_deterministic": false,
    },
    "device_info": {
        "device_model": "iphone12,3",
        "os_version": "14"
    },
    "timestamp": 1432681918.123456
    }],
  "errors": [],
  "attributed": true
}

Android'de deterministik olmayan bir dönüşüm için yanıt örneği:

{
  "ad_events": [
    {
      "ad_event_id": "Q2owS0VRancwZHk0QlJDdXVMX2U1TQ",
      "conversion_metric": "conversion",
      "interaction_type": "click",
      "campaign_type": "ACI",
      "campaign_id": 123456789,
      "campaign_name": "My App Campaign",
      "network_type": null,
      "network_subtype": null,
      "ad_group_id": 123456789,
      "ad_group_name": "My App AdGroup",
      "asset_group_id": null,
      "is_deterministic": false,
      "geo_info": {
        "city": "san jose",
        "country": "US",
        "region": "california"
      },
      "device_info": {
          "device_model": "sm-s926u",
          "os_version": "14"
      },
      "timestamp": 1432681918.123456
    },
    ],
    "errors": [],
    "warnings": []
  }

GBRAID tarafından ilişkilendirilen bir iOS/Android dönüşümüyle ilgili yanıt örneği:

{
  "ad_events": [{
    "ad_event_id": "Q2owS0VRancwZHk0QlJDdXVMX2U1TQ",
    "conversion_metric": "conversion",
    "interaction_type": "engagement",
    "campaign_type": "ACI",
    "campaign_id": 123456789,
    "campaign_name": "My App Campaign",
    "ad_type": "ClickToDownload",
    "external_customer_id": 123456789,
    "interaction_type": "engagement",
    "network_type": null,
    "ad_group_id": null,
    "ad_group_name": null,
    "asset_group_id": null,
    "is_deterministic": true,
    "timestamp": 0.000000
  }],
  "errors": [],
  "attributed": true,
  "warnings": [],
}

İstek hatalar içerdiğinde dönüşüm izleme yanıtına ilişkin bir örnek:

{
  "ad_events": [],
  "errors": ["INVALID_CURRENCY_CODE"],
  "attributed": false
}

Olumsuz bir dönüşüm izleme yanıtı örneği:

{
  "ad_events": [],
  "errors": [],
  "attributed": false
}

Tüm dönüşüm izleme istekleri için bir dönüşüm izleme yanıtı döndürülür.

Evrensel uygulama kampanyası için AEA dışındaki bir kullanıcıya yönelik olumlu dönüşüm izleme yanıtı örneği:

{
  "ad_events": [{
    "ad_event_id": "Q2owS0VRancwZHk0QlJDdXVMX2U1TQ",
    "conversion_metric": "conversion",
    "interaction_type": "engagement",
    "campaign_type": "ACI",
    "campaign_id": 123456789,
    "campaign_name": "My App Campaign",
    "ad_type": "ClickToDownload",
    "external_customer_id": 123456789,
    "location": 21144,
    "network_type": "Search",
    "network_subtype": "GoogleSearch",
    "video_id": null,
    "keyword": null,
    "match_type": null,
    "placement": null,
    "ad_group_id": 123456789,
    "ad_group_name": "My App AdGroup",
    "asset_group_id": null,
    "creative_id": null,
    "timestamp": 1432681913.123456
  }],
  "errors": [],
  "attributed": true,
  "warnings": []
}

Arama Ağı kampanyası için, AEA dışındaki bir kullanıcıya yönelik olumlu dönüşüm izleme yanıtı örneği:

{
  "ad_events": [{
    "ad_event_id": "Q2owS0VRancwZHk0QlJDdXVMX2U1TQ",
    "conversion_metric": "conversion",
    "interaction_type": "engagement",
    "campaign_type": "Search",
    "campaign_id": 123456789,
    "campaign_name": "My App Campaign",
    "ad_type": "ClickToDownload",
    "external_customer_id": 123456789,
    "location": 21144,
    "network_type": "Search",
    "network_subtype": "GoogleSearch",
    "video_id": null,
    "keyword": "+space +birds",
    "match_type": "b",
    "placement": null,
    "ad_group_id": 123456789,
    "ad_group_name": null,
    "asset_group_id": null,
    "creative_id": 123456789,
    "timestamp": 1432681913.123456
  }],
  "errors": [],
  "attributed": true,
  "warnings": []
}

Bir Görüntülü Reklam Ağı kampanyası için, AEA dışındaki bir kullanıcıya yönelik olumlu bir dönüşüm izleme yanıtı örneği:

{
  "ad_events": [{
    "ad_event_id": "Q2owS0VRancwZHk0QlJDdXVMX2U1TQ",
    "conversion_metric": "conversion",
    "interaction_type": "engagement",
    "campaign_type": "Display",
    "campaign_id": 123456789,
    "campaign_name": "My App Campaign",
    "ad_type": "ClickToDownload",
    "external_customer_id": 123456789,
    "location": 21144,
    "network_type": "Display",
    "network_subtype": "mGDN",
    "video_id": null,
    "keyword": null,
    "match_type": null,
    "placement": "mobile-app::2-343200656",
    "ad_group_id": 123456789,
    "ad_group_name": null,
    "asset_group_id": null,
    "creative_id": 123456789,
    "timestamp": 1432681913.123456
  }],
  "errors": [],
  "attributed": true,
  "warnings": []
}

YouTube kampanyası için, AEA dışındaki bir kullanıcıya yönelik olumlu dönüşüm izleme yanıtı örneği:

{
  "ad_events": [{
    "ad_event_id": "Q2owS0VRancwZHk0QlJDdXVMX2U1TQ",
    "conversion_metric": "conversion",
    "interaction_type": "engagement",
    "campaign_type": "Video",
    "campaign_id": 123456789,
    "campaign_name": "My App Campaign",
    "ad_type": "ClickToDownload",
    "external_customer_id": 123456789,
    "location": 21144,
    "network_type": "YouTube",
    "network_subtype": "YouTubeVideos",
    "video_id": "dQw4w9WgXcQ",
    "keyword": null,
    "match_type": null,
    "placement": null,
    "ad_group_id": 123456789,
    "ad_group_name": null,
    "asset_group_id": null,
    "creative_id": 123456789,
    "timestamp": 1432681913.123456
  }],
  "errors": [],
  "attributed": true,
  "warnings": []
}
 
{
  "ad_events": [{
    "ad_event_id": "Q2owS0VRancwZHk0QlJDdXVMX2U1TQ",
    "conversion_metric": "conversion",
    "interaction_type": "click",
    "campaign_type": "ACI",
    "campaign_id": 123456789,
    "campaign_name": "My App Campaign",
    "ad_type": "ClickToDownload",
    "external_customer_id": 123456789,
    "location": 21144,
    "network_type": "Display",
    "network_subtype": "",
    "video_id": null,
    "keyword": null,
    "match_type": null,
    "placement": null,
    "ad_group_id": 123456789,
    "ad_group_name": "My App AdGroup",
    "asset_group_id": null,
    "creative_id": null,
    "timestamp": 1432681913.123456
  },
  {
    "ad_event_id": "I8YUwWqxvOyqcwOcqBAkYZBMaOONSd",
    "conversion_metric": "conversion",
    "interaction_type": "click",
    "campaign_type": "ACI",
    "campaign_id": 123456789,
    "campaign_name": "My App Campaign",
    "ad_type": "ClickToDownload",
    "external_customer_id": 123456789,
    "location": 21144,
    "network_type": "Search",
    "network_subtype": "",
    "video_id": null,
    "keyword": null,
    "match_type": null,
    "placement": null,
    "ad_group_id": 123456789,
    "ad_group_name": "My App AdGroup",
    "asset_group_id": null,
    "creative_id": null,
    "timestamp": 1432681913.123456
  }
  ],
  "errors": [],
  "warnings": [],
  "attributed": true
}
 
{
  "ad_events": [{
    "ad_event_id": "Q2owS0VRancwZHk0QlJDdXVMX2U1TQ",
    "conversion_metric": "conversion",
    "interaction_type": "click",
    "campaign_type": "ACI",
    "campaign_id": 123456789,
    "campaign_name": "My App Campaign",
    "ad_type": "ClickToDownload",
    "external_customer_id": 123456789,
    "location": 21144,
    "network_type": "Display",
    "network_subtype": "",
    "video_id": null,
    "keyword": null,
    "match_type": null,
    "placement": null,
    "ad_group_id": 123456789,
    "ad_group_name": "My App AdGroup",
    "asset_group_id": null,
    "creative_id": null,
    "timestamp": 1432681913.123456
  }
  ],
  "errors": [],
  "warnings": [],
  "attributed": true
}
 
{
  "ad_events": [{
    "ad_event_id": "Q2owS0VRancwZHk0QlJDdXVMX2U1TQ",
    "conversion_metric": "conversion",
    "interaction_type": "click",
    "campaign_type": "ACI",
    "campaign_id": 123456789,
    "campaign_name": "My App Campaign",
    "ad_type": "ClickToDownload",
    "external_customer_id": 123456789,
    "location": 21144,
    "network_type": "Display",
    "network_subtype": "",
    "video_id": null,
    "keyword": null,
    "match_type": null,
    "placement": null,
    "ad_group_id": 123456789,
    "ad_group_name": "My App AdGroup",
    "asset_group_id": null,
    "creative_id": null,
    "timestamp": 1432681913.123456
  },
  {
    "ad_event_id": "I8YUwWqxvOyqcwOcqBAkYZBMaOONSd",
    "conversion_metric": "conversion",
    "interaction_type": "click",
    "campaign_type": "ACI",
    "campaign_id": 123456789,
    "campaign_name": "My App Campaign",
    "ad_type": "ClickToDownload",
    "external_customer_id": 123456789,
    "location": 21144,
    "network_type": "YouTube",
    "network_subtype": "YouTubeVideos",
    "video_id": null,
    "keyword": null,
    "match_type": null,
    "placement": null,
    "ad_group_id": 123456789,
    "ad_group_name": "My App AdGroup",
    "asset_group_id": null,
    "creative_id": null,
    "timestamp": 1432681913.123456
  }
  ],
  "errors": [],
  "warnings": [],
  "attributed": true
}


Ağlar arası ilişkilendirme isteği

Google Ads, dönüşüm izleme isteğine olumlu yanıt verdiğinde API tüketicisi, son tıklamayı belirledikten sonra ağlar arası ilişkilendirme kararını Google Ads'e bildirmelidir.

Ağlar arası ilişkilendirme isteği, orijinal dönüşüm izleme isteğiyle aynıdır ancak istek yolu şöyledir:

/pagead/conversion/app/1.1/cross_network

ve iki zorunlu parametrenin eklenmesi:

Ağlar arası ilişkilendirme isteği
ad_event_id

Zorunlu

Konum: Sorgu

Önceki istekteki ilişkilendirmeyle ilişkili reklam etkinliğinden alınan ad_event_id tanımlayıcısı.
attributed

Zorunlu

Konum: Sorgu

Google Ads'in, API tüketicisi tarafından dönüşüm için kredi alıp almadığı. 0 veya 1

Geçerli bir ağlar arası ilişkilendirme isteği örneği:

POST /pagead/conversion/app/1.1/cross_network
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=custom
       &app_event_name=level_achieved
       &rdid=0F7AB11F-DA50-498E-B225-21AC1977A85D
       &id_type=idfa
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &value=1.99
       &currency_code=USD
       &ad_event_id=Q2owS0VRancwZHk0QlJDdXVMX2U1TQ
       &attributed=1
Host: www.googleadservices.com
User-Agent: MyAnalyticsCompany/1.0.0 (iOS 10.0.2; en_US; iPhone9,1; Build/13D15; Proxy)
X-Forwarded-For: 216.58.194.174
Content-Type: application/json; charset=utf-8

Geçerli bir ağlar arası ilişkilendirme isteği her zaman yanıt gövdesi içermeyen genel bir 200 yanıtı alır.