Meta kataloğunda varyantlar, item_group_id ve ürün kimliği eşleşmesi

Meta'ya göre varyantlar, kataloğunuzdaki aynı ürünün farklı biçimleridir. Kırmızı ve mavi renklerde, küçük ve büyük bedenlerde satılan bir tişört dört varyanttan oluşur: kırmızı-küçük, kırmızı-büyük, mavi-küçük ve mavi-büyük [1]. Katalog açısından bunun anlamı şudur: her varyant kendi başına bir ürün satırıdır ve bu satırları bir grup kimliği birbirine bağlar.

İki düzey: ürün kimliği ve grup kimliği

Veri akışında her ürün satırının id alanı, o ürünün benzersiz içerik kimliğidir (content ID). Meta mümkünse stok kodunun (SKU) kullanılmasını önerir, alan en fazla 100 karakter olabilir ve her içerik kimliği katalogda yalnızca bir kez geçmelidir [3]. Bu son kuralın sonucu sert: aynı kimlikten birden fazla varsa Meta bu kimliğe sahip satırların tümünü yok sayar [3]. Kimlikler büyük/küçük harfe duyarlıdır; "abc123" ve "ABC123" iki ayrı ürün sayılır [7].

Varyantları gruplamak için item_group_id kullanılır: aynı ürünün tüm varyantlarına aynı grup kimliği yazılır [2][3]. Meta'nın geliştirici belgeleri bu değerin genellikle ana ürünün stok koduna karşılık geldiğini, ancak başka bir kimliğin de kullanılabileceğini belirtir [4]. Toplu API referansı da item_group_id alanını, reklamverenin verdiği bir ürün grubu kimliği olarak tanımlar ve bunun Meta'nın kendi kimliği (FBID) olmadığını vurgular [6].

Sık görülen bir hata, bir ürünün id değerinin başka ürünlerde grup kimliği olarak da kullanılmasıdır. Meta bunu "ID conflicts with group ID" sorunu olarak gösterir: katalogdaki tüm içerik kimlikleri ve grup kimlikleri birbirinden farklı olmalıdır [7].

Varyantları doğru ayırmak

Meta, bir gruptaki varyantların en az bir varyant özelliğiyle ayrılmasını ister: color, size, material, pattern, gender veya additional_variant_attribute [2]. Bir varyantta hangi özellikleri doldurduysanız gruptaki tüm varyantlarda aynılarını doldurmanız ve her varyantın benzersiz bir kombinasyona sahip olması gerekir [2]. Yalnızca farklı bir görsel, varyantı ayırt etmek için yeterli değildir [2]. Aynı ürünün tüm varyantları aynı veri akışında bulunmalıdır [2].

Reklamlarda her üründen yalnızca bir varyant gösterilir ve hangisinin gösterileceğini reklam teslim sistemi seçer; kişi ürüne tıkladığında diğer varyantları ürün sayfasında görür [1].

Farklı yüzeylerde kimlik alanları

Kimlikler farklı yüzeylerde farklı alan adlarıyla geçer:

• Veri akışında ve katalog toplu API'sinde (items_batch) alan adı id'dir [3][6].
• Toplu API'nin yanıtındaki doğrulama durumlarında satırlar retailer_id ile tanımlanır [6]. Graph API'deki ürün öğesinde (Product Item) retailer_id, "bu öğe için (bir ürünün varyantı olabilecek) benzersiz tanımlayıcı" olarak açıklanır; retailer_product_group_id ise öğenin varyantı olduğu grup kimliğidir [5].
• Aynı ürün öğesinin ayrıca Meta tarafından atanan, sayısal bir id değeri vardır [5]. Bu değer sizin kimliğiniz değildir; eşleştirmede kullanılan, sizin verdiğiniz kimliktir.

Piksel olaylarıyla eşleşme

Advantage+ katalog reklamları için Meta pikselinin ViewContent, AddToCart ve Purchase olaylarını göndermesi gerekir. Bu olaylarda content_ids (ya da contents) parametresi, katalogdaki bir ürünün id değerini veya bir ürün grubunun item_group_id değerini taşır [8]. Katalog referansı da açıktır: bu kimlik, Meta Pikselindeki içerik kimliğiyle birebir eşleşmelidir [3].

content_type parametresi isteğe bağlıdır, ancak gönderiliyorsa kimlik türüyle uyumlu olmalıdır: tek tek ürün kimlikleri için product, grup kimlikleri için product_group [9][11]. Meta, belirli bir varyantın (beden, renk) sayfasında product; henüz beden seçilmemiş bir ürün sayfasında product_group kullanılmasını önerir. AddToCart ve Purchase olaylarında product_group kullanılmamalıdır [9]. content_type gönderilmezse Meta olayı, türünden bağımsız olarak aynı kimliğe sahip tüm öğelerle eşleştirir [9].

Eşleşmenin ne kadar sağlıklı olduğunu katalog eşleşme oranı gösterir: olaylarda gelen içerik kimliklerinden bağlı katalogdaki ürünlerle eşleşenlerin oranı [10]. Aynı piksele birden fazla katalog bağlıysa oran kataloglar arasında bölünür [10]. Oran son 28 günü kapsar ve 48 saat gecikmeyle güncellenir [11]. Meta'nın sıraladığı biçim hatalarından bazıları: parametre adını content_id (sonunda "s" olmadan) yazmak ya da birden fazla kimliği tek bir metin içinde göndermek; örneğin ['12345,67890'] tek bir ürün kimliği olarak yorumlanır [11].

Shopify'da durum

Meta, Shopify'ı veri akışıyla birlikte kullanan ileri düzey kurulum için şunu söyler: ürünlerin doğru eşleşmesi için akışın id alanında her ürünün Shopify'daki varyant kimliği kullanılmalıdır [12].

Kimlik değiştirmeden önce

Meta, mevcut bir ürüne varyant eklerken varyantlardan birinin ürünün özgün id değerini korumasını önerir; aksi hâlde o ürün için toplanan piksel verisi korunmaz ve reklam performansı olumsuz etkilenebilir [2]. Grup kimliklerini değiştirirseniz ve pikseliniz grup kimliği gönderiyorsa, piksel kodundaki değerleri de güncellemeniz gerekir [7].