Importation en masse des éléments

Utilisez l’outil de téléversement en masse pour téléverser plusieurs éléments à la fois à l’aide d’un fichier CSV, plutôt que de téléverser les éléments individuellement. Les champs d’information sont similaires à ceux de l’ objet Ads pour vous aider à coordonner quelles informations vont où.

Vous aurez besoin de deux fichiers pour effectuer un téléversement en masse d’annonces :

• Un fichier de métadonnées d’élément (CSV)

• Fichiers créatifs (par ex., images ou vidéos)

1

Étape 1 : Préparez le fichier de métadonnées de l’élément

Il existe des champs obligatoires et des valeurs acceptées pour le fichier CSV que vous téléversez. Vos éléments apparaîtront exactement comme dans votre fichier ; ainsi, tout espace, signe de ponctuation ou caractère spécial sera conservé s’il est utilisé. Pour commencer, copiez le modèle CSV affiché ci-dessous et collez-le dans une application de tableur outéléchargez-le ici et importez-le directement.

Operation,AdID,State,Name,Description,ProgramId,AdType,HostedBy,Creative,IabAdUnit,ThirdPartyServableAdCreativeHeight,ThirdPartyServableAdCreativeWidth,Labels,AllowDeepLinking,AllowCustomPromoCode,CustomisationCharge,ImageAlternativeTag,LandingPage,iOSMobileFallbackAppId,AndroidMobileFallbackAppId,Language,LimitedTimeStartDate,LimitedTimeEndDate,FallbackAd,GetHtmlCodeType,Season,TopSeller,LinkText,ThirdPartyImpressionPixel,RestrictedToPartners,RestrictedToGroups,Metadata,DealId,DealName,DealType,DealScope,DealDescription,DealProducts,DealCategories,DealDefaultDiscountCode,DealLandingPage,DealMetadata,DealAllowDeepLinking,DealDiscountType,DealDiscountAmount,DealDiscountPercent,DealDiscountStartPercent,DealDiscountEndPercent,DealDiscountMaximumPercent,DealGift,DealRebate,DealMinimumPurchaseAmount,DealMaximumPurchaseAmount,DealBogoPurchaseLimit,DealBogoBuyQty,DealBogoBuyType,DealBogoBuyName,DealBogoGetQty,DealBogoGetType,DealBogoGetName,DealBogoGetDiscountType,DealBogoGetDiscountAmount,DealBogoGetDiscountPercent,DealSyncAdsPromoCodes

Astuce : Nous vous recommandons d’utiliser les détails du format de fichier disponibles sur l’écran Téléversement groupé pour vérifier vos saisies avant de téléverser !

Avant de créer ou de mettre à jour des éléments à l’aide d’un fichier de métadonnées, notez les points importants suivants concernant les mises à jour partielles :

• Les mises à jour partielles sont prises en charge. Si vous laissez une cellule vide, ce champ sera ignoré et sa valeur existante restera inchangée.

• Pour effacer ou supprimer une valeur, saisissez explicitement $CLEAR$ dans cette cellule. Cela supprime toute valeur précédemment enregistrée pour ce champ.

