カタログマネージャーを使ったダイナミック広告

グロッサリー

用語	定義
カタログ（catalog）	カタログには、販売する予定の商品が含まれます。AppLovinでは、すべての商品を1つのカタログで管理することを推奨しています。
バリエーション（variant）	バリエーションは、販売対象となる個別のSKU（在庫管理単位）です。各SKUは、それぞれ固有のバリエーションとして扱う必要があります。カタログマネージャーでは、itemIdが同じバリエーションは、同一アイテムのバリエーションとみなされます。たとえば、同じブランドの「レッド／Sサイズのシャツ」「レッド／Lサイズのシャツ」「ブルー／Lサイズのシャツ」は、それぞれが別々のバリエーションですが、共通のitemIdを持っています。

開始方法

[Shopify]/ja/ecommerce/shopify/)の方法でピクセルを連携している場合は、アカウントマネージャーまでお問い合わせください。 それ以外の場合は、以下の手順に従ってください。

1. ピクセルが item_variant_id を送信していることを確認します。
2. カタログCSVテンプレート をダウンロードして、カタログ情報を入力します。 各フィールドにコンマが含まれていないことを確認します（コンマはフィールドの区切りとしてのみ使用できます）。
3. CSVファイルを公開アクセス可能な場所にアップロードします。この例 を参照してください。
4. CSVのダウンロードリンクをAppLovinの担当者と共有します。
5. 変更がある場合は、アップロード済みのCSVを更新します。 AppLovinは、カタログへの変更内容を毎日18:00（UTC）に自動同期します。

Variantオブジェクト

フィールド	タイプ	要否	説明
additionalImageUrls	String[]	いいえ	バリエーションに関連付けられた追加画像。有効な拡張子は.jpg、.jpeg、および.pngです。配列内の項目はカンマではなくセミコロンで区切ってください。
additionalVideoUrls	String[]	いいえ	バリエーションに関連付けられた追加動画。使用可能な拡張子はmp4です。配列内の項目はカンマではなくセミコロンで区切ってください。
ageGroup	String	いいえ	ADULTS、ALL_AGES、INFANT、KIDS、NEWBORN、またはTODDLERのいずれか
brand	String	いいえ	同じitemIdに別のバリエーションが存在する場合は無視されます。256文字以内にする必要があります。
categoryId	整数	はい	GoogleカテゴリーID
description	String	はい	バリエーションの簡単な説明。説明文は簡潔かつ有益な内容とし、8192文字以内に収めてください。
gender	String	いいえ	FEMALE、MALE、またはUNISEXのいずれか
id	String	はい	バリエーションのID。これはピクセル内のitem_variant_idと一致しなければなりません。64文字以内にする必要があります。
isAvailable	Boolean	はい	バリエーションが利用可能か在庫切れか
isBundle	Boolean	はい	バリエーションが複数の商品をまとめて販売するセット商品であるかどうか
itemId	String	はい	アイテムのバリエーション全体で共有されるID。これはピクセル内のitem_idと一致しなければなりません。64文字以内にする必要があります。
multipackQuantity	Number	いいえ	1パックに含まれる同一のアイテムの数
name	String	はい	バリエーションの名前。1024文字以内にする必要があります。
numberOfReviews	Number	いいえ	バリエーションのレビュー数の合計
price	Decimal	はい	バリエーションの価格。バリエーションがセール中の場合、価格はセール前の元の価格を指定してください。
primaryImageUrl	String	はい	バリエーションに関連付けられたメイン画像。デフォルトでは、バリエーションが表示される際にこの画像が表示されます。有効な拡張子は.jpg、.jpeg、および.pngです。2048文字以内にする必要があります。
primaryVideoUrl	String	いいえ	バリエーションに関連付けられたメイン動画。デフォルトでは、バリエーションが表示される際にこの動画が表示されます。有効な拡張子はmp4です。2048文字以内にする必要があります。
rating	Decimal	いいえ	バリエーションの評価。0〜5段階。評価がない場合はnull。
rewardEndDate	DateTime	いいえ	rewardPercentの有効期間が終了する時刻。UTC時間としてISO-8601 に従い、タイムゾーンオフセットなしでフォーマットしてください（例：2025-01-07T00:00:00）。rewardStartDateとrewardEndDateが両方ともnullの場合、rewardPercentは有効ではありません。rewardEndDateがnullの場合に限り、rewardPercentはrewardStartDateから有効になります。
rewardPercent	Number	いいえ	バリエーションを購入した場合に顧客が受け取る割合。0〜100の数値で表示
rewardStartDate	DateTime	いいえ	rewardPercentが有効になり始める時刻。UTC時間としてISO-8601 に従い、タイムゾーンオフセットなしでフォーマットしてください（例：2025-01-01T00:00:00）。rewardStartDateとrewardEndDateが両方ともnullの場合、rewardPercentは有効ではありません。rewardEndDateがnullの場合に限り、rewardPercentはrewardStartDateから有効になります。
salePrice	Decimal	いいえ	バリエーションのセール価格。セール対象でない場合は null。
salePriceEndDate	DateTime	いいえ	salePriceの有効期間が終了する時刻。UTC時間としてISO-8601 に従い、タイムゾーンオフセットなしでフォーマットしてください（例：2025-01-07T00:00:00）。salePriceStartDateとsalePriceEndDateが両方ともnullの場合、salePriceは有効ではありません。salePriceEndDateがnullの場合に限り、salePriceはsalePriceStartDateから有効になります。
salePriceStartDate	DateTime	いいえ	salePriceが有効になり始める時刻。UTC時間としてISO-8601 に従い、タイムゾーンオフセットなしでフォーマットしてください（例：2025-01-01T00:00:00）。salePriceStartDateとsalePriceEndDateが両方ともnullの場合、salePriceは有効ではありません。salePriceStartDateがnullの場合に限り、salePriceはsalePriceEndDateまで有効です。
webUrl	String	はい	プロダクトランディングページのURL。このページにはピクセルが実装されており、View Itemイベントが発生する必要があります。

注意

CSVデータ内のエントリに二重引用符（\"）が含まれている場合、それらを正しくエスケープしないとCSVパーサーでエラーが発生する可能性があります。二重引用符をエスケープするには、バックスラッシュ（\）をその前に付けます。例：

id,name,itemId…
v0001,Lee \"Scratch\" Perry,i001…
v1234,Never Say \"Never Again\",i987…
⋮