For the complete documentation index, see llms.txt. This page is also available as Markdown.

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

CSVファイルを使って複数のアセットを一度にアップロードするには、一括アップロードツールを使用します。アセットを個別にアップロードするのではありません。情報フィールドは、 Ads オブジェクト と似ており、どの情報をどこに入れるかを整理するのに役立ちます。

一括広告アップロードを実行するには、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,,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",,,,,,,,"https://example.com/deal-landing-page","utm_source=impact",TRUE,,,,,,,,,,,,,,,,,,,,,,,
UPDATE,123456,Text Link Example,This is an example of updating a text link ad.,34567,TEXT_LINK,,,,,,"Funtext, GoodDay",FALSE,,,,,https://alwayslovewhatyoudo.com,,,ENGLISH_GB,,,,,,,,Click here for more!,,,,,,,,,,,,,,"https://example.com/deal-landing-page","utm_source=impact",TRUE,,,,,,,,,,,,,,,,,,,
  • 次の CREATE の行は、新しいバナーアセットを示します。

  • 次の UPDATE の行は部分更新を示します。入力されたフィールドのみが更新されます。

  • 値を消去したい場合(例: Labelsを削除する場合)、 $CLEAR$ その列で使用します。

フィールドを消去する例(CSV):

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

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

  1. 左側ナビゲーションバーから [Engage] v2 [Engage] → コンテンツ → 広告.

  2. 右上隅で 一括アップロード.

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

    • 選択  ファイル形式の詳細を表示/非表示 を表示して、必須列、その説明、使用可能な値、および以下の参照先でそれらが必須かどうかを確認します。 Ad header columns と Deal header columns の

  1. 選択 次へ.

Ad header columns
列名
説明

Operation (文字列)

必須 - 常に。

提供されたアセット詳細に対して実行する操作。

使用可能な値:

CREATE, UPDATE, DELETE.

ProgramId (整数)

必須 - 常に。

アセットが属する一意の impact.com Program ID。この値は更新できず、一括アップロードを実行しているプログラムと一致している必要があります。

AdID (文字列)

必須 - 既存のアセットに対して操作を実行する場合。

アセットの impact.com における一意の識別子。新しいアセットを作成する場合は空欄のままにします。次の場合に必須: Operation = UPDATE, DELETE.

State (文字列)

必須 - いいえ。

アセットの状態。

使用可能な値:

ACTIVE, PENDING, EXPIRED.

Name (文字列)

必須 - アセットを作成する場合。

アセット名. 次の場合に必須 Operation = CREATE.

AdType (文字列)

必須 - アセットを作成する場合。

既存の広告を更新する場合、広告タイプは変更できません。

次の場合に必須: Operation = CREATE.

使用可能な値:

IMAGE, TEXT_LINK, COUPON.

HostedBy (文字列)

必須 - 画像アセットを作成する場合。

アセットのクリエイティブがホストされている場所。次の場合に必須:

Operation = CREATE と AdType = IMAGE.

使用可能な値:

IR, URL, HTML.

Creative (文字列)

必須 - 画像アセットを作成する場合。

アップロードするクリエイティブファイル名。次の場合に必須:

Operation = CREATE と AdType = IMAGE.

IabAdUnit (文字列)

必須 - 画像アセットを作成する場合。

IAB標準のアセットサイズ。次の場合に必須: Operation =

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 (整数)

必須 - 画像アセットを作成する場合。

サードパーティで配信可能な画像の高さ(ピクセル)。

次の場合に必須: Operation = CREATE と IabAdUnit =

CUSTOM.

ThirdPartyServableAdCreativeWidth (整数)

必須 - 画像アセットを作成する場合。

サードパーティで配信可能な画像の幅(ピクセル)。

次の場合に必須: Operation = CREATE と IabAdUnit =

CUSTOM.

Language (文字列)

必須 - アセットを作成する場合。

使用可能な値:

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 (文字列)

テキストリンクまたはクーポンアセットを作成する場合は必須。

リンクとして表示される実際のテキスト。次の場合に必須: Operation = 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に追加される、コンマ区切りのクエリ文字列パラメータ。

Deal header columns
列名
説明

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;" 複数の商品はカンマで区切り、各商品の各フィールドはセミコロンで区切ります。

有効なフィールド: name - 商品名、 image - 一括アップロードの手順 2 でアップロードする予定の商品の画像ファイル名、 limit - 許可される数量、 regularPrice - 割引前価格、 dealPrice - 割引後価格。

DealCategories (CSV文字列)

新しいディールを作成する場合は必須。

ディールのカテゴリ。次の場合に必須: DealId が指定されていない、 DealName が指定されている、かつ DealScope = CATEGORY.

DealLandingPage (String) 必須 - いいえ

このディールのランディングページURL。新しいディールを作成するときに空欄のままにすると、プログラムの既定ランディングページが使用されます。

DealMetadata (CSV String) 必須 - いいえ

ディールのトラッキングリンクに対する、コンマ区切りのクエリ文字列パラメータ。空欄の場合、追加パラメータは追加されません。

DealAllowDeepLinking (Boolean) 必須 - いいえ

このディールのランディングページでディープリンクを許可するかどうかを決定します。空欄の場合、既定で FALSE になります。

DealDiscountType (CSV文字列)

新しいディールを作成する場合は必須。

次の場合に必須: DealId が指定されていない、 DealName が指定されている、かつ DealType = GENERAL_SALE.

