API Marketing

Inserzioni per lo shop

Le inserzioni per lo shop migliorano le prestazioni delle tue inserzioni indirizzando i clienti potenziali al tuo sito web o al tuo shop, a seconda di dove riteniamo che potrebbero effettuare un acquisto.

Prima di iniziare

Per creare una vendita dei prodotti del catalogo o un'inserzione per le conversioni usando la posizione della conversione "Sito web e shop", avrai bisogno di:

Passaggio 1: creazione di una campagna

Per iniziare, crea la tua campagna pubblicitaria con una richiesta POST per /act_{ad_account_id}/campaigns.

A questo livello, devi impostare il tuo obiettivo pubblicitario attraverso il campo dell'obiettivo. Per le inserzioni per lo shop, sono supportati gli obiettivi PRODUCT_CATALOG_SALES e CONVERSIONS per le esperienze non ODAX (esperienze pubblicitarie basate sui risultati) e l'obiettivo OUTCOME_SALES per le esperienze ODAX.

  • Per l'obiettivo PRODUCT_CATALOG_SALES, l'ID del catalogo prodotti è promoted_object. Tieni presente che il catalogo prodotti deve essere collegato a uno shop sul sito per essere idoneo alle inserzioni per lo shop.
  • Per l'obiettivo CONVERSIONS, il campo promoted_object non è obbligatorio.

Esempi di obiettivi non ODAX

Esempio di creazione di una campagna con l'obiettivo PRODUCT_CATALOG_SALES

curl \
  -F 'name=Product Catalog Sales Campaign' \
  -F 'objective=PRODUCT_CATALOG_SALES' \
  -F 'promoted_object={"product_catalog_id":"<PRODUCT_CATALOG_ID>"}' \
  -F 'status=PAUSED' \
  -F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/campaigns

Esempio di creazione di una campagna con l'obiettivo CONVERSIONS

curl \
  -F 'name=Conversion Campaign' \
  -F 'objective=CONVERSIONS' \
  -F 'status=PAUSED' \
  -F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/campaigns

Esempi di obiettivi ODAX

Esempio di creazione di una campagna PRODUCT_CATALOG_SALES con l'obiettivo OUTCOME_SALES

curl \
  -F 'name=Conversion Campaign' \
  -F 'objective=OUTCOME_SALES' \
  -F 'promoted_object={"product_catalog_id":"<PRODUCT_CATALOG_ID>"}' \
  -F 'status=PAUSED' \
  -F 'special_ad_categories=[]' \
  -F 'access_token=<ACCESS_TOKEN>' \ 
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/campaigns

Esempio di creazione di una campagna CONVERSIONS con l'obiettivo OUTCOME_SALES

curl \
  -F 'name=Conversion Campaign' \
  -F 'objective=OUTCOME_SALES' \
  -F 'status=PAUSED' \
  -F 'special_ad_categories=[]'
  -F 'access_token=<ACCESS_TOKEN>' \ 
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/campaigns

Passaggio 2: creazione di un gruppo di inserzioni

Per le inserzioni per lo shop, devi impostare il tipo di destinazione su SHOP_AUTOMATIC per il tuo gruppo di inserzioni.

  • Se l'obiettivo della campagna è impostato su PRODUCT_CATALOG_SALES, devi indicare un ID dell'insieme di prodotti in promoted_object per promuovere i prodotti di quell'insieme di prodotti.
  • Se l'oggetto della campagna è impostato su CONVERSIONS, imposta promoted_object come account per le vendite con acquisto sul sito abilitato.

