Introduzione al DDEX di Meta

Il pubblico a cui è rivolto questo documento è costituito da partner musicali che usano Rights Manager per la musica di Meta (RM4M) per gestire i propri contenuti. Questi partner musicali di solito vogliono eseguire una o entrambe le seguenti azioni:

  • gestire i diritti per le registrazioni audio e i riferimenti ai video musicali tramite Rights Manager di Meta;
  • gestire le registrazioni audio disponibili nella Libreria audio di Meta.
Meta supporta la versione 4.2 dello standard Electronic Release Notification (ERN) DDEX. Se un partner musicale non è in grado di fornire i metadati usando ERN 4.2, Meta può anche accettare la versione 3.8.3. Questo documento descrive i requisiti specifici per il feed DDEX di Meta. Tutti gli elenchi forniti a Meta dovrebbero seguire il profilo Audio Album o il profilo Single Resource Release (SRR), come pubblicato da DDEX.

La specifica ERN richiede che questi cinque elementi di alto livello siano presenti in ogni messaggio XML:

  • <MessageHeader> fornisce informazioni sul messaggio stesso: un numero di identificazione unico, il mittente, il destinatario e una marca temporale.
  • <PartyList> fornisce informazioni su tutte le entità coinvolte nella creazione dell'opera musicale: artisti, compositori, etichette, ecc.
  • <ResourceList> contiene i dettagli sulle registrazioni audio, sui riferimenti ai video musicali e su qualsiasi immagine associata.
  • <ReleaseList> definisce le pubblicazioni che possono essere effettuate dalle risorse in questo messaggio.
  • <DealList> definisce le informazioni commerciali chiave per ogni rilascio, come le aree geografiche in cui la distribuzione sarà resa disponibile, i diritti di utilizzo e la data di inizio di ogni rilascio.
In conformità alla convenzione DDEX, il nome del file del messaggio XML deve includere un identificativo univoco di distribuzione per la risorsa (Album o Single Resource Release). L'ID della pubblicazione è l'UPC, l'EAN o il GRid fornito all'interno dell'elemento <ReleaseId>. L'elemento <ReleaseId> non è obbligatorio per il feed SRR.

ERN Choreography

Per la trasmissione dei dati, Meta supporta il profilo SFTP batch come definito nella versione 6.1 dell'ERN Choreography Standard DDEX. Questa coreografia del profilo batch si applica anche alla consegna tramite S3.

  • Il trigger per indicare che un batch ha terminato il caricamento è un file semaforo a zero byte. Il nome di questo file deve essere la stringa BatchComplete_ seguita da BatchId e dall'estensione del file .xml.
  • Consigliamo di limitare il numero di tracce audio per batch a un massimo di 200.
  • Per la pubblicazione di riferimenti di video musicali, consigliamo di pubblicare un video per batch.
  • Il prefisso dell'indicatore di priorità non è al momento supportato. I batch vengono inseriti in ordine di ID Batch.

Un esempio semplificato della coreografia di batch accettata per la pubblicazione di un prodotto audio è il seguente:

/20231001123000000 {batch folder}
--/888012345678 {release_id folder}
----/resources
------888012345678_1_1.flac
------888012345678_1_2.flac
------888012345678.jpg
----888012345678.xml
--BatchComplete_20231001123000000.xml

Messaggi di conferma

Meta supporta i messaggi di conferma ERN (ACK). Questi messaggi seguono il Choreography Standard 6.1 e ti consentiranno di avere una comprensione molto più accurata e tempestiva dello stato di pubblicazione dei tuoi contenuti.

Le chiamate standard prevedono il posizionamento di tutti i file ACK in un'unica cartella /acknowledgements presente alla radice della posizione di consegna.

Tutti i file saranno denominati come segue: ACK_ErnMessageId_YYYYMMDDhhmmssnnn.xml

  • ErnMessageID è il valore MessageId all'interno del file XML che ci consegni insieme al rilascio.
  • YYYYMMDDhhmmssnnn è la marca temporale in cui il file ACK viene inserito nella cartella /acknowledgements.

Al momento supportiamo la comunicazione di due diversi stati ACK:

  • SuccessfullyIngestedByReleaseDistributor: indica che "Una distribuzione è stata inserita correttamente dal ReleaseDistributor".
  • ProcessingErrorAtReleaseDistributor: indica che "Il ReleaseDistributor ha riscontrato un errore di elaborazione in relazione alla distribuzione". Con ogni errore, includeremo una breve descrizione del problema specifico all'interno del campo ErrorText.

Il nostro obiettivo è che tutti i messaggi ACK vengano depositati nella cartella /acknowledgements entro 3 ore dalla consegna del prodotto che dev'essere confermato. I partner che desiderano elaborare questi messaggi devono rimuoverli non appena l'elaborazione è stata completata. Meta rimuoverà tutti i messaggi non elaborati circa 7 giorni dopo la consegna.

Selezione di un profilo di distribuzione

Meta_SRP - PADPIDA2013071501L
Meta_AAP - PADPIDA2018010804X

Meta supporta due profili di pubblicazione. Ciascuno ha uno scopo diverso.

Profilo Single Resource Release: questo profilo viene utilizzato per fornire (a.) diritti di proprietà delle registrazioni audio per singola traccia per le impronte audio oppure (b.) diritti di proprietà dei video musicali per singolo video per le impronte video. Meta non usa metadati a livello di album da questo feed.

Per le pubblicazioni di registrazioni audio che utilizzano un feed Single Resource, tutte le distribuzioni in <ReleaseList> devono avere un ReleaseType di SingleResourceRelease. Inoltre, l'elemento <SoundRecordingId> in <ResourceList> deve contenere un tag <ISRC>.

Per le pubblicazioni di video musicali, tutte le distribuzioni nel <ReleaseList> devono avere un ReleaseType di VideoSingle. Inoltre, l'elemento <VideoId> in <ResourceList> deve contenere un tag <ISRC>.

Profilo Audio Album: il profilo Audio Album è usato per pubblicare distribuzioni audio con traccia completa e metadati di distribuzione. Questo è l'unico profilo che può essere usato per rendere i contenuti disponibili nella suite di prodotti della libreria audio di Meta (ad es. Facebook Reels, Instagram Stories).

