アセットを一括アップロードする

一括アップロードツールを使うと、アセットを個別にアップロードするのではなく、CSVファイルを使用して複数のアセットを一度にアップロードできます。情報フィールドは、 広告オブジェクト どの情報をどこに対応させるかを整理するのに役立ちます。

一括広告アップロードを実行するには、2つのファイルが必要です:

• アセットのメタデータファイル（CSV）
• クリエイティブファイル（例：画像や動画）

1

ステップ1: アセットのメタデータファイルを準備する

アップロードするCSVファイルには、必須フィールドと受け入れ可能な値があります。アセットはファイルどおりにそのまま表示されるため、スペース、句読点、特殊文字を使用している場合はそれらもそのまま含まれます。開始するには、下に表示されているCSVテンプレートをコピーしてスプレッドシートアプリケーションに貼り付けるか、ここからダウンロード して直接インポートしてください。

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

ヒント： の使用をおすすめします。 ファイル形式 で利用できる詳細 一括アップロード をアップロード前に入力内容を確認する画面です！

メタデータファイルを使用してアセットを作成または更新する前に、部分更新に関する次の重要なポイントに注意してください:

• 部分更新はサポートされています。セルを空欄のままにすると、そのフィールドは無視され、既存の値は変更されません。
• 値を消去するには、明示的に $CLEAR$ をそのセルに入力してください。これにより、そのフィールドに以前保存されていた値が削除されます。

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,,バナーの例,これは、アップロードする新しいバナー広告の例です。,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,テキストリンクの例,これはテキストリンク広告を更新する例です。,34567,TEXT_LINK,,,,,,"Funtext, GoodDay",FALSE,,,,,https://alwayslovewhatyoudo.com,,,ENGLISH_GB,,,,,,,,こちらをクリックして詳細を確認！,,,,,,,,,,,,,,"https://example.com/deal-landing-page","utm_source=impact",TRUE,,,,,,,,,,,,,,,,,,,

• この CREATE 行は新しいバナーアセットを示します。
• この UPDATE 行は部分更新を示します — 値が入力されたフィールドのみ更新されます。
• 値を消去したい場合（例： ラベル） $CLEAR$ その列で使用します。

フィールドを消去する例（CSV）:

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

2

ステップ2: アセットのメタデータファイルをアップロードする

1. 左側のナビゲーションバーで、 ［Engage］ → コンテンツ → 広告.
2. 右上隅で、 一括アップロード.
3. 選択します  ファイルを選択、一括ファイルをアップロードして、 未処理.

   • 選択します  ファイル形式の詳細を表示/非表示 必須列、その説明、許容値、そして 広告ヘッダー列 および ディールヘッダー列 の下の参照を確認してください。

注： ファイルにエラーがある場合、impact.com が通知します。

1. 選択します 次へ.

広告ヘッダー列

