Przykłady atrybucji międzysieciowej

Większość reklamodawców współpracuje z kilkoma różnymi sieciami reklamowymi, aby wyświetlać reklamy w aplikacjach wydawców. Jeśli sieci reklamowe zarejestrują w interfejsie API własne źródła atrybucji i wyzwalacze, będą otrzymywać raporty o zdarzeniach i raporty zbiorcze z atrybucją własną.

Reklamodawcy, którzy chcą korzystać z usług zewnętrznych firm do atrybucji w wielu sieciach (XNA), aby określić jedną zwycięską reklamę dla danej konwersji, mogą nadal to robić, stosując te techniki:

  • Skonfiguruj serwer wewnętrzny, aby rejestrować zdarzenia reguł i otrzymywać raporty o atrybucji z interfejsu API.
  • dalszego używania obecnego partnera ds. pomiarów mobilnych,

Niezależnie od wybranej techniki interfejs Attribution Reporting API obsługuje wiele różnych funkcji, które umożliwiają zewnętrznemu dostawcy dostosowywanie logiki XNA w imieniu reklamodawcy:

  • Atrybucję można przeprowadzić za pomocą interfejsu API z lub bez przekierowań z sieci reklamowych.
  • Klucze priorytetu, filtry i usuwania duplikatów mogą zapewnić dodatkowe dostosowanie atrybucji na podstawie wymiarów źródła i wyzwalacza.
  • Okna atrybucji po instalacji umożliwiają źródłom, które spowodowały instalację, dalsze uzyskiwanie udziału w przyszłych zdarzeniach konwersji w aplikacji.

Model atrybucji, którego technologie reklamowe używają do deduplikacji w różnych sieciach i wybierania zwycięskich źródeł, może mieć różny poziom złożoności w zależności od tego, jak wykorzystywane są te funkcje interfejsu API.

Poniższe przykłady ilustrują scenariusze, w których można używać tych funkcji, oraz pokazują, jak różne konfiguracje wpływają na to, które źródło atrybucji ostatecznie otrzymuje udział w przypadku danego zdarzenia wywołującego.

Proces

Poniżej znajdziesz listę kroków procesu XNA. Aby uprościć opis, w tym artykule założyliśmy, że reklamodawca używa technologii wyświetlania reklam do dostarczania reklam i platformy MMP do pomiaru konwersji. Projekt interfejsu API jest jednak elastyczny – funkcjonalność nie różni się w zależności od typu technologii reklamowej ani nie wymaga jej użycia.

  1. Rejestracja źródła: użytkownik wyświetla reklamę lub klika ją, a technologia wyświetlania reklam rejestruje te źródła w interfejsie API. Technologia reklamowa wyświetlająca reklamy może też przekierowywać do innych technologii reklamowych, które również mogą rejestrować źródła bezpośrednio w interfejsie API lub włączać atrybucję w wielu sieciach bez przekierowań.
  2. Rejestracja wyzwalacza: użytkownik wykonuje działanie związane z konwersją, np. pierwsze otwarcie aplikacji, zakup lub dodanie produktu do koszyka, po czym platforma MMP rejestruje wyzwalacz w interfejsie API. Platforma MMP może też przekierowywać do innych dostawców technologii reklamowych, którzy mogą rejestrować wyzwalacze bezpośrednio w interfejsie API. Jeśli platforma MMP musi włączyć atrybucję w różnych sieciach bez przekierowań, konfigurację atrybucji należy określić podczas rejestracji wyzwalacza.
  3. Atrybucja: jeśli podczas rejestracji aktywatora określono konfigurację atrybucji, źródła pochodne są generowane w imieniu platformy MMP. Każdy wyzwalacz jest dopasowywany do kwalifikującego się źródła zarejestrowanego bezpośrednio przez MMP lub do kwalifikującego się źródła pochodnego wygenerowanego w imieniu MMP przy użyciu źródeł technologii wyświetlania reklam. Pozostałe źródła, które nie uzyskały atrybucji, są odrzucane i nie mogą już uzyskać atrybucji w przypadku przyszłych konwersji. W innych częściach dokumentacji możesz też spotkać się z określeniem „stracisz raz, stracisz na zawsze”.
    1. Gdy źródło pochodne utraci atrybucję, interfejs API nie będzie generować kolejnych źródeł pochodnych na podstawie źródła pierwotnego, gdy platforma MMP zarejestruje przyszłe zdarzenia konwersji. Technologia wyświetlania reklam i inne platformy MMP mogą nadal używać pierwotnego źródła do przyszłej atrybucji. Szczegółowo opisujemy to w scenariuszu 6.
  4. Generowanie raportów: atrybucja prowadzi do generowania raportów o zdarzeniach lub raportów zbiorczych. Pamiętaj, że w przypadku źródeł pochodnych generowane są tylko raporty zbiorcze.
  5. Dostarczanie raportu: wygenerowane raporty są zaplanowane do dostarczenia.