Altri requisiti per le inserzioni per lo shop:

  • Le inserzioni per lo shop supportano solo PURCHASE come evento di conversione (CUSTOM_EVENT_TYPE) nell'insieme di prodotti (se l'obiettivo è PRODUCT_CATALOG_SALES) o nel pixel di Meta (se l'obiettivo è CONVERSIONS).
  • Le inserzioni per lo shop supportano solo l'ottimizzazione per le conversioni fuori dal sito (OFFSITE_CONVERSIONS come optimization_goal).
  • Le inserzioni per lo shop supportano solo una strategia di offerta senza alcun limite di costo.
  • Affinché le inserzioni per lo shop siano pubblicate per lo shop, la targetizzazione deve includere gruppi di pubblico nelle aree geografiche con assistenza per l'acquisto sul sito (al momento gli Stati Uniti).
  • Affinché le inserzioni per lo shop siano pubblicate per lo shop, il posizionamento deve includere almeno una piattaforma con assistenza per l'acquisto sul sito (attualmente, Facebook e Instagram).

Esempio di creazione di un gruppo di inserzioni per lo shop con una campagna con l'obiettivo PRODUCT_CATALOG_SALES fatturato per IMPRESSIONS

curl \
  -F 'name=Product Catalog Sales Adset' \
  -F 'bid_amount=3000' \
  -F 'billing_event=IMPRESSIONS' \
  -F 'daily_budget=15000' \
  -F 'bid_strategy=LOWEST_COST_WITHOUT_CAP' \
  -F 'campaign_id=<CAMPAIGN_ID>' \
  -F 'targeting={"geo_locations": {"countries":["US"]} }' \
  -F 'destination_type=SHOP_AUTOMATIC' \
  -F 'promoted_object={"product_set_id":"<PRODUCT_SET_ID>","custom_event_type": "PURCHASE"}' \
  -F 'status=PAUSED' \
  -F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adsets

Esempio di creazione di un gruppo di inserzioni per lo shop con una campagna con l'obiettivo CONVERSIONS fatturato per IMPRESSIONS

curl \
  -F 'name=Conversion Adset' \
  -F 'bid_amount=3000' \
  -F 'billing_event=IMPRESSIONS' \
  -F 'daily_budget=15000' \
  -F 'bid_strategy=LOWEST_COST_WITHOUT_CAP' \
  -F 'campaign_id=<CAMPAIGN_ID>' \
  -F 'targeting={"geo_locations": {"countries":["US"]}}' \
  -F 'destination_type=SHOP_AUTOMATIC' \
  -F 'promoted_object={"omnichannel_object":{"onsite":[{"commerce_merchant_settings_id":"<COMMERCE_ACCOUNT_ID>"}],
  "pixel":[{"pixel_id": "<PIXEL_ID>","custom_event_type": "PURCHASE"}]}}' \
  -F 'status=PAUSED' \
  -F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/act_<D_ACCOUNT_ID>/adsets

Passaggio 3: fornitura della creatività

I gruppi di inserzioni per lo shop ti permettono di creare:

Le inserzioni per lo shop non supportano i seguenti elementi:

  • Formati pubblicitari con immagini/video se l'obiettivo della campagna è PRODUCT_CATALOG_SALES
  • Formati pubblicitari raccolta
  • Call to action impostate per inviare messaggi a una Pagina, a Instagram o a WhatsApp
  • Destinazioni impostate su un'app, un evento o esperienze interattive se l'obiettivo è CONVERSIONS

Inserzioni carosello o inserzioni con immagini/video

Puoi creare un'inserzione carosello proprio come si creano le inserzioni che non riguardano lo shop. Se l'obiettivo della tua campagna è CONVERSIONS, puoi anche creare un'inserzione con immagini/video.

I valori page_id e/o instagram_actor_id specificati in object_story_spec devono avere almeno uno shop appartenente all'account per le vendite che hai scelto di promuovere nel tuo gruppo di inserzioni o al catalogo che hai scelto di promuovere nella tua campagna. Devono anche essere collegati allo stesso account per le vendite.

Inoltre, per le inserzioni per lo shop, devi specificare una destinazione sul sito come destinazione alternativa per la tua pagina di destinazione fuori dal sito. A tal fine, imposta il campo onsite_destination in asset_feed_spec della tua creatività.

La destinazione sul sito deve essere una delle seguenti:

  • Pagina della vetrina virtuale dello shop
    Lo shop deve appartenere all'account per le vendite che promuovi nel tuo gruppo di inserzioni.

  • Un insieme di prodotti
    L'insieme di prodotti deve appartenere al catalogo dell'account per le vendite che promuovi nel tuo gruppo di inserzioni e deve contenere almeno un prodotto visibile e disponibile.

  • Un prodotto
    Il prodotto deve appartenere al catalogo dell'account per le vendite che promuovi nel tuo gruppo di inserzioni.

Esempio di impostazione del campo onsite_destinations in asset_feed_spec sulla pagina della vetrina virtuale dello shop

asset_feed_spec= {
  "onsite_destinations": [
    {
      "storefront_shop_id": "<SHOP_STOREFRONT_ID>"
    }
  ]
}

Esempio di impostazione del campo onsite_destinations in asset_feed_spec sull'insieme di prodotti

asset_feed_spec= {
  "onsite_destinations": [
    {
      "shop_collection_product_set_id": "<PRODUCT_SET_ID>"
    }
  ]
}

Esempio di impostazione del campo onsite_destinations in asset_feed_spec su un prodotto specifico

