Télécharger des actifs en masse

Utilisez l'outil de téléchargements en masse pour télécharger plusieurs éléments à la fois à l'aide d'un fichier CSV, plutôt que de télécharger les éléments individuellement. Les champs d'information sont similaires au Ads APIarrow-up-right pour vous aider à coordonner quelles informations vont où.

Vous aurez besoin de deux fichiers pour effectuer un téléchargement d'annonce en masse :

  • Un fichier de métadonnées des éléments

  • Les fichiers créatifs des éléments, qui sont généralement des images

1

Étape 1 : Préparez le fichier de métadonnées des annonces

Il existe des champs obligatoires et des valeurs acceptées pour le fichier CSV que vous téléchargez. Vos éléments apparaîtront exactement comme dans votre fichier, donc tout espace, signe de ponctuation ou caractère spécial sera présent s'il est utilisé. Pour commencer, copiez soit le modèle CSV affiché ci-dessous et collez-le dans une application de feuille de calcul ou téléchargez-le iciarrow-up-right et importez-le directement.

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

Étape 2 : Exemple de fichier de métadonnées

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 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,DealDiscountType,DealDiscountAmount,DealDiscountPercent,DealDiscountStartPercent,DealDiscountEndPercent,DealDiscountMaximumPercent,DealGift,DealRebate,DealMinimumPurchaseAmount,DealMaximumPurchaseAmount,DealBogoPurchaseLimit,DealBogoBuyQty,DealBogoBuyType,DealBogoBuyName,DealBogoGetQty,DealBogoGetType,DealBogoGetName,DealBogoGetDiscountType,DealBogoGetDiscountAmount,DealBogoGetDiscountPercent,DealSyncAdsPromoCodes
CREATE,,Banner Example,This is an example of a new banner ad you would upload.,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",,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,
UPDATE,123456,Text Link Example,This is an example of updating a text link ad.,34567,TEXT_LINK,,,,,,"Funtext, GoodDay",FALSE,,,,,alwayslovewhatyoudo.com,,,ENGLISH_GB,,,,,,,,Click here for more!,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,
  • Le CREATE ligne montre un nouvel élément de bannière.

  • Le UPDATE la ligne démontre une mise à jour partielle — seules les cases remplies seront mises à jour.

  • Si vous souhaitez effacer une valeur (par ex., supprimer Labels), vous utiliseriez $CLEAR$ dans cette colonne.

Exemple de champs effacés (CSV) :

UPDATE,123456,Text Link Example,$CLEAR$,$CLEAR$,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,
3

Étape 3 : Téléversez le fichier de métadonnées des éléments

  1. Dans la barre de navigation de gauche, sélectionnez [Engage] v2 [Engage]ContenuAnnoncesarrow-up-right.

  2. Dans le coin supérieur droit, sélectionnez Téléchargement en masse.

  3. Sélectionner  Choisir le fichier, téléversez votre fichier en masse, et sélectionnez Ouvrir.

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

      circle-exclamation
chevron-rightcolonnes d'en-tête d'annoncehashtag
Nom de la colonne
Description

Opération (Chaîne)

Obligatoire - Toujours.

Opération à exécuter sur les détails de l'élément fournis.

Valeurs autorisées :

CREATE, UPDATE, SUPPRIMER.

ProgramId (Entier)

Obligatoire - Toujours.

L'ID de 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échargement 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 pour l'élément. Laisser vide lors de la création d'un nouvel élément. Obligatoire si Opération = UPDATE, SUPPRIMER.

État (Chaîne)

Obligatoire - Non.

L'état de l'élément.

Valeurs autorisées :

ACTIF, EN ATTENTE, EXPIRÉ.

Nom (Chaîne)

Obligatoire - Lors de la création d'un élément.

Nom de l'élément. Obligatoire si Opération = CREATE.

Type d'annonce (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 peut ne pas changer.

Obligatoire si Opération = CREATE.

Valeurs autorisées :

IMAGE, LIEN_TEXTE, COUPON.

HébergéPar (Chaîne)

Obligatoire - Lors de la création d'un élément.

Où le créatif de l'élément est hébergé. Obligatoire si

Opération = CREATE et Type d'annonce = IMAGE.

Valeurs autorisées :

IR, URL, HTML.

Créatif (Chaîne)

Obligatoire - Lors de la création d'un élément image.

Nom du fichier créatif à téléverser. Obligatoire si

Opération = CREATE et Type d'annonce = IMAGE.

IabAdUnit (Chaîne)

Obligatoire - Lors de la création d'un élément image.

Taille d'élément standard IAB. Obligatoire si Opération =

CREATE et Type d'annonce = IMAGE et HébergéPar != IR.