Ogni feed Audio Album deve contenere due tipi di distribuzione:

  • Almeno una distribuzione a livello di prodotto con un <ReleaseType> di:
    • Album
    • Single
    • EP
    • ClassicalAlbum
    • DigitalBoxSetRelease
    • Definito dall'utente: UserDefinedValue="Mini Album"
    • Definito dall'utente: UserDefinedValye="Double Album"
  • Per ogni traccia, una distribuzione con <ReleaseType> di TrackRelease.

Se pubblichi i tuoi contenuti con diritti di impronta digitale e diritti della Libreria audio in un singolo feed Audio Album:

  • Le informazioni sulla proprietà dei diritti per una determinata registrazione audio devono essere associate a una sola distribuzione. Tutti i messaggi futuri contenenti informazioni sulla proprietà dei diritti per quella registrazione audio saranno trattati come aggiornamenti e pertanto sovrascriveranno i messaggi precedenti.
  • Devi consegnare entrambi i PartyID di Meta nel <MessageHeader> come <MessageRecipient> singoli. Di seguito è riportato un esempio.

Prima della pubblicazione

1. Configura il tuo account

Iscriviti a Rights Manager e contatta il rappresentante partner. Il rappresentante partner creerà il tuo account e configurerà il luogo di pubblicazione (S3 o SFTP) per la pubblicazione dei tuoi contenuti.

Fornisci il tuo Party ID DDEX al rappresentante partner. Se non disponi di un Party ID DDEX, puoi richiederne uno all'indirizzo http://dpid.ddex.net.

2. Leggi la Normativa di riferimento per le registrazioni audio di Meta

Partecipando a Rights Manager, dichiari che la tua organizzazione possiede e/o controlla i diritti esclusivi per i contenuti che includi in Rights Manager nei territori in cui li hai pubblicati. I riferimenti caricati su Rights Manager e/o offerti nei prodotti musicali di Facebook/Instagram devono inoltre rispettare tutti i seguenti standard relativi ai contenuti.

I riferimenti devono essere sufficientemente distinti da altri riferimenti. I riferimenti che difficilmente risulteranno sufficientemente distinti includono, ma non sono limitati a:

  • loop di produzione;
  • soundbed;
  • effetti sonori;
  • imitazioni sonore;
  • registrazioni per il karaoke;
  • registrazioni di composizioni di musica classica di dominio pubblico;
  • musica per meditazione, yoga o rilassamento;
  • DJ set, mix continui o altre raccolte simili .
I riferimenti devono essere contenuti musicali. I riferimenti che difficilmente saranno considerati contenuti musicali includono, ma non sono limitati a:

  • registrazioni di parole pronunciate;
  • registrazioni di sketch comici;
  • registrazioni tratte da film (diverse dalla colonna sonora di un film) ;
  • discorsi;
  • registrazioni di preghiere;
  • audiolibri;
  • podcast;
  • registrazioni di natura o fauna selvatica;
  • registrazioni di suoni ambientali.

PUBBLICA SOLO CONTENUTI CHE SODDISFANO QUESTI STANDARD. I riferimenti caricati su Rights Manager e/o offerti nei prodotti musicali di Facebook/Instagram che non rispettano questi standard possono essere eliminati del tutto e/o bloccati senza preavviso per impedirne l'associazione ai contenuti degli utenti.

Come per tutti i contenuti caricati su Facebook e Instagram, si applicano gli Standard della community pertinenti.

3. Invia file di test e convalida i casi applicabili

Esegui un test sia il profilo Single Resource Release che per il profilo Audio Album. Di seguito sono riportate istruzioni dettagliate per ciascun profilo. Per garantire un'acquisizione senza interruzioni, i batch audio non devono contenere più di 200 tracce, mentre i batch video devono contenere un video per batch.

  1. Crea una cartella all'interno della posizione di pubblicazione denominata per il Batch ID (marca temporale in formato YYYYMMDDhhmmssnnn).
  2. Carica i contenuti del test in questa cartella del batch.
  3. Dopo aver completato il caricamento di tutti i file per il test, crea un file di 0 kb il cui nome inizia con la stringa BatchComplete_, seguita dalla stessa marca temporale dell'ID Batch e, infine, dall'estensione del file .xml. La presenza di questo file indica a Meta che il batch è pronto per il download e l'elaborazione.

4. Controlla i batch di test

Dopo aver caricato i batch di test, collabora con il rappresentante partner per controllare i risultati e risolvere eventuali problemi nella coreografia di pubblicazione o nella creazione di file XML.

5. Completa i test end-to-end

Una volta che i batch di test risultano corretti, pubblica circa 10 distribuzioni del profilo Album e/o 10 distribuzioni video/con risorsa singola per il test end-to-end. Se l'inserimento avviene senza errori, il rappresentante partner chiederà che venga pubblicato il tuo catalogo completo.

Intestazione del messaggio

L'intestazione identifica sia il mittente (tu) sia il destinatario (Meta) in base al Party ID DDEX unico del mittente (DPid).

<MessageHeader>
    <MessageThreadId>1</MessageThreadId>
    <MessageId>9543BD3607862A82E04400144FEAB9A6</MessageId>
    <MessageSender>
        <PartyId>PADPIDAXXXXXXXXXXX</PartyId>
        <PartyName>
            <FullName>Example Rights Holder</FullName>
        </PartyName>
    </MessageSender>
    <MessageRecipient>
        <PartyId>PADPIDA2013071501L</PartyId>
        <PartyName>
            <FullName>Meta_SRP</FullName>
        </PartyName>
    </MessageRecipient>
    <MessageCreatedDateTime>2023-09-01T18:05:17.631Z</MessageCreatedDateTime>
    <MessageControlType>LiveMessage</MessageControlType>
</MessageHeader>

Se agisci in qualità di distributore e hai intenzione di pubblicare registrazioni audio o riferimenti a video musicali per terzi, usa l'elemento <SentOnBehalfOf> per fornire il DPid dei terzi. Nota: tali terzi dovranno disporre di un proprio contratto di licenza per i contenuti con Meta.

