Ta strona została przetłumaczona przez Cloud Translation API.

Integracja DDM z śledzeniem aplikacji przez firmy zewnętrzne

Poniższy proces kompleksowego opisuje konfigurację reklamodawcy i jego wdrożenie zewnętrzne, które jest potrzebne do prowadzenia kampanii w usługach DoubleClick po stronie kupującego przy użyciu rozwiązania innej firmy do śledzenia aplikacji. Więcej ogólnych informacji o DoubleClick Digital Marketing oraz funkcjach atrybucji w aplikacji znajdziesz na stronie w tle.

Reklamodawca konfiguruje zdarzenie konwersji w DDM, by odzwierciedlić instalację/konwersję (tylko Bid Manager – piksel konwersji) (Campaign Manager – aktywność Floodlight).
Reklamodawca „&links"” zdarzenie konwersji DDM w interfejsie firmy zewnętrznej i dostarcza kluczowe zmienne identyfikujące reklamodawcę i grupę aktywności konwersji.
- src to identyfikator reklamodawcy, który jest źródłem aktywności Floodlight.
- cat to ciąg tagu aktywności, którego serwery Floodlight używają do identyfikowania grupy aktywności, do której należy aktywność.
- type to ciąg tagu grupy identyfikujący grupę aktywności, z którą powiązana jest aktywność Floodlight.
- u1, u2, ... (jeśli występują) to pary klucz-wartość zmiennych niestandardowych Floodlight.
Dodatkowo reklamodawca musi przekazać innym osobom specjalny token autoryzacji: token jest to ciąg alfanumeryczny, który należy przekazać wraz z każdym żądaniem serwera do DDM.
Reklamodawca prowadzi kampanię reklamową w aplikacji z tagami reklam wyświetlanymi przez DBM na giełdach z określaniem stawek w czasie rzeczywistym lub realizowanymi przez DCM w mediach kupowanych bezpośrednio.
Użytkownicy widzą i/lub klikają reklamy rejestrowane przez DDM.
Gdy użytkownik zainstaluje aplikację lub wykona działanie powodujące konwersję (np. gra)
```
https://ad.doubleclick.net/ddm/s2s/appactivity/src=1234567;cat=fghij456;type=abcde123;u1=[friendlyname1];ord=1312312312
```
gdzie:
- src to identyfikator reklamodawcy, który jest źródłem aktywności Floodlight.
- cat to ciąg tagu aktywności, którego serwery Floodlight używają do identyfikowania grupy aktywności, do której należy aktywność.
- type to ciąg tagu grupy identyfikujący grupę aktywności, z którą powiązana jest aktywność Floodlight.
- ord to liczba losowa, dzięki której tag Floodlight jest unikalny.
- u1, u2, ... (jeśli występują) to pary klucz-wartość zmiennych niestandardowych Floodlight.
z dodatkowymi parametrami wysyłanymi przez ładunek JSON w żądaniu POST HTTP:
```
{
  "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
  }
}
```
Token autoryzacji reklamodawcy jest przekazywany w nagłówku HTTP autoryzacji:
```
Authorization: Token token="[advertiser authorization token string]"
```
gdzie:
- app (wymagany) to obiekt JSON reprezentujący aplikację, w której wystąpiła konwersja. Użyj app: {}, jeśli aplikacja, w której miało miejsce konwersja, jest niedostępna.
- bundle (jeśli jest dostępna) to pole obiektu aplikacji zawierające wartość w postaci nazwy pakietu Sklepu Play lub identyfikatora App Store.
- device to obiekt JSON reprezentujący urządzenie, na którym miała miejsce aktywność konwersji.
- ua to pole obiektu urządzenia, które reprezentuje ciąg znaków klienta użytkownika aplikacji, w której została zarejestrowana aktywność. Ten parametr jest wymagany.
- ip (jeśli jest dostępny) to adres IPv4 urządzenia przypisany do urządzenia. Ten parametr jest wymagany.
- didmd5 to ciąg znaków MD5 zawierający wartości IDFA lub wielkie identyfikatory wartości identyfikatora wyświetlania reklam Google Play.
- lmt to liczba całkowita z wartością 1, jeśli użytkownik włączył opcję „Ograniczaj śledzenie reklam” z IDFA/AdID lub ma wartość 0, jeśli nie została ustawiona.
W odpowiedzi DCM przesyła odpowiedź JSON określającą, czy zdarzenie konwersji jest przypisane do wyświetlenia czy kliknięcia realizowanego przez DCM, a jeśli „&"YES"”, dodatkowe informacje o zdarzeniu (ostatnie wyświetlenie lub kliknięcie):
```
- Ad ID
- Site ID
- Placement ID
- Creative ID
- Timestamp
```
Przykładowa odpowiedź JSON może wyglądać tak:
```
{"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"}
```
gdzie:
- attributed ma wartość 1 (jeśli konwersję można przypisać do wyświetlenia lub kliknięcia) albo 0 (jeśli nie można jej przypisać).
- last_impression_ad_id (jeśli przypisany = 1) to identyfikator reklamy dla ostatniego wyświetlenia.
- last_impression_site_id (jeśli przypisany = 1) to identyfikator witryny ostatniego wyświetlenia.
- last_impression_placement_id (jeśli przypisany = 1) to identyfikator miejsca docelowego ostatniego wyświetlenia.
- last_impression_creative_id (jeśli przypisany = 1) to identyfikator kreacji ostatniego wyświetlenia.
- last_click_ad_id (jeśli przypisany = 1, a kliknięcie zostało przypisane) to identyfikator reklamy ostatniego kliknięcia.
- last_click_site_id (jeśli przypisany = 1, a kliknięcie zostało przypisane) to identyfikator witryny ostatniego kliknięcia.
- last_click_placement_id (jeśli przypisany = 1, a kliknięcie zostało przypisane) to identyfikator miejsca docelowego ostatniego kliknięcia.
- last_click_creative_id (jeśli przypisany = 1, a kliknięcie zostało przypisane) to identyfikator kreacji na potrzeby ostatniego kliknięcia.
- last_click_exclid odpowiada unikalnemu identyfikatorowi kliknięcia wypełnionemu przez makro %eiid!
z kodami błędów HTTP w następujących przypadkach:
- HTTP 204, jeśli limit żądania został przekroczony.
- HTTP 400, gdy żądanie zostanie uznane za nieprawidłowe (np. brakuje wymaganych parametrów), a serwer przełączy się na śledzenie pikseli.
- HTTP 401, jeśli token autoryzacji jest nieprawidłowy.
- HTTP 404 za wszystkie nieprawidłowe żądania.
Reklamodawca będzie mógł przeglądać w systemie raporty dotyczące kampanii. Będzie też mógł przeglądać w DCM raporty o konwersjach z takimi samymi parametrami jak powyżej.