列名	説明
操作 （文字列） 必須 - 常に必要です。	提供されたアセット詳細に対して実行する操作。 許可される値: CREATE, UPDATE, DELETE.
プログラムID （整数） 必須 - 常に必要です。	アセットが属する impact.com の一意のプログラムID。この値は更新できず、一括アップロードを実行しているプログラムと一致している必要があります。
広告ID （文字列） 必須 - 既存アセットに対して操作を実行する場合。	アセットの impact.com における一意の識別子。新しいアセットを作成する場合は空欄のままにしてください。 操作 = UPDATE, DELETE.
州 （文字列） 必須 - いいえ。	アセットの状態。 許可される値: ACTIVE, PENDING, EXPIRED.
名前 （文字列） 必須 - アセットを作成する場合。	アセット名。必須 - 〜の場合 操作 = CREATE.
広告タイプ （文字列） 必須 - アセットを作成する場合。	既存の広告を更新する場合、広告タイプは変更できません。 必須 - 〜の場合 操作 = CREATE. 許可される値: IMAGE, TEXT_LINK, COUPON.
配置先 （文字列） 必須 - アセットを作成する場合。	アセットのクリエイティブがホストされている場所。必須 - 〜の場合 操作 = CREATE および 広告タイプ = IMAGE. 許可される値: IR, URL, HTML.
クリエイティブ （文字列） 必須 - 画像アセットを作成する場合。	アップロードするクリエイティブファイル名。必須 - 〜の場合 操作 = CREATE および 広告タイプ = IMAGE.
IabAdUnit （文字列） 必須 - 画像アセットを作成する場合。	IAB標準のアセットサイズ。必須 - 〜の場合 操作 = CREATE および 広告タイプ = IMAGE および 配置先 != IR. 許可される値: 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 （整数） 必須 - 画像アセットを作成する場合。	サードパーティ配信可能な画像の高さ（ピクセル）。 必須 - 〜の場合 操作 = CREATE および IabAdUnit = CUSTOM.
ThirdPartyServableAdCreativeWidth （整数） 必須 - 画像アセットを作成する場合。	サードパーティ配信可能な画像の幅（ピクセル）。 必須 - 〜の場合 操作 = CREATE および IabAdUnit = CUSTOM.
言語 （文字列） 必須 - アセットを作成する場合。	許可される値: 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 （日付） 必須 - LimitedTimeStartDate が指定されている場合	これはISO8601の日付です。形式の例: 2013-06-30T00:00:00-07:00.
LinkText （文字列） 必須 - テキストリンクまたはクーポンアセットを作成する場合。	リンクとして実際に表示されるテキスト。必須 - 〜の場合 操作 = CREATE および 広告タイプ = TEXT_LINK または COUPON.
説明 必須 - いいえ。	アセットの説明。
ラベル （CSV文字列） 必須 - いいえ。	アセットラベル。
AllowDeepLinking （真偽値） 必須 - いいえ。	広告主サイト内のより深いページへのリンクを許可するかどうかを決定します。 既定値は true.
AllowCustomPromoCode （真偽値） 必須 - いいえ。	パートナーがこのプロモーション専用の一意のプロモコードを要求できるようにします。 既定値は false.
CustomisationCharge （小数 10.2） 必須 - いいえ。	アセットのカスタマイズ料金。
ImageAlternativeTag （文字列） 必須 - いいえ。	画像アセットコードで使用する代替タグ。
LandingPage （文字列） 必須 - いいえ。	ランディングページURL。URLプロトコルを含める必要があります。 アセットを作成する際に指定がない場合は、プログラムの既定のランディングページが使用されます。
iOSMobileFallbackAppId （文字列） 必須 - いいえ。	モバイルトラフィックでアプリが検出されない場合に、iOSアプリのランディングページへフォールバックさせるかを指定します。アプリIDはシステムのアプリIDと一致している必要があります。
AndroidMobileFallbackAppId （文字列） 必須 - いいえ。	モバイルトラフィックでアプリが検出されない場合に、Androidアプリのランディングページへフォールバックさせるかを指定します。アプリIDはシステムのアプリIDと一致している必要があります。
LimitedTimeStartDate （文字列） 必須 - いいえ。	これはISO8601の日付です。形式の例: 2013-06-30T00:00:00-07:00.
FallbackAd （文字列） 必須 - いいえ。	フォールバックアセットIDを指定します。 IMAGE アセットにのみ適用されます。
GetHtmlCodeType （文字列） 必須 - いいえ。	許可される値: IFRAME_ONLY, HTML_AND_IFRAME.
Season （文字列） 必須 - いいえ。	許可される値: 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, その他.
TopSeller （真偽値） 必須 - いいえ。	トップセラー。既定値は false.
ThirdPartyImpressionPixel （文字列） 必須 - いいえ。	このアセットで使用するサードパーティのインプレッションピクセルHTML。
RestrictedToPartners （CSV文字列） 必須 - いいえ。	このアセットへのアクセス権を持つパートナーIDをカンマ区切りで指定します。
RestrictedToGroups （CSV文字列） 必須 - いいえ。	このアセットへのアクセス権を持つパートナーグループIDをカンマ区切りで指定します。
メタデータ （CSV文字列） 必須 - いいえ。	トラッキングURLに追加されるクエリ文字列パラメータをカンマ区切りで指定します。

ディールヘッダー列