Scenariusz 1. Atrybucja międzysieciowa z przekierowaniami

Reklamodawca korzysta z 2 technologii wyświetlania reklam i 1 platformy MMP. Gdy użytkownik kliknie reklamy wyświetlane przez technologie reklamowe, technologie te przekierują go do platformy MMP w momencie rejestracji źródła. Gdy użytkownik dokona konwersji w aplikacji, platforma MMP przekieruje go do dostawców technologii reklamowych w momencie rejestracji wywołania.

Platforma MMP otrzyma raport po usunięciu duplikatów z różnych sieci, a każdy dostawca technologii reklamowej wyświetlający reklamy otrzyma raporty o atrybucji własnej.

Oś czasu rejestracji

W momencie t0 użytkownik klika reklamę wyświetloną przez dostawcę technologii reklamowych ad-tech1, który rejestruje źródło Source1 wraz z przekierowaniem Source2 przez mmp-ad-tech:

  "Attribution-Reporting-Register-Source": {
    "source_event_id": "34532",
    "web_destination": "https://destination.example.com",
    "priority": "10",
    "expiry": "172800",
    "aggregation_keys": {
      "campaignCounts": "0x1"
    }
  },
  "Attribution-Reporting-Redirect": [
    "https://www.mmp-ad-tech.com/source2"
  ]
// Registered by mmp-ad-tech using redirects
  "Attribution-Reporting-Register-Source": {
    "source_event_id": "788324",
    "web_destination": "https://destination.example.com",
    "priority": "30",
    "expiry": "172800",
    "aggregation_keys": {
      "campaignCounts": "0x2",
      "geoValue": "0x102"
    }
  }

W momencie t1 użytkownik klika reklamę wyświetloną przez ad-tech2, aby zarejestrować Source3 wraz z przekierowaniem do mmp-ad-tech (Source4):

  "Attribution-Reporting-Register-Source": {
    "source_event_id": "6574435",
    "web_destination": "https://destination.example.com",
    "priority": "10",
    "expiry": "172800",
    "aggregation_keys": {
      "campaignCounts": "0x3"
    }

  },
  "Attribution-Reporting-Redirect": [
    "https://www.mmp-ad-tech.com/source"
  ]
// Registered by mmp-ad-tech using redirects
  "Attribution-Reporting-Register-Source": {
    "source_event_id": "4532343",
    "web_destination": "https://destination.example.com",
    "priority": "20",
    "expiry": "172800",
    "aggregation_keys": {
      "campaignCounts": "0x4"
    }
  }

W momencie t2 działanie użytkownika lub konwersja w aplikacji reklamodawcy powoduje rejestrację wywołania przez mmp-ad-tech (Trigger1), który przekierowuje też do ad-tech1 (Trigger2) i ad-tech2 (Trigger3):

nie zdefiniowano

Wynik

Zarejestrowane źródła mmp-ad-tech Source2 i Source4 konkurują w atrybucji dla zarejestrowanego aktywatora mmp-ad-tech Trigger1. Źródło2 ma wyższy priorytet niż Źródło4. Trigger2 od ad-tech1 jest przypisywany do Source1 od ad-tech1, a Trigger3 od ad-tech2 jest przypisywany do Source3 od ad-tech2.

Konkurencyjne źródła

Pola

Source1

Source2

Source3

Source4

Źródło rejestrujące technologię reklamową

ad-tech1

mmp-ad-tech

ad-tech2

mmp-ad-tech

source_event_id

34532

788324

6574435

4532343

miejsce docelowe

https://destination.example.com

https://destination.example.com

https://destination.example.com

https://destination.example.com

priorytet

10

30

10

20

Zarejestrowane aktywatory
Wynik atrybucji

Atrybuty aktywatora 1 do Źródła 2, atrybuty aktywatora 2 do Źródła 1 i atrybuty aktywatora 3 do Źródła 3.

Atrybucja po uwzględnieniu zignorowanych źródeł

