When I call the zoom add registrant API with the parameters below, it does create the registration record. However, it does not include the source_id field in the registration information. Likewise, when I retrieve the source registration record through the API, it does not include the source_id field in the results. Is this a known bug or am I using the incorrect field identifier (source_id)?
Hello @elisa.zoom , would you have any update on this? We are trying to use the source_id field to track the source of the webinar registration, but the value being passed in via source_id field is not being attributed to the tracking link setup for webinars. I know it used to work because I used it last year for one of our webinars, but now it seems to be broken.
Hi @denney.abraham
I am happy to look into this again.
Could you share with me how were you passing this field in your requests so I can try and replicate this issue? and how are you trying to track this down please
When a webinar has been setup, there is an option to set up multiple tracking links for it which we can use on different sites (Facebook, Twitter, etc). On the Zoom Webinar Tracking Page, we can see how many people registered for the webinar using those tracking links. That way we can track how many people registered from Facebook, Twitter, etc.
Last year when I was using this, each tracking link used to resemble this format: zoomDomain/767667623/78923490/join
The value ā767667623ā was the zoom meeting number that was given to all attendees while the value ā78923490ā was the source_id. Each tracking link would have a unique source_id. I was able to send that source_id value to the Zoom Webinar registration API via the āsource_idā property in the JSON above. When that call was finished, the count for that tracking link incremented on the Zoom Webinar Tracking Page.
This time when I tried to use the tracking link, the tracking link provided by Zoom resembles this format: zoomDomain/78923490/join
The actual zoom meeting number is no longer part of the link, but there is another value ā78923490ā in the link. I figured that was the source_id since it is part of the tracking link. So, this is where the value of āsource_idā in the JSON above comes from.
Now the webinar registration succeeds, but the tracking link count on the Zoom Webinar Tracking Page does not increment. It appears that Zoom just ignores the āsource_idā value passed in to the Webinar Registration API via the JSON payload.
Hi @denney.abraham
Thanks for sharing more details with me.
I am able to pass the source ID that I am getting from the url to add registrants to a test webinar that I have set up.
I got the source_id from the URL of the webinar I created and then passed the same request body that you passed and I can see how the number of registrants increases.
could you please try again with a new webinar?
Thank you @elisa.zoom for checking on this. Does the count for the tracking link increment as well? I can confirm that the count of registrants for the webinar itself increments, but I did not see the count for the tracking link incrementing. The source_id is supposed to connect to the tracking link, not just the webinar.
Hi @elisa.zoom,
Sorry for the delay in getting back to you. I was out on PTO for a while and then was not well for a few days.
I tried to attach a screenshot of āSource Tracking Linkā section of the Webinar setup page to this post, but it wouldnāt let me.
So, here is my explanation of where it is:
When setting up a Webinar, under the āInvitationsā tab, in the āInvite Attendeesā section, there is a āSource Tracking Linkā section with an ā+ Addā link to the right. Click on the ā+ Addā link to create a new Source Tracking Link. Once the new āSource Tracking Linkā is created, you will notice that the Tracking Link has an ID that is different from your meeting number. That number is the Source ID I have used in the past. Note that the āRegistrationsā count on the right side says ā0ā.
In the past when it was working as expected, I have included that source ID in the API call (in the property āsource_idā of the body), and when I have done so, the count in āRegistrationsā column goes up by 1. That is no longer happening. We are looking to have it work the way it used to in the past so that we can track how many people registered via a certain source.
I believe this is intended behavior since user/registrant 2 never registered via the tracking source. The logic for source_id couldāve been rendered void with the update to the source tracking url parameters. I note this API changelog update for source_id, but no additional context is added: Zoom Meeting API - March 18, 2023
In my opinion, since source tracking pertains to the url, Iām not sure why itās an option to enter via add registrant API requests since the point of the url is gauge registrant engagement from specified sites.
The previous behavior you observed for source_id may be deprecated or was unexpected. I will open a request with our documentation team.
Do you have any evidence demonstrating the previous behavior that I would be able to share with the team?
Thank you @gianni.zoom for your detailed response. It was very helpful. Unfortunately, I do not have an example from the last time I used the āsource_idā property as I did not preserve any logs or screenshots.
I do have some questions and notes based on all the information you provided:
Is there a different API available for calling so that we can register a user using the tracking source without having to make the tracking source link available to the user?
The original intent for the āsource_idā in Add Webinar Registrant API was āThe tracking sourceās unique identifier.ā (as I see here: Add a Webinar Registrant and specifically :source_id)
Is there a way I can use the APIs available to register a user under the Tracking Source? Iād really appreciate any guidance on this.
If there is no API to call where I can register a user under the tracking source without having to making the link available to the user, then it appears that the original feature was working as intended because it aligns with the documentation and my experience with using it. Can that feature be restored because it appears to me that it was working as expected. This appears to be a change that was introduced at some point.
As it stands right now, the :source_id property on the Add a Webinar Registrant API appears to be serving no purpose at all. Thatās why I think it is an unintended change from the previous functionality.
Thank you again for your kind efforts to help me with this.
I was wondering if you have any thoughts or findings based on my questions and notes above. Iād appreciate it if you could help me figure out a way to use Zoomās current API to register a user and have the tracking link count increment as well.
The internal team Iām working with wasnāt able to reproduce the issue, even though I did. I am waiting for clarification on what is additionally needed to help see the behavior.
Could you try again and see if youāre seeing the same behavior? Please grab the tracking id from the response headers for the request.
Thank you, @gianni.zoom , for following up on this and letting me know the details of the right ID to use. Iāll follow up with my team-member and test it as soon as possible. I will let you know how it goes.