asset_feed_spec= {
  "onsite_destinations": [
    {
      "details_page_product_id": "<PRODUCT_ID>"
    }
  ]
}

Esempio di creatività per un'inserzione con immagine

curl \
  -F 'name=Sample Creative' \
  -F 'asset_feed_spec= {
        "onsite_destinations": [
          {
            "storefront_shop_id": "<SHOP_STOREFRONT_ID>"
          }
        ]
      }' \
  -F 'object_story_spec={ 
    "link_data": { 
      "image_hash": "<IMAGE_HASH>", 
      "link": "<OFFSITE_LANDING_URL>", 
      "message": "try it out" 
    }, 
    "page_id": "<PAGE_ID>",
    "instagram_actor_id" : "<INSTAGRAM_ACTOR_ID>" 
  }' \
  -F 'degrees_of_freedom_spec={
      "creative_features_spec": {
        "standard_enhancements": {
          "enroll_status": "OPT_OUT"
        }
      }
    }' \ 
  -F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives

Inserzioni del catalogo Advantage+ con formato carosello

Per creare un'inserzione carosello per la promozione di prodotti di un insieme di prodotti, puoi consultare Primi passi con le inserzioni del catalogo Advantage+ - Passaggio 3: fornitura di una creatività dell'inserzione.

I valori page_id e/o instagram_actor_id specificati in object_story_spec devono avere almeno uno shop appartenente all'account per le vendite che hai scelto di promuovere nel tuo gruppo di inserzioni o al catalogo che hai scelto di promuovere nella tua campagna. Devono anche essere collegati allo stesso account per le vendite.

Per l'insieme di prodotti nella creatività:

  • Se stai configurando una campagna che ha PRODUCT_CATALOG_SALES come obiettivo, l'insieme di prodotti che scegli deve appartenere al catalogo che hai impostato nella tua campagna e deve corrispondere all'insieme di prodotti che scegli di promuovere nel tuo gruppo di inserzioni.
  • Se stai configurando una campagna che ha CONVERSIONS come obiettivo, l'insieme di prodotti che scegli deve appartenere al catalogo dell'account per le vendite che scegli di promuovere nel tuo gruppo di inserzioni.

Le funzioni aggiuntive supportate per le inserzioni per lo shop sono le ottimizzazioni per gli shop. Aggiungeremo automaticamente diverse ottimizzazioni alle tue inserzioni se riterremo che possano migliorare le prestazioni delle tue inserzioni. Per attivare questa opzione, imposta shops_bundle su true in asset_feed_spec nella tua creatività: l'opzione include sia i tag del prodotti automatizzati che i motivi per acquistare al momento, nonché altre potenziali ottimizzazioni in futuro.

Le ottimizzazioni dello shop attualmente supportate sono:

  • Tag automatizzati del prodotto: possiamo taggare automaticamente i prodotti nella tua inserzione. I tag dei prodotti rimandano le persone direttamente alla pagina del prodotto pertinente nel tuo shop.
  • Motivi per acquistare: possiamo mettere automaticamente in primo piano le informazioni sui prodotti del tuo shop, come "Spedizione gratuita", "Popolari" o "Poca disponibilità". Potremmo anche aggiungere un'offerta esistente che consente ai clienti di risparmiare su articoli selezionati nel tuo shop.

Per attivare i tag automatizzati dei prodotti, imposta automated_product_tags su true in template_data di object_story_spec. Per attivare i motivi per acquistare, imposta reasons_to_shop su true in asset_feed_spec della tue creatività.

Esempi di inserzioni carosello che promuovono un insieme di prodotti con l'attivazione di ottimizzazioni dello shop completamente automatizzate


Attivazione di shops_bundle

curl \
  -F 'name=Sample Creative' \
  -F 'product_set_id="<PRODUCT_SET_ID>"' \
  -F 'asset_feed_spec= {
        "shops_bundle": true
      }'\
  -F 'object_story_spec={ 
    "template_data": { 
      "call_to_action":  {
            "type": "SHOP_NOW"
          },
      "link": "<OFFSITE_LANDING_URL>",
      "multi_share_end_card": false,
      "name": "{{product.name}}"
    }, 
    "page_id": "<PAGE_ID>",
    "instagram_actor_id": "<INSTAGRAM_ACTOR_ID>" 
  }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives

Attivazione di automated_product_tags

