Sources publicitaires

À quoi ça sert

Une source publicitaire importe dans Deltia les résultats de vos campagnes — dépense, impressions, clics, conversions — depuis Google Ads, Meta Ads ou TikTok Ads. Les graphiques du module KPI et l'assistant IA lisent ensuite cette copie, à côté de vos données Deltia. Cette page complète Sources de données externes, qui décrit ce que toutes les sources ont en commun : test de connexion, statuts, rôles autorisés à lire, scope des données.

Google Ads et TikTok Ads passent par une connexion de l'organisation, créée une seule fois dans « Intégrations », « Approbation des connecteurs », onglet « Connexions ». Meta Ads utilise un jeton saisi dans la source elle-même.

Concepts clés

• Connexion Google — le compte Google Ads de l'organisation, relié à Deltia par OAuth. Une source Google Ads s'appuie sur elle.
• Connexion TikTok — le compte TikTok for Business de l'organisation, relié à Deltia par l'app que vous avez créée sur le portail TikTok API for Business.
• Rapport — un jeu de lignes importé jour par jour : un niveau (compte, campagne, publicité…), des métriques et, au choix, des ventilations.
• Ventilation — une dimension ajoutée au jour pour détailler un rapport, par exemple le pays. Un rapport en accepte 4 au plus pour Meta Ads, 3 pour TikTok Ads.
• Un compte ou tous les comptes — une source lit un seul compte, ou tous ceux que sa connexion ou son jeton atteint. Dans ce second mode, un compte ajouté ou retiré côté plateforme est pris en compte à la synchronisation suivante, sans toucher à la source.
• Comptes à ignorer — les comptes que la source ne synchronise pas, en mode « tous les comptes ».
• Lu en direct — une métrique (la couverture, par exemple) que le graphique demande directement à la plateforme sur sa période, au lieu de l'additionner jour par jour.

Comment faire

Connecter Google Ads

Une source « Google Ads » lit le compte de votre organisation à travers une connexion Google approuvée. Créez cette connexion une seule fois.

1. Dans « Intégrations », « Approbation des connecteurs », onglet « Connexions », cliquez sur « Connecter Google Ads ».
2. Suivez le guide « Préparer le projet Google Cloud » affiché dans le volet : activer l'API Google Ads, configurer l'écran de consentement, créer un client OAuth de type application Web, puis publier l'application si l'audience est « Externe ».
3. Renseignez « Nom », « ID client OAuth » et « Code secret du client ».
4. Collez l'« URI de redirection autorisée » affichée dans le volet sur le client OAuth, à l'étape correspondante du guide.
5. Cliquez sur « Connecter » : « Redirection vers Google… » s'affiche et Google vous demande votre accord.

À votre retour, « Compte relié et validé. Vous pouvez maintenant l'utiliser dans une source de données. » confirme la connexion. Elle est validée d'emblée et proposée au choix dans le formulaire d'une source Google Ads.

Si Google ne renvoie pas l'accord attendu, un message l'explique : « Vous avez refusé l'autorisation. Rien n'a été relié. », « Un accès demandé n'a pas été accordé. Relancez la connexion en cochant toutes les autorisations proposées. », « La demande a expiré. Relancez la connexion. » ou « La connexion a échoué. Réessayez, puis contactez un administrateur si cela persiste. »

Tant que l'application Google reste en état « Test », Google retire l'autorisation au bout de sept jours : la connexion est alors à réautoriser. Ouvrez la ligne de la connexion dans la file de validation, puis cliquez sur « Reconnecter ».

Connecter TikTok Ads

1. Dans l'onglet « Connexions », cliquez sur « Connecter TikTok Ads ».
2. Suivez le guide « Préparer l'app TikTok for Business » : devenir développeur sur le portail TikTok API for Business, créer l'app, cocher les permissions « Ad Account Management » et « Reporting », puis attendre la validation de l'app par TikTok (jusqu'à sept jours ouvrés, avec un e-mail à la clé).
3. Collez l'« Advertiser redirect URL » affichée dans le volet sur l'app, à l'étape correspondante du guide.
4. Renseignez « Nom », « App ID » et « Secret », tels qu'ils figurent dans « My Apps », « Basic Information ».
5. Cliquez sur « Connecter » : « Redirection vers TikTok… » s'affiche et TikTok vous demande votre accord.