<MessageHeader>
    <MessageThreadId>1</MessageThreadId>
    <MessageId>9543BD3607862A82E04400144FEAB9A6</MessageId>
    <MessageSender>
        <PartyId>PADPIDAXXXXXXXXXXX</PartyId>
        <PartyName>
            <FullName>Example Distributor</FullName>
        </PartyName>
    </MessageSender>
    <SentOnBehalfOf>
        <PartyId>PADPIDAYYYYYYYYYYY</PartyId>
        <PartyName>
            <FullName>Example Rights Holder</FullName>
        </PartyName>
    </SentOnBehalfOf>
    <MessageRecipient>
        <PartyId>PADPIDA2013071501L</PartyId>
        <PartyName>
            <FullName>Meta_SRP</FullName>
        </PartyName>
    </MessageRecipient>
    <MessageCreatedDateTime>2023-02-03T09:57:14Z</MessageCreatedDateTime>
</MessageHeader>

Se stai pubblicando contenuti per finalità di impronta audio e raccolta di audio, fornisci entrambi i DPid di Meta nel <MessageHeader> come <MessageRecipient> singoli.

<MessageHeader>
    <MessageThreadId>1</MessageThreadId>
    <MessageId>9543BD3607862A82E04400144FEAB9A6</MessageId>
    <MessageSender>
        <PartyId>PADPIDAXXXXXXXXXXX</PartyId>
        <PartyName>
            <FullName>Example Distributor</FullName>
        </PartyName>
    </MessageSender>
    <SentOnBehalfOf>
        <PartyId>PADPIDAYYYYYYYYYYY</PartyId>
        <PartyName>
            <FullName>Example Rights Holder</FullName>
        </PartyName>
    </SentOnBehalfOf>
    <MessageRecipient>
        <PartyId>PADPIDA2013071501L</PartyId>
        <PartyName>
            <FullName>Meta_SRP</FullName>
        </PartyName>
    </MessageRecipient>
    <MessageRecipient>
        <PartyId>PADPIDA2018010804X</PartyId>
        <PartyName>
            <FullName>Meta_AAP</FullName>
        </PartyName>
    </MessageRecipient>
    <MessageCreatedDateTime>2017-02-03T09:57:14Z</MessageCreatedDateTime>
</MessageHeader>

Lista delle risorse

Il <ResourceList> contiene i dettagli relativi alle registrazioni audio o ai video musicali (risorse principali) e alle immagini (risorse secondarie) che compongono la pubblicazione. In un Audio Album con 10 tracce, ad esempio, i riferimenti alle risorse da A1 ad A10 sono le registrazioni audio, mentre A11 è la copertina dell'album. I feed Single Resource Release non devono contenere alcun elemento grafico.

ID delle registrazioni audio

Meta richiede che ogni elemento <SoundRecording> includa un codice ISRC valido.

<SoundRecording>
  <ResourceReference>A1</ResourceReference>
  <Type>MusicalWorkSoundRecording</Type>
  <ResourceId>
     <ISRC>USRE50702485</ISRC>
  </ResourceId>
  <DisplayTitleText>...

ID dei video

Meta richiede che ogni elemento <Video> includa un codice ISRC valido. Questo dovrebbe essere l'ISRC del video stesso, non della registrazione audio sottostante.

<Video>
  <ResourceReference>A1</ResourceReference>
  <Type>ShortFormMusicalWorkVideo</Type>
  <ResourceId>
    <ISRC>USVD35482355</ISRC>
  </ResourceId>
  <DisplayTitleText>...

Metadati delle registrazioni audio e dei video musicali

Per le linee guida su come popolare i metadati della registrazione audio e/o del video musicale, consulta la Music Metadata Style Guide v2.1 della Music Business Association.

Pubblicazione delle informazioni relative agli artisti

ID artista

Ogni artista deve avere un numero di identificazione associato. Lo standard ERN prevede che venga fornito almeno un identificatore, ma consente l'aggiunta di più identificatori per ciascun artista. Ogni identificatore può essere un International Standard Name Identifier (ISNI), un identificatore proprietario o un ID Meta.

  1. ID interno: questi ID vengono creati da un titolare dei diritti (etichetta/distributore), generalmente per uso interno.
  2. Esempio: <PartyId Namespace="DPID:PADPIDXXXXXXXXXXXXX">12345</PartyId>

  3. ID esterno: si tratta di identificatori globali associati a un artista, ad esempio il codice ISNI.
  4. Esempio: <PartyId IsISNI="true">0000000123456789</PartyId>

  5. ID Meta: questi ID vengono creati da Meta. Abbiamo assegnato uno di questi ID a ogni artista disponibile nel nostro sistema. Dopo la pubblicazione del catalogo completo, genereremo (e condivideremo) un file CSV contenente questi ID insieme alle informazioni relative al nome dell'artista associato. Questo file includerà:
    • ISRC
    • Nome dell'artista
    • ID Meta

Gli aggiornamenti XML possono quindi essere inviati per il backfill di qualsiasi ID disponibile nel catalogo di un partner. Fornisci quindi l'ID Meta con il Party ID applicabile. Ad esempio:

Profilo Single Release di Facebook (feed Impronta digitale):
  • <PartyId Namespace="DPID:PADPIDA2013071501L">123123456456</PartyId>
Profilo Audio Album di Facebook (feed Libreria di effetti audio):
  • <PartyId Namespace="DPID:PADPIDA2018010804X">123123456456</PartyId>

URL del profilo dell'artista

ERN4.2 consente anche di fornire l'URL della pagina di un artista. Può essere la pagina di un profilo Facebook, un nome utente Instagram o entrambi.

Ecco un esempio contenente i dettagli di come dovrebbe apparire:

<Party>
  <PartyReference>PArtist1</PartyReference>
  <PartyName>
    <FullName>Great Artist</FullName>
  </PartyName>
  <PartyId>
    <ISNI>0000000045871863</ISNI>  <!-- ISNI value -->
    <ProprietaryId Namespace="PADPIDA9999999999Z">100123</ProprietaryId>  <!-- External ID -->
    <ProprietaryId Namespace="PADPIDA2018010804X">181077133824492</ProprietaryId>  <!-- Internal Meta ID -->
  </PartyId>
  <ArtistProfilePage>https://www.facebook.com/GreatArtist</ArtistProfilePage>
  <ArtistProfilePage>https://www.instagram.com/greatartistofficial</ArtistProfilePage>
</Party>

Traduzioni

