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

複数のアセットを個別にアップロードするのではなく、CSVファイルを使用して一度に複数のアセットをアップロードするには、一括アップロードツールを使用します。情報フィールドは、どの情報がどこに入るかを調整するのに役立つ点で、次のものと類似しています。 Ads API どの情報がどこに配置されるかを調整するのに役立ちます。

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

• アセットのメタデータファイル

• 一般的に画像であるアセットのクリエイティブファイル

1

ステップ 1: 広告メタデータファイルを準備する

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

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

重要: 次の使用を推奨します: ファイル形式 の詳細は次で入手できます: 一括アップロード 画面で、アップロードする前に入力内容を確認してください!

2

ステップ 2: メタデータファイルの例

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

• 部分的な更新がサポートされています。セルを空白のままにすると、そのフィールドは無視され、既存の値は変更されません。

• 値をクリアまたは消去するには、明示的に次を入力してください: $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,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!,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,

• この CREATE 行は新しいバナーアセットを示します。

• この UPDATE 行は部分更新を示しています — 値が入力されているフィールドのみが更新されます。

• 値をクリアしたい場合（例: Labels)、その列には $CLEAR$ を使用します。

フィールドをクリアする例（CSV）:

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

3

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

1. 左側のナビゲーションバーから、次を選択します: [Engage] → コンテンツ → 広告.

2. 右上隅で、次を選択します: 一括アップロード.

3. 選択  ファイルを選択、一括ファイルをアップロードし、次を選択します: 開く.

   • 選択  ファイル形式の詳細を表示/非表示 必須列、その説明、受け入れ可能な値、および必須かどうかに関する情報を見るには、 広告ヘッダー列 および ディールヘッダー列 の参照を下記で確認してください。

     重要: impact.com はファイルにエラーがある場合、警告を行います。

広告ヘッダー列

列名	説明
操作 (文字列) 必須 - 常に。	提供されたアセットの詳細に対して実行する操作。 許容される値: CREATE, UPDATE, DELETE.
ProgramId (整数) 必須 - 常に。	アセットが属する一意の impact.com プログラムID。この値は更新できず、一括アップロードが実行されているプログラムと一致する必要があります。
AdID (文字列) 必須 - 既存のアセットに対して操作を実行する場合。	アセットの一意の impact.com 識別子。新しいアセットを作成する場合は空白のままにしてください。が提供されている場合は必須です。 操作 = UPDATE, DELETE.
State (文字列) 必須 - いいえ。	アセットの状態。 許容される値: ACTIVE, PENDING, EXPIRED.
名前 (文字列) 必須 - アセットを作成する場合。	アセット名。 が提供されている場合は必須です。 操作 = CREATE.
AdType (文字列) 必須 - アセットを作成する場合。	既存の広告を更新する場合、広告タイプは変更できない場合があります。 が提供されている場合は必須です。 操作 = CREATE. 許容される値: IMAGE, TEXT_LINK, COUPON.
HostedBy (文字列) 必須 - アセットを作成する場合。	アセットクリエイティブがホストされている場所。が提供されている場合は必須です。 操作 = CREATE および AdType = IMAGE. 許容される値: IR, URL, HTML.
Creative (文字列) 必須 - 画像アセットを作成する場合。	アップロードされるクリエイティブファイルの名前。が提供されている場合は必須です。 操作 = CREATE および AdType = IMAGE.
IabAdUnit (文字列) 必須 - 画像アセットを作成する場合。	IAB標準のアセットサイズ。が提供されている場合は必須です。 操作 = CREATE および AdType = IMAGE および HostedBy != 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 および AdType = TEXT_LINK または COUPON.
説明 必須 - いいえ。	アセットの説明。
Labels (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, OTHER.
TopSeller (真偽値) 必須 - いいえ。	トップセラー。デフォルトは false.
ThirdPartyImpressionPixel (文字列) 必須 - いいえ。	このアセットで使用するサードパーティのインプレッションピクセルHTML。
RestrictedToPartners (CSV 文字列) 必須 - いいえ。	このアセットにアクセスできるべきパートナーIDをカンマ区切りで指定します。
RestrictedToGroups (CSV 文字列) 必須 - いいえ。	このアセットにアクセスできるべきパートナーグループIDをカンマ区切りで指定します。
Metadata (CSV 文字列) 必須 - いいえ。	トラッキングURLに追加されるカンマ区切りのクエリ文字列パラメータ。

ディールヘッダー列

列名	説明
DealName (文字列) 必須 - 新しいディールを作成する場合。	作成してアセットにリンクするディールの名前。が提供されている場合は必須です。 DealId が提供されていない場合。
DealType (文字列) 必須 - 新しいディールを作成する場合。	作成するディールのタイプ。が提供されておらず DealName が提供されている場合は必須です。 DealId が提供されていない場合。 許容される値: 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;" 複数の製品はコンマで区切り、各製品フィールドはセミコロンで区切ります。 有効なフィールド: name - 製品名、 image - 一括アップロードのステップ2でアップロードする予定のファイルの製品画像ファイル名、 limit - 許可される数量、 regularPrice - 割引前の価格、 dealPrice - 割引後の価格。
DealCategories (CSV 文字列) 必須 - 新しいディールを作成する場合。	ディールのカテゴリ。 が必須です。 DealId が提供されていない場合、 DealName が提供されており、 DealScope = CATEGORY.
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. 許容される値: FREE, AMOUNT, PERCENT.
DealBogoGetDiscountAmount (小数 10.2) 必須 - 新しいディールを作成する場合。	BOGO ディールの割引額。 が提供されている場合は必須です。 DealId が提供されていない場合、 DealName が提供されている場合、 DealType = BOGO、および DealBogoGetDiscountType = AMOUNT.
DealBogoGetDiscountPercent (小数 10.2) 必須 - 新しいディールを作成する場合。	BOGO ディールの割引率。 が提供されている場合は必須です。 DealId が提供されていない場合、 DealName が提供されている場合、 DealType = BOGO、および DealBogoGetDiscountType = PERCENT.
DealId (文字列) 必須 - いいえ。	アセットがリンクされるディールの一意の impact.com 識別子。
DealDefaultDiscountCode (文字列) 必須 - いいえ。	デフォルトのディール割引コード。
DealSyncAdsPromoCodes (真偽値) 必須 - いいえ。	関連する広告とプロモコードをこのディールと同期させます。同期は期間限定日、制限されたパートナーアクセス、および状態に適用されます。

1. 選択 次へ.

4

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

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

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

   • を押し続けます Command ⌘ macOS ではまたは CTRL PC では複数の広告クリエイティブファイルを一度に選択するには。

2. 選択 承諾して広告を作成。すべての広告がアップロードされると、 広告 ページに表示されます。