Source4 – w przyszłości nie będzie konkurować o atrybucję.

Raporty o zdarzeniach

URL raportu: https://www.mmp-ad-tech.com/.well-known/attribution-reporting/report-event-attribution

  {
    "attribution_destination": "https://destination.example.com",
    "scheduled_report_time": "800176400",
    "source_event_id": "788324",
    "trigger_data": "1",
    "source_type": "navigation",
    "randomized_trigger_rate": 0.0024263
  }

Adres URL raportu: https://www.ad-tech1.com/.well-known/attribution-reporting/report-event-attribution

  {
    "attribution_destination": "https://destination.example.com",
    "scheduled_report_time": "800176400",
    "source_event_id": "34532",
    "trigger_data": "2",
    "source_type": "navigation",
    "randomized_trigger_rate": 0.0024263
  }

Adres URL raportu: https://www.ad-tech2.com/.well-known/attribution-reporting/report-event-attribution

  {
    "attribution_destination": "https://destination.example.com",
    "scheduled_report_time": "800176400",
    "source_event_id": "6574435",
    "trigger_data": "3",
    "source_type": "navigation",
    "randomized_trigger_rate": 0.0024263
  }
Raporty zagregowane

Adres URL raportu: https://www.mmp-ad-tech.com/.well-known/attribution-reporting/report-aggregate-attribution

  {
    "attribution_destination": "https://destination.example.com",
    "histograms": [
      {
        "key": "0x104",
        "value": 11
      }
    ]
  }

Adres URL raportu: https://www.ad-tech1.com/.well-known/attribution-reporting/report-aggregate-attribution

  {
    "attribution_destination": "https://destination.example.com",
    "histograms": [
      {
        "key": "0x201",
        "value": 21
      }
    ]
  }

Adres URL raportu: https://www.ad-tech2.com/.well-known/attribution-reporting/report-aggregate-attribution

  {
    "attribution_destination": "https://destination.example.com",
    "histograms": [
      {
        "key": "0x303",
        "value": 31
      }
    ]
  }

Scenariusz 2. Atrybucja międzysieciowa bez przekierowań

Reklamodawca korzysta z 2 technologii wyświetlania reklam i 1 platformy MMP. Użytkownik klika reklamę z pierwszej platformy reklamowej, która przekierowuje go do MMP w celu rejestracji źródła. Gdy użytkownik kliknie reklamę z drugiego systemu reklamowego, system ten nie przekierowuje użytkownika, ale z wyprzedzeniem udostępnia MMP podzbiór kluczy agregacji.

Użytkownik dokonuje konwersji w aplikacji, w której platforma MMP rejestruje wywołanie, ale nie przekierowuje do żadnej z technologii reklamowych. Technologia reklamowa, która nie przekierowuje, uzyskuje atrybucję ostatniego kontaktu. Tylko platforma MMP otrzyma podsumowujący raport o konwersjach po usunięciu duplikatów z różnych sieci, który będzie zawierać tę konwersję.

Oś czasu rejestracji

W momencie t0 użytkownik klika reklamę, co powoduje rejestrację w usłudze Źródło1 przez ad-tech1 i rejestrację w usłudze Źródło2 przez mmp-ad-tech za pomocą przekierowania z ad-tech1:

  "Attribution-Reporting-Register-Source": {
    "source_event_id": "234543",
    "web_destination": "https://destination.example.com",
    "priority": "20",
    "expiry": "172801",
    "aggregation_keys": {
      "campaignCounts": "0x159"
    }
  },
  "Attribution-Reporting-Redirect": [
    "http://www.mmp-ad-tech.com"
  ]
 // Registered by mmp-ad-tech using redirect
 "Attribution-Reporting-Register-Source": {
    "source_event_id": "45453",
    "web_destination": "https://destination.example.com",
    "priority": "100",
    "expiry": "172801",
    "aggregation_keys": {
      "campaignCounts": "0x159",
      "geoValue": "0x5",
    }
  }

W momencie t1 użytkownik klika inną reklamę, co powoduje, że źródło Source3 jest powiązane z technologią reklamową ad-tech2, która udostępnia klucze agregacji:

 // Registered by ad-tech2
  "Attribution-Reporting-Register-Source": {
    "source_event_id": "978",
    "web_destination": "https://destination.example.com",
    "priority": "20",
    "expiry": "172801",
    "aggregation_keys": {
      "campaignCounts": "0x159",
      "geoValue": "0x5"
    },
    "shared_aggregation_keys": [
      "campaignCounts"
    ]
  }