Valeurs autorisées : INCONNU, RECTANGLE_MOYEN, POP_UP_CARRE, RECTANGLE_VERTICAL, GRAND_RECTANGLE, RECTANGLE, RECTANGLE_3_1_, POP_UNDER, FULL_BANNER, HALF_BANNER, MICRO_BANNER, BOUTON_1, BOUTON_2, BANNIÈRE_VERTICALE, BOUTON_CARRE, LEADERBOARD, WIDE_SKYSCRAPER, SKYSCRAPER, DEMI_PAGE, PERSONNALISÉ.

ThirdPartyServableAdCreativeHeight (Entier)

Obligatoire - Lors de la création d'un élément image.

Hauteur de l'image servable par un tiers, en pixels.

Obligatoire si Opération = CREATE et IabAdUnit =

PERSONNALISÉ.

ThirdPartyServableAdCreativeWidth (Entier)

Obligatoire - Lors de la création d'un élément image.

Largeur de l'image servable par un tiers, en pixels.

Obligatoire si Opération = CREATE et IabAdUnit =

PERSONNALISÉ.

Langue (Chaîne)

Obligatoire - Lors de la création d'un élément.

Valeurs autorisées :

AFRIKAANS, ARABE, BULGARE, CHINOIS, CHINOIS_TRADITIONNEL, TCHEQUE, 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, LETTONE, 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

Ceci est une date ISO8601. Format d'exemple : 2013-06-30T00:00:00-07:00.

LinkText (Chaîne)

Obligatoire - Lors de la création d'un lien texte ou d'un élément coupon.

Texte réel affiché pour le lien. Obligatoire si Opération = CREATE et Type d'annonce = LIEN_TEXTE ou COUPON.

Description

Obligatoire - Non.

Description de l'élément.

Labels (Chaîne CSV)

Obligatoire - Non.

Étiquettes de l'élément.

AllowDeepLinking (Booléen)

Obligatoire - Non.

Détermine si le lien vers une page plus profonde du site annonceur sera autorisé.

Par défaut vrai.

AllowCustomPromoCode (Booléen)

Obligatoire - Non.

Permet au Partenaire de demander son propre code promo unique pour cette promotion.

Par défaut faux.

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 de destination. Elle doit contenir le protocole URL.

Par défaut, utilise la page de destination par défaut du programme lors de la création d'un élément si elle n'est pas fournie.

iOSMobileFallbackAppId (Chaîne)

Obligatoire - Non.

Spécifiez si le trafic mobile doit revenir à la page de destination de votre application iOS si aucune application n'est détectée. L'identifiant de l'application doit correspondre à l'identifiant système de l'application.

AndroidMobileFallbackAppId (Chaîne)

Obligatoire - Non.

Spécifiez si le trafic mobile doit revenir à la page de destination de votre application Android si aucune application n'est détectée. L'identifiant de l'application doit correspondre à l'identifiant système de l'application.

LimitedTimeStartDate (Chaîne)

Obligatoire - Non.

Ceci est une date ISO8601. Format d'exemple : 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.

Saison (Chaîne)

Obligatoire - Non.

Valeurs autorisées :

HIVER, PRINTEMPS, ÉTÉ, AUTOMNE, NOUVEL_AN, JOUR_DES_PRÉSIDENTS, SAINT_VALENTIN, SAINT_PATRICK, PÂQUES, FÊTE_DES_MÈRES, MEMORIAL_DAY, FÊTE_DES_PÈRES, JOUR_DE_L'INDÉPENDANCE, RETOUR_À_L'ÉCOLE, FÊTE_DU_TRAVAIL, HALLOWEEN, ACTION_DE_GRÂCES, BLACK_FRIDAY, CYBER_MONDAY, HANOUCCA, NOËL, FAMILY_DAY, VENDREDI_SAINT, VICTORIA_DAY, JOUR_DU_CANADA, AUGUST_CIVIC_HOLIDAY, REMEMBRANCE_DAY, BOXING_DAY, AUSTRALIA_DAY, ANZAC_DAY, QUEENS_BIRTHDAY, FIN_D'EXERCICE, WAITANGI_DAY, AUTRE.

TopSeller (Booléen)

Obligatoire - Non.

Meilleure vente. Par défaut faux.

ThirdPartyImpressionPixel (Chaîne)

Obligatoire - Non.

Pixel d'impression HTML tiers à utiliser avec cet élément.

RestrictedToPartners (Chaîne CSV)

Obligatoire - Non.

Identifiants des partenaires séparés par des virgules qui devraient avoir accès à cet élément.

RestrictedToGroups (Chaîne CSV)

Obligatoire - Non.

Identifiants des groupes de partenaires séparés par des virgules qui devraient avoir accès à cet élément.

