Référence du connecteur TikTok Ads
Bêta
Cette fonctionnalité est en version bêta.
Cet article fournit des informations de référence pour le connecteur TikTok Ads, y compris les tables, dimensions et métriques prises en charge.
Tables sources prises en charge
Le connecteur TikTok Ads prend en charge les tables sources suivantes :
Pour les tables à portée annonceur, définissez source_schema sur l'ID d'annonceur TikTok. Pour business_center, définissez source_schema sur default.
Tables prenant en charge les mises à jour incrémentielles
Les tables de rapport suivantes prennent en charge l’ingestion incrémentielle :
campaign_report_dailycampaign_report_hourlyadgroup_report_dailyadgroup_report_hourlyad_report_dailyad_report_hourlycampaign_age_gender_reportcampaign_country_reportcampaign_language_reportcampaign_platform_reportad_age_gender_reportad_country_reportad_language_reportad_platform_reportcustom_reportlorsquequery_lifetimeestfalse
Tables qui prennent en charge uniquement les mises à jour par batch (non incrémentielles)
Les tables suivantes sont actualisées à chaque mise à jour du pipeline :
campaignad_groupadbusiness_centercampaign_report_lifetimeadgroup_report_lifetimead_report_lifetimecustom_reportlorsquequery_lifetimeesttrue
Rapports prédéfinis
Les rapports prédéfinis sont des query de rapport préconfigurées avec des dimensions et des métriques fixes pour les besoins de reporting courants.
Rapport ( | Dimensions | Niveau de données | Type de rapport |
|---|---|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Groupes de métriques
Les métriques renvoyées pour chaque rapport prédéfini dépendent de son type de rapport.
Les rapports BASIC renvoient les métriques suivantes :
Groupe | Métriques |
|---|---|
Performances de base |
|
Lecture vidéo |
|
Engagement |
|
attribution |
|
Événements dans l'application |
|
Événements de page |
|
Événements TikTok Shop |
|
SKAdNetwork (SKAN) |
|
Les métriques SKAdNetwork (SKAN) sont renvoyées pour les rapports BASIC quotidiens et à vie, mais pas pour les rapports horaires.
Les rapports AUDIENCE renvoient les métriques suivantes :
Groupe | Métriques |
|---|---|
Performances de base |
|
Événements de page |
|
Rapports personnalisés
En plus des rapports prédéfinis, vous pouvez créer des rapports personnalisés en définissant source_table sur custom_report dans les spécifications de votre pipeline et en fournissant custom_report_options sous connector_options.tiktok_ads_options.
{
"table": {
"source_schema": "<your-ad-account-id>",
"source_table": "custom_report",
"destination_catalog": "<destination-catalog>",
"destination_schema": "<destination-schema>",
"destination_table": "<your-report-name>",
"connector_options": {
"tiktok_ads_options": {
"lookback_window_days": 7,
"sync_start_date": "<YYYY-MM-DD>",
"custom_report_options": {
"dimensions": ["stat_time_day", "ad_id"],
"metrics": ["spend", "impressions", "clicks"],
"report_type": "BASIC",
"data_level": "AUCTION_AD",
"query_lifetime": false
}
}
}
}
}
custom_report_options champs
Champ | Description |
|---|---|
| Liste des dimensions à inclure (par exemple, |
| Liste des champs de métrique à renvoyer. |
| Type de rapport : |
| Niveau d’agrégation : |
| Si |
Les rapports personnalisés ont les exigences suivantes :
- Définissez
destination_tablequandsource_tableestcustom_report. Les rapports personnalisés ne sont pas renvoyés par la découverte de tables et doivent être configurés explicitement. - Fournissez au moins une valeur pour
dimensionsetmetrics. - Pour un rapport qui n’est pas à vie, incluez
stat_time_dayoustat_time_hourdansdimensions. - Un rapport personnalisé sur la durée de vie est entièrement actualisé à chaque mise à jour du pipeline. Ne configurez pas
sync_start_dateoulookback_window_dayspour un rapport sur la durée de vie.
Options de date du rapport
Vous pouvez configurer les options suivantes sous connector_options.tiktok_ads_options pour les rapports sans durée de vie :
Champ | Description |
|---|---|
| La date initiale à ingérer, au format |
| Le nombre de jours récents à relire pendant les mises à jour incrémentielles, de |
Les dates des rapports utilisent le décalage GMT fixe du compte annonceur. Le décalage de l'annonceur TikTok ne change pas pour l'heure d'été, même lorsque le fuseau horaire du compte est représenté par un nom de région.