fenix/docs/activation.md
Alessio Placitelli 0d82431195 Generate the activation ping and send it with Glean (#1707)
This fetches the Google Advertising ID, salts it and
then applies hashing before sending a ping with it,
at startup. Hashing and salting are used in order
to prevent ourselves to correlate advertising IDs
from the same user running different products we
own off a single device. We will never send the
client_id and the Google Advertising ID in the same
ping.
2019-05-03 09:40:21 -05:00

1.2 KiB

The activation ping

Description

This ping provides a measure of the activation of mobile products.

Scheduling

The activation ping is automatically sent at the very first startup, after Glean is initialized. It is only sent once and only re-attempted a subsequent startups if it hasn't been sent yet.

Contents

This ping contains the following fields:

Field name Type Description
identifier String An hashed and salted version of the Google Advertising ID from the device.
activation_id UUID An alternate identifier, not correlated with the client_id, generated once and only sent with the activation ping.

The activation ping also includes the common ping sections found in all pings, with the exclusion of the client_id (as defined by the pings.yaml file).

Example activation ping

{
  "ping_info": { },
  "client_info": { },
  "metrics": {
    "string": {
      "activation.identifier": "d+lnddDYN2ILBDGvhBIBHORRMrmVwTCp6rGLLFi8SMo="
    },
    "uuid": {
      "activation.activation_id": "c0c40a5f-bd75-41ca-8097-9a38103de7fe"
    }
  }
}