列名	説明
DealName （文字列） 必須 - 新しいディールを作成する場合。	作成してアセットにリンクするディールの名前。必須 - 〜の場合 DealId が提供されていない場合。
DealType （文字列） 必須 - 新しいディールを作成する場合。	作成するディールの種類。必須 - 〜の場合 DealId が提供されておらず、DealName が指定されている場合。 許可される値: GENERAL_SALE,FREE_SHIPPING, GIFT_WITH_PURCHASE, REBATE, BOGO, PRODUCT_LAUNCH.
DealScope （文字列） 必須 - 新しいディールを作成する場合。	必須 - 〜の場合 DealId が提供されていない場合、 DealName が、 DealType != BOGO。 許可される値: ENTIRE_STORE, CATEGORY, PRODUCT, PRODUCTS.
DealProducts （CSV文字列） 必須 - 新しいディールを作成する場合。	ディールの商品。必須 - 〜の場合 DealId が提供されていない場合、 DealName が、 DealScope = PRODUCT. 許可される値: オプション1: 商品名の一覧 例: "Product1, Product2". オプション2: 商品の値ペア一覧 例: "name=Product1;regularPrice=10;dealPrice=9.50; image=prodimg1.jpg, name=Product2;" 複数の商品はカンマで区切り、各商品フィールドはセミコロンで区切ります。 有効なフィールド: 名前 - 商品名, 画像 - 一括アップロードのステップ2でアップロードする予定のファイルの、商品画像ファイル名, 上限 - 許可される数量, 通常価格 - 割引前価格, 割引価格 - 割引後価格。
DealCategories （CSV文字列） 必須 - 新しいディールを作成する場合。	ディールカテゴリ。必須 - 〜の場合 DealId が提供されていない場合、 DealName が、 DealScope = CATEGORY.
DealLandingPage（文字列） 必須 - いいえ	このディールのランディングページURL。新しいディールを作成する際に空欄のままにすると、プログラムの既定のランディングページが使用されます。
DealMetadata（CSV文字列） 必須 - いいえ	ディールのトラッキングリンクに付与するクエリ文字列パラメータをカンマ区切りで指定します。空欄の場合、追加パラメータは追加されません。
DealAllowDeepLinking（真偽値） 必須 - いいえ	ディールのランディングページでディープリンクを許可するかどうかを決定します。空欄の場合、既定値は FALSE になります。
DealDiscountType （CSV文字列） 必須 - 新しいディールを作成する場合。	必須 - 〜の場合 DealId が提供されていない場合、 DealName が、 DealType = GENERAL_SALE。 許可される値: FIXED, PERCENT, PERCENT_RANGE, PERCENT_MAXIMUM.
DealDiscountAmount （小数 10.2） 必須 - 新しいディールを作成する場合。	セール割引額。必須 - 〜の場合 DealId が提供されていない場合、 DealName が、 DealType = GENERAL_SALE、および DealDiscountType = FIXED.
DealDiscountPercent （小数 10.2） 必須 - 新しいディールを作成する場合。	セール割引率。必須 - 〜の場合 DealId が提供されていない場合、 DealName が、 DealType = GENERAL_SALE、および DealDiscountType = PERCENT.
DealDiscountStartPercent （小数 10.2） 必須 - 新しいディールを作成する場合。	ディール割引範囲の開始率。必須 - 〜の場合 DealId が提供されていない場合、 DealName が、 DealType = GENERAL_SALE、および DealDiscountType = PERCENT_RANGE.
DealDiscountEndPercent （小数 10.2） 必須 - 新しいディールを作成する場合。	ディール割引範囲の開始率。必須 - 〜の場合 DealId が提供されていない場合、 DealName が、 DealType = GENERAL_SALE、および DealDiscountType = PERCENT_RANGE.
DealDiscountMaximumPercent （小数 10.2） 必須 - 新しいディールを作成する場合。	ディールの最大割引率。必須 - 〜の場合 DealId が提供されていない場合、 DealName が、 DealType = GENERAL_SALE、および DealDiscountType = PERCENT_MAXIMUM.
DealGift （小数 10.2） 必須 - 新しいディールを作成する場合。	特典の詳細。必須 - 〜の場合 DealId が提供されていない場合、 DealName が、 DealType = GIFT_WITH_PURCHASE.
DealRebate （小数 10.2） 必須 - 新しいディールを作成する場合。	リベート額。必須 - 〜の場合 DealId が提供されていない場合、 DealName が、 DealType = REBATE.
DealMinimumPurchaseAmount （小数 10.2） 必須 - 新しいディールを作成する場合。	ディールの最小購入金額。必須 - 〜の場合 DealId が提供されていない場合、 DealName が、 DealType = BOGO.
DealMaximumSavingsAmount （小数 10.2） 必須 - 新しいディールを作成する場合。	ディールの最大節約額。必須 - 〜の場合 DealId が提供されていない場合、 DealName が、 DealType = BOGO.
DealBogoPurchaseLimit （整数） 必須 - 新しいディールを作成する場合。	この価格で許可される商品の最大数量。必須 - 〜の場合 DealId が提供されていない場合、 DealName が、 DealType = BOGO.
DealBogoBuyQty （整数） 必須 - 新しいディールを作成する場合。	BOGO購入数量。必須 - 〜の場合 DealId が提供されていない場合、 DealName が、 DealType = BOGO.
DealBogoBuyType （文字列） 必須 - 新しいディールを作成する場合。	BOGO購入アイテムタイプ。必須 - 〜の場合 DealId が提供されていない場合、 DealName が、 DealType = BOGO. 許可される値: PRODUCT, CATEGORY.
DealBogoBuyName （文字列） 必須 - 新しいディールを作成する場合。	購入商品の名前またはカテゴリ名。必須 - 〜の場合 DealId が提供されていない場合、 DealName が、 DealType = BOGO.
DealBogoGetQty （整数） 必須 - 新しいディールを作成する場合。	BOGO取得数量。必須 - 〜の場合 DealId が提供されていない場合、 DealName が、 DealType = BOGO.
DealBogoGetType （文字列） 必須 - 新しいディールを作成する場合。	BOGO取得アイテムタイプ。必須 - 〜の場合 DealId が提供されていない場合、 DealName が、 DealType = BOGO. 許可される値: PRODUCT, CATEGORY.
DealBogoGetName （文字列） 必須 - 新しいディールを作成する場合。	取得する商品またはカテゴリの名前。次の場合必須 DealId が提供されていない場合、 DealName が、 DealType = BOGO.
DealBogoGetDiscountType （文字列） 必須 - 新しいディールを作成する場合。	BOGO取引の割引タイプ。次の場合必須 DealId が提供されていない場合、 DealName が、 DealType = BOGO. 許可される値: 無料, 金額, PERCENT.
DealBogoGetDiscountAmount （小数 10.2） 必須 - 新しいディールを作成する場合。	BOGO取引の割引金額。次の場合必須 DealId が提供されていない場合、 DealName が、 DealType = BOGO、および DealBogoGetDiscountType = 金額.
DealBogoGetDiscountPercent （小数 10.2） 必須 - 新しいディールを作成する場合。	BOGO取引の割引率。次の場合必須 DealId が提供されていない場合、 DealName が、 DealType = BOGO、および DealBogoGetDiscountType = PERCENT.
DealId （文字列） 必須 - いいえ。	アセットがリンクされる取引の impact.com の一意の識別子。
DealDefaultDiscountCode （文字列） 必須 - いいえ。	取引のデフォルト割引コード。
DealSyncAdsPromoCodes （真偽値） 必須 - いいえ。	関連付けられた広告とプロモコードをこの取引と同期したままにします。同期は、期間限定の日付、制限付きパートナーアクセス、およびステータスに適用されます。

3

ステップ 3: アセットのクリエイティブファイルをアップロードする

次に、アップロードできるようにアセットのクリエイティブファイルを準備する必要があります。

1. 次の 画像を指定する ページで、 ファイルを選択 を使用して、アセットのクリエイティブファイルを一括アップロードします。アップロードするファイル名は、メタデータファイル内のクリエイティブフィールドの名前と完全に一致している必要があります（例：クリエイティブフィールドに Example.jpgが含まれている場合、アップロードするアセットのクリエイティブファイルも Example.jpg).

   • 押しながら Command ⌘ を macOS で、または CTRL を PC で押すと、複数のアセットのクリエイティブファイルを一度に選択してアップロードできます。
2. 選択します 承諾して広告を作成。すべてのアセットがアップロードされると、次に表示されます 広告 ページ。