Meta supporta l'inserimento di dati relativi ad artisti, album e traduzione delle tracce. Questi dati vengono usati per contribuire a definire il nostro algoritmo di ricerca e altre implementazioni del prodotto. Se fornito, gli utenti che hanno impostato i propri dispositivi su una lingua specifica vedranno la versione in quella lingua del nome dell'artista o del titolo della traccia nei risultati di ricerca e nel prodotto. Per fornire questi dati, utilizza l'elemento LanguageAndScriptCode con TitleType="TranslatedTitle", annotando la lingua della traduzione, e aggiungilo agli elementi SoundRecording e Release.

Esempio:

<SoundRecording>
  ...
  <DisplayTitleText>Example Title (Live)</DisplayTitleText>
  <DisplayTitle ApplicableTerritoryCode="WorldWide" IsDefault="True">
    <TitleText>Example Title (Live)</TitleText>
  </DisplayTitle>
  <DisplayTitle LanguageAndScriptCode="ja-Jpan" ApplicableTerritoryCode="Worldwide">
    <TitleText>例題 (生で)</TitleText>
  </DisplayTitle>
  <DisplayTitle LanguageAndScriptCode="ja-Latn" ApplicableTerritoryCode="Worldwide">
    <TitleText>エグザーンプル・タイタル (リブ)</TitleText>
  </DisplayTitle>
    ...
</SoundRecording>

Proprietà delle registrazioni audio e dei video musicali

La proprietà delle registrazioni audio e/o dei video musicali viene applicata utilizzando il tag <ResourceRightsController>. L'esempio seguente specifica che Example Rights Holder possiede la registrazione audio in Canada e Messico. Il <PartyId> deve essere impostato sul DPID del detentore dei diritti.

Sono supportati solo i valori 0.0 e 100.0 per il tag <RightSharePercentage>, dove 100.0 indica che detieni la proprietà nei rispettivi territori e 0.0 indica che non la detieni. Ti consigliamo di impostare inizialmente il valore su 100.0 e di impostarlo su 0.0 in caso di rimozione di territori. Se <RightSharePercentage> viene omesso, si presuppone sia 100.0.

<ResourceList>
    <SoundRecording>
      <ResourceReference>A1</ResourceReference>
      ...
      <ResourceRightsController>
        <RightsControllerPartyReference>PRightsHolder</RightsControllerPartyReference>
          <RightsControlType>RightsController</RightsControlType>
          <RightSharePercentage>100.00</RightSharePercentage>
          <DelegatedUsageRights>
            <UseType>UserMakeAvailableUserProvided</UseType>
          </DelegatedUsageRights>
      </ResourceRightsController>
      ...
    </SoundRecording>
</ResourceList>

Registrazione audio tecnica e dettagli delle immagini e dei video

Per consentire la più alta probabilità di corrispondenza dei contenuti generati dagli utenti, nonché la massima qualità audio dei prodotti della nostra Libreria di audio, Meta richiede che tutte le registrazioni audio siano pubblicate in formato FLAC, con una frequenza di campionamento di almeno 44,1kHz e una risoluzione di 16bit. Sono accettate anche qualità superiori.

I contenuti video musicali pubblicati ai fini della protezione del diritto d'autore devono avere la massima qualità possibile per il provider. Ciò include, a titolo esemplificativo, le seguenti condizioni:

  • I video devono essere pubblicati con la frequenza dei fotogrammi originale.
    • I video originariamente progressivi non devono essere interlacciati al momento della pubblicazione.
    • I video originariamente interlacciati devono essere pubblicati allo stesso modo.
    • Non sono consentiti contenuti telecinema o contrassegni a discesa.
    • Le dimensioni dei video non devono essere aumentate.
  • I contenuti devono essere pubblicati nelle proporzioni originali.
  • I contenuti devono essere pubblicati nel formato di archivio originale. Ad esempio, una risorsa archiviata come streaming MPEG-2 PS non può essere usata per generare una risorsa ProRes o viceversa.

Le immagini devono essere pubblicate in formato JPG o PNG, con la massima qualità disponibile. Tuttavia, le immagini non possono superare gli 85 milioni di pixel. Ciò significa che, per le immagini quadrate, se le dimensioni superano i 9200x9200 pixel, il prodotto non verrà inserito.

Lista delle distribuzioni

Profilo Single Resource Release

Una pubblicazione completa di un prodotto con risorsa singola che include un messaggio XML ERN, un file audio e le condizioni dell'offerta applicabili.

  • Imposta <ReleaseType> su SingleResourceRelease

Profilo Audio Album

Comunicazione della sequenza delle tracce

Come descritto in DDEX KB, usa <ResourceGroup> per comunicare la sequenza delle tracce usando <ResourceGroupContentItem> accompagnato da <ResourceType> impostato su SoundRecording.

Casi d'uso

Nuovo album completo

Una pubblicazione completa di un album, inclusi il messaggio XML ERN, i file audio, i file degli elementi grafici e le condizioni dell'offerta applicabili.

  • Imposta <ReleaseType> su Album
  • <ReleaseResourceReferenceList>dovrebbe fare riferimento a tutte le risorse audio e le immagini degli album pubblicate.

Nuovo singolo completo (distribuzione)

Una pubblicazione completa di un singolo, inclusi il messaggio XML ERN, i file audio, i file degli elementi grafici e le condizioni dell'offerta applicabili.

  • Imposta <ReleaseType> su Single

Nuovo multidisco completo

Una pubblicazione completa di un multidisco, inclusi il messaggio XML ERN, i file audio, i file degli elementi grafici e le condizioni dell'offerta applicabili.

  • Imposta <ReleaseType> su Album
  • La distribuzione principale deve contenere più <ResourceGroup>, ciascuna con un <SequenceNumber> corrispondente ai vari dischi.

Aggiornamento completo

Un aggiornamento completo, con nuovi file audio o immagine e il messaggio ERN XML aggiornato.

  • Aggiorna sia l'ID del messaggio sia la marca temporale.
  • Le somme hash dei file devono essere diverse da quelle di qualsiasi pubblicazione precedente.
  • Fornisci aggiornamenti aggiuntivi dei metadati, se necessario.

Aggiornamento dei metadati delle tracce

Un aggiornamento solo di metadati, con i file multimediali noninclusi e a cui non si fa riferimento nel messaggio XML ERN.