W momencie t2 działanie lub konwersja użytkownika powoduje rejestrację wywołania przez mmp-ad-tech, który zawiera konfigurację atrybucji dla ad-tech2:

  "Attribution-Reporting-Register-Trigger": {
    "event_trigger_data": [
      {
        "trigger_data": "2",
        "priority": "101"
      }
    ],
    "aggregatable_trigger_data": [
      {
        "key_piece": "0x400",
        "source_keys": [
          "campaignCounts"
        ],
        "x_network_data": {
          "key_offset": 10
        }
      }
    ],
    "aggregatable_values": {
      "campaignCounts": 32768
    },
    "attribution_config": [
      {
        "source_network": "enrollment-id-ad-tech-2",
        "source_priority_range": {
          "start": 1,
          "end": 1000
        },
        "priority": "200",
        "expiry": "172800"
      }
    ],
    "x_network_key_mapping": {
      "enrollment-id-ad-tech-2": "0x4"
    }
  }

Wynik

Source2 dopasowuje rejestrację i miejsce docelowe do aktywatora, dzięki czemu staje się konkurencyjnym źródłem atrybucji. Dodatkowo podczas rejestracji wyzwalacza określono konfigurację atrybucji dla dostawcy technologii reklamowych 2 i źródła 3, używając kluczy agregacji udostępnianych przez dostawcę technologii reklamowych 2. Umożliwia to wygenerowanie źródła pochodnego, Source3', jako konkurencyjnego źródła na potrzeby atrybucji.

Konkurencyjne źródła

Pola

Source2

Źródło3'

Rejestrowanie technologii reklamowych przez pierwotne źródło

mmp-ad-tech

ad-tech2

source_event_id

45453

978

priorytet

100

200

Zarejestrowane aktywatory

Trigger1 od mmp-ad-tech.

Wynik atrybucji

Zdarzenie Trigger1 zostanie przypisane do źródła Source3', ponieważ ma ono wyższy priorytet niż Source2.

Atrybucja po uwzględnieniu zignorowanych źródeł

Source2

Raporty o zdarzeniach

Brak – w przypadku źródeł pochodnych nie są generowane raporty o zdarzeniach.

Raporty zbiorcze

Źródło nadrzędne Źródła3, czyli Źródło3, udostępnia tylko campaignCounts, a kluczowy element wyzwalacza jest obliczany w ten sposób:

(key_piece value) | ((x_network_key_mapping entry) << offset)
0x400 | (0x4 << 10) = 0x1400

Klucz wynikowy jest generowany przez wykonanie operacji OR na kluczu wyzwalającym (0x1400) i kluczu źródłowym (0x159), co daje wartość 0x1559.

Adres URL raportu: http://www.mmp-ad-tech.com/.well-known/attribution-reporting/report-aggregate-attribution

{
  "attribution_destination": "https://destination.example.com",
  "histograms": [
    {
     "key": "0x1559",
      "value": 32768
    }
  ]
}

Scenariusz 3. Zarejestrowane źródło MMP i kandydat na element nadrzędny źródła pochodnego w tym samym łańcuchu rejestracji

Reklamodawca korzysta z 2 technologii wyświetlania reklam i 1 platformy MMP. Użytkownik klika reklamę z pierwszej platformy reklamowej, która nie przekierowuje użytkownika podczas rejestracji źródła, ale udostępnia klucze agregacji platformie MMP. Użytkownik klika reklamę z drugiej technologii wyświetlania reklam, która przekierowuje do platformy MMP podczas rejestracji źródła i udostępnia jej klucze agregacji.

Oś czasu rejestracji

W momencie t0 użytkownik klika reklamę wyświetloną przez platformę reklamową 1, co rozpoczyna rejestrację źródła 1:

 "Attribution-Reporting-Register-Source": {
    "source_event_id": "52343",
    "web_destination": "https://destination.example.com",
    "priority": "20",
    "expiry": "172800",
    "aggregation_keys": {
     "campaignCounts": "0x159",
     "geoValue": "0x5"
   },
   "shared_aggregation_keys": [
     "campaignCounts",
     "geoValue"
   ]
 }