使用可能な値:

FIXED, PERCENT, PERCENT_RANGE, PERCENT_MAXIMUM.

ディール割引額 (小数 10.2)

新しいディールを作成する場合は必須。

セール割引額。次の場合は必須 DealId が指定されていない、 DealName が、 DealType = GENERAL_SALE、および DealDiscountType = FIXED.

ディール割引率 (小数 10.2)

新しいディールを作成する場合は必須。

セール割引率。次の場合は必須 DealId が指定されていない、 DealName が、 DealType = GENERAL_SALE、および DealDiscountType = PERCENT.

ディール割引範囲の開始率 (小数 10.2)

新しいディールを作成する場合は必須。

ディール割引範囲の開始率。次の場合は必須 DealId が指定されていない、 DealName が、 DealType = GENERAL_SALE、および DealDiscountType = PERCENT_RANGE.

ディール割引範囲の終了率 (小数 10.2)

新しいディールを作成する場合は必須。

ディール割引範囲の開始率。次の場合は必須 DealId が指定されていない、 DealName が、 DealType = GENERAL_SALE、および DealDiscountType = PERCENT_RANGE.

ディール最大割引率 (小数 10.2)

新しいディールを作成する場合は必須。

ディールの最大割引率。次の場合は必須 DealId が指定されていない、 DealName が、 DealType = GENERAL_SALE、および DealDiscountType = PERCENT_MAXIMUM.

ディール特典 (文字列)

新しいディールを作成する場合は必須。

特典の詳細。次の場合は必須 DealId が指定されていない、 DealName が指定されている、かつ DealType = GIFT_WITH_PURCHASE.

ディール払い戻し (小数 10.2)

新しいディールを作成する場合は必須。

払い戻し額。次の場合は必須 DealId が指定されていない、 DealName が指定されている、かつ DealType = REBATE.

ディール最小購入金額 (小数 10.2)

新しいディールを作成する場合は必須。

ディールの最小購入金額。次の場合は必須 DealId が指定されていない、 DealName が指定されている、かつ DealType = BOGO.

ディール最大節約額 (小数 10.2)

新しいディールを作成する場合は必須。

ディールの最大節約額。次の場合は必須 DealId が指定されていない、 DealName が指定されている、かつ DealType = BOGO.

ディールBOGO購入上限 (整数)

新しいディールを作成する場合は必須。

この価格で許可されるアイテムの最大数量。次の場合は必須 DealId が指定されていない、 DealName が指定されている、かつ DealType = BOGO.

ディールBOGO購入数量 (整数)

新しいディールを作成する場合は必須。

BOGOの購入数量。次の場合は必須 DealId が指定されていない、 DealName が指定されている、かつ DealType = BOGO.

ディールBOGO購入タイプ (文字列)

新しいディールを作成する場合は必須。

BOGOの購入アイテム種別。次の場合は必須 DealId が指定されていない、 DealName が指定されている、かつ DealType = BOGO.

使用可能な値:

PRODUCT, CATEGORY.

ディールBOGO購入名 (文字列)

新しいディールを作成する場合は必須。

購入商品の名称またはカテゴリ。次の場合は必須 DealId が指定されていない、 DealName が指定されている、かつ DealType = BOGO.

ディールBOGO取得数量 (整数)

新しいディールを作成する場合は必須。

BOGOの取得数量。次の場合は必須 DealId が指定されていない、 DealName が指定されている、かつ DealType = BOGO.

ディールBOGO取得タイプ (文字列)

新しいディールを作成する場合は必須。

BOGOの取得アイテム種別。次の場合は必須 DealId が指定されていない、 DealName が指定されている、かつ DealType = BOGO.

使用可能な値:

PRODUCT, CATEGORY.

ディールBOGO取得名 (文字列)

新しいディールを作成する場合は必須。

取得商品の名称またはカテゴリ。次の場合は必須 DealId が指定されていない、 DealName が指定されている、かつ DealType = BOGO.

ディールBOGO取得割引種別 (文字列)

新しいディールを作成する場合は必須。

BOGOディールの割引種別。次の場合は必須 DealId が指定されていない、 DealName が指定されている、かつ DealType = BOGO.

使用可能な値:

無料, 金額, PERCENT.

ディールBOGO取得割引額 (小数 10.2)

新しいディールを作成する場合は必須。

BOGOディールの割引額。次の場合は必須 DealId が指定されていない、 DealName が、 DealType = BOGO、および ディールBOGO取得割引種別 = 金額.

ディールBOGO取得割引率 (小数 10.2)

新しいディールを作成する場合は必須。

BOGOディールの割引率。次の場合は必須 DealId が指定されていない、 DealName が、 DealType = BOGO、および ディールBOGO取得割引種別 = PERCENT.

DealId (文字列)

必須 - いいえ。

アセットがリンクされるディールの、impact.com の一意の識別子。

ディールの既定割引コード (文字列)

必須 - いいえ。

ディールの既定割引コード。

ディールの広告とプロモコードを同期 (論理値)

必須 - いいえ。

関連する広告とプロモコードをこのディールと同期された状態に保ちます。同期は、期間限定の日付、制限されたパートナーアクセス、およびステータスに適用されます。

3

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

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

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

    • 押し続け Command ⌘ macOS で、または CTRL PC で、複数のアセットのクリエイティブファイルをまとめて選択してアップロードします。

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

最終更新

役に立ちましたか?