> For the complete documentation index, see [llms.txt](https://help.impact.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.impact.com/brand/ja/what-would-you-like-to-learn-about/platform-features/ads/manage-ads/bulk-upload-assets.md). # アセットを一括アップロードする CSVファイルを使用して複数のアセットを一度にアップロードするには、アセットを個別にアップロードするのではなく、一括アップロードツールを使います。情報フィールドは [広告オブジェクト](https://integrations.impact.com/brand-api-reference/reference/ads) どの情報をどこに入れるかを整理するのに役立ちます。 **一括広告アップロードを実行するには、2つのファイルが必要です:** * アセットメタデータファイル（CSV） * クリエイティブファイル（例: 画像または動画） {% stepper %} {% step %} **ステップ1: アセットメタデータファイルを準備する** アップロードするCSVファイルには、必須フィールドと使用可能な値があります。アセットはファイルどおりにそのまま表示されるため、スペース、句読点、特殊文字は使用されていればそのまま表示されます。開始するには、下に表示されているCSVテンプレートをコピーしてスプレッドシートアプリケーションに貼り付けるか、![](/files/13cccf72e7bffda0ccdbcbaccef663ee74d618f0)[こちらからダウンロードする](https://res.cloudinary.com/product-enablement/raw/upload/v1765961581/CSVs/Assets/Bulk_upload_ads_template_-_Sheet1.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 ``` {% hint style="info" %} **ヒント：** 以下の使用を推奨します。 *ファイル形式* の詳細は以下の [*一括アップロード*](https://app.impact.com/secure/advertiser/engage/ads/manage-all-ads-flow.ihtml) 画面で、アップロード前に入力内容を確認してください！ {% endhint %} メタデータファイルを使用してアセットを作成または更新する前に、部分更新に関する次の重要な点に注意してください: * 部分更新はサポートされています。セルを空欄のままにすると、そのフィールドは無視され、既存の値は変更されません。 * 値を消去または削除するには、 `$CLEAR$` をそのセルに明示的に入力してください。これにより、そのフィールドに以前保存されていた値が削除されます。 ```csv 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 作成,,バナーの例,これはアップロードする新しいバナー広告の例です。,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,,,,,,,,,,,,,,,,,,,,,,, 更新,123456,テキストリンクの例,これはテキストリンク広告を更新する例です。,34567,TEXT_LINK,,,,,,"Funtext, GoodDay",FALSE,,,,,https://alwayslovewhatyoudo.com,,,ENGLISH_GB,,,,,,,,こちらをクリックしてさらに！,,,,,,,,,,,,,,"https://example.com/deal-landing-page","utm_source=impact",TRUE,,,,,,,,,,,,,,,,,,, ``` * この `作成` この行は新しいバナーアセットを示します。 * この `更新` この行は部分更新を示します。入力済みのフィールドのみが更新されます。 * 値を消去したい場合（たとえば `ラベル`を削除する場合）は、 `$CLEAR$` をその列で使用します。 フィールドの消去例（CSV）: ```csv UPDATE,123456,Text Link Example,$CLEAR$,$CLEAR$,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,, ``` {% endstep %} {% step %} **ステップ2: アセットメタデータファイルをアップロードする** 1. 左側のナビゲーションバーから、 ![\[Engage\] v2](https://paligoapp-cdn-eu1.s3.eu-west-1.amazonaws.com/impact/attachments/f01cdffa431a4d75ff09c130b66974d4-aa671735ec2b65af79961eaf59ab60af.svg) **\[Engage]** → **コンテンツ** → [**広告**](https://app.impact.com/secure/advertiser/engage/ads/manage-all-ads-flow.ihtml)**.** 2. 右上隅で、 **一括アップロード**. 3. を選択  **ファイルを選択**、一括ファイルをアップロードし、 **開く**. * を選択  **ファイル形式の詳細を表示/非表示** 必須列、その説明、許可される値、および以下の *広告ヘッダー列* と *ディールヘッダー列* の参照を表示します。 {% hint style="success" icon="memo" %} **注:** ファイルにエラーがあれば、impact.com が通知します。 {% endhint %} 4. を選択 **次へ**.
広告ヘッダー列 | 列名 | 説明 | | ----------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | |

操作 （文字列）

必須 - 常に。

|

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

許可される値:

作成, 更新, 削除.

| |

プログラムID （整数）

必須 - 常に。

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

広告ID （文字列）

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

| アセットの impact.com 一意識別子。新しいアセットを作成する場合は空欄のままにします。次の場合は必須 *操作* = `更新`, `削除`. | |

州 （文字列）

必須 - いいえ。

|

アセットの状態。

許可される値:

有効, 保留中, 期限切れ.

| |

名前 （文字列）

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

| *アセット名*。次の場合は必須 *操作* = `作成`. | |

広告タイプ （文字列）

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

|

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

次の場合は必須 操作 = 作成.

許可される値:

画像, テキストリンク, クーポン.

| |

ホスト先 （文字列）

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

|

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

操作 = 作成 と 広告タイプ = 画像.

許可される値:

IR, URL, HTML.

| |

クリエイティブ （文字列）

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

|

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

操作 = 作成 と 広告タイプ = 画像.

| |

IAB広告ユニット （文字列）

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

|

IAB標準のアセットサイズ。次の場合は必須 操作 =

作成 と 広告タイプ = 画像 と ホスト先 != IR.

許可される値: 不明, ミディアムレクタングル, スクエアポップアップ, 縦長レクタングル, ラージレクタングル, レクタングル, レクタングル 3:1, ポップアンダー、フルバナー, ハーフバナー、マイクロバナー, ボタン1, ボタン2, 縦型バナー, スクエアボタン, リーダーボード, ワイドスカイスクレイパー, スカイスクレイパー, ハーフページ広告, カスタム.

| |

サードパーティ配信可能広告クリエイティブの高さ （整数）

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

|

サードパーティ配信可能画像の高さ（ピクセル）

次の場合は必須 操作 = 作成 と IAB広告ユニット =

カスタム.

| |

サードパーティ配信可能広告クリエイティブの幅 （整数）

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

|

サードパーティ配信可能画像の幅（ピクセル）

次の場合は必須 操作 = 作成 と IAB広告ユニット =

カスタム.

| |

言語 （文字列）

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

|

許可される値:

アフリカーンス語, アラビア語, ブルガリア語, 中国語, 繁体字中国語, チェコ語, デンマーク語, オランダ語, 英語, 英語（英国）, 英語（オーストラリア）, 英語（カナダ）, 英語（ニュージーランド）, 英語（南アフリカ）, エストニア語, フィリピノ語, フィンランド語, フランス語, フランス語（カナダ）, ドイツ語, ヘブライ語, ヒンディー語, インドネシア語, イタリア語, 日本語, 韓国語, ラトビア語, リトアニア語, マレー語, マルタ語, ノルウェー語, ポルトガル語, ポルトガル語（ブラジル）, ポーランド語, ロシア語, スロベニア語, スペイン語, スペイン語（メキシコ）, スウェーデン語, タイ語, トルコ語, ベトナム語.

| |

期間限定終了日 （日付）

必須 - LimitedTimeStartDate が指定されている場合

| これはISO8601日付です。形式例: `2013-06-30T00:00:00-07:00`. | |

リンクテキスト （文字列）

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

| リンクに表示される実際のテキスト。次の場合は必須 *操作* = `作成` と *広告タイプ* = `テキストリンク` や `クーポン`. | |

説明

必須 - いいえ。

| アセットの説明。 | |

ラベル （CSV文字列）

必須 - いいえ。

| アセットのラベル。 | |

ディープリンクを許可 （ブール値）

必須 - いいえ。

|

広告主サイト内のより深いページへのリンクを許可するかどうかを決定します。

既定値は true.

| |

カスタムプロモーションコードを許可 （ブール値）

必須 - いいえ。

|

パートナーがこのプロモーション用に独自の一意なプロモーションコードを要求できるようにします。

既定値は false.

| |

カスタマイズ料金 （小数 10.2）

必須 - いいえ。

| アセットのカスタマイズ料金額。 | |

画像代替タグ （文字列）

必須 - いいえ。

| 画像アセットのコードで使用する代替タグ。 | |

ランディングページ （文字列）

必須 - いいえ。

|

ランディングページのURL。URLプロトコルを含める必要があります。

アセット作成時に指定がない場合は、プログラムの既定ランディングページが使用されます。

| |

iOSMobileFallbackAppId （文字列）

必須 - いいえ。

| モバイルトラフィックでアプリが検出されなかった場合に iOS アプリのランディングページへフォールバックするかを指定します。App ID はシステムの app id と一致している必要があります。 | |

AndroidMobileFallbackAppId （文字列）

必須 - いいえ。

| モバイルトラフィックでアプリが検出されなかった場合に Android アプリのランディングページへフォールバックするかを指定します。App ID はシステムの App ID と一致している必要があります。 | |

期間限定開始日 （文字列）

必須 - いいえ。

| これはISO8601日付です。形式例: `2013-06-30T00:00:00-07:00`. | |

フォールバック広告 （文字列）

必須 - いいえ。

| フォールバック用アセットIDを指定します。適用対象は `画像` のみに適用されます。 | |

HTMLコード取得タイプ （文字列）

必須 - いいえ。

| 許可される値: `IFRAMEのみ`, `HTMLとIFRAME`. | |

季節 （文字列）

必須 - いいえ。

|

許可される値:

冬, 春, 夏, 秋, 元日, 大統領の日, バレンタインデー, 聖パトリックの日, イースター, 母の日, 追悼記念日, 父の日, 独立記念日, 新学期開始, 労働者の日, ハロウィーン, サンクスギビング, ブラックフライデー, サイバーマンデー, ハヌカー, クリスマス, ファミリーデー, グッドフライデー, ビクトリア・デー, カナダ・デー, 8月シビックホリデー, 戦没者追悼記念日, ボクシングデー, オーストラリア・デー, アンザック・デー, 女王誕生日, 会計年度末, ワイタンギ・デー, その他.

| |

人気商品 （ブール値）

必須 - いいえ。

| 人気商品。既定値は `false`. | |

ThirdPartyImpressionPixel （文字列）

必須 - いいえ。

| このアセットで使用するサードパーティインプレッションピクセルのHTML。 | |

パートナーに限定 （CSV文字列）

必須 - いいえ。

| このアセットへのアクセス権を持つ、カンマ区切りのパートナーID。 | |

グループに限定 （CSV文字列）

必須 - いいえ。

| このアセットへのアクセス権を持つ、カンマ区切りのパートナーグループID。 | |

メタデータ （CSV文字列）

必須 - いいえ。

| トラッキングURLに追加される、カンマ区切りのクエリ文字列パラメータ。 |
ディールヘッダー列 | 列名 | 説明 | | -------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | |

ディール名 （文字列）

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

| 作成してアセットにリンクするディールの名前。次の場合は必須 *ディールID* が指定されていない。 | |

ディールタイプ （文字列）

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

|

作成するディールのタイプ。次の場合は必須 ディールID が指定されておらず、かつ DealName がある場合。

許可される値:

一般セール,送料無料, 購入特典, リベート, BOGO, 新商品発売.

| |

ディール範囲 （文字列）

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

|

次の場合は必須 ディールID が指定されていない、 ディール名 であり、かつ ディールタイプ != BOGO。

許可される値:

ストア全体, カテゴリ, 商品, 商品一覧.

| |

ディール商品 （CSV文字列）

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

|

ディール商品。次の場合は必須 ディールID が指定されていない、 ディール名 であり、かつ ディール範囲 = 商品.

許可される値:

オプション1: 商品名リスト 例: "商品1, 商品2".

オプション2: 商品の値ペアリスト 例: "name=Product1;regularPrice=10;dealPrice=9.50; image=prodimg1.jpg, name=Product2;" 複数の商品はカンマで区切り、各商品のフィールドはセミコロンで区切ります。

有効なフィールド: 名前 - 商品名、 画像 - 一括アップロードのステップ2でアップロードする予定のファイルの商品画像ファイル名、 上限 - 許可数量、 通常価格 - 割引前価格、 ディール価格 - 割引後価格。

| |

ディールカテゴリ （CSV文字列）

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

| ディールカテゴリ。次の場合は必須 *ディールID* が指定されていない、 *ディール名* であり、かつ *ディール範囲* = `カテゴリ`. | |

DealLandingPage（文字列）
必須 - いいえ

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

DealMetadata（CSV文字列）
必須 - いいえ

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

DealAllowDeepLinking（ブール値）
必須 - いいえ

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

DealDiscountType （CSV文字列）

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

|

次の場合は必須 ディールID が指定されていない、 ディール名 であり、かつ ディールタイプ = 一般セール。

許可される値:

固定額, パーセント, パーセント範囲, 最大パーセント.

| |

ディール割引額 （小数 10.2）

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

| セール割引額。次の場合は必須 *ディールID* が指定されていない、 *ディール名* であり、 *ディールタイプ* = `一般セール`、および *DealDiscountType* = `固定額`. | |

ディール割引率 （小数 10.2）

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

| セール割引率。次の場合は必須 *ディールID* が指定されていない、 *ディール名* であり、 *ディールタイプ* = `一般セール`、および *DealDiscountType* = `パーセント`. | |

ディール割引範囲の開始率 （小数 10.2）

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

| ディール割引範囲の開始率。次の場合は必須 *ディールID* が指定されていない、 *ディール名* であり、 *ディールタイプ* = `一般セール`、および *DealDiscountType* = `パーセント範囲`. | |

ディール割引範囲の終了率 （小数 10.2）

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

| ディール割引範囲の開始率。次の場合は必須 *ディールID* が指定されていない、 *ディール名* であり、 *ディールタイプ* = `一般セール`、および *DealDiscountType* = `パーセント範囲`. | |

ディール最大割引率 （小数 10.2）

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

| ディール最大割引率。次の場合は必須 *ディールID* が指定されていない、 *ディール名* であり、 *ディールタイプ* = `一般セール`、および *DealDiscountType* = `最大パーセント`. | |

ディール特典 （小数 10.2）

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

| 特典の詳細。次の場合は必須 *ディールID* が指定されていない、 *ディール名* であり、かつ *ディールタイプ* = `購入特典`. | |

ディールリベート （小数 10.2）

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

| リベート額。次の場合は必須 *ディールID* が指定されていない、 *ディール名* であり、かつ *ディールタイプ* = `リベート`. | |

ディール最低購入金額 （小数 10.2）

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

| ディール最低購入金額。次の場合は必須 *ディールID* が指定されていない、 *ディール名* であり、かつ *ディールタイプ* = `BOGO`. | |

ディール最大節約額 （小数 10.2）

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

| ディール最大節約額。次の場合は必須 *ディールID* が指定されていない、 *ディール名* であり、かつ *ディールタイプ* = `BOGO`. | |

ディールBOGO購入上限 （整数）

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

| この価格で許可される商品の最大数量。次の場合は必須 *ディールID* が指定されていない、 *ディール名* であり、かつ *ディールタイプ* = `BOGO`. | |

ディールBOGO購入数量 （整数）

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

| BOGO購入数量。次の場合は必須 *ディールID* が指定されていない、 *ディール名* であり、かつ *ディールタイプ* = `BOGO`. | |

ディールBOGO購入タイプ （文字列）

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

|

BOGOの購入アイテム種別。該当する場合は必須 ディールID が指定されていない、 ディール名 であり、かつ ディールタイプ = BOGO.

許可される値:

商品, カテゴリ.

| |

BOGO購入商品の名前 （文字列）

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

| 購入する商品またはカテゴリの名前。該当する場合は必須 *ディールID* が指定されていない、 *ディール名* であり、かつ *ディールタイプ* = `BOGO`. | |

BOGO取得数量 （整数）

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

| BOGOの取得数量。該当する場合は必須 *ディールID* が指定されていない、 *ディール名* であり、かつ *ディールタイプ* = `BOGO`. | |

BOGO取得アイテム種別 （文字列）

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

|

BOGOの取得アイテム種別。該当する場合は必須 ディールID が指定されていない、 ディール名 であり、かつ ディールタイプ = BOGO.

許可される値:

商品, カテゴリ.

| |

BOGO取得商品の名前 （文字列）

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

| 取得する商品またはカテゴリの名前。該当する場合は必須 *ディールID* が指定されていない、 *ディール名* であり、かつ *ディールタイプ* = `BOGO`. | |

BOGO案件の割引種別 （文字列）

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

|

BOGO案件の割引種別。該当する場合は必須 ディールID が指定されていない、 ディール名 であり、かつ ディールタイプ = BOGO.

許可される値:

無料, 金額, パーセント.

| |

BOGO案件の割引額 （小数 10.2）

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

| BOGO案件の割引額。該当する場合は必須 *ディールID* が指定されていない、 *ディール名* であり、 *ディールタイプ* = `BOGO`、および *BOGO案件の割引種別* = `金額`. | |

BOGO案件の割引率 （小数 10.2）

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

| BOGO案件の割引率。該当する場合は必須 *ディールID* が指定されていない、 *ディール名* であり、 *ディールタイプ* = `BOGO`、および *BOGO案件の割引種別* = `パーセント`. | |

ディールID （文字列）

必須 - いいえ。

| アセットがリンクされる案件の、impact.com の一意の識別子。 | |

デフォルトの案件割引コード （文字列）

必須 - いいえ。

| デフォルトの案件割引コード。 | |

広告とプロモコードを同期 （ブール値）

必須 - いいえ。

| 関連する広告とプロモコードをこの案件と同期したままにします。同期は、期間限定日付、制限付きパートナーアクセス、状態に適用されます。 |
{% endstep %} {% step %} **ステップ 3: アセットのクリエイティブファイルをアップロードする** 次に、アップロードできるようにアセットのクリエイティブファイルを準備してください。 1. ～の *画像を指定* ページで、選択 **ファイルを選択** アセットのクリエイティブファイルを一括アップロードするには。アップロードするファイル名は、メタデータファイルのクリエイティブ欄にある名前と完全に一致している必要があります（例: クリエイティブ欄に `Example.jpg`、アップロードするアセットのクリエイティブファイルも同じ名前にする必要があります `Example.jpg`). * 押しながら **Command ⌘** macOS では、または **CTRL** PC では、複数のアセットのクリエイティブファイルをまとめて選択して一度にアップロードできます。 2. を選択 **承諾して広告を作成**。すべてのアセットがアップロードされると、 [*広告*](https://app.impact.com/secure/advertiser/engage/ads/manage-all-ads-flow.ihtml) ページ。 {% endstep %} {% endstepper %} --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://help.impact.com/brand/ja/what-would-you-like-to-learn-about/platform-features/ads/manage-ads/bulk-upload-assets.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.