Operation,AdID,Name,Description,ProgramId,AdType,HostedBy,Creative,IabAdUnit,ThirdPartyServableAdCreativeHeight,ThirdPartyServableAdCreativeWidth,Labels,AllowDeepLinking,AllowCustomPromoCode,CustomisationCharge,ImageAlternativeTag,LandingPage,iOSMobileFallbackAppId,AndroidMobileFallbackAppId,Language,LimitedTimeStartDate,LimitedTimeEndDate,LimitedTimeZone,FallbackAd,GetHtmlCodeType,Season,TopSeller,LinkText,ThirdPartyImpressionPixel,RestrictedToPartners,RestrictedToGroups,Metadata,DealId,DealName,DealType,DealScope,DealDescription,DealProducts,DealCategories,DealDefaultDiscountCode,DealLandingPage,DealMetadata,DealAllowDeepLinking,DealDiscountType,DealDiscountAmount,DealDiscountPercent,DealDiscountStartPercent,DealDiscountEndPercent,DealDiscountMaximumPercent,DealGift,DealRebate,DealMinimumPurchaseAmount,DealMaximumPurchaseAmount,DealBogoPurchaseLimit,DealBogoBuyQty,DealBogoBuyType,DealBogoBuyName,DealBogoGetQty,DealBogoGetType,DealBogoGetName,DealBogoGetDiscountType,DealBogoGetDiscountAmount,DealBogoGetDiscountPercent,DealSyncAdsPromoCodes
CREATE,,Exemple de bannière,Ceci est un exemple de nouvelle annonce bannière que vous téléverseriez.,12345,BANNER,IR,Banner_Creative1,,,,"Banner, NewBanner",TRUE,,,,,,,ENGLISH,2020-07-01T00:00:00-08:00,2038-09-19T03:14:00-08:00,FRAME_ONLY,,,,,"1234567, 8901234",,,,,,,,"https://example.com/deal-landing-page","utm_source=impact",TRUE,,,,,,,,,,,,,,,,,,,,,,,
UPDATE,123456,Exemple de lien texte,Ceci est un exemple de mise à jour d’une annonce de lien texte.,34567,TEXT_LINK,,,,,,"Funtext, GoodDay",FALSE,,,,,https://alwayslovewhatyoudo.com,,,ENGLISH_GB,,,,,,,,Cliquez ici pour en savoir plus !,,,,,,,,,,,,,,"https://example.com/deal-landing-page","utm_source=impact",TRUE,,,,,,,,,,,,,,,,,,,

• Le CREATE la ligne indique un nouvel élément bannière.

• Le UPDATE la ligne montre une mise à jour partielle — seuls les champs renseignés seront mis à jour.

• Si vous vouliez effacer une valeur (par ex. supprimer Étiquettes), vous utiliseriez $CLEAR$ dans cette colonne.

Exemple d’effacement de champs (CSV) :

UPDATE,123456,Exemple de lien texte,$CLEAR$,$CLEAR$,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,

2

Étape 2 : Téléversez le fichier de métadonnées de l’élément

1. Dans la barre de navigation de gauche, sélectionnez [Engage] → Contenu → Annonces.

2. Dans le coin supérieur droit, sélectionnez Téléversement groupé.

3. Sélectionnez  Choisir un fichier, téléversez votre fichier en masse et sélectionnez Ouvert.

   • Sélectionnez  Afficher/masquer les détails du format de fichier pour afficher des informations sur les colonnes obligatoires, leurs descriptions, les valeurs acceptées et savoir si elles sont obligatoires dans les colonnes d’en-tête des annonces et colonnes d’en-tête des offres références ci-dessous.

Remarque : impact.com vous avertira s’il y a des erreurs dans le fichier.

1. Sélectionnez Suivant.

colonnes d’en-tête des annonces