Meta supporta solo gli aggiornamenti dei metadati completi. Devi includere tutti i metadati delle tracce, inclusi i valori che non hanno subito modifiche. L'ultimo aggiornamento dei metadati avrà sempre la precedenza (ovvero, i metadati forniti in precedenza saranno sovrascritti).

  • Rimuovi la sezione <TechnicalSoundRecordingDetails> e <TechnicalImageDetails> per ciascuna risorsa, poiché i file non sono inclusi.
  • Un errore comune consiste nel rimuovere l'intero blocco <Image>, anziché solo la sezione <TechnicalImageDetails> al suo interno, e nel rimuovere tutti i riferimenti a esso associati. Ciò comporta l'effetto indesiderato di rimuovere completamente l'elemento grafico dall'album.

Audio accettato ReleaseType

Profilo Single Resource Release Profilo Audio Album
SingleResourceReleaseAlbum
Singolo
TrackRelease
VideoTrackRelease
EP
ClassicalAlbum
DigitalBoxSetRelease
UserDefined: UserDefinedValue="Mini Album"
UserDefined: UserDefinedValue="Double Album"
UserDefined: UserDefinedValue="Snippet"
Se un prodotto che non contiene nessuno dei ReleaseType precedenti viene pubblicato su Meta, non riuscirà a essere elaborato dal sistema.

Profilo Music Video

La lista di <ReleaseType> accettati è composta da VideoSingle e VideoTrackRelease . Se un prodotto che non contiene i <ReleaseType> precedenti viene pubblicato su Meta, non verrà elaborato correttamente dal sistema.

Casi d'uso

Video completo: una pubblicazione di un singolo prodotto completa di file XML, file video, file degli elementi grafici e condizioni dell'offerta.

  • Imposta <ReleaseType> su VideoSingle.

Aggiornamento risorsa + metadati: un aggiornamento completo con un nuovo file video e un file XML aggiornato.

  • Aggiorna sia <MessageId> che <MessageCreatedDateTime>.
  • Fornisci aggiornamenti aggiuntivi dei metadati, se necessario.

Aggiornamento solo di metadati:un aggiornamento solo XML, con file multimediali non inclusi e senza riferimenti nel file XML.

  • Meta supporta solo gli aggiornamenti dei metadati completi. Devi includere tutti i metadati della traccia video, inclusi i valori che non hanno subito modifiche.
  • L'ultimo aggiornamento dei metadati avrà sempre la precedenza (ovvero, i metadati forniti in precedenza saranno sovrascritti).
  • Elimina le sezioni <TechnicalVideoDetails> e <TechnicalImageDetails> per ciascuna risorsa, poiché i file non sono inclusi.

Lista degli accordi

L'elemento <DealList> definisce le informazioni commerciali chiave per ogni distribuzione, come le aree geografiche in cui questa sarà resa disponibile, i diritti di utilizzo e le date di inizio/fine di ogni distribuzione. Ogni elemento <ReleaseDeal> definisce gli accordi per una distribuzione da <ReleaseList>, a cui si fa riferimento con il relativo <ReleaseReference> .

Meta legge gli accordi in base a ogni singola traccia, pertanto verranno elaborati solo gli accordi per TrackRelease singole (ad es. R1, R2, ecc.). Eventuali accordi cui si fa riferimento per un <ReleaseType> di Album, Singolo o altrimenti (ad es. R0) verranno ignorati.

Date di inizio/fine per ciascun feed

Profilo Single Release di Meta (feed Impronta digitale)

I riferimenti sono attivi alla data e all'ora specificate in <ValidityPeriod>/<StartDate> (o <StartDateTime>). Per attivare un riferimento non appena viene ricevuto, fornisci un <ValidityPeriod>/<StartDate> (o <StartDateTime>) nel passato. Contrassegnando un <EndDate> sul feed delle impronte digitali, il riferimento audio o video viene rimosso da Rights Manager e vengono evitate eventuali corrispondenze con i contenuti generati dagli utenti.

L'esempio seguente specifica che, per i contenuti generati dagli utenti che corrispondono al riferimento, verranno bloccati in tutto il mondo a partire dal 10/01/2023. Il blocco dei contenuti terminerà alle ore 23:59:59 del 26/04/2023 (maggiori informazioni sono disponibili di seguito). A partire dalle ore 00:00:00 del 27/04/2023 e continuando a tempo indeterminato, qualsiasi contenuto generato dagli utenti caricato sulle varie piattaforme di Meta che corrisponde al riferimento verrà monetizzato.

<Deal>
    <DealTerms>
        <TerritoryCode>Worldwide</TerritoryCode>
        <ValidityPeriod>
            <StartDateTime>2023-01-10T00:00:00</StartDateTime>
            <EndDateTime>2023-04-26T11:59:59</EndDateTime>
        </ValidityPeriod>
        <CommercialModelType>RightsClaimModel</CommercialModelType>
        <UseType>UserMakeAvailableUserProvided</UseType>
        <RightsClaimPolicy>
            <RightsClaimPolicyType>BlockAccess</RightsClaimPolicyType>
        </RightsClaimPolicy>
    </DealTerms>
</Deal>
<Deal>
    <DealTerms>
        <TerritoryCode>Worldwide</TerritoryCode>
        <ValidityPeriod>
            <StartDateTime>2023-04-27T00:00:00</StartDateTime>
        </ValidityPeriod>
        <CommercialModelType>RightsClaimModel</CommercialModelType>
        <UseType>UserMakeAvailableUserProvided</UseType>
        <RightsClaimPolicy>
            <RightsClaimPolicyType>Monetize</RightsClaimPolicyType>
        </RightsClaimPolicy>
    </DealTerms>
</Deal>

Profilo Audio Album di Meta (feed Libreria di effetti audio)

Il feed album accetta una data di inizio per i riferimenti pubblicati. Se indichi una data di fine nel feed della Libreria di effetti audio, rimuovi il riferimento solo dalla Libreria di effetti audio. Nel caso di rimozioni, così come per il feed delle impronte digitali, Meta consiglia di inviare un valore <EndDate> di ieri o precedente.

Per entrambi i feed, se <DealTerms> non specifica un <EndDate>, i riferimenti sono validi a tempo indeterminato.

Data e ora

Tempo assoluto e tempo relativo

Meta distingue tra tempo assoluto e tempo relativo. In poche parole, la differenza può essere attribuita alla presenza o meno di un offset del fuso orario.

