Üçüncü Taraf Uygulama İzleme için DDM Entegrasyonu

Aşağıdaki uçtan uca akışta, DoubleClick alıcı tarafı ürünlerinde bir üçüncü taraf uygulama izleme çözümüyle kampanya yürütmek için hem reklamveren ayarları hem de üçüncü taraf uygulama açıklanmaktadır. Genel olarak DoubleClick Dijital Pazarlama hakkında daha fazla bilgi ve uygulama içi ilişkilendirme işlevine genel bakış için lütfen DoubleClick Dijital Pazarlama arka plan sayfasına bakın.

  1. Reklamveren, DDM'deki Dönüşüm etkinliğini yükleme/dönüşümü temsil edecek şekilde ayarlar (yalnızca Bid Manager - dönüşüm pikseli) (Campaign Manager - Floodlight etkinliği).
  2. Üçüncü taraf arayüzündeki reklamveren "bağlantıları" dönüşüm etkinliği, bir reklamveren ve dönüşüm etkinliği grubunu tanımlayan temel değişkenleri sağlar.

    • src, Floodlight etkinliğinin kaynağı olan reklamveren kimliğidir.
    • cat, Floodlight sunucularının etkinliğin ait olduğu etkinlik grubunu tanımlamak için kullandığı etkinlik etiketi dizesidir.
    • type, Floodlight etkinliğinin ilişkilendirildiği etkinlik grubunu tanımlayan grup etiketi dizesidir.
    • u1, u2, ... (varsa) özel Floodlight değişkeni anahtar/değer çiftleridir.
  3. Ayrıca reklamverenin, kendi yetkilendirme jetonunu üçüncü taraflara da sunması gerekir: token, reklamverene özel her sunucu isteğiyle birlikte iletilmesi gereken reklamverene özgü alfanümerik bir dizedir.

  4. Reklamveren, uygulama içi reklam kampanyasını, gerçek zamanlı teklif verme exchange'lerinde DBM tarafından veya doğrudan satın alınan medyada DCM tarafından yayınlanan reklam etiketleriyle yayınlar.

  5. Son kullanıcı, DDM tarafından günlüğe kaydedilen reklamları görür ve/veya tıklar.

  6. Son kullanıcı uygulamayı yüklediğinde ve/veya bir dönüşüm etkinliğini (oyun oynama vb.) tamamladığında üçüncü taraf sunucular her uygulama etkinliğinde DDM

    https://ad.doubleclick.net/ddm/s2s/appactivity/src=1234567;cat=fghij456;type=abcde123;u1=[friendlyname1];ord=1312312312
    

    Bu örnekte:

    • src, Floodlight etkinliğinin kaynağı olan reklamveren kimliğidir.
    • cat, Floodlight sunucularının etkinliğin ait olduğu etkinlik grubunu tanımlamak için kullandığı etkinlik etiketi dizesidir.
    • type, Floodlight etkinliğinin ilişkilendirildiği etkinlik grubunu tanımlayan grup etiketi dizesidir.
    • ord, Floodlight etiketini benzersiz hale getirmek için kullanılan rastgele bir sayıdır.
    • u1, u2, ... (varsa) özel Floodlight değişkeni anahtar/değer çiftleridir.

    HTTP POST'unda JSON yükü aracılığıyla gönderilen ek parametrelerle:

    {
      "app": {
        "bundle": "com.rovio.angrybirds"
      },
      "device": {
        "ua": "Mozilla/5.0 (iPhone; CPU iPhone OS 6_0 like Mac OS X) AppleWebKit/536.26 (KHTML, like Gecko) Version/6.0 Mobile/10A5376e Safari/8536.25",
        "ip": "108.176.57.230",
        "didmd5": "A2D2DA47AC2DE1BCA16883BD5CAA6F2F",
        "lmt": 1
      }
    }
    

    ve reklamveren yetkilendirme jetonu, HTTP Yetkilendirme Başlığı'nda iletilir:

    Authorization: Token token="[advertiser authorization token string]"
    

    Bu örnekte:

    • app (gerekli), dönüşüm etkinliğinin gerçekleştiği uygulamayı temsil eden JSON nesnesidir. Dönüşüm etkinliğinin gerçekleştiği uygulama kullanılamıyorsa app: {} özelliğini kullanın.
    • bundle (varsa), Play Store paket adının veya App Store Kimliğinin bir dize değerini içeren uygulama nesne alanıdır.
    • device, dönüşüm etkinliğinin gerçekleştiği cihazı temsil eden JSON nesnesidir.
    • ua, bir etkinliğin kaydedildiği uygulamadaki kullanıcı aracısı dizesini temsil eden cihaz nesnesi alanıdır. Bu parametre zorunludur.
    • ip (varsa), cihaza atanan cihazın IPv4 adresidir. Bu parametre zorunludur.
    • didmd5, büyük harfle yazılmış IDFA veya Google Play Reklam Kimliği değerinin MD5 karma dizesidir.
    • lmt, IDFA/AdID ile kullanıcı "Sınırlama" reklam seçeneğini etkinleştirdiyse 1 değerine veya ayarlanmamışsa 0 değerine sahip bir tam sayıdır.

    DDM, dönüşüm etkinliğinin DCM tarafından sunulan bir görünüm veya tıklamayla ilişkilendirilip ilişkilendirilmediğine ve "YES" ise etkinlikle ilgili ek bilgilere (son görünüm veya tıklama) ilişkin bir JSON yanıtıyla yanıt verir:

    - Ad ID
    - Site ID
    - Placement ID
    - Creative ID
    - Timestamp
    

    Örnek bir JSON yanıtı şu şekilde görünebilir:

    {"attributed": 1,  // Whether the conversion can be attributed to a DCM event.
     "last_impression_ad_id":283641088,
     "last_impression_site_id":1408067,
     "last_impression_placement_id":107616368,
     "last_impression_creative_id":60162352,
     "last_impression_timestamp":1415647607,
     "last_click_ad_id":283641088,
     "last_click_site_id":1408067,
     "last_click_placement_id":107616368,
     "last_click_creative_id":60162352,
     "last_click_timestamp":1415647657,
     "last_click_exclid":"CKm0nLKhyssCFceH2wod8l4I4A"}
    

    Bu örnekte:

    • attributed, değer 1'dir (dönüşüm bir gösterim veya tıklamayla ilişkilendirilebilirse) veya 0 (ilişkilendirilemiyorsa).
    • last_impression_ad_id (ilişkilendirilmişse = 1), son gösterimin reklam kimliğidir.
    • last_impression_site_id (ilişkilendirilmişse = 1), son gösterimin site kimliğidir.
    • last_impression_placement_id (ilişkilendirilmişse = 1), son gösterimin yerleşim kimliğidir.
    • last_impression_creative_id (ilişkilendirilmişse = 1), son gösterimin reklam öğesi kimliğidir.
    • last_click_ad_id (ilişkilendirilmiş = 1 ve bir tıklama ilişkilendirilmişse) son tıklamanın reklam kimliğidir.
    • last_click_site_id (ilişkilendirilmiş = 1 ve bir tıklama ilişkilendirilmişse) son tıklamanın site kimliğidir.
    • last_click_placement_id (ilişkilendirilmiş = 1 ve bir tıklama ilişkilendirilmişse) son tıklamanın yerleşim kimliğidir.
    • last_click_creative_id (ilişkilendirilmiş = 1 ve bir tıklama ilişkilendirilmişse) son tıklamanın reklam öğesi kimliğidir.
    • last_click_exclid, %eiid! makrosu aracılığıyla doldurulan benzersiz bir tıklama kimliğine karşılık gelir

    HTTP hata kodlarıyla, aşağıdaki senaryolar için:

    • İstek kotası aşıldıysa HTTP 204.
    • İstek geçersiz kabul edildiğinde (ör. gerekli parametreler eksik olduğunda) ve sunucu piksel izlemeye geçtiğinde HTTP 400.
    • Yetkilendirme jetonu geçersizse HTTP 401.
    • Kötü istekler için HTTP 404.

    Reklamveren, sisteminizdeki kampanya raporlarını görebilir; reklamveren de yukarıda belirtilen parametrelerle DCM'deki dönüşüm raporlarını görebilir.