list_sign_up_clicks

{
  "name": "list_sign_up_clicks",
  "resource": "account",
  "tier": "observe",
  "grant": "super_admin",
  "summary": "Super-admin: the ad-click rows the plane wrote at account creations — each row's identifier, the account's identifier, the advertiser's click identifiers the landing carried, the consent reading, and the creation instant — unexpired, at or after `since`, up to `limit`. The company's read of the platform's own measurement record for its upload to the advertiser; never an address, a name, or any other member of the account.",
  "annotations": {
    "readOnlyHint": true,
    "destructiveHint": false,
    "openWorldHint": false,
    "idempotentHint": true
  }
}

{
  "name": "list_sign_up_clicks",
  "title": "List sign-up clicks",
  "tier": "observe",
  "scenario": "API-L0-12",
  "summary": "Read the ad-click rows the platform wrote at account creations, unexpired and created at or after `since`, oldest first, up to `limit` (500 by default and at most). Each row carries its id, the account's id, the click identifiers the landing carried (`gclid`, `gbraid`, `wbraid`, those present), `consent` (`granted` where the UK banner was accepted, `not_asked` otherwise), and `created_at`. Super-admin (platform operator) only, for the operator's upload of conversions to the advertiser. It answers no address, no name, and nothing else of the account.",
  "owners": [
    "ACB-L0-86",
    "API-L0-12"
  ]
}

{
  "request": {
    "type": "object",
    "required": [],
    "properties": {
      "since": {
        "type": "string",
        "description": "Inclusive start: rows created at or after this instant. Use YYYY-MM-DD followed by T (or t), HH:mm, optional :ss, an optional decimal fraction of 1–9 digits after seconds, then Z (or z) or a signed HH:mm offset. Omission answers from the oldest unexpired row; the HTTP action returns 400 invalid_request naming the member for null, empty strings, wrong types, or malformed values."
      },
      "limit": {
        "type": "integer",
        "minimum": 1,
        "maximum": 500,
        "description": "How many rows at most, 1 to 500; 500 where none is given."
      }
    }
  },
  "response": {
    "type": "object",
    "required": [
      "contract_version",
      "clicks",
      "count"
    ],
    "properties": {
      "contract_version": {
        "const": 1
      },
      "reference": {
        "type": "string",
        "pattern": "^[0-9a-f]{10}$",
        "description": "The short reference the platform recorded this call under, ten lowercase hexadecimal characters, the value the call’s record row carries; quote it when reporting the call."
      },
      "clicks": {
        "type": "array",
        "items": {
          "type": "object",
          "required": [
            "id",
            "account",
            "consent",
            "created_at"
          ],
          "properties": {
            "id": {
              "type": "string",
              "description": "The row's own identifier, the value `settle_sign_up_clicks` names."
            },
            "account": {
              "type": "string",
              "description": "The account's identifier, the value `read_operated_account` reads; no address and no name."
            },
            "gclid": {
              "type": "string",
              "description": "Google's click identifier the landing carried, where it carried one."
            },
            "gbraid": {
              "type": "string",
              "description": "Google's iOS app-to-web click identifier the landing carried, where it carried one."
            },
            "wbraid": {
              "type": "string",
              "description": "Google's iOS web-to-app click identifier the landing carried, where it carried one."
            },
            "consent": {
              "enum": [
                "granted",
                "not_asked"
              ],
              "description": "`granted` where the visitor accepted the UK consent banner, `not_asked` where no banner stood."
            },
            "created_at": {
              "type": "string",
              "description": "The account's creation instant, UTC, the conversion's instant."
            }
          }
        },
        "description": "The rows, oldest first."
      },
      "count": {
        "type": "integer",
        "minimum": 0,
        "description": "How many rows the answer carries."
      },
      "detail": {
        "type": "string"
      }
    }
  }
}