install_pro: Install ChannelAttributionPro binary tailored to your...

View source: R/ChannelAttribution.R

install_proR Documentation

Install ChannelAttributionPro binary tailored to your OS/arch/R

Description

Interactively installs the ChannelAttributionPro package by contacting the ChannelAttribution build service, which returns a platform-appropriate binary (or source) package URL for your current operating system, CPU architecture, and R version. At the prompt you can enter:

  • a token (recommended), or

  • a work/university email to request a token (the function sends the request and exits).

Usage

install_pro()

Details

When called, the function asks you to enter your ChannelAttributionPro token. If you don't have one, you can enter your work/university email; the function will request a token for that address and return invisibly, so you can re-run it once the token arrives.

Processing steps:

  1. Detect your platform (os, os_vers, arch) and R minor version.

  2. Send a form-encoded request to the ChannelAttribution builder endpoint to obtain a package URL.

  3. Install the returned package via install.packages with repos = NULL.

  4. On exit, send a small status message to a monitoring endpoint with minimal text (no local files).

Dependencies: This function requires curl (for HTTPS) and jsonlite (for JSON parsing). If either is missing, the function aborts with a friendly message.

Networking and privacy: The function performs outbound HTTPS requests to https://app.channelattribution.io, sending only the minimal parameters needed to resolve the correct binary and (on exit) a small status string for diagnostics. No local files or datasets are uploaded.

Interactive prompt: Input is collected via base R readline() (no masking). In some environments the input may be visible.

Value

Invisibly returns NULL. Progress and outcome messages are printed.

Errors and messages

  • Invalid or expired token (HTTP 401): You will see a message inviting you to contact info@channelattribution.io or request a new token.

  • Network/SSL issues: Reported as a concise network_or_ssl_error: ....

  • Unexpected builder response: The function prints diagnostic information (platform and R version) that you can forward to support.

Author(s)

ChannelAttribution Team

See Also

install.packages

Examples

## Not run: 
## Typical interactive use:
install_pro()

## If you don't have a token at prompt:
##   - enter your work/university email to request one
##   - check your inbox (including spam)
##   - re-run install_pro() with the token

## End(Not run)

ChannelAttribution documentation built on Nov. 17, 2025, 5:07 p.m.