Il tempo assoluto viene segnalato includendo un offset del fuso orario (es. "...18:00:00Z" o "...18:00:00-07:00"). In pratica, il tempo assoluto si traduce in un'azione applicata esattamente nello stesso punto temporale ("lancio globale") in tutto il mondo. Ad esempio, un StartDateTime "2023-06-10T18:00:00Z" determina le seguenti disponibilità:

  • "2023-06-10 10:00 PST" per gli utenti in California.
  • "2023-06-10 18:00 GMT" per gli utenti nel Regno Unito.
  • "2023-06-10 19:00 CET" per gli utenti in Germania.
  • "2023-06-11 03:00 JST" per gli utenti in Giappone.

Il tempo relativo viene segnalato non includendo un offset del fuso orario (es. "...18:00:00"). In pratica, il tempo relativo si traduce in un'azione applicata alla stessa ora del giorno per gli utenti nel relativo fuso orario locale ("lancio graduale"). Ad esempio, un StartDateTime "2023-06-10T18:00:00" determina le seguenti disponibilità:

  • "2023-06-10 18:00 PST" per gli utenti in California.
  • "2023-06-10 18:00 GMT" per gli utenti nel Regno Unito.
  • "2023-06-10 18:00 CET" per gli utenti in Germania.
  • "2023-06-11 18:00 JST" per gli utenti in Giappone.

Tuttavia, data la natura globale dei prodotti di Meta e della nostra offerta di prodotti basati sui contenuti generati dagli utenti, tutti i dati temporali relativi saranno invece letti come tempo assoluto nel fuso orario ET. Quindi, un StartDateTime "2023-06-10T18:00:00" determina le seguenti disponibilità:

  • "2023-06-10 15:00 PST" per gli utenti in California.
  • "2023-06-10 23:00 GMT" per gli utenti nel Regno Unito.
  • "2023-06-11 00:00 CET" per gli utenti in Germania.
  • "2023-06-11 08:00 JST" per gli utenti in Giappone.

Se la parte responsabile della distribuzione desidera che il contenuto sia disponibile su base territoriale, è possibile utilizzare StartDateTime specifici con offset del fuso orario. Ad esempio, per rendere disponibile un contenuto il 10/06/2023 alle 18:00 ora locale in ognuno dei seguenti Paesi: US, GB, DE e JP:

<ReleaseDeal>
   <Deal>
       <DealReleaseReference>R1</DealReleaseReference>
       <DealTerms>
           <TerritoryCode>US</TerritoryCode>
           <ValidityPeriod>
               <StartDateTime>2023-06-10T18:00:00-05:00</StartDateTime>
           </ValidityPeriod>
           <CommercialModelType>RightsClaimModel</CommercialModelType>
           <UseType>UserMakeAvailableLabelProvided</UseType>
       </DealTerms>
   </Deal>
   <Deal>
       <DealTerms>
           <TerritoryCode>GB</TerritoryCode>
           <ValidityPeriod>
               <StartDateTime>2023-06-10T18:00:00+0:00</StartDateTime>
           </ValidityPeriod>
           <CommercialModelType>RightsClaimModel</CommercialModelType>
           <UseType>UserMakeAvailableLabelProvided</UseType>
       </DealTerms>
   </Deal>
   <Deal>
       <DealTerms>
           <TerritoryCode>DE</TerritoryCode>
           <ValidityPeriod>
               <StartDateTime>2023-06-10T18:00:00+01:00</StartDateTime>
           </ValidityPeriod>
           <CommercialModelType>RightsClaimModel</CommercialModelType>
           <UseType>UserMakeAvailableLabelProvided</UseType>
       </DealTerms>
   </Deal>
   <Deal>
       <DealTerms>
           <TerritoryCode>JP</TerritoryCode>
           <ValidityPeriod>
               <StartDateTime>2023-06-10T18:00:00+09:00</StartDateTime>
           </ValidityPeriod>
           <CommercialModelType>RightsClaimModel</CommercialModelType>
           <UseType>UserMakeAvailableLabelProvided</UseType>
       </DealTerms>
   </Deal>
</ReleaseDeal>

Interpretazione di data e ora per i contenuti delle impronte digitali e della Libreria di effetti audio

Solo data (ad es. "2023-06-10")

  • Descrizione: ora esatta (mezzanotte ET) applicata a livello globale per tutti gli utenti.
  • Tipo: tempo assoluto ("lancio globale")
  • Interpretazione (quando viene applicata la data):
    • Per gli utenti negli Stati Uniti (EST): "2023-06-10T00:00:00-05:00" (o "2023-06-10T05:00:00Z")
    • Per gli utenti nel Regno Unito (BST): "2023-06-10T05:00:00+00:00" (o "2023-06-10T05:00:00Z")
    • Per gli utenti in Germania (CET): "2023-06-10T06:00:00+01:00" (o "2023-06-10T05:00:00Z")
    • Per gli utenti in Giappone (JST): "2023-06-10T13:00:00+09:00" (o "2023-06-10T05:00:00Z")

Data e ora senza fuso orario (ad es. "2023-06-10T09:00:00")

  • Descrizione: ora esatta (analizzata come ET) applicata a livello globale per tutti gli utenti.
  • Tipo: tempo assoluto ("lancio globale")
  • Interpretazione (quando viene applicata la data):
    • Per gli utenti negli Stati Uniti (EST): "2023-06-10T09:00:00-05:00" (o "2023-06-10T14:00:00Z")
    • Per gli utenti nel Regno Unito (BST): "2023-06-10T14:00:00+00:00" (o "2023-06-10T14:00:00Z")
    • Per gli utenti in Germania (CET): "2023-06-10T05:00:00+01:00" (o "2023-06-10T14:00:00Z")
    • Per gli utenti in Giappone (JST): "2023-06-10T22:00:00+09:00" (o "2023-06-10T14:00:00Z")

Data e ora con fuso orario (ad es. "2023-06-10T09:00:00Z")

  • Descrizione: ora esatta (quella fornita) applicata a livello globale per tutti gli utenti.
  • Tipo: tempo assoluto ("lancio globale")
  • Interpretazione (quando viene applicata la data):
    • Per gli utenti negli Stati Uniti (EST): "2023-06-10T04:00:00-05:00" (o "2023-06-10T09:00:00Z")
    • Per gli utenti nel Regno Unito (BST): "2023-06-10T09:00:00+00:00" (o "2023-06-10T09:00:00Z")
    • Per gli utenti in Germania (CET): "2023-06-10T10:00:00+01:00" (o "2023-06-10T09:00:00Z")
    • Per gli utenti in Giappone (JST): "2023-06-10T18:00:00+09:00" (o "2023-06-10T09:00:00Z")