W momencie t1 w łańcuchu rejestracji 2 platforma ad-tech2 rejestruje źródło Source2 i przekierowuje do rejestracji źródła MMP, Source3:

  "Attribution-Reporting-Register-Source": {
    "source_event_id": "234456",
    "web_destination": "https://destination.example.com",
    "priority": "20",
    "expiry": "172801",
    "aggregation_keys": {
      "campaignCounts": "0x159"
    },
    "shared_aggregation_keys": [
      "campaignCounts"
    ]
  },
  "Attribution-Reporting-Redirect": [
    "http://www.mmp-ad-tech.com"
  ]
  "Attribution-Reporting-Register-Source": {
    "source_event_id": "4234",
    "web_destination": "https://destination.example.com",
    "priority": "100",
    "expiry": "172800",
    "aggregation_keys": {
      "campaignCounts": "0x159"
    }
  }

W momencie t2 rejestracja aktywatora ma skonfigurowaną atrybucję, która generuje źródła pochodne z technologii reklamowych 1 i 2:

  "Attribution-Reporting-Register-Trigger": {
    "event_trigger_data": [
      {
        "trigger_data": "2",
        "priority": "101"
      }
    ],
    "aggregatable_trigger_data": [
      {
        "key_piece": "0x400",
        "source_keys": [
          "campaignCounts"
        ],
        "x_network_data" : {
          "key_offset" : 10
        }
      }
    ],
    "aggregatable_values": {
      "campaignCounts": 32768,
      "geoValue": 1664
    },
    "attribution_config": [
      {
        "source_network": "enrollment-id-ad-tech-1",
        "source_priority_range": {
          "start": 1,
          "end": 1000
        },
        "priority": "20",
        "expiry": "172800"
      },
      {
        "source_network": "enrollment-id-ad-tech-2",
        "source_priority_range": {
          "start": 1,
          "end": 1000
        },
        "priority": "20",
        "expiry": "172800"
      }
    ],
    "x_network_key_mapping" : {
      "enrollment-id-ad-tech-1" : "0x2",
      "enrollment-id-ad-tech-2" : "0x4"
    }
  }

W rezultacie atrybucję uzyskuje źródło zarejestrowane w platformie MMP w drugim łańcuchu rejestracji. Wynikowy raport zbiorczy będzie wyglądał mniej więcej tak:

Wynik

Źródło pochodne ze źródła 2 (z wartością „source_event_id": "234456”) nie bierze udziału w atrybucji, ponieważ w tym samym łańcuchu rejestracji znajduje się też zarejestrowane źródło mmp-ad-tech.

Konkurencyjne źródła

Pola

Źródło1'

Source3

Rejestracja technologii reklamowej przez pierwotne źródło

ad-tech1

mmp-ad-tech

source_event_id

52343

4234

priorytet

20

100

Zarejestrowane aktywatory

Trigger1 od mmp-ad-tech.

Wynik atrybucji

Wyzwalacz1 zostanie przypisany do źródła Source3, ponieważ ma ono wyższy priorytet niż Source1.

Atrybucja po uwzględnieniu zignorowanych źródeł

Source1' – źródło Source1 nie będzie już brane pod uwagę przy tworzeniu źródła pochodnego dla mmp-ad-tech.

Raporty o zdarzeniach

Adres URL raportu: https://www.ad-tech1.com/.well-known/attribution-reporting/report-event-attribution

  {
    "attribution_destination": "https://destination.example.com",
    "scheduled_report_time": "800176400",
    "source_event_id": "4234",
    "trigger_data": "2",
    "source_type": "navigation",
    "randomized_trigger_rate": 0.0024263
  }
Raporty zbiorcze

Adres URL raportu: http://www.mmp-ad-tech.com/.well-known/attribution-reporting/report-aggregate-attribution

{
  "report_url": "http://www.mmp-example.com",
  "payload": {
    "attribution_destination": "https://destination.example.com",
    "histograms": [
      {
        "key": "0x559"
        "value": 32768
      }
    ]
  }
}

Scenariusz 4. Atrybucja w różnych sieciach bez przekierowań z kryteriami wyboru źródła

Reklamodawca korzysta z 4 technologii wyświetlania reklam i 1 platformy MMP. Użytkownik klika reklamę z 1 technologii wyświetlania reklam i wyświetla reklamy z pozostałych 3. Gdy użytkownik dokona konwersji w aplikacji reklamodawcy, MMP rejestruje wywołanie i określa, które zarejestrowane źródła technologii wyświetlania reklam mają być użyte do utworzenia źródeł pochodnych na podstawie tych filtrów:

  1. priority_range: wybierz źródła o priorytecie w podanym zakresie.
  2. expiry: wybierz źródła, których ważność wygasa po określonym czasie;
  3. source_filters: wybierz źródła, których dane filtra pasują do określonych filtrów źródła.
  4. source_not_filters: wybierz źródła, których not_filters pasują do określonych source_not_filters;

