8000 Improve documentation on distribution links · Issue #361 · ropensci/qualtRics · GitHub
[go: up one dir, main page]
More Web Proxy on the site http://driver.im/
Skip to content

Improve documentation on distribution links #361

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom
Open
ian-c-young opened this issue Jan 15, 2025 · 5 comments
Open

Improve documentation on distribution links #361

ian-c-young opened this issue Jan 15, 2025 · 5 comments
Labels
documentation

Comments

@ian-c-young
Copy link

Is there a way to pull distribution links for surveys with the all_surveys() function? Or any other function in this package?
@juliasilge
Copy link
Collaborator

I believe that first you get the distributions: https://docs.ropensci.org/qualtRics/reference/fetch_distributions.html
And then you get the links: https://docs.ropensci.org/qualtRics/reference/list_distribution_links.html

I will be honest that I haven't used distributions much from Qualtrics, though, so let me know if that doesn't make sense!

@ian-c-young
Copy link
Author

Thanks for the response! When I run fetch_distributions I receive a tibble with no rows and 34 columns. Or when I run list_distribution_links I get a 400 error. I might be using the wrong Qualtrics lingo. I think what I am looking to pull into R is the anonymous survey link for any given survey. Not sure if that functionality exists in this package or I should explore the Qualtrics API with httr2.

@ian-c-young
Copy link
Author

Ah I overthought it. I see qualtrics names its anonymous survey links in consistent way. So I just did all_surveys() then a simple mutate call to create a new variable called survey_link, appending the survey id from the id column to my orgs default qualtrics link structure.

@juliasilge
Copy link
Collaborator

Do you think we could improve our documentation for these functions, to clarify what you need to do here? For example, does the example here need to be improved?

https://docs.ropensci.org/qualtRics/reference/list_distribution_links.html

@ian-c-young
Copy link
Author

I think that would help some. I also am really not familiar with distribution links and data in Qualtrics, so I am probably not the best person to ask. I mistook the distribution links and data for retrieving the anonymous survey link within the distribution section of Qualtrics. I have only really worked with sending out surveys via an anonymous survey link, not uploading emails into Qualtrics and getting a specific link for each recipient which I am guessing these functions relate to.

Separately, this is how I used this package to pull my anonymous survey links into R. Currently in Qualtrics all the anonymous survey links follow this structure.

all_surveys() |>
mutate(survey_link = str_c("https://[Your Organization ID].[Your Datacenter ID].qualtrics.com/jfe/form/", id))

@juliasilge juliasilge changed the title Getting distribution link Improve documentation on distribution links Jan 17, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Assignees
No one assigned
Labels
documentation
Projects
None yet
Milestone
No milestone
Development

No branches or pull requests
2 participants
@juliasilge @ian-c-young
0