Metadata (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.

chevron-rightcolonnes d'en-tête d'offrehashtag
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 à 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 que DealName l'est.

Valeurs autorisées :

VENTE_GÉNÉRALE,LIVRAISON_GRATUITE, CADEAU_AVEC_ACHAT, REMBOURSEMENT, BOGO, LANCEMENT_PRODUIT.

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 :

MAGASIN_ENTIER, CATÉGORIE, PRODUIT, PRODUITS.

DealProducts (chaîne CVS)

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 = PRODUIT.

Valeurs autorisées :

Option 1 : Liste de noms de produits par ex. "Product1, Product2".

Option 2 : Liste de paires de valeur produit par ex. "name=Product1;regularPrice=10;dealPrice=9.50; image=prodimg1.jpg, name=Product2;" où les produits multiples sont séparés par des virgules et les différents champs produit sont séparés par un point-virgule.

Champs valides : name - nom du produit, image - nom de fichier de l'image du produit du fichier que vous avez l'intention de téléverser à l'étape deux du téléchargement 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 = CATÉGORIE.

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 = VENTE_GÉNÉRALE.

Valeurs autorisées :

FIXE, POURCENTAGE, PLAGE_POURCENTAGE, POURCENTAGE_MAXIMUM.

DealDiscountAmount (Décimal 10.2)

Obligatoire - Lors de la création d'une nouvelle offre.

Montant de la remise. Obligatoire si DealId n'est pas fourni, DealName est, DealType = VENTE_GÉNÉRALE, et DealDiscountType = FIXE.

DealDiscountPercent (Décimal 10.2)

Obligatoire - Lors de la création d'une nouvelle offre.

Pourcentage de la remise. Obligatoire si DealId n'est pas fourni, DealName est, DealType = VENTE_GÉNÉRALE, et DealDiscountType = POURCENTAGE.

DealDiscountStartPercent (Décimal 10.2)

Obligatoire - Lors de la création d'une nouvelle offre.

Pourcentage de début de la plage de remise. Obligatoire si DealId n'est pas fourni, DealName est, DealType = VENTE_GÉNÉRALE, et DealDiscountType = PLAGE_POURCENTAGE.

DealDiscountEndPercent (Décimal 10.2)

Obligatoire - Lors de la création d'une nouvelle offre.

Pourcentage de début de la plage de remise. Obligatoire si DealId n'est pas fourni, DealName est, DealType = VENTE_GÉNÉRALE, et DealDiscountType = PLAGE_POURCENTAGE.

DealDiscountMaximumPercent (Décimal 10.2)

Obligatoire - Lors de la création d'une nouvelle offre.

Remise maximale en pourcentage. Obligatoire si DealId n'est pas fourni, DealName est, DealType = VENTE_GÉNÉRALE, et DealDiscountType = POURCENTAGE_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 = CADEAU_AVEC_ACHAT.

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 = REMBOURSEMENT.

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 maximum d'économies pour 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 d'achat BOGO. Obligatoire si DealId n'est pas fourni, DealName est, et DealType = BOGO.

Valeurs autorisées :

PRODUIT, CATÉGORIE.

DealBogoBuyName (Chaîne)

Obligatoire - Lors de la création d'une nouvelle offre.

Nom du produit ou de la catégorie d'achat. 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 :

PRODUIT, CATÉGORIE.

DealBogoGetName (Chaîne)

Obligatoire - Lors de la création d'une nouvelle offre.

Nom du produit ou de la catégorie obtenu. 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 BOGO. Obligatoire si DealId n'est pas fourni, DealName est, et DealType = BOGO.

Valeurs autorisées :

GRATUIT, MONTANT, POURCENTAGE.

DealBogoGetDiscountAmount (Décimal 10.2)

Obligatoire - Lors de la création d'une nouvelle offre.

Montant de la remise 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 BOGO. Obligatoire si DealId n'est pas fourni, DealName est, DealType = BOGO, et DealBogoGetDiscountType = POURCENTAGE.

DealId (Chaîne)

Obligatoire - Non.

Identifiant unique impact.com pour 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.

Garder les annonces associées et les codes promo synchronisés avec cette offre. La synchronisation s'applique aux dates à durée limitée, à l'accès restreint des partenaires et à l'état.

  1. Sélectionner Suivant.

4

Étape 4 : Téléversez les fichiers créatifs des éléments

Ensuite, vous aurez besoin que vos fichiers créatifs d'éléments soient prêts afin qu'ils puissent être téléversés.

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

    • Maintenez enfoncée la touche Commande ⌘ sur macOS ou CTRL sur PC pour sélectionner plusieurs fichiers créatifs d'annonces à téléverser en une fois.

  2. Sélectionner Accepter et créer des annonces. Une fois toutes les annonces téléversées, elles apparaîtront dans la Annoncesarrow-up-right page.

Mis à jour

Ce contenu vous a-t-il été utile ?