Skip to main content
4 - Connect your CMP
Marine CIPRIANO avatar
Written by Marine CIPRIANO
Updated over a month ago

Connecting JOIN to Your CMP

Navigate to your CMP settings where you will need to add a custom cookie.

You will be required to add information related to the cookie:

  • Name: JOIN Stories

  • Short Description: JOIN Stories uses a cookie to analyze the performance of your Stories on our site. This helps us improve your experience.

  • Long Description: To provide you with an optimal experience, JOIN Stories uses a cookie that allows us to collect data on the use of our Stories on your site. This information helps us understand how you interact with our content so we can continually improve our service. By accepting the use of this cookie, you contribute to making our platform even more effective and tailored to your needs.

  • Category: Analytic

Managing Consent

We offer three methods to manage user consent. You can choose the one that best fits your environment and CMP.

This is configurable from the Workspace Settings under the Advanced analytics tab.

1. Cookie Matching (recommended)

This method allows JOIN Stories to automatically verify a specific cookie that you configure in your CMP. You must provide:

  • Cookie Name: The name of the cookie that stores consent.

  • Cookie Value: The value that represents the user's consent (e.g., "opt-in").

  • Condition: The condition to verify (e.g., "equals" for equality, "includes" for inclusion, or "regular expression").

JOIN Stories will use this information to determine if the user has given consent.

2. Force Consent

In this mode, JOIN Stories automatically considers that the user has given consent, without performing any verification.

3. Function Call

If you prefer to directly control consent management, you can call a function to indicate to JOIN Stories whether the user has consented or not.

// The user has given his consent
window.joinStories.consentManager.setUserConsent(true);

// The user has not given their consent
window.joinStories.consentManager.setUserConsent(false);

It is recommended to consult your CMP regarding the cookies set or the various available methods to be notified in the event of a user's consent modification, thereby allowing the information to be transmitted to JOIN Stories.

Integration example with Axeptio

1. Function Call

To be notified of the acceptance or refusal of cookies, you need to add the following code snippet. If consent is given, you should call the JOIN Stories function to notify that consent has been granted:

window.joinStories.consentManager.setUserConsent(true);

With a vendor join_stories, the result would be:

void 0 === window._axcb && (window._axcb = []); 
window._axcb.push(function (axeptio) {
axeptio.on("cookies:complete", function (choices) {
if (choices.join_stories) {
window.joinStories.consentManager.setUserConsent(true);
}
});
});

For more details, please refer to the Axeptio documentation.

b. Cookie Matching

Axeptio lists the authorized vendors in its cookie named axeptio_authorized_vendors with the following format: ,VENDOR_1,VENDOR_2,VENDOR_3,

Suppose you want JOIN Stories to detect consent when join_stories is present in the axeptio_authorized_vendors cookie. Here’s how you can configure it:

  • Cookie Name: axeptio_authorized_vendors

  • Condition: includes

  • Cookie Value: join_stories

This configuration means that JOIN Stories will check if the string join_stories is included in the value of the axeptio_authorized_vendors cookie. If it is, consent is considered given.

Useful documentations:

Did this answer your question?