Aller au contenu principal

Gérer les sponsors et les publicités

De nombreux clubs sportifs comptent sur des commandites et des publicités pour couvrir les coûts et favoriser les partenariats. Avec COOLROOL, vous pouvez gérer les dossiers des sponsors, les lier aux clubs et afficher les publicités ou bannières ciblées dans l'application. Ce guide montre comment ajouter des sponsors, les joindre à des clubs et gérer des images ou des messages promotionnels uniques.

Flux de travail typique​

Manage Sponsors Flow

1. Créer un nouveau Sponsor​

Un sponsor peut être une marque de sport nationale, un restaurant local ou toute organisation qui soutient votre club. COOLROOL est le sponsor des magasins (nom, logo, coordonnées) afin que vous puissiez les joindre plus tard aux clubs ou événements. Utilisez le point de terminaison POST /sponsor pour créer un nouvel enregistrement parrain.

curl --request POST \
  --url https://api.coolrool. om/sponsor \
  --header 'Authorization: Bearer <ADMIN_TOKEN>' \
  --form 'name=SuperSports' \
  --form 'description=Leading sports equipment brand' \
  --form 'isGlobal=true' \
  --form 'contactPersonName=John' \
  --form 'contactPersonSurname=Doe' \
  --form 'contactPersonPhone=+330000000' \
  --form 'website=https://www. upersports.com' \
  --form 'img=@/path/to/sponsor-logo. ng'

Les sponsors marqués isGlobal peuvent apparaître dans n'importe quel club, tandis que les sponsors isLocal ne peuvent être pertinents que pour des régions spécifiques.

2. Ajouter des images ou des bannières uniques​

De nombreux sponsors veulent des bannières tournantes ou des annonces saisonnières. Vous pouvez stocker ces images et les planifier pour qu'elles soient affichées dans l'application à certaines dates en utilisant le point de terminaison PATCH /sponsor/unique-images/{id}.

curl --request PATCH \
  --url "https://api.coolrool. om/sponsor/unique-images/3001" \
  --header 'Authorization: Bearer <ADMIN_TOKEN>' \
  --form 'specialDate=2025-12-01T00:00:00Z' \
  --form 'endSpecialDate=2025-12-31T23:59:59Z' \
  --form 'url=https://cdn. oolrool.com/soldes/vacances. pg' \
  --form 'name=Bannière de vente de vacances' \
  --form 'description=20% de tout l'équipement'

3. Attacher un sponsor à un Club​

Si SuperSports sponsorise spécifiquement Thunder FC vous pouvez les lier pour que les membres du club voient les publicités pertinentes dans leur application en utilisant le point de terminaison POST /sponsor/club-sponsor.

curl --request POST \
  --url https://api.coolrool. om/sponsor/club-sponsor \
  --header 'Authorization: Bearer <ADMIN_TOKEN>' \
  --form 'clubId=1001' \
  --form 'sponsorId=3001'

À ce stade, les membres de Thunder FC peuvent voir des publicités ou des bannières SuperSports dans leur interface COOLROOL.

4. Affichage des publicités dans l'application​

Une fois que le sponsor est lié, COOLROOL affiche automatiquement le marquage des sponsors dans les sections pertinentes, comme le flux de réservation d’événements, le tableau de bord du club ou le fil d’actualité de l’utilisateur. Vous n’avez pas besoin de coder la logique d’affichage à moins que vous ne personnalisiez le front-end. Vous pouvez utiliser les points de terminaison suivants pour récupérer les données du sponsor :

L'exemple suivant montre comment récupérer tous les sponsors pour un club particulier :

curl --request GET \
  --url https://api.coolrool. om/sponsor/recommendation \
  --header 'Authorization: Bearer <USER_TOKEN>'

5. Gérer ou supprimer un Sponsor​

Si un contrat de sponsor expire ou ne souhaite plus apparaître, vous pouvez mettre à jour ou supprimer son enregistrement en utilisant les points de terminaison suivants :

L'exemple suivant montre comment supprimer un sponsor :

curl --request DELETE \
  --url "https://api.coolrool. om/sponsor/3001" \
  --header 'Authorization: Bearer <ADMIN_TOKEN>'

Les clubs précédemment liés à ce sponsor n'afficheront plus leurs annonces.