Le même message « Compte relié et validé… » confirme la connexion. Pour une connexion dont l'accord est perdu, ouvrez sa ligne et cliquez sur « Reconnecter ».

Déclarer une source Google Ads

1. Dans l'onglet « Sources de données », cliquez sur « Ajouter une source ».
2. Choisissez « Google Ads » comme « Type de source ».
3. Renseignez « Nom », puis choisissez la « Connexion Google ». Sans connexion utilisable, la liste affiche « Aucune connexion Google utilisable ».
4. Lisez un seul compte : renseignez l'« ID client Google Ads », tel qu'affiché dans Google Ads (par exemple 123-456-7890), et l'« ID du compte administrateur (MCC) » seulement si l'accès passe par un compte administrateur.
5. Ou lisez tous les comptes : activez « Lire tous les comptes du compte administrateur » et renseignez l'« ID du compte administrateur (MCC) ». Le compte Google qui a autorisé la connexion doit être utilisateur de ce compte administrateur, sinon la liste reste vide.
6. Choisissez le « Début de l'import », puis réglez « Jours relus » et « Jours par passage ».
7. Réglez « Synchroniser toutes les (heures) » et le « Scope des données » (voir Ranger les lignes dans un scope).
8. Composez les rapports (voir « Composer les rapports »).
9. Choisissez les « Rôles autorisés à lire la source », puis cliquez sur « Ajouter ».

En mode « tous les comptes », la source lit les comptes clients actifs sous le compte administrateur, à tous les niveaux. Chaque ligne importée porte l'ID et le nom de son compte client.

Déclarer une source Meta Ads

1. Dans l'onglet « Sources de données », cliquez sur « Ajouter une source ».
2. Choisissez « Meta Ads » comme « Type de source ».
3. Renseignez « Nom », puis le « Jeton d'utilisateur système » généré dans Business Manager pour un utilisateur système ayant accès aux comptes publicitaires. Il est stocké chiffré.
4. Lisez un seul compte : renseignez l'« ID du compte publicitaire », avec ou sans act_.
5. Ou lisez tous les comptes : activez « Lire tous les comptes publicitaires du jeton ».
6. Renseignez le « Début de l'import », les « Jours relus », les « Jours par passage » (90 au plus pour Meta : « La fenêtre Meta ne dépasse pas 90 jours ») et « Synchroniser toutes les (heures) ».
7. Réglez le « Scope des données » et composez les rapports.
8. Choisissez les « Rôles autorisés à lire la source », puis cliquez sur « Ajouter ».

Un compte n'est lu que si l'utilisateur système du jeton y a accès. L'aide « Que faire dans Business Manager pour qu'un compte soit lu » indique le chemin : « Paramètres de l'entreprise », « Utilisateurs système », l'utilisateur système, puis « Ajouter des actifs ». Retirer le compte de l'utilisateur système le fait sortir de la synchronisation, sans rien changer dans Deltia.

Déclarer une source TikTok Ads

1. Dans l'onglet « Sources de données », cliquez sur « Ajouter une source ».
2. Choisissez « TikTok Ads » comme « Type de source ».
3. Renseignez « Nom », puis choisissez la « Connexion TikTok ». Sans connexion utilisable, la liste affiche « Aucune connexion TikTok utilisable ».
4. Lisez un seul annonceur : renseignez l'« ID de l'annonceur », tel qu'affiché dans TikTok Ads Manager sous le nom du compte (20 chiffres au plus).
5. Ou lisez tous les annonceurs : activez « Lire tous les annonceurs de la connexion ».
6. Renseignez le « Début de l'import », les « Jours relus », les « Jours par passage » (30 au plus pour TikTok : « La fenêtre TikTok ne dépasse pas 30 jours ») et « Synchroniser toutes les (heures) ».
7. Réglez le « Scope des données » et composez les rapports.
8. Choisissez les « Rôles autorisés à lire la source », puis cliquez sur « Ajouter ».