Gdy źródła pochodne zostaną wygenerowane na podstawie kryteriów, mogą brać udział w atrybucji.

Harmonogram rejestracji

W momencie t0 użytkownik klika, co powoduje, że technologia reklamowa1 rejestruje źródło Source1, które przypisuje source_type jako nawigację do tego zarejestrowanego źródła:

  "Attribution-Reporting-Register-Source": {
    "source_event_id": "87456",
    "web_destination": "https://destination.example.com",
    "priority": "20",
    "expiry": "172801",
    "filter_data": {
      "filter1": [
        "does_not_matter"
      ],
      "filter2": [
        "non-match"
      ]
    },
    "aggregation_keys": {
      "campaignCounts": "0x119",
      "geoValue": "0x5"
    },
    "shared_aggregation_keys": [
      "campaignCounts",
      "geoValue"
    ]
  }

W momencie t1 użytkownik wyświetla reklamę, co powoduje, że technologia reklamowa 2 rejestruje źródło Source2, które przypisuje do tego zarejestrowanego źródła typ źródła event:

  "Attribution-Reporting-Register-Source": {
    "source_event_id": "9078",
    "web_destination": "https://destination.example.com",
    "priority": "2000",
    "expiry": "172801",
    "filter_data": {
      "filter1": [
        "does_not_matter"
      ],
      "filter2": [
        "match"
      ]
    },
    "aggregation_keys": {
      "campaignCounts": "0x129",
      "geoValue": "0x5"
    },
    "shared_aggregation_keys": [
      "campaignCounts",
      "geoValue"
    ]
  }

W momencie t2 wyświetlenie przez użytkownika powoduje zarejestrowanie przez technologię reklamową 3 źródła Source3, które przypisuje do tego zarejestrowanego źródła typ źródła jako zdarzenie:

  "Attribution-Reporting-Register-Source": {
    "source_event_id": "2413",
    "web_destination": "https://destination.example.com",
    "priority": "20",
    "filter_data": {
      "filter1": [
        "non-match"
      ],
      "filter2": [
        "non-match"
      ]
    },
    "aggregation_keys": {
      "campaignCounts": "0x159",
      "geoValue": "0x5"
    },
    "shared_aggregation_keys": [
      "campaignCounts",
      "geoValue"
    ]
  }

W momencie t3 wyświetlenie przez użytkownika powoduje zarejestrowanie przez technologię reklamową4 źródła Źródło4, które przypisuje do tego zarejestrowanego źródła typ źródła jako zdarzenie:

  "Attribution-Reporting-Register-Source": {
    "source_event_id": "7567",
    "web_destination": "https://destination.example.com",
    "priority": "20",
    "filter_data": {
      "filter1": [
        "match"
      ],
      "filter2": [
        "match"
      ]
    },
    "aggregation_keys": {
      "campaignCounts": "0x169",
      "geoValue": "0x5"
    },
    "shared_aggregation_keys": [
      "campaignCounts",
      "geoValue"
    ]
  }

W momencie t4 konwersja użytkownika powoduje, że platforma MMP-ad-tech rejestruje wyzwalacz z konfiguracją atrybucji dla wszystkich innych wymienionych wcześniej źródeł zarejestrowanych przez platformy ad-tech:

  "Attribution-Reporting-Register-Trigger": {
    "event_trigger_data": [
      {
        "trigger_data": "2",
        "priority": "100"
      }
    ],
    "aggregatable_trigger_data": [
      {
        "key_piece": "0x400",
        "source_keys": [
          "campaignCounts"
        ]
      }
    ],
    "aggregatable_values": {
      "campaignCounts": 32768,
      "geoValue": 1664
    },
    "attribution_config": [
      {
        "source_network": "enrollment-id-ad-tech-1",
        "source_priority_range": {
          "start": 1,
          "end": 100
        },
        "source_filters": {
          "source_type": [
            "event"
          ]
        },
        "priority": "100",
        "expiry": "172801"
      },
      {
        "source_network": "enrollment-id-ad-tech-2",
        "source_priority_range": {
          "start": 1,
          "end": 1000
        },
        "source_filters": {
          "source_type": [
            "navigation"
          ]
        },
        "priority": "100",
        "expiry": "172801"
      },
      {
        "source_network": "enrollment-id-ad-tech-3",
        "source_priority_range": {
          "start": 1,
          "end": 1000
        },
        "source_filters": {
          "source_type": [
            "navigation"
          ],
          "filter1": [
            "match"
          ],
          "filter2": [
            "match"
          ]
        },
        "priority": "50",
        "expiry": "172801"
      },
      {
        "source_network": "enrollment-id-ad-tech-4",
        "source_priority_range": {
          "start": 1,
          "end": 1000
        },
        "source_filters": {
          "source_type": [
            "navigation"
          ],
          "filter1": [
            "match"
          ],
          "filter2": [
            "match"
          ]
        },
        "priority": "30",
        "expiry": "172801"
      }
    ],
    "x_network_key_mapping": {
      "enrollment-id-ad-tech-1": "0x1",
      "enrollment-id-ad-tech-2": "0x2",
      "enrollment-id-ad-tech-3": "0x3",
      "enrollment-id-ad-tech-4": "0x4"
    }
  }