Nom de colonne	Description
Operation (Chaîne) Obligatoire - Toujours.	Opération à exécuter sur les détails de l’élément fournis. Valeurs autorisées : CREATE, UPDATE, DELETE.
ProgramId (Entier) Obligatoire - Toujours.	L’ID programme unique impact.com auquel l’élément appartient. Cette valeur ne peut pas être mise à jour et doit correspondre au programme dans lequel le téléversement en masse est exécuté.
AdID (Chaîne) Obligatoire - Lors de l’exécution d’une opération sur un élément existant.	Identifiant unique impact.com de l’élément. Laisser vide lors de la création d’un nouvel élément. Obligatoire si Operation = UPDATE, DELETE.
État (Chaîne) Obligatoire - Non.	L’état de l’élément. Valeurs autorisées : ACTIVE, EN ATTENTE, EXPIRED.
Nom (Chaîne) Obligatoire - Lors de la création d’un élément.	Nom de l’élément. Obligatoire si Operation = CREATE.
AdType (Chaîne) Obligatoire - Lors de la création d’un élément.	Lors de la mise à jour d’une annonce existante, le type d’annonce ne peut pas être modifié. Obligatoire si Operation = CREATE. Valeurs autorisées : IMAGE, TEXT_LINK, COUPON.
HostedBy (Chaîne) Obligatoire - Lors de la création d’un élément.	Où la création de l’élément est hébergée. Obligatoire si Operation = CREATE et AdType = IMAGE. Valeurs autorisées : IR, URL, HTML.
Creative (Chaîne) Obligatoire - Lors de la création d’un élément image.	Nom du fichier créatif à téléverser. Obligatoire si Operation = CREATE et AdType = IMAGE.
IabAdUnit (Chaîne) Obligatoire - Lors de la création d’un élément image.	Taille standard IAB de l’élément. Obligatoire si Operation = CREATE et AdType = IMAGE et HostedBy != IR. Valeurs autorisées : UNKNOWN, MEDIUM_RECTANGLE, SQUARE_POP_UP, VERTICAL_RECTANGLE, LARGE_RECTANGLE, RECTANGLE, RECTANGLE_3_1_, POP_UNDER, FULL_BANNER, HALF_BANNER, MICRO_BANNER, BUTTON_1, BUTTON_2, VERTICAL_BANNER, SQUARE_BUTTON, LEADERBOARD, WIDE_SKYSCRAPER, SKYSCRAPER, HALF_PAGE_AD, CUSTOM.
ThirdPartyServableAdCreativeHeight (Entier) Obligatoire - Lors de la création d’un élément image.	Hauteur de l’image diffusible par un tiers, en pixels. Obligatoire si Operation = CREATE et IabAdUnit = CUSTOM.
ThirdPartyServableAdCreativeWidth (Entier) Obligatoire - Lors de la création d’un élément image.	Largeur de l’image diffusible par un tiers, en pixels. Obligatoire si Operation = CREATE et IabAdUnit = CUSTOM.
Langue (Chaîne) Obligatoire - Lors de la création d’un élément.	Valeurs autorisées : AFRIKAANS, ARABE, BULGARE, CHINOIS, CHINOIS_TRADITIONNEL, TCHÈQUE, DANOIS, NÉERLANDAIS, ANGLAIS, ANGLAIS_GB, ANGLAIS_AU, ANGLAIS_CA, ANGLAIS_NZ, ANGLAIS_ZA, ESTONIEN, FILIPINO, FINNOIS, FRANÇAIS, FRANÇAIS_CA, ALLEMAND, HÉBREU, HINDI, INDONÉSIEN, ITALIEN, JAPONAIS, CORÉEN, LETTON, LITUANIEN, MALAIS, MALTAIS, NORVÉGIEN, PORTUGAIS, PORTUGAIS_BR, POLONAIS, RUSSE, SLOVÈNE, ESPAGNOL, ESPAGNOL_MX, SUÉDOIS, THAÏ, TURC, VIETNAMIEN.
LimitedTimeEndDate (Date) Obligatoire - Si LimitedTimeStartDate est fourni	Il s’agit d’une date ISO8601. Exemple de format : 2013-06-30T00:00:00-07:00.
LinkText (Chaîne) Obligatoire - Lors de la création d’un élément de lien texte ou de coupon.	Texte réel affiché pour le lien. Obligatoire si Operation = CREATE et AdType = TEXT_LINK ou COUPON.
Description Obligatoire - Non.	Description de l’élément.
Étiquettes (Chaîne CSV) Obligatoire - Non.	Étiquettes de l’élément.
AllowDeepLinking (Booléen) Obligatoire - Non.	Détermine si l’accès à une page plus profonde au sein du site de l’annonceur sera autorisé. Par défaut true.
AllowCustomPromoCode (Booléen) Obligatoire - Non.	Autoriser le partenaire à demander son propre code promo unique pour cette promotion. Par défaut false.
CustomisationCharge (Décimal 10.2) Obligatoire - Non.	Montant des frais de personnalisation de l’élément.
ImageAlternativeTag (Chaîne) Obligatoire - Non.	Balise alternative à utiliser dans le code de l’élément image.
LandingPage (Chaîne) Obligatoire - Non.	L’URL de la page d’atterrissage. Elle doit contenir le protocole URL. Par défaut, la page d’atterrissage par défaut du programme est utilisée lors de la création d’un élément si aucune n’est fournie.
iOSMobileFallbackAppId (Chaîne) Obligatoire - Non.	À spécifier si le trafic mobile doit rediriger vers la page d’atterrissage de votre application iOS si aucune application n’est détectée. L’ID de l’application doit correspondre à l’ID système de l’application.
AndroidMobileFallbackAppId (Chaîne) Obligatoire - Non.	À spécifier si le trafic mobile doit rediriger vers la page d’atterrissage de votre application Android si aucune application n’est détectée. L’ID de l’application doit correspondre à l’ID système de l’application.
LimitedTimeStartDate (Chaîne) Obligatoire - Non.	Il s’agit d’une date ISO8601. Exemple de format : 2013-06-30T00:00:00-07:00.
FallbackAd (Chaîne) Obligatoire - Non.	Spécifiez un ID d’élément de secours, applicable uniquement aux IMAGE éléments.
GetHtmlCodeType (Chaîne) Obligatoire - Non.	Valeurs autorisées : IFRAME_ONLY, HTML_AND_IFRAME.
Season (Chaîne) Obligatoire - Non.	Valeurs autorisées : WINTER, SPRING, SUMMER, FALL, NEW_YEAR, PRESIDENTS_DAY, VALENTINES_DAY, ST_PATRICKS_DAY, EASTER, MOTHERS_DAY, MEMORIAL_DAY, FATHERS_DAY, INDEPENDANCE_DAY, BACK_TO_SCHOOL, LABOR_DAY, HALLOWEEN, THANKSGIVING, BLACK_FRIDAY, CYBER_MONDAY, HANUKKAH, CHRISTMAS, FAMILY_DAY, GOOD_FRIDAY, VICTORIA_DAY, CANADA_DAY, AUGUST_CIVIC_HOLIDAY, REMEMBRANCE_DAY, BOXING_DAY, AUSTRALIA_DAY, ANZAC_DAY, QUEENS_BIRTHDAY, END_OF_FINANCIAL_YEAR, WAITANGI_DAY, AUTRE.
TopSeller (Booléen) Obligatoire - Non.	Meilleure vente. Par défaut false.
ThirdPartyImpressionPixel (Chaîne) Obligatoire - Non.	HTML du pixel d’impression tiers à utiliser avec cet élément.
RestrictedToPartners (Chaîne CSV) Obligatoire - Non.	IDs des partenaires séparés par des virgules qui doivent avoir accès à cet élément.
RestrictedToGroups (Chaîne CSV) Obligatoire - Non.	IDs des groupes de partenaires séparés par des virgules qui doivent avoir accès à cet élément.
Métadonnées (Chaîne CSV) Obligatoire - Non.	Paramètres de chaîne de requête séparés par des virgules qui seront ajoutés à l’URL de suivi.

