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

グロッサリー

用語	定義
カタログ（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を使用して別のバリエーションが存在する場合は無視されます
categoryId	整数	はい	GoogleカテゴリーID
description	String	はい	バリエーションの簡単な説明
gender	String	いいえ	FEMALE、MALE、またはUNISEXのいずれか
id	String	はい	バリエーションのID。これはピクセル内のitem_variant_idと一致しなければなりません。
isAvailable	Boolean	はい	バリエーションが利用可能か在庫切れか
isBundle	Boolean	はい	バリエーションが複数の商品をまとめて販売するセット商品であるかどうか
itemId	String	はい	アイテムのバリエーション全体で共有されるID。これはピクセルのitem_idと一致しなければなりません。
multipackQuantity	Number	いいえ	1パックに含まれる同一のアイテムの数
name	String	はい	バリエーションの名前
numberOfReviews	Number	いいえ	バリエーションのレビュー数の合計
price	Decimal	はい	バリエーションの価格
primaryImageUrl	String	はい	バリアントに関連付けられたメイン画像。デフォルトでは、バリアントが表示される際にこの画像が表示されます。有効な拡張子は.jpg、.jpeg、および.pngです。
primaryVideoUrl	String	いいえ	バリアントに関連付けられたビデオ画像。デフォルトでは、バリアントが表示される際にこの画像が表示されます。有効な拡張子はmp4です。
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イベントが発生する必要があります。