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 kapsamında, 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şturuluyorsa 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. Dil ve ülke kodu, iki harfli olarak ve alt çizgiyle ayrılmış şekilde kullanılır. (en_US)

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

Analytics/reklam ürününün çalıştığı 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 kullanıcı aracısı tamamen istemci tarafında oluşturulmuşsa ; Proxy öğesini hariç tutun. Bu nedenle, bir uygulama kullanıcı aracısı şöyle 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

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ıklamayı 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 yapılan POST istekleridir: 

/pagead/conversion/app/version
burada version, dönüşüm izleme API'sinin amaçlanan sürümüdür. Şu anda tek geçerli sürüm 1.0'dır.

Standart bir uygulama dönüşümü isteği 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 ise 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

Ek zengin etkinlik verilerini, anahtarları değerlerle eşleyen basit bir JSON nesnesi dizesi olarak iletin. Kabul edilebilir değerler dize ve dize dizisidir.

{"level": 5, "attempts": 20}
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ıdan alınan cihaz kimliği gibi durumlarda cihaz kimliği eksikse bu kimliği tamamen sıfır olarak ayarlayın.

00000000-0000-0000-0000-000000000000
id_type

Zorunlu

Konum: Sorgu

rdid alanında depolanan tanımlayıcı türü. Gelecekte burada daha fazla değer kabul edebiliriz ancak başlangıçta aşağıdakileri destekleyeceğiz.

Android

advertisingid

iOS

idfa
eea

Belirli koşullarda zorunlu

Konum: Sorgu

EEA 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ı EEA'da bulunuyorsa geçerli Avrupa 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 iznini 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ırlandırma durumu.

  • 0: Kullanıcı, reklam izlemenin sınırlanmasını seçmedi.
  • 1: Kullanıcı, reklam izlemenin sınırlanmasını seçti.
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 ana makine 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ın sürümünü yansıtmalıdır. Uygulama bir 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ı (saniye cinsinden, mikrosaniye hassasiyetine kadar).

1432681913.123456
value

İsteğe bağlı

Konum: Sorgu

Etkinliğin parasal 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ğlanırsa 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

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

BX3QojHp4mY5MrJtFM_d1u
gclid_only_request

Belirli koşullarda gereklidir

Konum: Sorgu

rdid (advertisingid) not kullanılabilir 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. Bu değerin, 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ündeContent-Length: 0 zengin etkinlik verisi iletilmediği durumlarda) sunucumuz, isteğinizde Content-Length: 0 üstbilgisini açıkça ayarlamanızı gerektirir.

Örnek İstek

Ö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.0
       ?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 gelir bilgileri içeren, rdid (advertisingid) bilgisi bulunmayan geçerli bir dönüşüm izleme isteği örneği:

POST /pagead/conversion/app/1.0
       ?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.0
       ?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ğine örnek: example://product/123?gclid=Cj0KEQjw0dy4BRCuuL_e5M

POST /pagead/conversion/app/1.0
       ?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.0
       ?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

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

  • Tamsayı

    • 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 = dört haneli yıl, örneğin 2016
      • mm = iki haneli ay (ör. Eylül için 09)
      • dd = iki haneli 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 dd 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 hassasiyetine kadar UTC saat diliminde tanımlanan Unix/Epoch zaman damgası
    • Geçerli örnekler:
      • 1478713087 for Wed, 09 Nov 2016 17:38:07 GMT
      • 1073513982.123000 için Çar, 07 Oca 2004 22:19:42.123 GMT

  • Diziler

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

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

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: İsteğin birinde "eea" alanı ayarlanmamış veya geçersiz.

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

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

  • ad_personalization_missing_or_invalid: İstekte "ad_personalization" alanı ayarlanmamış veya alan geçersiz. 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 iznini etkinleştirmediyse 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, ç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 sun

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 sun

dize

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

conversion
timestamp

Her zaman sun

sayı

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

1432681913.123456
campaign_type

Her zaman sun

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ının kısaltmasıdır. ACE, Etkileşime Yönelik Uygulama Kampanyaları'nın kısaltmasıdır.
campaign_id

Her zaman sun

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 sun

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 sun

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 sun

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 sun

sayı

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

Her zaman sun

dize

Bu alan, reklam etkinliğinin gerçekleştiği Google Ads reklam 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 reklam 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ğı İş Ortakları 
SearchPartners

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

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

YouTube

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

GoogleTv

GoogleTV Videos ağı 
GoogleTvVideos

ağlar arası

Ağlar arası Maksimum Performans 
cross-network
video_id

Yalnızca network_type, YouTube olduğunda ve campaign_type, ACI ve ACE olmadığında 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, ACI ve ACE olmadığında sağlanır.

dize

Reklam etkinliğiyle ilişkili arama anahtar kelimesi.

+food +delivery
match_type

Yalnızca network_type, Search olduğunda ve campaign_type, ACI ve ACE olmadığında sağlanır.

dize

Arama anahtar kelimelerinin eşleme türü.

Tam 
e
 Sıralı 
p
 Geniş 
b
placement

Yalnızca network_type, Display olduğunda ve campaign_type, ACI ve ACE olmadığında sağlanır.

dize

Reklam etkinliğiyle ilişkili 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.

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.

My App AdGroup
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

Örnek Yanıtlar

İ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 dönüşüm izleme yanıtına örnek:

{
  "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": null,
    "ad_group_name": "",
    "creative_id": null,
    "timestamp": 1432681913.123456
  }],
  "errors": [],
  "attributed": true,
  "warnings": []
}

Bir 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": "My App AdGroup",
    "creative_id": 123456789,
    "timestamp": 1432681913.123456
  }],
  "errors": [],
  "attributed": true,
  "warnings": []
}

Bir Görüntülü Reklam Ağı kampanyasında, AEA dışındaki bir kullanıcı için olumlu 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": "My App AdGroup",
    "creative_id": 123456789,
    "timestamp": 1432681913.123456
  }],
  "errors": [],
  "attributed": true,
  "warnings": []
}

YouTube 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": "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": "My App AdGroup",
    "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": null,
    "ad_group_name": "",
    "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": null,
    "ad_group_name": "",
    "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": null,
    "ad_group_name": "",
    "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": null,
    "ad_group_name": "",
    "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": null,
    "ad_group_name": "",
    "creative_id": null,
    "timestamp": 1432681913.123456
  },
  ],
  "errors": [],
  "warnings": [],
  "attributed": true
}


Ağlar Arası İlişkilendirme İsteği

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

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.0/cross_network

ve iki zorunlu parametrenin eklenmesi:

Ağlar Arası İlişkilendirme İsteğ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.0/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.