Référence du connecteur Reddit Ads
Bêta
Cette fonctionnalité est en Bêta. Les administrateurs du Workspace peuvent contrôler l'accès à cette fonctionnalité à partir de la page Previews . Consultez Gérer les aperçus Databricks.
Cette page fournit des informations de référence pour le connecteur géré Reddit Ads dans Lakeflow Connect, y compris les tables prises en charge, les définitions de colonnes et les types de données.
Tables sources prises en charge
Le connecteur Reddit Ads prend en charge les types de tables suivants :
- Tables d'entités : Données de configuration concernant votre compte Reddit Ads, tels que les campagnes, les groupes d'annonces et les annonces. Ces tables sont entièrement actualisées à chaque exécution de pipeline.
- Tables de rapport : métriques de performance, telles que les impressions, les clics et les dépenses. Ces tables prennent en charge l'ingestion incrémentielle.
- Rapport personnalisé : Une table définie par l'utilisateur qui vous permet de choisir des dimensions de répartition et des champs de métriques. Voir les rapports personnalisés.
Tables d'entités
Nom de la table | Description |
|---|---|
| Comptes publicitaires accessibles à l'utilisateur authentifié. Réside dans le schéma source |
| Configuration et paramètres de la Campagne. |
| Configuration et paramètres du groupe d'annonces. |
| Détails et paramètres d'annonce individuels. Correspond à |
Tables de rapports
Nom de la table | Clé principale | Description |
|---|---|---|
|
| Indicateurs de performance au niveau de la campagne. |
|
| Métriques de performance au niveau du groupe d'annonces. |
|
| Indicateurs de performance au niveau des annonces. |
|
| Indicateurs de performance au niveau de la campagne, ventilés par pays. |
Conventions de type de données
Devise
Les colonnes monétaires — par exemple, spend, cpc, bid_value — sont stockées comme decimal(19,2) dans la devise du compte publicitaire. Les valeurs sont des montants décimaux (par exemple, 12.34), non des micros. Le code de devise du compte est disponible dans la colonne ad_account.currency et dans la colonne de rapport currency.
Colonnes JSON
Certaines colonnes de table d'entités contiennent des objets imbriqués complexes stockés sous forme de chaînes JSON : targeting, schedule, event_trackers. Analysez-les avec from_json() ou parse_json() en SQL ou PySpark.
Curseur incrémental
Les tables de rapports utilisent metrics_updated_at (timestamp) comme curseur incrémental.
Schémas de table d'entité
ad_account
Comptes publicitaires accessibles à l'utilisateur authentifié. Cette table se trouve dans le schéma source default.
Colonne | Type de données | Description |
|---|---|---|
|
| Clé primaire. ID de compte publicitaire. |
|
| Nom du compte publicitaire. |
|
| Type de compte. |
|
| Statut d'approbation de l'administrateur. |
|
| ID métier associé. |
|
| Quand le compte a été créé. |
|
| Date de dernière modification du compte. |
|
| Code de devise du compte, par exemple |
|
| Fuseau horaire du compte. |
|
| Paramètre de type d'attribution. |
|
| Paramètre de type d'attribution d'application. |
|
| Cliquez sur la fenêtre d'attribution. |
|
| Afficher la fenêtre d'attribution. |
|
| Fenêtre d'attribution des clics d'application. |
|
| Fenêtre d'attribution de la vue de l'application. |
|
| Type de plafond de dépenses. |
|
| Motif de la suspension du compte, le cas échéant. |
|
| Communautés exclues du ciblage. |
|
| Mots-clés exclus du ciblage. |
|
| Préférences des Partenaires Pixels. |
|
| ID de membre du contact principal. |
campaign
Configuration et paramètres de la Campagne.
Colonne | Type de données | Description |
|---|---|---|
|
| Clé primaire. ID de campagne. |
|
| ID de compte publicitaire associé. |
|
| Nom de la campagne. |
|
| Objectif de la campagne. |
|
| Statut défini par l'utilisateur (ACTIF ou EN PAUSE). |
|
| Statut de livraison effectif. |
|
| Raisons détaillées du statut de livraison. |
|
| Lorsque la campagne a été créée. |
|
| Date de la dernière modification de la campagne. |
|
| Heure de start de la campagne. |
|
| Heure de fin de la campagne. |
|
| Type d'enchère. |
|
| Stratégie d'enchères. |
|
| Valeur de l'enchère en devise du compte. |
|
| Type d'objectif. |
|
| Valeur de l'objectif dans la devise du compte. |
|
| Plafond de dépenses dans la devise du compte. |
|
| ID de pixel de conversion associé. |
|
| ID de l'instrument de financement associé. |
|
| Objectif d'optimisation. |
|
| Type de conversion post-affichage. |
|
| ID d'application associé. |
|
| Étiquette de facture. |
|
| Si l'optimisation du budget de la campagne est en mode MAX. |
|
| Indique si l'optimisation du budget de la campagne est activée. |
|
| Catégories d'annonces spéciales (par exemple, logement, crédit). |
|
| Métadonnées SKAdNetwork. |
|
| Paramètre de restriction d'âge. |
ad_group
Configuration et paramètres du groupe d'annonces.
Colonne | Type de données | Description |
|---|---|---|
|
| Clé primaire. ID de groupe d'annonces. |
|
| ID de compte publicitaire associé. |
|
| ID de campagne associé. |
|
| Nom du groupe Ad. |
|
| Statut défini par l'utilisateur. |
|
| Statut de livraison effectif. |
|
| Raisons détaillées du statut de livraison. |
|
| Lorsque le groupe d'annonces a été créé. |
|
| Date de dernière modification du groupe d'annonces. |
|
| Heure de start du groupe d'annonces. |
|
| Heure de fin du groupe d'annonces. |
|
| Type d'enchère. |
|
| Stratégie d'enchères. |
|
| Valeur de l'enchère en devise du compte. |
|
| Type d'objectif. |
|
| Valeur de l'objectif dans la devise du compte. |
|
| ID de pixel de conversion associé. |
|
| Objectif d'optimisation. |
|
| Type de conversion post-affichage. |
|
| Indique si l'optimisation du budget de la campagne est active pour ce groupe d'annonces. |
|
| Type d'objectif de la campagne. |
|
| ID d'application associé. |
|
| ID d'ensemble de produits associé. |
|
| Type de shopping. |
|
| ID de public enregistré. |
|
| Chaîne JSON contenant les paramètres de ciblage. |
|
| Paramètres de ciblage des achats. |
|
| Chaîne JSON contenant les paramètres de planification des annonces. |
|
| Métadonnées SKAdNetwork. |
ad
Détails et paramètres d'annonce individuels. Correspond à ads dans l'API Reddit Ads.
Colonne | Type de données | Description |
|---|---|---|
|
| Clé primaire. ID d'annonce. |
|
| ID de compte publicitaire associé. |
|
| ID de groupe d'annonces associé. |
|
| ID de campagne associé. |
|
| Nom de l'annonce. |
|
| Type d'annonce. |
|
| Statut défini par l'utilisateur. |
|
| Statut de livraison effectif. |
|
| Raisons détaillées du statut de livraison. |
|
| Lorsque l'annonce a été créée. |
|
| Date de la dernière modification de l'annonce. |
|
| URL de destination lorsque l'annonce est cliquée. |
|
| Paramètres de requête ajoutés à l'URL de clic. |
|
| Type d'objectif de la campagne. |
|
| ID de publication Reddit associé. |
|
| URL de la publication Reddit associée. |
|
| ID de profil associé. |
|
| URL de prévisualisation d'annonce. |
|
| Lorsque l'URL d'aperçu expire. |
|
| Chaîne JSON contenant les configurations de suivi des événements. |
|
| Produits associés. |
|
| Motif du rejet de l'annonce, le cas échéant. |
|
| Paramètres de création d'achats. |
|
| Métadonnées SKAdNetwork. |
Signaler les schémas de table
Toutes les tables de rapport partagent les mêmes colonnes de métriques. Elles ne diffèrent que par leurs colonnes de clé primaire.
Colonnes de métriques partagées
Chaque table de rapport comprend account_id (string) et les colonnes de métriques suivantes :
Livraison de base
Colonne | Type de données | Description |
|---|---|---|
|
| Nombre d'impressions. |
|
| Nombre de clics. |
|
| Dépenses totales dans la devise du compte. |
|
| Coût effectif pour mille impressions. |
|
| Coût par clic. |
|
| Coût par vue. |
|
| Taux de clics. |
|
| Nombre d'utilisateurs uniques atteints. |
|
| Nombre moyen de fois que chaque utilisateur a vu l'annonce. |
|
| Nombre d'impressions visibles. |
|
| Nombre de clics engagés. |
|
| Nombre de prospects Reddit. |
|
| Retour sur les dépenses publicitaires à partir des conversions. |
Engagement (renseigné pour les campagnes d’engagement ; null pour les autres types de campagnes)
Colonne | Type de données | Description |
|---|---|---|
|
| Nombre de votes positifs sur l'annonce. |
|
| Nombre de votes négatifs sur l'annonce. |
|
| Nombre de votes positifs sur les commentaires. |
|
| Nombre de votes négatifs sur les commentaires. |
|
| Nombre de commentaires soumis. |
|
| Nombre de vues de page de commentaires. |
Lectures vidéo et temps de visionnage
Colonne | Type de données | Description |
|---|---|---|
|
| Nombre de fois où la lecture vidéo a start. |
|
| Nombre de fois où la vidéo a été développée. |
|
| Nombre de lectures avec le son activé. |
|
| Nombre de vues atteignant 3 secondes. |
|
| Nombre de vues atteignant 5 secondes. |
|
| Nombre de vues atteignant 10 secondes. |
|
| Nombre de vues atteignant 25 % d'achèvement. |
|
| Nombre de vues atteignant 50 % d'achèvement. |
|
| Nombre de vues atteignant 75 % d'achèvement. |
|
| Nombre de vues atteignant 95 % de complétion. |
|
| Nombre de vues atteignant 100 % de complétion. |
Taux de vidéos et visibilité
Colonne | Type de données | Description |
|---|---|---|
|
| Taux de vues de vidéo. |
|
| Taux de visionnage de la vidéo à 6 secondes. |
|
| Taux de visionnage de la vidéo à 15 secondes. |
|
| Taux de complétion vidéo. |
|
| Nombre d'impressions entièrement visibles. |
|
| Nombre d'impressions visibles. |
|
| Nombre d'impressions visibles visionnées 6 secondes. |
|
| Nombre d'impressions visibles vues 15 secondes. |
Coût par vue
Colonne | Type de données | Description |
|---|---|---|
|
| Coût par vue de 3 secondes. |
|
| Coût par vue de 6 secondes. |
|
| Coût par vue de 15 secondes. |
|
| Coût par vue achevée. |
Autre
Colonne | Type de données | Description |
|---|---|---|
|
| Code de devise pour les colonnes monétaires. |
|
| Date de la dernière mise à jour des métriques. Utilisé comme curseur incrémental. |
campaign_report
Indicateurs de performance au niveau de la campagne.
Clé primaire : campaign_id (string), date (date, YYYY-MM-DD).
Inclut toutes les colonnes de métriques partagées plus account_id (string).
ad_group_report
Métriques de performance au niveau du groupe d'annonces.
Clé primaire : ad_group_id (string), date (date, YYYY-MM-DD).
Inclut toutes les colonnes de métriques partagées ainsi que account_id (string) et pacing (double), qui sont renvoyés automatiquement pour la répartition du groupe d'annonces.
ad_report
Indicateurs de performance au niveau des annonces.
Clé primaire : ad_id (string), date (date, YYYY-MM-DD).
Inclut toutes les colonnes de métriques partagées plus account_id (string).
campaign_country_report
Indicateurs de performance au niveau de la campagne, ventilés par pays.
Clé primaire : campaign_id (string), date (date, YYYY-MM-DD), country (string).
Inclut toutes les colonnes de métriques partagées plus account_id (string).
Rapports personnalisés
Un rapport personnalisé vous permet de choisir les dimensions de répartition exactes et les champs de métrique que vous souhaitez. Déclarez-le en définissant source_table: custom_report et en fournissant la définition du rapport sous connector_options.reddit_ads_options.custom_report_options.
Le nom destination_table est obligatoire pour les rapports personnalisés.
La clé primaire d'un rapport personnalisé est composée des colonnes de répartition choisies. Les champs de métriques sont stockés sous forme de valeurs de données.
Répartitions et champs de rapport personnalisé
Répartitions prises en charge — vous devez inclure au moins une dimension temporelle (DATE ou HOUR). Le nom de la colonne de destination est affiché entre parenthèses.
DATE (date), HOUR (heure), AD_ACCOUNT_ID (ID de compte), AD_GROUP_ID (ID de groupe d'annonces), AD_ID (ID d'annonce), CAMPAIGN_ID (ID de campagne), COMMUNITY (communauté), COUNTRY (pays), DMA (dma), GALLERY_ITEM_ID (ID de publication), GENDER (sexe), INTEREST (intérêt), KEYWORD (mot-clé), OS_TYPE (type de système d'exploitation), PLACEMENT (emplacement), REGION (région).
Champs pris en charge (le nom de la colonne de destination est le jeton en minuscules) :
Livraison des cœurs : IMPRESSIONS (long), CLICKS (long), SPEND (decimal(19,2)), CPC (decimal(19,2)), ECPM (decimal(19,2)), CTR (double), CONVERSION_ROAS (double).
Vidéo : VIDEO_STARTED, VIDEO_PLAYS_EXPANDED, VIDEO_PLAYS_WITH_SOUND, VIDEO_WATCHED_3_SECONDS, VIDEO_WATCHED_5_SECONDS, VIDEO_WATCHED_10_SECONDS, VIDEO_WATCHED_25_PERCENT, VIDEO_WATCHED_50_PERCENT, VIDEO_WATCHED_75_PERCENT, VIDEO_WATCHED_95_PERCENT, VIDEO_WATCHED_100_PERCENT, VIDEO_FULLY_VIEWABLE_IMPRESSIONS, VIDEO_VIEWABLE_IMPRESSIONS (tous long).
Conversions d'installation d'application : APP_INSTALL_ADD_PAYMENT_INFO_COUNT, APP_INSTALL_ADD_TO_CART_COUNT, APP_INSTALL_APP_LAUNCH_COUNT, APP_INSTALL_COMPLETED_TUTORIAL_COUNT, APP_INSTALL_INSTALL_COUNT, APP_INSTALL_MMP_INSTALL_COUNT, APP_INSTALL_MMP_TOTAL_INSTALL_COUNT, APP_INSTALL_SKAN_INSTALL_COUNT, APP_INSTALL_SKAN_TOTAL_INSTALL_COUNT, APP_INSTALL_LEVEL_ACHIEVED_COUNT, APP_INSTALL_PURCHASE_COUNT, APP_INSTALL_SEARCH_COUNT, APP_INSTALL_SIGN_UP_COUNT, APP_INSTALL_SPEND_CREDITS_COUNT, APP_INSTALL_VIEW_CONTENT_COUNT (tous long).
Autre : PRIORITY (string).