curl \
  -F 'name=Sample Creative' \
  -F 'product_set_id="<PRODUCT_SET_ID>"' \
  -F 'object_story_spec={ 
    "template_data": {
      "automated_product_tags": true
      "call_to_action":  {
            "type": "SHOP_NOW"
          },
      "link": "<OFFSITE_LANDING_URL>",
      "multi_share_end_card": false,
      "name": "{{product.name}}"
    }, 
    "page_id": "<PAGE_ID>",
    "instagram_actor_id": "<INSTAGRAM_ACTOR_ID>"
  }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives

Attivazione di reasons_to_shop

curl \
  -F 'name=Sample Creative' \
  -F 'product_set_id="<PRODUCT_SET_ID>"' \
  -F 'asset_feed_spec= {
        "reasons_to_shop": true
      }'\
  -F 'object_story_spec={ 
    "template_data": { 
      "call_to_action":  {
            "type": "SHOP_NOW"
          },
      "link": "<OFFSITE_LANDING_URL>",
      "multi_share_end_card": false,
      "name": "{{product.name}}"
    }, 
    "page_id": "<PAGE_ID>",
    "instagram_actor_id": "<INSTAGRAM_ACTOR_ID>" 
  }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives

Nota:

  • Le inserzioni per lo shop non supportano le categorie per le inserzioni del catalogo Advantage+.
  • L'ottimizzazione automatica dei tag dei prodotti è supportata solo su Instagram.

Creatività per il catalogo Advantage+

Le inserzioni per lo shop supportano anche la creatività per il catalogo Advantage+. Questa funzione mostra creatività dell'inserzione e formati diversi ad account del Centro gestione account diversi, in base a ciò a cui è più probabile che rispondano.

Per configurare le tue creatività, puoi seguire le istruzioni in Creatività per il catalogo Advantage+ - Passaggio 3: inserimento della creatività dell'inserzione.

I valori page_id e/o instagram_actor_id specificati in object_story_spec devono avere almeno uno shop appartenente all'account per le vendite che hai scelto di promuovere nel tuo gruppo di inserzioni o al catalogo che hai scelto di promuovere nella tua campagna. Devono anche essere collegati allo stesso account per le vendite.

Per l'insieme di prodotti nella creatività:

  • Se stai configurando una campagna che ha PRODUCT_CATALOG_SALES come obiettivo, l'insieme di prodotti che scegli deve appartenere al catalogo che hai impostato nella tua campagna e deve corrispondere all'insieme di prodotti che scegli di promuovere nel tuo gruppo di inserzioni.
  • Se stai configurando una campagna che abbia CONVERSIONS come obiettivo, l'insieme di prodotti che scegli deve appartenere al catalogo dell'account per le vendite che scegli di promuovere nel tuo gruppo di inserzioni.

Esempio di creatività per il catalogo Advantage+

curl \
  -F 'name=Sample Creative' \
  -F 'product_set_id="<PRODUCT_SET_ID>"' \
  -F 'asset_feed_spec= {
    "optimization_type":"FORMAT_AUTOMATION",
    "ad_formats": ["CAROUSEL", "COLLECTION"],
    "images": [{"hash": "<CUSTOMIZED_IMAGE_HASH>"}],
    "descriptions": [{"text": "{{product.description}}", "From {{product.current_price}}", ...]
    } 
   }'\
  -F 'object_story_spec={ 
    "template_data": { 
      "call_to_action":  {
            "type": "SHOP_NOW"
          },
      "link": "<OFFSITE_LANDING_URL>",
      "multi_share_end_card": false,
      "name": "{{product.name}}"
    }, 
    "page_id": "<PAGE_ID>",
    “instagram_actor_id” : “<INSTAGRAM_ACTOR_ID>” 
  }' \
  -F 'degrees_of_freedom_spec={
      "creative_features_spec": {
        "standard_enhancements": {
          "enroll_status": "OPT_OUT"
        }
      }
    }' \ 
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives

Passaggio 4: creazione di un'inserzione

Infine, puoi creare un'inserzione che faccia riferimento a una creatività dell'inserzione.

curl \
-F 'status=PAUSED' \
-F 'name=Test' \
-F 'adset_id=<ADSET_ID>' \
-F 'creative= {
       "creative_id": "<CREATIVE_ID>"
    },
}' \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/ads

Inserzioni per lo shop in Advantage+ shopping campaign

Le inserzioni per lo shop sono supportate insieme alle Advantage+ shopping campaign, perché si ritiene che insieme possano migliorare ulteriormente le prestazioni.

Per creare un'Advantage+ shopping campaign con le inserzioni per lo shop, segui i passaggi descritti in Advantage+ shopping campaign - Passaggio 2: crea una campagna per creare prima una campagna.