Wynik

Te źródła nie kwalifikują się do generowania źródeł pochodnych z powodu niezgodności z kryteriami:

  1. Źródło1 nie spełnia warunków filtra source_type:event w konfiguracji atrybucji platformy ad-tech1
  2. Źródło 2 ma priorytet ustawiony na 2000, co wykracza poza zakres filtra priorytetu technologii reklamowej 2 (1–1000).
  3. Source3 nie pasuje do wartości parametru filter2
Konkurencyjne źródła

Pola

Źródło4'

Technologia reklamowa rejestrująca pierwotne źródło

ad-tech4

source_event_id

7567

miejsce docelowe

https://destination.example.com

priorytet

30

wygasa

Czas rejestracji + 2 dni

Zarejestrowane aktywatory

Trigger1 od mmp-ad-tech.

Wynik atrybucji

Aktywator1 jest przypisywany do „Źródła4”, ponieważ jest to jedyne źródło kwalifikujące się do atrybucji.

Atrybucja po uwzględnieniu zignorowanych źródeł

Brak

Raporty o zdarzeniach

Brak – w przypadku zwycięzcy pochodzącego ze źródła pochodnego nie są generowane raporty o zdarzeniach.

Raporty zbiorcze

Adres URL raportu: http://www.mmp-ad-tech.com

{
  "attribution_destination": "https://example.com",
  "histograms": [
    {
      "key": "0x56d",
      "value": 32768
    },
    {
      "key": "0x5",
      "value": 1664
    }
  ]
}

Scenariusz 5. Atrybucja po instalacji

Reklamodawca korzysta z 2 technologii wyświetlania reklam i 1 platformy MMP. Użytkownik klika reklamę z pierwszej platformy reklamowej i instaluje aplikację reklamodawcy. Podczas atrybucji konwersji po instalacji źródło pochodne z atrybucją instalacji ma pierwszeństwo przed innymi źródłami, nawet jeśli mają one wyższe priorytety.

Harmonogram rejestracji

W momencie t0 interakcja użytkownika powoduje, że platforma ad-tech1 rejestruje Source1:

  "Attribution-Reporting-Register-Source": {
    "source_event_id": "3645",
    "destination": "android-app://com.example.app",
    "priority": "20",
    "expiry": "172801",
    "install_attribution_window": "86400",
    "post_install_exclusivity_window": "864000",
    "aggregation_keys": {
      "campaignCounts": "0x119",
      "geoValue": "0x5"
    },
    "shared_aggregation_keys": [
      "campaignCounts",
      "geoValue"
    ]
  }

W momencie t1 użytkownik instaluje aplikację com.example.app na swoim urządzeniu.

W momencie t2 interakcja użytkownika powoduje, że technologia reklamowa 2 rejestruje źródło 2:

  "Attribution-Reporting-Register-Source": {
    "source_event_id": "345789",
    "destination": "android-app://com.example.app",
    "priority": "100",
    "aggregation_keys": {
      "campaignCounts": "0x159",
      "geoValue": "0x5"
    },
    "shared_aggregation_keys": [
      "campaignCounts",
      "geoValue"
    ]
  }

