Importation en masse de ressources

Utilisez l’outil de téléversement en masse pour téléverser plusieurs assets à la fois à l’aide d’un fichier CSV, plutôt que de téléverser les assets 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 groupé d’annonces :

• Un fichier de métadonnées d’asset (CSV)
• Fichiers créatifs (p. ex., images ou vidéos)

1

Étape 1 : Préparez le fichier de métadonnées d’asset

Il existe des champs obligatoires et des valeurs acceptées pour le fichier CSV que vous téléversez. Vos assets apparaîtront exactement comme dans votre fichier ; tout espace, signe de ponctuation ou caractère spécial sera donc conservé s’il est utilisé. Pour commencer, copiez le modèle CSV affiché ci-dessous et collez-le dans une application de feuille de calcul 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 le format de fichier détails disponibles sur l’ Importation en masse écran pour vérifier vos saisies avant de téléverser !

Avant de créer ou de mettre à jour des assets à 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 stocké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 d’une 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 montre un nouvel asset bannière.
• Le UPDATE la ligne illustre une mise à jour partielle — seuls les champs renseignés seront mis à jour.
• Si vous vouliez effacer une valeur (p. 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 d’asset

1. Dans la barre de navigation de gauche, sélectionnez [Engage] → Contenu → Annonces.
2. Dans le coin supérieur droit, sélectionnez Importation en masse.
3. Sélectionnez  Choisir un fichier, téléversez votre fichier groupé et sélectionnez Ouvrir.

   • Sélectionnez  Afficher/masquer les détails du format du fichier pour afficher des informations sur les colonnes requises, leurs descriptions, les valeurs acceptées et savoir si elles sont obligatoires dans le colonnes d’en-tête d’annonce et colonnes d’en-tête d’offre 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 d’annonce

Nom de la colonne	Description
Operation (Chaîne) Obligatoire - toujours.	Opération à exécuter sur les détails de l’asset fournis. Valeurs autorisées : CREATE, UPDATE, DELETE.
ProgramId (Entier) Obligatoire - toujours.	L’identifiant de programme unique impact.com auquel l’asset appartient. Cette valeur ne peut pas être mise à jour et doit correspondre au programme dans lequel le téléversement groupé est exécuté.
AdID (Chaîne) Obligatoire - lors de l’exécution d’une opération sur un asset existant.	Identifiant unique impact.com de l’asset. Laisser vide lors de la création d’un nouvel asset. Obligatoire si Operation = UPDATE, DELETE.
État (Chaîne) Obligatoire - non.	L’état de l’asset. Valeurs autorisées : ACTIVE, EN ATTENTE, EXPIRED.
Nom (Chaîne) Obligatoire - lors de la création d’un asset.	Nom de l’asset. Obligatoire si Operation = CREATE.
AdType (Chaîne) Obligatoire - lors de la création d’un asset.	Lors de la mise à jour d’une annonce existante, le type d’annonce ne peut pas changer. Obligatoire si Operation = CREATE. Valeurs autorisées : IMAGE, TEXT_LINK, COUPON.
HostedBy (Chaîne) Obligatoire - lors de la création d’un asset image.	Lieu d’hébergement du créatif de l’asset. Obligatoire si Operation = CREATE et AdType = IMAGE. Valeurs autorisées : IR, URL, HTML.
Créatif (Chaîne) Obligatoire - lors de la création d’un asset 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 asset image.	Taille standard IAB de l’asset. 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 asset image.	Hauteur de l’image diffusée par un tiers, en pixels. Obligatoire si Operation = CREATE et IabAdUnit = CUSTOM.
ThirdPartyServableAdCreativeWidth (Entier) Obligatoire - lors de la création d’un asset image.	Largeur de l’image diffusée par un tiers, en pixels. Obligatoire si Operation = CREATE et IabAdUnit = CUSTOM.
Langue (Chaîne) Obligatoire - lors de la création d’un asset.	Valeurs autorisées : AFRIKAANS, ARABIC, BULGARIAN, CHINESE, CHINESE_TRADITIONAL, CZECH, DANISH, DUTCH, ENGLISH, ENGLISH_GB, ENGLISH_AU, ENGLISH_CA, ENGLISH_NZ, ENGLISH_ZA, ESTONIAN, FILIPINO, FINISH, FRENCH, FRENCH_CA, GERMAN, HEBREW, HINDI, INDONESIAN, ITALIAN, JAPANESE, KOREAN, LATVIAN, LITHUANIAN, MALAY, MALTESE, NORWEGIAN, PORTUGUESE, PORTUGUESE_BR, POLISH, RUSSIAN, SLOVENIAN, SPANISH, SPANISH_MX, SWEDISH, THAI, TURKISH, VIETNAMESE.
LimitedTimeEndDate (Date) Obligatoire - si LimitedTimeStartDate est fourni	Il s’agit d’une date ISO 8601. Format d’exemple : 2013-06-30T00:00:00-07:00.
LinkText (Chaîne) Obligatoire - lors de la création d’un asset 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’asset.
Étiquettes (Chaîne CSV) Obligatoire - non.	Étiquettes de l’asset.
AllowDeepLinking (Booléen) Obligatoire - non.	Détermine si la liaison vers une page plus profonde du site de l’annonceur sera autorisée. Valeur par défaut : vrai.
AllowCustomPromoCode (Booléen) Obligatoire - non.	Autorise le partenaire à demander son propre code promo unique pour cette promotion. Valeur par défaut : faux.
CustomisationCharge (Décimal 10.2) Obligatoire - non.	Montant des frais de personnalisation de l’asset.
ImageAlternativeTag (Chaîne) Obligatoire - non.	Balise alternative à utiliser dans le code de l’asset image.
LandingPage (Chaîne) Obligatoire - non.	L’URL de la page de destination. Elle doit contenir le protocole de l’URL. Par défaut, la page de destination par défaut du programme est utilisée lors de la création d’un asset si aucune n’est fournie.
iOSMobileFallbackAppId (Chaîne) Obligatoire - non.	Indique si le trafic mobile doit être redirigé vers la page de destination 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.	Indique si le trafic mobile doit être redirigé vers la page de destination 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 ISO 8601. Format d’exemple : 2013-06-30T00:00:00-07:00.
FallbackAd (Chaîne) Obligatoire - non.	Indiquez un ID d’asset de repli, applicable uniquement aux IMAGE assets.
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.	Top Seller. Valeur par défaut : faux.
ThirdPartyImpressionPixel (Chaîne) Obligatoire - non.	Code HTML du pixel d’impression tiers à utiliser avec cet asset.
RestrictedToPartners (Chaîne CSV) Obligatoire - non.	Identifiants de partenaires séparés par des virgules qui doivent avoir accès à cet asset.
RestrictedToGroups (Chaîne CSV) Obligatoire - non.	Identifiants de groupes de partenaires séparés par des virgules qui doivent avoir accès à cet asset.
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 d’offre

Nom de la colonne	Description
DealName (Chaîne) Obligatoire - lors de la création d’une nouvelle offre.	Nom de l’offre à créer et à associer à l’asset. 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 que DealName l’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 de 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ù les différents produits sont séparés par des virgules et les divers champs produit par des points-virgules. Champs valides : nom - nom du produit, image - nom de fichier de l’image du produit du 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 (String) Obligatoire - non	L’URL de la page de destination pour cette offre. Si elle est laissée vide lors de la création d’une nouvelle offre, la page de destination par défaut du programme sera utilisée.
DealMetadata (CSV String) 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 elle est laissée vide, aucun paramètre supplémentaire ne sera ajouté.
DealAllowDeepLinking (Boolean) Obligatoire - non	Détermine si le deep linking est autorisé pour la page de destination de l’offre. Si elle est laissée 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 (Chaîne) 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 rabais. 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 de 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 des é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 acheté 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 achetée. 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é reçue 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 reçu 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 reçue. 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 : GRATUIT, MONTANT, 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 = MONTANT.
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 associé.
DealDefaultDiscountCode (Chaîne) Obligatoire - non.	Code de remise par défaut de l’offre.
DealSyncAdsPromoCodes (Booléen) Obligatoire - non.	Conservez la synchronisation des annonces et des codes promotionnels associés avec cette offre. La synchronisation s’applique aux dates à durée limitée, à l’accès restreint des partenaires et à l’état.

3

Étape 3 : téléversez les fichiers créatifs de la ressource

Ensuite, vous devrez préparer vos fichiers créatifs de la ressource afin qu’ils puissent être téléversés.

1. Sur le Indiquez les images page, sélectionnez Choisir des fichiers pour téléverser en masse les fichiers créatifs de la ressource. Les noms des fichiers téléversés doivent correspondre exactement aux noms du champ créatif dans votre fichier de métadonnées (par ex., si le champ créatif contient Example.jpg, le fichier créatif de la ressource que vous téléversez doit également s’appeler Example.jpg).

   • Maintenez enfoncé Commande ⌘ sur macOS ou CTRL sur PC pour sélectionner plusieurs fichiers créatifs de la ressource à téléverser en une seule fois.
2. Sélectionnez Accepter et créer des annonces. Une fois que tous les éléments auront été téléversés, ils apparaîtront dans le Annonces page.