Per le date di inizio e di fine, Meta si riserva il diritto di applicare un periodo di tolleranza per le spese generali operative.

Accordi multipli per la stessa distribuzione

In conformità alla Knowledge Base DDEX, Meta non supporta elementi <ReleaseDeal> con <DealReleaseReference> identico. Se viene utilizzato un <DealReleaseReference> identico per più elementi <ReleaseDeal>, avrà effetto solo l'ultimo elemento <ReleaseDeal>.

Utilizzo di una normativa personalizzata

Per applicare una normativa di corrispondenza personalizzata, le condizioni <DealTerms> per la traccia devono attribuire a Meta i diritti per i contenuti generati dagli utenti e per i contenuti generati dagli utenti con l'aiuto di strumenti, vale a dire, le condizioni devono includere esattamente una delle combinazioni dei tipi seguenti in base a ciascun feed. Meta ignora qualsiasi accordo per altri tipi di distribuzione e altre condizioni dell'accordo.

Meta <DealTerms> per il feed delle impronte digitali audio e video (in genere, profilo Single Release)

<CommercialModelType> deve essere RightsClaimModel
<UseType> deve essere UserMakeAvailableUserProvided

Meta <DealTerms> per il feed della Libreria di effetti audio (in genere, profilo Audio Album)

<CommercialModelType> deve essere RightsClaimModel
<UseType> deve essere UserMakeAvailableLabelProvided

Supporto <DealTerms> per <ValidityPeriod>

Meta supporta solo un singolo <ValidityPeriod> per ogni <DealTerms>. Per indicare un nuovo <ValidityPeriod>, è necessario fornire un aggiornamento per la distribuzione interessata.

<RightsClaimPolicy>

Affinché i contenuti caricati vengano associati ai contenuti generati dagli utenti sulle piattaforme di Meta, è necessario fornire <RightsClaimPolicy> con un valore <RightsClaimPolicyType>. Il <RightsClaimPolicyType> definisce la normativa di corrispondenza del tuo riferimento. Le corrispondenze vengono create solo se includi questo elemento. La tabella seguente associa i valori ERN consentiti all'azione Rights Manager.

ERN RightsClaimPolicyType Rights Manager di Meta
MonetizeClaim Ad Earnings
BlockAccessBlock
ReportUsageMonitor (Track)

RightsClaimPolicy è un campo obbligatorio per tutti i DealTerms delle impronte digitali, a meno che non venga comunicata una rimozione.

Uso personalizzato di <RightsClaimPolicyType> + <Condition>

L'elemento <Condition> all'interno di <RightsClaimPolicy> specifica la percentuale di corrispondenza sui contenuti generati dagli utenti. Le normative condizionali si applicano solo se la durata o la percentuale di corrispondenza rientrano in una soglia specifica.

Ad esempio, il codice qui sotto applica una normativa di corrispondenza di Claim Ad Earnings, ma solo se la durata della corrispondenza è superiore al 90% della durata del file di riferimento.

<RightsClaimPolicy>
    <Condition>
        <Value>90</Value>
        <Unit>Percent</Unit>
        <RelationalRelator>MoreThanOrEqualTo</RelationalRelator>
    </Condition>
    <RightsClaimPolicyType>Monetize</RightsClaimPolicyType>
</RightsClaimPolicy>

<TerritoryCode>

<TerritoryCode> può aiutare a specificare diverse normative di corrispondenza per diversi territori. Per farlo, fornisci più elementi <Deal>, ciascuno con le rispettive caratteristiche (ad es. StartDate, RightsClaimPolicy).

In questo esempio, l'accordo specifica di richiedere i ricavi pubblicitari negli Stati Uniti e di bloccarli in Canada. Le condizioni di corrispondenza sono una percentuale superiore al 10% di una corrispondenza di riferimento.

<Deal>
    <DealTerms>
        <TerritoryCode>US</TerritoryCode>
        <ValidityPeriod>
            <StartDateTime>2023-09-01T00:00:00</StartDateTime>
        </ValidityPeriod>
        <CommercialModelType>RightsClaimModel</CommercialModelType>
        <UseType>UserMakeAvailableUserProvided</UseType>
        <RightsClaimPolicy>
            <Condition>
                <Value>10</Value>
                <Unit>Percent</Unit>
                <RelationalRelator>MoreThanOrEqualTo</RelationalRelator>
            </Condition>
            <RightsClaimPolicyType>Monetize</RightsClaimPolicyType>
        </RightsClaimPolicy>
    </DealTerms>
</Deal>
<Deal>
    <DealTerms>
        <TerritoryCode>CA</TerritoryCode>
        <ValidityPeriod>
            <StartDateTime>2023-09-01T00:00:00</StartDateTime>
        </ValidityPeriod>
        <CommercialModelType>RightsClaimModel</CommercialModelType>
        <UseType>UserMakeAvailableUserProvided</UseType>
        <RightsClaimPolicy>
            <Condition>
                <Value>10</Value>
                <Unit>Percent</Unit>
                <RelationalRelator>MoreThanOrEqualTo</RelationalRelator>
            </Condition>
            <RightsClaimPolicyType>BlockAccess</RightsClaimPolicyType>
        </RightsClaimPolicy>
    </DealTerms>
</Deal>

Rimozioni

Per le rimozioni, Meta consiglia di impostare <EndDate> sulla data di scadenza dell'accordo, come spiegato in questo articolo della knowledge base DDEX. Per rimuovere una registrazione audio o un video musicale da Rights Manager, devi fornire una <EndDate> nel passato. Questo si applica al profilo Single Resource e al profilo Album Release.

Lista degli accordi per il profilo Single Release di Meta (feed Impronte digitali)

Indica una <EndDate> nel passato. Ciò disattiverà il riferimento in Rights Manager e rimuoverà la sua normativa di corrispondenza. Puoi anche eseguire una rimozione impostando <RightSharePercentage> su 0.0 per Worldwide o tutti i territori.

Lista degli accordi per il profilo Audio Album di Meta (feed Libreria di effetti audio)

Indica una <EndDate> nel passato. Ciò rimuoverà la traccia dalla Libreria di effetti audio.

Rimozione per territorio

