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

Aşağıdaki uçtan uca akışta, üçüncü taraf uygulama izleme çözümü kullanılarak DoubleClick satın alma tarafı ürünlerinde kampanya yayınlamak için gereken reklamveren kurulumu ve üçüncü taraf uygulaması açıklanmaktadır.

Genel olarak DoubleClick Dijital Pazarlama ve uygulama içi ilişkilendirme özelliklerine genel bakış hakkında daha fazla bilgi için DoubleClick Dijital Pazarlama arka plan sayfasını inceleyin.

  1. Reklamveren, yüklemeyi veya dönüşümü (yalnızca Bid Manager - dönüşüm pikseli) temsil etmek için DDM'de dönüşüm etkinliği oluşturur (Campaign Manager - Floodlight etkinliği).

  2. Reklamveren, üçüncü taraf arayüzünde DDM dönüşüm etkinliğini "bağlar" ve bir reklamvereni 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. Reklamveren, TPA'ya uygunluk için izin toplama işlemini belirtmek üzere değişkenler ekler.

    • eea, AEA kullanıcılarını tanımlamak için kullanılır.
      • eea=0, kullanıcının AEA'da olmadığını gösterir.
      • eea=1, kullanıcının AEA'da olduğunu gösterir.
    • ad_user_data, kullanıcı verilerinin reklam amaçlarıyla kullanılmasına yönelik izin işaretidir.
      • Yalnızca eea=1 ise ayarlanması gerekir
      • ad_user_data=0, kullanıcının reklam amacıyla kullanıcı düzeyindeki verilerin Google'a iletilmesine izin vermediğini gösterir.
      • ad_user_data=1, kullanıcının reklam amacıyla kullanıcı düzeyindeki verilerin Google'a iletilmesine izin verdiğini gösterir.
    • npa, reklam kişiselleştirme içeriği için kullanılır.
      • npa=0, kullanıcının kişiselleştirmeye izin verdiğini gösterir.
      • npa=1, kullanıcının kişiselleştirmeye izin vermediğini gösterir.
    • test_request_reason=dma, DMA parametrelerini test etmek için kullanılabilir.
      • Tüm DMA parametrelerini doğrular ve uyarılar döndürür.
      • Sahte tıklamalarla çoklu yanıt döndürür.
      • Dönüşümleri test dönüşümleri olarak kaydeder.

  4. Ayrıca reklamverenin, üçüncü taraflara kendi yetkilendirme jetonunu sağlaması gerekir:

    token, DDM'ye gönderilen her sunucu isteğiyle birlikte iletilmesi gereken, reklamverene özgü bir alfanümerik dizedir.

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

  6. Son kullanıcı, DDM tarafından kaydedilen reklamları görür ve tıklar.

  7. Son kullanıcı uygulamayı yüklediğinde veya "oyun oynama" gibi bir dönüşüm etkinliğini tamamladığında üçüncü taraf sunucular her uygulama etkinliğinde DDM'ye "ping" gönderir:

    AEA'da bulunmayan kullanıcı için örnek URL

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

    AEA'daki kullanıcılar için örnek URL

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

    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.
    • eea, kullanıcının AEA'da olup olmadığını tanımlar.
    • ad_user_data, kullanıcının çerezlere ve ölçüme izin verip vermediğini tanımlar.
    • npa, kullanıcının kişiselleştirmeye izin verip vermediğini tanımlar.

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

    {
  "app": {
    "bundle": "com.rovio.angrybirds"
  },
  "device": {
    "ua": "Mozilla/5.0 (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 üstbilgisinde iletilir:

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

    Bu örnekte:

    • app (zorunlu), 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: {} simgesini kullanın.
    • bundle (varsa) Play Store paket adının veya App Store kimliğinin dize değerini içeren uygulama nesnesi alanıdır.
    • device, dönüşüm etkinliğinin gerçekleştiği cihazı temsil eden JSON nesnesidir.
    • ua, bir etkinliğin kaydedildiği uygulamanın kullanıcı aracısı dizesini temsil eden cihaz nesnesi alanıdır. Bu parametre zorunludur.
    • ip (varsa) cihaza atanan cihaz IPv4 adresidir. Bu parametre zorunludur.
    • didmd5, büyük harfli IDFA veya Google Play Reklam Kimliği değerinin MD5 karma dizesidir.
    • lmt, kullanıcının IDFA veya AdID ile "Reklam İzlemeyi Sınırla" seçeneğini etkinleştirdiği durumlarda 1, ayarlanmadığı durumlarda ise 0 değerine sahip bir tam sayıdır.

    DDM, dönüşüm etkinliğinin DCM tarafından sunulan bir görüntülemeyle veya tıklamayla ilişkilendirilip ilişkilendirilmediğine dair bir JSON yanıtı verir. "EVET" ise etkinlikle ilgili ek bilgiler (son görüntüleme veya tıklama) sağlanır:

    • Reklam Kimliği
    • Site Kimliği
    • Yerleşim Kimliği
    • Reklam Öğesi Kimliği
    • Zaman damgası

    Örnek bir JSON yanıtı şu şekilde olabilir:

    {
  "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",
  "cps": <cps>,
  "ad_events": [
    <ad event objects>
  ],
  "warnings": [<warning strings>],
  "errors": [<error strings>],
}

    Bu örnekte:

    • attributed, dönüşüm bir gösterim veya tıklamayla ilişkilendirilebiliyorsa 1, ilişkilendirilemiyorsa 0 değeridir.
    • last_impression_ad_id (ilişkilendirildiyse = 1) son gösterimin reklam kimliğidir.
    • last_impression_site_id (attributed = 1 ise) son gösterimin site kimliğidir.
    • last_impression_placement_id (ilişkilendirilmiş = 1 ise) son gösterimin yerleşim kimliğidir.
    • last_impression_creative_id (ilişkilendirildiyse = 1) son gösterimin reklam öğesi kimliğidir.
    • last_click_ad_id (attributed = 1 ise ve bir tıklama ilişkilendirildiyse) son tıklamanın reklam kimliğidir.
    • last_click_site_id (attributed = 1 ise ve bir tıklama ilişkilendirildiyse) son tıklamanın site kimliğidir.
    • last_click_placement_id (if attributed = 1 and a click was attributed) son tıklamanın yerleşim kimliğidir.
    • last_click_creative_id (if attributed = 1 and a click was attributed) is the creative ID for the last click.
    • last_click_exclid, %eiid! makrosu kullanılarak doldurulan benzersiz bir tıklama kimliğine karşılık gelir.

    Mart 2024'te DPY'nin uygulanmaya başlamasıyla birlikte aşağıdaki alanlar da kullanıma sunulacaktır:

    • cps, etkinliğin hangi Temel Platform Hizmeti'ne ait olduğunu gösterir.
      • a : Reklamlar
      • m : Haritalar
      • p : Play Store
      • s : Arama
      • h : Alışveriş
      • y : YouTube
    • ad_events, tüm dönüşüm etkinliklerini içeren ad_event nesnelerinin bir dizisidir.
      • ad_event nesnesinde aşağıdaki alanlar bulunur:
      • product_type, dönüşümden sorumlu ürünü bildiren bir dizedir. Bu değer DCM veya DBM olur.
      • interaction_type, etkinliğe yol açan etkileşim türüdür. impression veya click
      • conversion_metric, ilişkilendirme için kullanılan dönüşüm metriğidir. conversion veya view_through_conversion
      • timestamp, reklam etkinliğinin gerçekleştiği UNIX zaman damgasıdır (mikrosaniye hassasiyetinde). Bu değer, son tıklamayla ilişkilendirme için kullanılmalıdır.
      • campaign_type, reklam etkinliğini oluşturan kampanya türünü tanımlar.
      • line_item_id (Yalnızca DBM), reklam etkinliğini oluşturan DBM satır öğesi kimliğidir.
      • line_item_name (Yalnızca DBM), reklam etkinliğini oluşturan DBM satır öğesinin adıdır.
      • placement_id (Yalnızca DCM), reklam etkinliğini oluşturan DCM yerleşim etiketi kimliğidir.
      • placement_name (Yalnızca DCM), reklam etkinliğini oluşturan DCM yerleşim etiketinin adıdır.
      • external_customer_id, reklam etkinliğini oluşturan kampanyanın sahibi olan reklamveren kimliğidir.
        • product DBM ise bu alan DBM reklamveren kimliğini gösterir.
        • product DCM ise bu alan DCM reklamveren kimliğini temsil eder.
      • creative_id, reklam etkinliğini oluşturan reklam öğesi reklam biriminin kimliğidir.
        • product DBM ise bu alan DBM reklam öğesi kimliğini gösterir.
        • product DCM ise bu alan, DCM reklam öğesi kimliğini temsil eder.
      • exchange_id (Yalnızca DBM), DBM reklamının yayınlandığı exchange'in kimliğidir.
      • insertion_order_id (Yalnızca DBM) DBM kampanya siparişi kimliğidir.
      • site_id (Yalnızca DCM), reklam etkinliğinin DCM site kimliğidir.
      • cps, reklam etkinliğinin hangi Temel Platform Hizmeti'ne ait olduğunu gösterir. Daha fazla bilgi için dokümanda cps alanının tam açıklamasına bakın.
    • warnings, dönüşüm etkinliği tarafından oluşturulan uyarılar dizisidir.

    • errors, aşağıdaki senaryolarda HTTP hata kodlarıyla dönüşüm etkinliği tarafından oluşturulan bir hata dizisidir:

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

    Reklamveren, sisteminizdeki kampanya raporlarını görebilir. Ayrıca, aynı parametrelerle DCM'deki dönüşüm raporlarını da görebilir.

    DPY'nin Mart 2024'te yürürlüğe girmesinden sonraki ek örnek yanıtlar

    Dönüşümün hem Arama Ağı hem de YouTube reklam etkileşimleriyle ilişkilendirildiği ancak Arama Ağı ile YouTube CPS'leri arasında 5(2)(b) + 5(2)(c) çapraz kullanım izninin reddedildiği bir ilişkilendirilmiş dönüşüm izleme yanıtı örneği:

    {
  attributed: 1,
  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: 1415647655,
  last_click_exclid: "CKm0nLKhyssCFceH2wod8l4I4A",
  cps: "s",
  ad_events: [{
      cps : "s",
      product_type: "DCM",
      interaction_type: "click",
      ad_event_type: "click",
      campaign_type: "Display",
      placement_id: 107616368,
      placement_name: "TEST PLACEMENT NAME",
      external_customer_id: 7480542,
      creative_id: 60162352,
      timestamp: 1415647655.123456,
      site_id: 1408067,
      }, {
      cps : "s",
      product_type:"DCM",
      interaction_type: "impression",
      ad_event_type: "impression",
      campaign_type: "Display",
      placement_id: 107616368,
      placement_name: "TEST PLACEMENT NAME",
      external_customer_id: 7480542,
      creative_id: 60162352,
      timestamp: 1415647607.123456,
      site_id: 1408067
      },{
      cps : "y",
      product_type: "DCM",
      ad_event_type: "click",
      campaign_type: "Display",
      placement_id: 107616370,
      placement_name: "Placement on Youtube",
      external_customer_id: 7480542,
      creative_id: 6016444,
      timestamp: 14344344.123456,
      site_id: 140806
      },
  ]}

    Bir DBM kampanyası için olumlu dönüşüm izleme yanıtı örneği:

    {
  attributed: 1,
  last_click_ad_id: 283641088,
  last_click_site_id: 1408067,
  last_click_placement_id: 107616368,
  last_click_creative_id :60162352,
  last_click_timestamp: 1415647655,
  last_click_exclid: "CKm0nLKhyssCFceH2wod8l4I4A"
  cps: "y",
  ad_events: [{
    product_type: "DBM",
    interaction_type: "click",
    ad_event_type: "click",
    campaign_type: "Display",
    line_item_id: 123456789,
    line_item_name: "TEST LINE ITEM NAME",
    external_customer_id: 2550,
    creative_id: 512333,
    exchange_id: 132,
    insertion_order_id: 523423,
    timestamp: 1432681913.123456
    cps: "y"
  },
  {
    product_type: "DCM",
    interaction_type: "click",
    campaign_type: "Display",
    placement_id: 9342323,
    placement_name: "TEST PLACEMENT NAME",
    external_customer_id: 7480542,
    creative_id: 8234234,
    timestamp: 1432681913.123456,
    cps: "y"
  }
]}