Choisir les comptes à ignorer

1. Dans le formulaire d'une source en mode « tous les comptes », repérez le champ « Comptes à ignorer » et cliquez sur « Charger les comptes » : la liste des comptes s'affiche. Tant qu'elle n'est pas chargée : « Aucun compte ignoré. Chargez les comptes pour les voir. »
2. Cochez les comptes que la source ne doit pas synchroniser.
3. Cliquez sur « Ajouter » (nouvelle source) ou « Modifier » (source existante).

Un compte qui n'est plus rattaché porte la mention « Plus listé sous le compte administrateur » pour Google Ads, « Plus listé par Meta » pour Meta Ads et « Plus listé par TikTok » pour TikTok Ads. Meta Ads affiche aussi le statut de chaque compte : « Actif », « Désactivé », « Paiement en attente », « Fermé », « Autre statut » ou « Statut inconnu ».

Modifier la liste des comptes ignorés relance l'import des flux de la source depuis la date de départ.

Composer les rapports

1. Dans le formulaire de la source, repérez le champ « Rapports ».
2. Cliquez sur « Ajouter un rapport », puis donnez-lui un « Nom du rapport ».
3. Choisissez le « Niveau » (Google Ads : la « Ressource »).
4. Cochez les « Métriques » voulues. Une indication précise parfois où la métrique s'applique, par exemple « Campagnes Search uniquement ».
5. Cochez, si besoin, des « Ventilations ».
6. Pour retirer un rapport, cliquez sur « Supprimer le rapport {numéro} ».

Le « Mode expert (JSON) » donne accès à la définition brute. Un rapport que l'éditeur ne sait pas afficher (champ, ventilation ou requête hors catalogue) ouvre le champ directement en JSON : il reste modifiable.

Modifier les réglages d'une source déjà synchronisée

1. Ouvrez la source depuis l'onglet « Sources de données ».
2. Modifiez le réglage voulu, puis cliquez sur « Modifier ».

Les données déjà importées sont conservées dans ces cas : changer « Jours par passage » ou « Jours relus », et avancer le « Début de l'import » (les lignes antérieures à la nouvelle date sont supprimées, le flux est recompté sans être réimporté). Reculer ou retirer le « Début de l'import » réinitialise les flux concernés : l'historique est réimporté.

Référence

Réglages des sources publicitaires

Les « Jours relus » sont relus à chaque synchronisation, car les plateformes corrigent leurs derniers jours ; l'import initial avance de « Jours par passage » à chaque synchronisation. L'ID client Google Ads compte 10 chiffres ; l'ID du compte publicitaire Meta en compte jusqu'à 20.

Niveaux de rapport

Métriques particulières de Google Ads

Les parts d'impression et le quality score sont recalculés sur la période d'un graphique en pondérant chaque jour par ses impressions. Le niveau « Mot-clé » produit une ligne par mot-clé actif et par jour : sur un grand compte, la limite de 2 000 000 lignes par flux peut être atteinte. Rapprochez alors la date de départ.

Messages d'erreur du formulaire

Les causes d'échec d'une synchronisation (« aucun compte à synchroniser », « limite de lignes atteinte », « le rapport asynchrone de l'API a échoué », connexion à réautoriser) sont listées dans Sources de données externes.

Qui peut quoi

Questions fréquentes

Quand une source atteint 2 000 000 lignes pour un flux, que se passe-t-il ? La synchronisation s'arrête avec « limite de lignes atteinte : avancez la date de début ou retirez le rapport ». Avancer le « Début de l'import » supprime les anciennes lignes et libère de la place sans réimporter.

Un compte ajouté dans Business Manager ou dans Google Ads apparaît-il tout seul ? Oui, si la source est en mode « tous les comptes » : il est pris en compte à la synchronisation suivante.

Puis-je ajouter une plateforme publicitaire qui n'est pas listée ? Pas comme source dédiée. Une « API REST (JSON) » peut lire une autre API : voir Sources de données externes.