Ci sono due modi per ottenere una rimozione territoriale:

  • indicare i territori che continueranno ad avere diritti con una StartDate E fornire le aree geografiche da rimuovere con una EndDate;
  • indicare solo i territori che continueranno ad avere i diritti con una StartDate.
In entrambi i casi, il risultato finale saranno diritti affermativi per un insieme di territori e nessun diritto per il resto.

Esempi

Esempio 1. Rimozione per territorio

<!--
Assuming you had ownership in the past on DE, US, CA and MX.
And you lost ownership in CA and MX.
Please note that deal definitions for the remaining territories (DE and US in this case)
need to present in the message.
-->
<DealList>
    <ReleaseDeal>
        <DealReleaseReference>R1</DealReleaseReference>
        <Deal>
            <DealTerms>
                <TerritoryCode>CA</TerritoryCode>
                <TerritoryCode>MX</TerritoryCode>
                <ValidityPeriod>
                    <StartDateTime>2023-08-15T00:00:00</StartDateTime>
                    <EndDateTime>2023-09-01T00:00:00</EndDateTime>
                </ValidityPeriod>
                <CommercialModelType>RightsClaimModel</CommercialModelType>
                <UseType>UserMakeAvailableUserProvided</UseType>
                <UseType>UserMakeAvailableLabelProvided</UseType>
                <RightsClaimPolicy>
                    <RightsClaimPolicyType>Monetize</RightsClaimPolicyType>
                </RightsClaimPolicy>
            </DealTerms>
        </Deal>
        <Deal>
            <DealTerms>
                <TerritoryCode>DE</TerritoryCode>
                <TerritoryCode>US</TerritoryCode>
                <ValidityPeriod>
                    <StartDateTime>2023-08-15T00:00:00</StartDateTime>
                </ValidityPeriod>
                <CommercialModelType>RightsClaimModel</CommercialModelType>
                <UseType>UserMakeAvailableUserProvided</UseType>
                <UseType>UserMakeAvailableLabelProvided</UseType>
                <RightsClaimPolicy>
                    <RightsClaimPolicyType>Monetize</RightsClaimPolicyType>
                </RightsClaimPolicy>
            </DealTerms>
        </Deal>
    </ReleaseDeal>
</DealList>

Esempio 2. Rimozione di una singola traccia all'interno di un prodotto

<DealList>
    <ReleaseDeal>
        <DealReleaseReference>R1</DealReleaseReference>
        <Deal>
            <DealTerms>
                <TerritoryCode>Worldwide</TerritoryCode>
                <ValidityPeriod>
                    <StartDateTime>2023-08-15T00:00:00</StartDateTime>
                    <EndDateTime>2023-09-01T00:00:00</EndDateTime>
                </ValidityPeriod>
                <CommercialModelType>RightsClaimModel</CommercialModelType>
                <UseType>UserMakeAvailableUserProvided</UseType>
                <UseType>UserMakeAvailableLabelProvided</UseType>
                <RightsClaimPolicy>
                    <RightsClaimPolicyType>Monetize</RightsClaimPolicyType>
                </RightsClaimPolicy>
            </DealTerms>
        </Deal>
    </ReleaseDeal>
        <Deal>
        <DealReleaseReference>R2</DealReleaseReference>
        <DealReleaseReference>R3</DealReleaseReference>
            <DealTerms>
                <TerritoryCode>Worldwide</TerritoryCode>
                <ValidityPeriod>
                    <StartDateTime>2023-08-15T00:00:00</StartDateTime>
                </ValidityPeriod>
                <CommercialModelType>RightsClaimModel</CommercialModelType>
                <UseType>UserMakeAvailableUserProvided</UseType>
                <UseType>UserMakeAvailableLabelProvided</UseType>
                <RightsClaimPolicy>
                    <RightsClaimPolicyType>Monetize</RightsClaimPolicyType>
                </RightsClaimPolicy>
            </DealTerms>
        </Deal>
    </ReleaseDeal>
</DealList>

Esempio 3. Rimozione completa usando la lista dei territori

<!--
Assuming you had ownership in the past on DE, US, CA and MX.
And you lost ownership in all of these territories.
-->
<DealList>
    <ReleaseDeal>
        <DealReleaseReference>R1</DealReleaseReference>
        <DealReleaseReference>R2</DealReleaseReference>
        <DealReleaseReference>R3</DealReleaseReference>
        <Deal>
            <DealTerms>
                <TerritoryCode>DE</TerritoryCode>
                <TerritoryCode>US</TerritoryCode>
                <TerritoryCode>CA</TerritoryCode>
                <TerritoryCode>MX</TerritoryCode>
                <ValidityPeriod>
                    <StartDateTime>2023-08-15T00:00:00</StartDateTime>
                    <EndDateTime>2023-09-01T00:00:00</EndDateTime>
                </ValidityPeriod>
                <CommercialModelType>RightsClaimModel</CommercialModelType>
                    <UseType>UserMakeAvailableUserProvided</UseType>
                    <UseType>UserMakeAvailableLabelProvided</UseType>
                <RightsClaimPolicy>
                    <RightsClaimPolicyType>Monetize</RightsClaimPolicyType>
                </RightsClaimPolicy>
            </DealTerms>
        </Deal>
    </ReleaseDeal>
</DealList>

Esempio 4. Rimozione completa usando Worldwide

<!--
Assuming you have ownership in the past on DE, US, CA and MX.
And you lost ownership in all of these territories.
-->
<DealList>
    <ReleaseDeal>
        <DealReleaseReference>R1</DealReleaseReference>
        <DealReleaseReference>R2</DealReleaseReference>
        <DealReleaseReference>R3</DealReleaseReference>
        <Deal>
            <DealTerms>
                <TerritoryCode>Worldwide</TerritoryCode>
                <ValidityPeriod>
                    <StartDateTime>2023-08-15T00:00:00</StartDateTime>
                    <EndDateTime>2023-09-01T00:00:00</EndDateTime>
                </ValidityPeriod>
                <CommercialModelType>RightsClaimModel</CommercialModelType>
                    <UseType>UserMakeAvailableUserProvided</UseType>
                    <UseType>UserMakeAvailableLabelProvided</UseType>
                <RightsClaimPolicy>
                    <RightsClaimPolicyType>Monetize</RightsClaimPolicyType>
                </RightsClaimPolicy>
            </DealTerms>
        </Deal>
    </ReleaseDeal>
</DealList>