W momencie t3 moduł mmp-ad-tech rejestruje wywołanie z konfiguracjami atrybucji dla dostawców ad-tech1 i ad-tech2:

  "Attribution-Reporting-Register-Trigger": {
    "event_trigger_data": [
      {
        "trigger_data": "2",
        "priority": "100"
      }
    ],
    "aggregatable_trigger_data": [
      {
        "key_piece": "0x400",
        "source_keys": [
          "campaignCounts"
        ]
      }
    ],
    "aggregatable_values": {
      "campaignCounts": 32768,
      "geoValue": 1664
    },
    "attribution_config": [
      {
        "source_network": "enrollment-id-ad-tech-1",
        "priority": "10",
        "expiry": "172801",
        "post_install_exclusivity_window": "172800"
      },
      {
        "source_network": "enrollment-id-ad-tech-2",
        "priority": "20",
        "expiry": "172801"
      }
    ],
    "x_network_key_mapping": {
      "enrollment-id-ad-tech-1": "0x1",
      "enrollment-id-ad-tech-2": "0x3"
    }
  }

Wynik

Wygenerowane źródła pochodne ze Źródła 1 i Źródła 2 (odpowiednio Źródło 1′ i Źródło 2′), które konkurują o atrybucję.

Konkurencyjne źródła

Pola

Źródło1'

Źródło2'

Rejestracja technologii reklamowej przez pierwotne źródło

ad-tech1

ad-tech2

source_event_id

3645

345789

miejsce docelowe

android-app://com.example.app

android-app://com.example.app

priorytet

10

20

Zwiększanie liczby instalacji aplikacji

tak

nie

Zarejestrowane aktywatory

Trigger1 od mmp-ad-tech.

Wynik atrybucji

Wyzwalacz1 jest przypisywany do „Source1”, ponieważ spowodował instalację aplikacji docelowej. Pamiętaj, że Source2 miał wyższy priorytet.

Atrybucja po uwzględnieniu zignorowanych źródeł

Source2' – źródła pochodne z Source2 nie będą uwzględniane w atrybucji w przypadku żadnych wyzwalaczy zarejestrowanych przez mmp-ad-tech.

Raporty o zdarzeniach

Brak – w przypadku zwycięzcy pochodzącego ze źródła pochodnego nie są generowane raporty o zdarzeniach.

Raporty zbiorcze

Adres URL raportu: http://www.mmp-ad-tech.com/.well-known/attribution-reporting/report-aggregate-attribution

{
  "attribution_destination": "android-app://com.example.app",
  "histograms": [
    {
      "key": "0x519",
      "value": 32768
    },
    {
      "key": "0x5",
      "value": 1664
    }
  ]
}

Scenariusz 6. Jedna przegrana oznacza przegraną na zawsze

Jeśli źródło technologii reklamowej 1 ma źródło, którego źródło pochodne brało udział w atrybucji wywołanej przez technologię reklamową mmp i utraciło atrybucję, źródło technologii reklamowej 1 nie jest już używane do tworzenia źródła pochodnego dla wywołań technologii reklamowej mmp. Oto przykładowa oś czasu:

  • W momencie t0 źródło Source1 platformy ad-tech1 jest zarejestrowane w usłudze "priority": "10".
  • W momencie t1 źródło Source2 platformy ad-tech2 jest zarejestrowane w usłudze "priority": "20".
  • W momencie t2 wywołanie Trigger1 dostawcy mmp-ad-tech jest zarejestrowane w konfiguracjach atrybucji dostawców ad-tech1 i ad-tech2.
  • W momencie t3 atrybucja dla aktywatora Trigger1 następuje w miejscu, w którym źródło pochodne z technologii reklamowej 2 wygrywa atrybucję, a źródło technologii reklamowej 1 jest ignorowane.
  • W momencie t4 źródło Source3 platformy ad-tech3 jest zarejestrowane w usłudze "priority": "5".
  • W momencie t5 funkcja Trigger2 dostawcy mmp-ad-tech jest zarejestrowana w konfiguracjach dostawców ad-tech1 i ad-tech3.
  • W momencie t6 następuje atrybucja aktywatora Trigger2, w której wygrywa źródło pochodne z Source3 (Source3’).

Wyjaśnienie wyników

Źródło pochodne ze źródła platformy reklamowej 1 utraciło atrybucję dla aktywatora 1, więc źródło 1 nie zostało użyte do utworzenia źródła pochodnego na potrzeby atrybucji aktywatora 2. Gdyby nie przegrało wcześniej w momencie t3, wygrałoby ze źródłem ad-tech3 ze względu na wyższy priorytet.