Quando crei un gruppo di inserzioni per le Advantage+ shopping campaign con inserzioni per lo shop, analogamente alle sole inserzioni per lo shop, imposta destination_type su SHOP_AUTOMATIC e specifica il tuo account per le vendite in promoted_object.

curl \
  -F 'name=Advantage+ Shopping Adset' \
  -F 'bid_amount=3000' \
  -F 'billing_event=IMPRESSIONS' \
  -F 'daily_budget=15000' \
  -F 'bid_strategy=LOWEST_COST_WITHOUT_CAP' \
  -F 'campaign_id=<CAMPAIGN_ID>' \
  -F 'targeting={"geo_locations": {"countries":["US"]}}' \
  -F 'destination_type=SHOP_AUTOMATIC' \
  -F 'promoted_object={"omnichannel_object":{"onsite":[{"commerce_merchant_settings_id":"<COMMERCE_ACCOUNT_ID>"}],"pixel":[{"pixel_id": "<PIXEL_ID>","custom_event_type": "PURCHASE"}]}}' \
  -F 'status=PAUSED' \
  -F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adsets

Per saperne di più, consulta Ottimizzazione delle conversioni su più canali per Advantage+ shopping campaign.

Quando crei una creatività e un'inserzione per le Advantage+ shopping campaign con le inserzioni per lo shop, la procedura è uguale a quella delle sole inserzioni per lo shop. Per maggiori dettagli, consulta il Passaggio 3: fornitura della creatività qui sopra.

Idoneità alle vendite per le inserzioni per lo shop

Per ottenere ID pertinenti per le inserzioni per lo shop, devi ottenere l'autorizzazione catalog_management dal tuo cliente.

Per creare inserzioni per lo shop per una Pagina, la Pagina deve avere uno shop visibile sul sito. Lo puoi ottenere nel seguente modo:

curl -i -X GET \
"https://graph.facebook.com/v21.0/<PAGE_ID>/commerce_merchant_settings?fields=id,shops{id,fb_sales_channel{status,fb_page{id,name}},is_onsite_enabled,shop_status}&access_token=<PAGE_ACCESS_TOKEN>"

Esempio di risposta

{
  "id":"<commerce_account_id>",
  "shops": {
    "data": [
      {
        "fb_sales_channel": {
          "status": "STAGING",
          "fb_page": {
            "name": "Page 1",
            "id": "<page_id>"
          }
        },
        "id": "<shop_id_1>",
        "is_onsite_enabled": true,
        "shop_status": "INACTIVE"
      },
      {
        "fb_sales_channel": {
          "status": "ENABLED",
          "fb_page": {
            "name": "Page 2",
            "id": "<page_id>"
          }
        },
        "id": "<shop_id_2>",
        "is_onsite_enabled": true,
        "shop_status": "ACTIVE"
      }
    ],    
    // …
}

Per la Pagina con cui desideri creare inserzioni per lo shop, controlla che is_onsite_enabled sia impostato su true e che shop_status sia ACTIVE. In tal caso, potrai creare inserzioni per lo shop per la Pagina seguendo le istruzioni contenute nel resto di questa guida.

Ottieni gli ID delle vendite per la creazione di inserzioni per lo shop

Per creare un'inserzione per lo shop per una Pagina, ti occorrono:

Puoi ottenere l'ID dell'account per le vendite e l'ID dello shop eseguendo la richiesta precedente.

curl -i -X GET \
"https://graph.facebook.com/v21.0/<PAGE_ID>/commerce_merchant_settings?fields=id,shops{id,fb_sales_channel{fb_page{id,name}}}&access_token=<PAGE_ACCESS_TOKEN>"

Un account per le vendite potrebbe avere più shop: dovrai scegliere quello con la Pagina con cui vuoi creare inserzioni per lo shop.

Per l'ID del catalogo, l'ID dell'insieme di prodotti e l'ID del prodotto

curl -i -X GET \
"https://graph.facebook.com/v21.0/<PAGE_ID>/commerce_merchant_settings?fields=id,product_catalogs{id,product_sets}&access_token=<PAGE_ACCESS_TOKEN>"

Esempio di risposta

{
  "id": "<commerce_account_id>",
  "product_catalogs": {
    "data": [
      {
        "id": "<product_catalog_id>",
        "product_sets": {
          "data": [
            {
              "id": "<product_set_id>",
              "name": "Product Set 1",
              "filter": "{\"product_item_id\":{\"is_any\":[]}}"
            },
          ],
        }
      }
    ]
  }
}