colonnes d’en-tête des offres

Nom de colonne	Description
DealName (Chaîne) Obligatoire - Lors de la création d’une nouvelle offre.	Nom de l’offre à créer et à lier à l’élément. Obligatoire si DealId n’est pas fourni.
DealType (Chaîne) Obligatoire - Lors de la création d’une nouvelle offre.	Type d’offre à créer. Obligatoire si DealId n’est pas fourni et DealName est. Valeurs autorisées : GENERAL_SALE,FREE_SHIPPING, GIFT_WITH_PURCHASE, REBATE, BOGO, PRODUCT_LAUNCH.
DealScope (Chaîne) Obligatoire - Lors de la création d’une nouvelle offre.	Obligatoire si DealId n’est pas fourni, DealName est, et DealType != BOGO. Valeurs autorisées : ENTIRE_STORE, CATEGORY, PRODUCT, PRODUCTS.
DealProducts (Chaîne CSV) Obligatoire - Lors de la création d’une nouvelle offre.	Produits de l’offre. Obligatoire si DealId n’est pas fourni, DealName est, et DealScope = PRODUCT. Valeurs autorisées : Option 1 : liste des noms de produits, par ex. "Product1, Product2". Option 2 : liste de paires valeur-produit, par ex. "name=Product1;regularPrice=10;dealPrice=9.50; image=prodimg1.jpg, name=Product2;" où plusieurs produits sont séparés par des virgules et les différents champs du produit sont séparés par des points-virgules. Champs valides : nom - nom du produit, image - nom de fichier de l’image du produit correspondant au fichier que vous prévoyez de téléverser à l’étape deux du téléversement en masse, limit - quantité autorisée, regularPrice - prix avant remise, dealPrice - prix après remise.
DealCategories (Chaîne CSV) Obligatoire - Lors de la création d’une nouvelle offre.	Catégories de l’offre. Obligatoire si DealId n’est pas fourni, DealName est, et DealScope = CATEGORY.
DealLandingPage (Chaîne) Obligatoire - Non	L’URL de la page d’atterrissage de cette offre. Si elle est laissée vide lors de la création d’une nouvelle offre, la page d’atterrissage par défaut du programme sera utilisée.
DealMetadata (Chaîne CSV) Obligatoire - Non	Paramètres de chaîne de requête séparés par des virgules pour le lien de suivi de l’offre. Si ce champ est laissé vide, aucun paramètre supplémentaire ne sera ajouté.
DealAllowDeepLinking (Booléen) Obligatoire - Non	Détermine si le deeplinking est autorisé pour la page d’atterrissage de l’offre. Si ce champ est laissé vide, la valeur par défaut sera FALSE.
DealDiscountType (Chaîne CSV) Obligatoire - Lors de la création d’une nouvelle offre.	Obligatoire si DealId n’est pas fourni, DealName est, et DealType = GENERAL_SALE. Valeurs autorisées : FIXED, PERCENT, PERCENT_RANGE, PERCENT_MAXIMUM.
DealDiscountAmount (Décimal 10.2) Obligatoire - Lors de la création d’une nouvelle offre.	Montant de la remise de vente. Obligatoire si DealId n’est pas fourni, DealName est, DealType = GENERAL_SALE, et DealDiscountType = FIXED.
DealDiscountPercent (Décimal 10.2) Obligatoire - Lors de la création d’une nouvelle offre.	Pourcentage de remise de vente. Obligatoire si DealId n’est pas fourni, DealName est, DealType = GENERAL_SALE, et DealDiscountType = PERCENT.
DealDiscountStartPercent (Décimal 10.2) Obligatoire - Lors de la création d’une nouvelle offre.	Pourcentage de début de la plage de remise de l’offre. Obligatoire si DealId n’est pas fourni, DealName est, DealType = GENERAL_SALE, et DealDiscountType = PERCENT_RANGE.
DealDiscountEndPercent (Décimal 10.2) Obligatoire - Lors de la création d’une nouvelle offre.	Pourcentage de début de la plage de remise de l’offre. Obligatoire si DealId n’est pas fourni, DealName est, DealType = GENERAL_SALE, et DealDiscountType = PERCENT_RANGE.
DealDiscountMaximumPercent (Décimal 10.2) Obligatoire - Lors de la création d’une nouvelle offre.	Remise maximale en pourcentage de l’offre. Obligatoire si DealId n’est pas fourni, DealName est, DealType = GENERAL_SALE, et DealDiscountType = PERCENT_MAXIMUM.
DealGift (Décimal 10.2) Obligatoire - Lors de la création d’une nouvelle offre.	Détails du cadeau. Obligatoire si DealId n’est pas fourni, DealName est, et DealType = GIFT_WITH_PURCHASE.
DealRebate (Décimal 10.2) Obligatoire - Lors de la création d’une nouvelle offre.	Montant du remboursement. Obligatoire si DealId n’est pas fourni, DealName est, et DealType = REBATE.
DealMinimumPurchaseAmount (Décimal 10.2) Obligatoire - Lors de la création d’une nouvelle offre.	Montant minimum d’achat pour l’offre. Obligatoire si DealId n’est pas fourni, DealName est, et DealType = BOGO.
DealMaximumSavingsAmount (Décimal 10.2) Obligatoire - Lors de la création d’une nouvelle offre.	Montant maximal d’économies de l’offre. Obligatoire si DealId n’est pas fourni, DealName est, et DealType = BOGO.
DealBogoPurchaseLimit (Entier) Obligatoire - Lors de la création d’une nouvelle offre.	Quantité maximale d’articles autorisés à ce prix. Obligatoire si DealId n’est pas fourni, DealName est, et DealType = BOGO.
DealBogoBuyQty (Entier) Obligatoire - Lors de la création d’une nouvelle offre.	Quantité d’achat BOGO. Obligatoire si DealId n’est pas fourni, DealName est, et DealType = BOGO.
DealBogoBuyType (Chaîne) Obligatoire - Lors de la création d’une nouvelle offre.	Type d’article à acheter pour BOGO. Obligatoire si DealId n’est pas fourni, DealName est, et DealType = BOGO. Valeurs autorisées : PRODUCT, CATEGORY.
DealBogoBuyName (Chaîne) Obligatoire - Lors de la création d’une nouvelle offre.	Nom du produit ou de la catégorie à acheter. Obligatoire si DealId n’est pas fourni, DealName est, et DealType = BOGO.
DealBogoGetQty (Entier) Obligatoire - Lors de la création d’une nouvelle offre.	Quantité obtenue BOGO. Obligatoire si DealId n’est pas fourni, DealName est, et DealType = BOGO.
DealBogoGetType (Chaîne) Obligatoire - Lors de la création d’une nouvelle offre.	Type d’article obtenu BOGO. Obligatoire si DealId n’est pas fourni, DealName est, et DealType = BOGO. Valeurs autorisées : PRODUCT, CATEGORY.
DealBogoGetName (Chaîne) Obligatoire - Lors de la création d’une nouvelle offre.	Nom du produit ou de la catégorie obtenue. Obligatoire si DealId n’est pas fourni, DealName est, et DealType = BOGO.
DealBogoGetDiscountType (Chaîne) Obligatoire - Lors de la création d’une nouvelle offre.	Type de remise de l’offre BOGO. Obligatoire si DealId n’est pas fourni, DealName est, et DealType = BOGO. Valeurs autorisées : FREE, AMOUNT, PERCENT.
DealBogoGetDiscountAmount (Décimal 10.2) Obligatoire - Lors de la création d’une nouvelle offre.	Montant de la remise de l’offre BOGO. Obligatoire si DealId n’est pas fourni, DealName est, DealType = BOGO, et DealBogoGetDiscountType = AMOUNT.
DealBogoGetDiscountPercent (Décimal 10.2) Obligatoire - Lors de la création d’une nouvelle offre.	Pourcentage de remise de l’offre BOGO. Obligatoire si DealId n’est pas fourni, DealName est, DealType = BOGO, et DealBogoGetDiscountType = PERCENT.
DealId (Chaîne) Obligatoire - Non.	Identifiant unique impact.com de l’offre à laquelle l’élément sera lié.
DealDefaultDiscountCode (Chaîne) Obligatoire - Non.	Code de remise par défaut de l’offre.
DealSyncAdsPromoCodes (Booléen) Obligatoire - Non.	Conservez les annonces et les codes promo associés synchronisés avec cette offre. La synchronisation s’applique aux dates à durée limitée, aux accès partenaires restreints et à l’état.

3

Étape 3 : Téléversez les fichiers créatifs de l’élément

Ensuite, vous devrez préparer les fichiers créatifs de votre élément afin qu’ils puissent être téléversés.

1. Dans la Spécifiez des images page, sélectionnez Choisir des fichiers pour téléverser en masse les fichiers créatifs de l’élément. Les noms de fichiers téléversés doivent correspondre exactement aux noms figurant dans le champ creative de votre fichier de métadonnées (par ex., si le champ creative contient Exemple.jpg, le fichier créatif de l’élément que vous téléversez doit également être nommé Exemple.jpg).

   • Maintenez Command ⌘ sur macOS ou CTRL sur PC pour sélectionner plusieurs fichiers créatifs d’élément à téléverser en même temps.

2. Sélectionnez Accepter et créer les annonces. Une fois que tous les éléments ont été téléversés, ils apparaîtront dans le Annonces .